Nethür
登录
macOS 版即将推出

博客 · 2026年11月3日

如何并行运行多个 Claude Code agent

并行 Claude Code session 实用指南:为什么共用一个 checkout 会互相干扰、git worktree 如何解决,以及如何让多个 agent 的成果都便于审查。

Nethür 工作空间中多个 agent session 并排运行

一个 Claude Code session 在单个 checkout 内是单线程的:它读写你启动它时所在目录中的文件。要并行运行多个 Claude Code agent,就给每个 agent 一个独立的 git worktree——在独立 branch 上的另一份 checkout——并在每个 worktree 中启动一个 Claude Code 实例。像 Nethür 这样的托管工具会自动处理 worktree、terminal 和审查所需的记录工作。

一个 Claude Code session 很惊艳,直到你需要同时推进三项改动。常见的本能反应是在同一个仓库里打开三个 terminal 标签页。这样能撑几分钟,然后两个 agent 开始编辑同一个文件,一个在另一个脚下切换 branch,测试运行读到的 checkout 已经不存在了。

并行 agent 不是 prompt 的问题,而是文件系统的问题。Claude Code 通过普通文件完成工作,所以两个 session 需要两个既不共享 branch、也不共享 index 的工作目录。

为什么 terminal 标签页算不上并行工作

一个 git 仓库的每个工作树只有一个已检出 branch。在同一棵工作树里打开两个 Claude Code session,它们共享一切:相同的文件、相同的 index、相同的 node_modules、相同的 dev server 端口。session 看起来彼此独立,是因为 terminal 彼此独立,但底下的代码不是。

  • 一个 agent 执行 git switch 或 git rebase,另一个 agent 还在编辑旧文件。
  • 两个 agent 写同一个文件;后保存的覆盖先保存的,先前的改动从工作树里消失。
  • test watcher、dev server 或 migration 针对的是那一刻碰巧检出的 branch。
  • 审查结果只能靠猜,因为 diff 里同时包含每个 session 的工作。

标签页用来做只读浏览、看日志或者问个快速问题仍然有用。一旦 agent 需要编辑文件并运行测试,它就不再合适了。

并行运行 session 的三种实用方式

有三种方案值得考虑。它们的区别在于给你多少隔离,以及把多少记录和清理工作留给你自己。

  1. 同一个 checkout 里的 terminal 标签页——启动快,但并发编辑不安全。
  2. 手动创建 git worktree,每个 worktree 配一个 Claude Code 实例——真正隔离,但路径、依赖和清理都要自己管。
  3. 像 Nethür 这样的工作空间:自动创建并跟踪 worktree,在每个 worktree 中运行 agent,并把 diff 和 session 集中在一处。

方案一:自己创建 git worktree

git worktree 是同一个仓库的第二份 checkout,位于独立目录、使用独立 branch。git 共享对象数据库,所以副本很轻量,但文件和 index 是独立的。

git fetch origin
git worktree add ../shop-fix-login -b fix/login origin/main
git worktree add ../shop-fix-billing -b fix/billing origin/main

cd ../shop-fix-login && claude
# second terminal
cd ../shop-fix-billing && claude

现在每个 Claude Code 实例看到的是不同的目录和不同的 branch。你可以让一个修 login race,另一个重写 billing,两者都不会覆盖对方的文件。

代价在于新 checkout 缺少的一切:依赖没装、.env 文件不在,两个 session 还可能尝试绑定同一个端口。你要么在每个 worktree 里重新安装,要么共享那些体积大、被 gitignore 的目录。Nethür 在worktree 指南中记录了同样的问题和自己的解法:共享路径、nethur.yaml 配置项、.worktreeinclude 和 setup hook。

方案二:使用 Claude Code 自带的并行能力

Claude Code 自身在不断加入同时运行多条工作流的方式。桌面应用可以在隔离的 git worktree 中运行并行 session,subagent 和 agent team 则让一个 session 把部分工作委派出去。如果你完全生活在 Anthropic 的产品里并且独自工作,这或许已经够用。

这些能力仍然只围绕 Claude。它们不会给你一个让 Claude Code、Codex 和其他 CLI agent 并排运行的工作空间,也不会给队友一个共享场所来查看和接管彼此的 session。如果你的并行工作跨越不同 agent、机器或人,就需要 agent 之上的一层。

方案三:替你管理 worktree 的工作空间

Nethür 的设计前提是:一个任务对应一个工作空间,而不是一个标签页。每个 worktree 都是真正的 git worktree,有自己的 branch、文件、terminal、编辑器标签页和浏览器标签页。创建一个 worktree 只需要一个简短对话框,git 操作在后台完成。

  1. 安装 Nethür 并添加仓库。如果是团队使用,选择承载工作的机器——你的笔记本、队友的机器、VPS 或 SSH 目标。
  2. 为每个并行任务创建一个 worktree。按任务命名,选择 start-from ref(通常是 origin/main),如果有 GitHub、GitLab、Linear 或 Jira 条目就一并关联。
  3. 在每个 worktree 中打开 agent 选择器并启动 Claude Code。Nethür 会以该 worktree 作为工作目录启动它,因此两个 session 不会互相干扰。
  4. agent 运行时,可以拆分窗格或在 worktree 之间切换。侧边栏会显示哪些 session 正在工作、等待或已完成。
  5. 针对各自的 start-from ref 审查每个 diff。保留胜出的版本,commit 并 push,从该 worktree 打开 pull request,然后删除落选的 worktree 及其 branch。

关键差异不在于那个创建 worktree 的按钮,而在于 worktree、agent session、diff 和清理始终附着在同一个任务上。并行 agent 实操指南用截图和一个三 agent 的示例走完了同样的流程。

哪种方式适合你的工作?

方式文件隔离搭建审查团队
同一 checkout 中的标签页无——共享文件和 branch即时diff 混杂,需要手动理清没有共享视图
手动 git worktree完整——每个 worktree 一个 branchgit 命令、依赖、env 文件每个目录一个 diff,全靠手动路径只能在聊天里传来传去
Claude Code 桌面端对 Claude session 完整隔离安装并登录Claude 内置审查单用户界面
Nethür完整——git worktree 或文件夹工作空间添加仓库,创建 worktree按 worktree 查看 diff、标注、PR 流程共享项目、聊天、接管

四种能发挥并行优势的模式

  • 同一任务,三个 agent。把完全相同的 prompt 交给三个 worktree 中的 Claude Code、Codex 和另一个 CLI。比较 diff,而不是依次重试;分歧通常指向真正的难点。
  • 按层面拆分。一个 agent 负责 API 改动,一个负责 UI,一个写测试。把同一个 issue 关联到每个 worktree,让上下文始终可见。
  • 实现与审查。让一个 agent 做改动,另一个在独立 worktree 中阅读 diff 并寻找回归。你仍然是最终裁决者。
  • 探索与交付。在一个 worktree 中保留长期调研 session,在另一个中进行干净的实现 session。调研 agent 永远不会弄脏你即将 merge 的 branch。

需要提前规划的坑

  • 依赖和本地密钥。新的 worktree 是干净的 checkout。共享 node_modules 和缓存,用 .worktreeinclude 复制 .env 文件,或者在创建后运行 setup hook。
  • 端口和数据库。两个 dev server 抢 3000 会打架。给每个 worktree 分配独立端口,尽可能也分配独立数据库或 schema。
  • 生成文件和 migration。除非工具本身支持,否则不要对同一个数据库运行两个 migration。
  • Token 预算。并行会成倍放大用量。先从两三个 session 开始,留意用量仪表,停掉那些只是在等待的 session。
  • 清理欠账。每个 worktree 都是一个 branch。选定赢家后立刻删除落选者,否则仓库会堆满被放弃的实验。

并行工作遇上多人协作会更难

当两个开发者同时在同一项目上运行 agent,文件系统问题就变成了协调问题。谁的 worktree 在哪个 branch 上?谁在等审查?作者离线时,别人能接手这个 session 吗?

Nethür 用共享项目和团队服务器解决这一点:所有人连接同一个工作空间,能看到活跃 session,可以在工作旁边 @ 提及彼此,并且无需复制对话记录就能接管 session。每个人仍然用自己的 Claude 订阅登录,没有需要轮换的共享 key。团队指南介绍了具体搭建方式。

从两个 worktree 开始

选一个通常需要连续跑两次 Claude Code 的任务。从同一个 ref 创建两个 worktree,给两个 agent 相同的 prompt,然后比较结果。这个实验比任何 benchmark 都更能说明并行工作的实际情况:你会在自己的仓库里看到隔离带来的好处、依赖带来的摩擦,以及审查的成本。

奏效之后,保留胜出的 branch,删掉另一个 worktree。然后用一个能干净拆成两半的任务再来一次。并行 agent 是一种习惯,不是一个开关。

把指南用起来。

下载 Nethür,几分钟内跑起第一个并行 agent;或者在你已有的机器上搭建团队工作空间。