我用 3 个 AI Agent 并行写代码，产出翻 3 倍——但第一天就踩了 5 个坑

上个月我的代码提交量涨了 3 倍，不是因为我突然变强了，是因为我开始让 3 个 AI Agent 同时干活。但说实话，第一周差点把项目搞崩。

Claude Code 负责架构和重构，Codex CLI 写功能模块，OpenCode 跑测试修 Bug。听起来像个完美的流水线对吧？实际跑起来的第一天，三个 Agent 在同一个文件里互相覆盖对方的代码，Git 冲突比我的 commit 还多。

坑 1：三个 Agent 改同一个文件，合并到你怀疑人生

最开始我让三个 Agent 各自认领一个 feature，结果它们都对 main.py 和 config.yaml 动了手。Claude Code 重构了配置加载逻辑，Codex 同时加了个新接口，OpenCode 修 Bug 的时候又改了异常处理——三个 diff 摞在一起，merge 的时候我盯着屏幕看了二十分钟不知道该留谁的。

解法：用 Git worktree。给每个 Agent 分配独立的工作目录，各自在自己的分支上干活：

# 为每个 Agent 创建独立 worktree
git worktree add ../agent-claude feature/claude-refactor
git worktree add ../agent-codex feature/codex-api
git worktree add ../agent-opencode fix/opencode-bugs

每个 Agent 的 prompt 里明确写死：「你只能修改以下文件：xxx」。这条规则比什么高级 prompt 技巧都管用。

坑 2：Agent 之间不知道对方在干什么

Codex 写了个 UserService 类，Claude Code 重构的时候不知道这回事，把接口签名全改了。Codex 的代码瞬间全部炸，OpenCode 跑测试的时候报了 47 个错。

解法：在项目根目录放一个 CONTEXT.md 文件，每次 Agent 完成任务后自动追加一行日志：

[Claude Code] 重构了 UserService，新签名为 get_user(user_id: str) -> UserDTO
[Codex CLI] 新增 PaymentService，依赖 UserService.get_user()
[OpenCode] 修复了 PaymentService 的空指针，需要 UserDTO 包含 payment_methods 字段

不要追求自动同步——让 Agent 读这个文件比搞什么共享状态可靠得多。10 行文本，解决了我 80% 的协同问题。

坑 3：Token 消耗爆炸，一天烧了 $40

三个 Agent 并行跑，每个都在反复读项目文件、跑测试、分析输出。第一天下来 Token 账单 $42，我整个人都不好了。后来发现 Claude Code 在重构的时候把整个项目文件全读了一遍——很多文件它根本不需要看。

解法：

# .claude/settings.json
{
  "maxContextSize": 64000,
  "autoCompact": true,
  "excludedFiles": ["*.lock", "node_modules/**", "dist/**", "*.min.js"]
}

同时给每个 Agent 限定任务范围：「只关注 src/services/ 目录，不需要看 tests/ 和 docs/」。加上 headroom 压缩工具输出后再喂给 LLM，Token 消耗从 $42 降到了 $12。

坑 4：三个 Agent 的代码风格完全不一样

Claude Code 写的代码像教科书——类型标注完整、docstring 齐全、函数不超过 30 行。Codex CLI 写的像赶死线——变量名是 data、result、tmp，一个函数能干 200 行。OpenCode 修 Bug 的时候顺手把 Codex 的代码改了，但不是重构，是把 data 改成了 payload——然后所有引用 data 的地方全炸。

解法：项目根目录放 .cursorrules 或 .claude/instructions.md，所有 Agent 启动时自动读：

## 代码规范（所有 Agent 必须遵守）
- 函数不超过 50 行
- 变量名必须有意义，禁止 data/tmp/result
- Python 用 typing，TypeScript 用严格模式
- 改别人代码前：先读 CONTEXT.md 确认负责人

这条规范文件是我花时间最多的——不是写代码，是把规则写清楚。但只要写一次，三个 Agent 都老实了。

坑 5：并行跑导致 Git 冲突每 10 分钟一次

三个 Agent 同时在各自 worktree 里提交，每次合并都有冲突。我一开始手动解决，15 分钟一次，比写代码还累。后来发现不是 Git 的问题——是任务拆得太碎。

解法：不要让 Agent 拆成 10 个小任务并行跑，而是让每个 Agent 领一个独立的大模块：

• Claude Code：负责整个 auth 模块（10 个文件）
• Codex CLI：负责整个 payment 模块（8 个文件）
• OpenCode：修 notification 模块的 Bug（5 个文件）

三个模块几乎没有文件交集，合并冲突从每天 20+ 次降到 2 次。

现在的流程

三周跑下来，这一套已经稳了：

1. 早上 9 点，写好今天的 CONTEXT.md 更新，列出各 Agent 负责的模块
2. 开三个终端，各自在独立 worktree 里跑 Agent
3. 中午 12 点，review 三个 Agent 的输出，把能用的合并进主分支
4. 下午 2 点，根据上午的结果调整任务，继续跑
5. 下午 5 点，收工，合并最终版本

代码产出从一天 200 行提到了 600 行。注意：不是让 Agent 写更多代码，是让 Agent 分担不同类型的活。人做决策和架构，Agent 做实现和测试——这才是并行真正的价值。

你试过多 Agent 并行吗？遇到了什么坑？评论区聊聊。

---

📌 作者：Aliaoo
🚀 专注 AI 工具实战、云部署、自动化脚本。每篇都是亲测可跑的教程。

🖥️ 需要云服务器跑项目？ 👉 CSDN 开发云常年折扣，新用户首单特惠

📬 觉得有用就点个赞，想追更就点个关注——下次搜到我不靠缘分。