实战

Claude Code 并行开发实战:多会话、Git Worktrees、Fan-out 同时处理多个任务

Claude Code 并行开发实战:6 种方案(多会话标签、Git Worktrees、非交互批量、Writer/Reviewer、Agent Teams、Fan-out)同时处理多个任务,含成本优化模型选择建议。

2026/4/104分钟 阅读ClaudeEagle

一个 Claude 实例处理一个任务,两个处理两个。Claude Code 支持真正的并行开发,多个实例同时工作互不干扰。


为什么需要并行?

  • 大型重构:100 个文件 JS→TS,分 10 批并行处理
  • 功能开发:一个实例写代码,另一个同时写测试
  • Writer/Reviewer:A 写,B 审,比自我 review 质量高
  • 多 bug 并行修:10 个独立 issue,10 个实例同时处理

方案 1:多会话标签页(最简单)

VS Code 插件:

命令面板 → Claude Code: Open in New Tab

每个标签独立上下文。蓝点 = 等待确认,橙点 = 后台完成。


方案 2:Git Worktrees + 多实例(真正并行)

多会话在同一目录会互相覆盖文件,Worktrees 解决这个问题:

bash
# 每个功能独立工作目录
git worktree add ../project-auth feature/auth
git worktree add ../project-payments feature/payments
git worktree add ../project-search feature/search

# 分别在不同 VS Code 窗口打开
code ../project-auth
code ../project-payments
code ../project-search

# 完成后合并
git worktree remove ../project-auth
git merge feature/auth

方案 3:非交互模式批量并行(CI/自动化)

bash
# 并行分析多个日志
for log_file in logs/*.log; do
  claude -p "Analyze and summarize errors in this log" \
    --output-format json < "$log_file" > "analysis_$(basename $log_file).json" &
done
wait

# 批量生成文档
find src -name '*.ts' | while read f; do
  claude -p "Write JSDoc for this file" < "$f" >> docs_output.json &
done

输出格式:textjson(方便脚本处理)、stream-json(实时处理)


方案 4:Writer/Reviewer 模式

text
# 会话 A(Writer)
"Implement a rate limiter for our API endpoints"

# 会话 B(Reviewer,全新干净上下文)
"Review @src/middleware/rateLimiter.ts for edge cases,
race conditions, and consistency with existing middleware."

# 会话 A 根据反馈修改
"Here's the review feedback: [paste from B]. Address these issues."

Reviewer 有干净上下文,不会偏向自己写的代码,review 质量更高。

也适合测试:A 写代码,B 写测试(互不知道对方的实现)。


方案 5:Agent Teams(自动协调)

多个 Claude 自动协调,一个「队长」分配任务,「队员」并行执行:

text
[队长]
任务:把认证从 JWT 迁移到 OAuth2
→ 队员 A:src/auth/ 核心逻辑
→ 队员 B:更新 5 个调用方
→ 队员 C:更新测试

[并行执行后汇报给队长]

按任务类型选模型节省成本:

任务推荐模型
代码库探索haiku(快速便宜)
功能实现sonnet(平衡)
安全 review、复杂重构opus(最强)

方案 6:Fan-out 大规模迁移

bash
# 列出所有需要迁移的文件
find src -name '*.js' > files.txt

# 分批(每批 10 个)
split -l 10 files.txt batch_

# 并行启动多个实例
for batch in batch_*; do
  claude --permission-mode auto \
    -p "Migrate JS to TypeScript: $(cat $batch)" &
done
wait

# 汇总验证
claude -p "Review all migrations and fix remaining issues"

并行时的注意事项

1. 给每个 Agent 明确边界:不让两个 Claude 改同一批文件。

2. 用 Worktrees 防冲突:同一目录多 Claude 会互相覆盖。

3. CLAUDE.md 里定义团队规则

markdown
# Agent Team 规则
- 队员只修改分配给自己的文件
- 发现跨模块依赖时通知队长,不自行处理
- 完成后在 tasks/status.md 更新状态

4. 用独立 Reviewer Agent 验证

text
"Use a subagent to review all changes for edge cases and security issues"

来源:Claude Code 官方 Best Practices | morphllm.com | 整理:ClaudeEagle

相关文章推荐

实战Claude Code Agent Teams 实战指南:启用配置、并行任务分工、计划审批与最佳实践Claude Code Agent Teams 实战指南:启用配置(CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 settings.json 或环境变量)、Agent Teams vs Subagents 5 维度对比(上下文/通信/协调/适用场景/Token 消耗)、四大最适用场景(研究审查/独立模块/竞争假设调试/跨层协调)、启动示例(自然语言描述任务和团队结构)、两种显示模式(in-process Shift+Down 切换/split panes tmux 分屏)、计划审批流程(Plan 模式/Lead 自主审批/拒绝反馈重提交)、共享任务列表(pending-in progress-completed/文件锁防竞争/自主认领)、对话历史共享机制、清理团队,以及 7 大最佳实践和常见问题排查。2026/3/9实战Claude Code Agent Teams 实战指南:多实例协作、并行代码审查与竞争假设调试Claude Code Agent Teams 完整实战指南:适用场景(研究审查/新功能/竞争假设/跨层协调)、启用方法(CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1)、自然语言创建团队示例、in-process 和 split panes 两种显示模式、六大控制操作(指定模型/要求 Plan 批准/直接对话/任务分配/关闭队友/清理团队)、Hooks 质量关卡配置、并行代码审查和竞争假设调试两个实战案例,以及五大故障排查。2026/3/6实战实战:用 Claude Code 从零开发 Z80/ZX Spectrum 模拟器的完整经验分享Redis 作者 antirez 分享了用 Claude Code 在净室条件下完全自主开发 Z80/ZX Spectrum 模拟器的完整经验。Claude Code 独立工作 20 分钟,产出 1200 行高质量 C 代码,通过了最严格的 ZEXDOC/ZEXALL 测试,全程零次用户提示,揭示了正确使用 Claude Code 的关键:提供详细设计文档和规格说明。2026/2/28实战Claude Code Hooks 实战:自动格式化、危险命令拦截、任务通知,6 个开箱即用配置Claude Code Hooks 实战:6 个开箱即用配置——Prettier 自动格式化、rm -rf 拦截、路径保护、任务完成通知、ESLint 自动修复、会话日志。Hooks 是 100% 确定执行的。2026/4/10实战Claude Code 上下文管理实战:/compact、/clear、子 Agent,解决长会话性能下降Claude Code 上下文管理完整攻略:6 条实战规则解决长会话性能下降,含 /compact /clear 时机选择、子 Agent 节省 40% Token、跨会话继续任务、检查点回退操作。2026/4/10实战Claude Code Hooks 进阶:用事件钩子打造自动格式化、安全检查和部署流水线Claude Code Hooks 进阶教程:5 个实战案例覆盖自动格式化、安全守卫、commit 消息生成和通知转发。含完整配置和 Hook 输出协议详解。2026/4/7