如何用 git worktree 并行运行多个 AI 编码 agent

到 2026 年，AI 辅助开发中最大的转变之一，就是你不再让单个 agent 对着单个任务。Claude Code 和 Cursor 这类工具现在鼓励并行运行多个 agent——一个修 bug，一个写测试，第三个起草新功能。陷阱在于：如果它们都编辑同一个工作目录，就会互相覆盖各自的改动，把构建搞坏。

干净的解决办法是一个老牌 Git 特性，事实证明它正是为此而生的完美原语：worktree（工作树）。

worktree 到底是什么

通常一个 Git 仓库只有一个工作目录——也就是你编辑文件的那个文件夹。git worktree 让一个仓库能同时拥有多个工作目录，每个检出到不同的分支，而它们共享同一份底层的 .git 历史。每个 worktree 都是磁盘上一个带有自己文件的真实文件夹，所以一个 agent 在某个 worktree 里干活，碰不到另一个 worktree 里的文件。

把它想成给每个 agent 在同一间办公室里配一张自己的桌子，而不是三个人抢一个键盘。

核心工作流

在你的仓库内部，为每个任务在各自的分支上创建一个 worktree：

# Create a new branch + folder for an auth bug fix
git worktree add ../myapp-auth-fix -b fix/auth-bug

# Another for a feature, in parallel
git worktree add ../myapp-search -b feat/search

# See everything you have checked out
git worktree list

现在你的主仓库旁边有了两个同级文件夹：myapp-auth-fix 和 myapp-search。在每个里面打开一个独立的 agent 会话——cd ../myapp-auth-fix 并在那里启动 Claude Code，然后在另一个终端标签页里对 ../myapp-search 做同样的事。每个 agent 都有一份完整、独立的检出。它们同时运行、各自提交到自己的分支，永不冲突。

当一个任务完成后，合并它的分支并移除 worktree，让一切保持整洁：

git checkout main
git merge fix/auth-bug
git worktree remove ../myapp-auth-fix

一个具体例子

假设你在做一个小型 web 应用，手头有三件相互独立的活：修一个不稳定的登录重定向、给一个列表加分页、升级一个慢的依赖。与其一件一件做：

git worktree add ../app-login   -b fix/login-redirect
git worktree add ../app-paging  -b feat/pagination
git worktree add ../app-deps    -b chore/upgrade-deps

在每个文件夹里用一个聚焦的提示启动一个 agent。当登录 agent 在追查重定向逻辑时，分页 agent 已经在写组件了，而依赖 agent 正在跑升级和测试套件。二十分钟后，你审查三个各自独立、干净的分支，把通过的合并掉。

让它保持井然有序的小贴士

• 保持任务相互独立。 worktree 防止文件冲突，但如果两个 agent 在不同分支上编辑同一批文件，你最后仍会遇到合并冲突。沿着天然的接缝去拆分工作。
• 给每个 worktree 同样的上下文。 一个提交到你仓库里的 CLAUDE.md（或等价的规则文件）会自动随每个 worktree 一起带过去，于是每个 agent 都继承你的约定。
• 留意依赖文件夹。 node_modules、虚拟环境和构建缓存在 worktree 之间不共享。你可能需要在每个 worktree 里跑一次 npm install，或者用一个带全局存储的包管理器（pnpm、uv）来避免重复下载所有东西。
• 别过度并行。 实践中，三到五个并发 agent 是甜蜜点。再多，你花在审查和协调上的时间就会超过你换来的速度。

自 2025 年末以来，原生 worktree 集成已陆续登陆各大工具，如今也有专门的启动器替你拉起会话。但你不需要其中任何一个就能上手——git worktree add 内置于 Git，今天就能用，而且它是让多个 AI agent 同时为你构建、又不会互相绊倒的最可靠的单一办法。