怎么同时运行多个 Claude Code agent

并行运行 Claude Code agent 的四种方式

Subagent：一个会话里的并行助手

subagent 有自己的上下文窗口、系统提示词和工具。它看不到你的对话，只有它的总结会传回来，这样主会话的上下文就能保持精简。Claude Code 自带 Explore（只读）和 Plan 等内置 subagent，你也可以自己加。

1. 定义一个 subagent

   在 .claude/agents/（和项目共享）或 ~/.claude/agents/（只给你自己）里建一个 Markdown 文件。只有 name 和 description 是必填的；tools 限制它能用什么，model 选择模型。

   ---
   name: code-reviewer
   description: Reviews code for quality and best practices
   tools: Read, Glob, Grep
   model: sonnet
   ---
   
   You are a code reviewer. When invoked, analyze the code and give
   specific, actionable feedback on quality, security and best practices.

2. 让 Claude 同时跑好几个

   直接要求并行，比如“并行审查 auth、billing 和 search 三个模块”。Claude 派生的 subagent 默认在后台启动，最多同时 20 个，做完后汇报。输入 /tasks 可以看到它们。

3. 给要改文件的 subagent 单独的 worktree

   在 subagent 的 frontmatter 里加上 isolation: worktree，或者让 Claude 给它的 agent 使用 worktree。这样每个 subagent 都在仓库的一份临时副本里修改；如果没做任何改动，副本会被删除。

在 git worktree 里并行运行 Claude Code 会话

1. 忽略 worktree 文件夹

   Claude Code 在仓库根目录的 .claude/worktrees/ 里创建 worktree。仓库至少要有一个 commit。

   echo ".claude/worktrees/" >> .gitignore

2. 每个任务开一个会话

   在每个终端里用不同的名字运行 claude --worktree（或 -w）。每个会话都有自己的文件夹和一个名为 worktree-<name> 的分支，基于默认分支创建。

   # 终端 1
   claude --worktree feature-auth
   
   # 终端 2
   claude --worktree bugfix-login

3. 复制需要的未跟踪文件

   新的 worktree 里只有被 Git 跟踪的文件。把 .env 这类文件列进 .worktreeinclude 文件（gitignore 语法），Claude Code 就会把它们复制进去。

   .env
   .env.local

4. 合并并清理

   会话结束时，没有改动的 worktree 会连同分支一起删除；有改动的会问你是否保留。像合并其他分支一样合并它们。headless 的 -p 运行不会询问，所以要用 git worktree remove 自己删掉。

5. 或者用桌面应用

   按 Cmd+N（Windows 上是 Ctrl+N）新建会话，启动前打开 Worktree 开关；它默认是关的。多个会话可以在分屏视图里并排显示。

来源：Anthropic 的 worktree 文档（英文）

用 --bg 和 agent view 运行后台会话

claude --bg "<prompt>" 在后台启动一个会话并立即返回，所以你可以接连启动好几个。每个会话在修改任何东西之前都会先进入自己的 worktree。claude agents 列出它们；claude logs <id>、claude attach <id> 和 claude stop <id> 管理单个会话。

关掉终端后它们会继续运行，但电脑关机后就不会了。Agent view 还是研究预览版。更多无人值守运行的内容，看怎么在后台运行 Claude Code agent。

Agent teams：能互相沟通的 agent

Agent teams 是实验性功能，默认关闭。在 shell 里或 settings.json 的 env 块里设置 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 开启，然后让 Claude 为某个任务“派生三个队友”。队友共享一个任务列表并互相发消息；它们显示在终端里，用 tmux 或 iTerm2 时也可以显示在分屏窗格里。

• 只支持交互式会话：-p 和 Agent SDK 不会派生队友。
• 每个会话只能有一个团队，不能嵌套团队，进程内的队友不会被 /resume 恢复。
• 队友共用同一份代码检出，所以要给每个人分配不同的文件。
• 花费高得多：按 Anthropic 文档的说法，队友在 plan 模式下运行时，一个团队大约要用单个会话 7 倍的 token。

避免并行 agent 互相覆盖

• 如果两个 agent 可能动到同样的文件，就给每个一个独立的 worktree。worktree 里的会话改不了主检出，它的 subagent 也改不了。
• 在 agent team 里按文件分工：两个队友改同一个文件会互相覆盖。
• 每个 subagent 和会话都消耗同一份用量限制，所以同时跑好几个会成倍消耗用量。简单的 subagent 用 model: haiku。
• 运行同一套测试或开发服务器的 agent 可能会抢端口；给每个分配自己的端口。

把并行的 agent 变成各有分工的团队

worktree 和 agent teams 拆分的是你正盯着的一个任务。Crewmark 则把多个 Claude Code 或 Codex 会话作为员工来运行，各有自己的岗位、目标和工作时间，在同一块看板上派活。

1. 一个岗位一名员工

   SEO 专员、软件工程师和 UI 设计师各自待在自己的对话里，有自己的指令和目标。

2. 所有人共用一块看板

   把 issue 分配给合适的员工。每名员工按自己的心跳醒来，领下一个 issue，边做边评论，谁在做什么一目了然。

3. 它们来问你，而不是互相问

   员工需要审核或权限时，会给你发消息，然后先做别的。读读什么是 AI 员工。

多个 Claude Code agent 常见问题