我对比了两种用 Claude Code 做多任务开发的方式：一种把所有 Agent 塞同一个目录，另一种每个 Agent 分配独立的工作目录。结论很直接——Git worktrees 做隔离，才是团队协作的正解。而且 Claude Code 自带的 -w 标志已经集成了 worktree 创建，一行命令就能启动一个隔离任务。说起来，下面给你一遍实操流程——怎么配置、怎么使用、踩了哪些坑。

为什么 worktrees 突然被盯上了

Git worktrees 不是新东西——Git 在 2014 年就引入了。但过去没人当回事，开发者习惯一个仓库一个工作目录。切分支就 git switch。怎么说呢，AI Agent 来后问题才暴露出来。

当你给一个 Claude Code Agent 下任务：「重构这个模块的使用者服务」，就在这个时候另一个 Agent 在同一个目录里跑「给该模块写单元测试」。两个 Agent 同时往同一个文件写东西。或者一个切换分支把另一个的工作目录搞乱，这就是最常见的冲突场景。下面列出典型痛点：

• File collisions双写同一文件导致覆盖或冲突。
• Branch confusion一个 Agent 切分支，另一个中途工作被打断。其实，
• Context contaminationAgent 读到了未提交的改动。逻辑出错，
• Lock conflicts工具链文件锁互相阻塞。 话说回来，

worktrees 的思路很简单：每个 Agent 一个独立工作目录。共享同一 .git 对象存储，却在物理层面互不干扰。

从捷径来看，Claude Code 自带的 -w

Claude Code 从某个版本开始内置了 -w 标志。只需一行命令，它自动帮你完成所有 worktree 创建：

claude -w -p "重构使用者服务模块。用 IUserRepository 接口替换旧的 UserRepository 类"

Claude Code 接到任务后自动执行以下步骤：

1. 为任务创建独立分支。
2. 将该分支检出到独立 worktree 目录。
3. 完成后保留 worktree，以便后续 review 再合回主分支。

You can run multiple terminals for different tasks:

# Terminal 1
claude -w -p "重构认证模块为 JWT"
# Terminal 2
claude -w -p "添加 API 限流中间件"
# Terminal 3
claude -w -p "修复登录页面闪退"

每个 claude 进程都有自己的分支、工作目录和上下文。文件不会互相覆盖，测试不会互相干扰，一个任务切分支也不会影响另一个。

完成后如何 review 与合并？

git diff main..feature/jwt-refactor # 审查变更
git checkout main && git merge feature/jwt-refactor # 合回主分支
git worktree remove ../project-jwt-refactor # 清理 worktree

This is intentional – AI writes code but human still reviews before merging.

手动配置这方面，精细控制时使用方法

If you don’t like auto-generated branch names or want more control。you can manually create and manage worktrees.

# Create branches and add corresponding worktrees
git branch feature/refactor-user main
git worktree add ../my-service-refactor feature/refactor-user
git branch feature/tests main
git worktree add ../my-service-tests feature/tests
git worktree list

You now have three independent directories each on its own branch sharing same Git object store. Be careful: you cannot checkout same branch in two different worktrees simultaneously.

Claude Code 并行工作实例 – 两个 Agent 同场景演练

重构 agent：

cd ~/projects/my-service-refactor
claude -p "重构 user-service.ts：用 IUserRepository 接口替换 UserRepository 类"

单元测试 agent：

cd ~/projects/my-service-tests
claude -p "为 IUserRepository 编写完整单元测试，覆盖正常和异常方法"

The two processes run independently in ir own trees. In practice,y ran for several minutes without interference;each committed changes only to its own branch.

并行合并实操步骤

An agent finishes its task,n fetch from local repo and merge:

cd ~/projects/my-service
# Fetch from local trees
git fetch . refactor-user:tasks/refactor-user
# Merge into main without fast-forward
git merge tasks/refactor-user --no-ff
# Similarly for tests
git fetch . tests:tasks/tests
git merge tasks/tests --no-ff

至于工具推荐。Worktrunk CLI 与 Mule AI

Worktrunk CLI

• Create a new agent tree: worktrunk create agent1
• Select an existing tree: worktrunk switch agent2
• Lsit all trees: worktrunk list

This tool stores trees under .worktrees/​…​‑agentX/​，,avoiding clutter. It’s handy when scaling beyond dozens of agents.