过去,让多个AI Agent(比如Claude)同时在一个项目里干活,堪称一场噩梦。
开发者得自己写Bash脚本管理并发,手动创建、清理Gitworktree,时刻担心两个Agent同时编辑同一文件,引发冲突、状态污染和合并灾难。不少团队甚至专门开发内部工具,只为避免AI互相“踩脚”。结果,光是配置并行环境就要耗费半小时,业务代码还没写一行,精力先被耗尽。
更讽刺的是,AI使用率高的团队,PR Review时间反而增加了91%。协调多个Agent产出的成本,早已抵消了生成速度带来的收益。
如今,Claude Code的--worktree(简写-w)参数,直接终结了这种混乱。
每个Agent都拥有专属分支、独立目录,就像进入各自的“平行宇宙”。无需协调,告别stash-checkout-重启的循环。
这不仅是功能的升级,更是开发范式的彻底转变:开发者不再只是写代码的人,而是调度多个Agent、评估并整合最优输出的指挥官。
Cursor已支持8个Agent并行,Codex也有后台Agent,整个AI编程生态都在指向同一个方向:单线程开发已成过去式,能降低多Agent协作摩擦的工具,才是未来的赢家。
而Claude Code的--worktree,正是开启这场变革的关键开关。
典型并行场景,效率直接拉满
- 功能开发+紧急修复并行:一个Claude专注推进新功能,另一个同步修复线上紧急Bug,互不干扰。
- Writer/Reviewer模式:一个Claude负责写代码,另一个在独立环境里做静态分析、安全检查和Code Review。
- 批量迁移任务:多个Claude并行处理不同模块的代码迁移,比如Python2转3、React类组件转Hooks。
- A/B方案对比:让两个Claude用不同架构实现同一功能,最后对比性能、可读性和测试覆盖率,择优而选。
CLI操作:灵活掌控并行开发
基础用法,一键启动
创建名为“feature-auth”的worktree并启动Claude:
claude --worktree feature-auth
再开一个会话处理其他任务:
claude --worktree bugfix-123
不想手动命名,直接输入:
claude --worktree
Claude会自动生成随机名称,比如“bright-running-fox”。
注意,使用前项目必须是Git仓库,没有.git目录的话,先运行git init。
存储位置与配置
Worktree默认存放在.claude/worktrees/<name>/,对应Git分支是worktree-<name>。
比如运行claude --worktree feature-auth,会自动创建.claude/worktrees/feature-auth/目录和worktree-feature-auth分支,且以远程默认分支为起点。
建议在.gitignore中添加.claude/worktrees/,避免worktree内容被主仓库误追踪。
会话中动态创建
无需提前规划,在Claude对话里直接说“work in a worktree”或“start a new isolated session”,Claude会自动创建并切换到新worktree。
退出时的智能清理
退出worktree会话时,Claude会智能判断:
- 若没有任何改动,自动删除worktree目录和分支,不留痕迹;
- 若有修改或提交,会询问你是保留还是清理,保留可方便后续继续,清理则彻底移除所有内容。
手动精细控制(进阶操作)
你也可以用原生Git命令做更精细的管理:
基于新分支创建worktree,放在仓库外:
git worktree add ../project-feature-a -b feature-a
基于已有分支创建:
git worktree add ../project-bugfix bugfix-123
进入worktree后启动Claude:
cd ../project-feature-a && claude
查看所有worktree并清理:
git worktree list
git worktree remove ../project-feature-a
要注意,每个新worktree都是干净环境,可能需要重新安装依赖,比如Node项目跑npm install,Python项目激活虚拟环境。
Desktop桌面版:零配置无感并行
Claude Code Desktop把Worktree做到了极致,无需任何命令,点点鼠标就能实现并行。
自动隔离,开箱即用
点击侧边栏的“+ New Session”,每个新会话自动获得独立worktree。左边写功能,右边修Bug,完全隔离,零配置上手。
自定义设置,按需调整
- 修改存储位置:在Settings→Claude Code中,可自定义worktree的存放路径。
- 设置分支前缀:比如设置前缀为claude/,所有Claude创建的worktree分支都会以claude/开头,方便在Git中识别和管理。
一键清理,轻松便捷
用完一个会话,把鼠标悬停在侧边栏的会话上,点击归档图标,就能自动移除对应的worktree和分支。
需注意,Desktop的会话隔离依赖Git,macOS一般自带,Windows用户需先安装Git for Windows。
结语:并行是标配,决策才是核心
--worktree不只是一个简单的CLI参数,它重构了AI协同开发的工作流。
从此,多Agent并行不再是负担,而是默认状态。开发者终于能把精力放在决策和整合上,不用再纠结如何防止AI搞乱代码。
单线程开发的时代已经落幕,多Agent协作的“平行宇宙”正式开启。