Claude 与 Skill
多个 Claude Code 并行跑任务?光靠 worktree 隔离不够,一个 Agent 能删光另一个的提交
很多人以为给每个 Claude Code Agent 开一个 git worktree 就能安全并行,但所有 worktree 共享同一个 .git 目录,沙箱又允许写入它,一个 Agent 三条命令就能永久删掉另一个未推送的提交。作者实测验证了风险,并给出给每个 Agent 独立仓库、借用对象库、沙箱外推送的完整方案。
今天就能做
- 并行跑多个 Claude Code Agent 前,检查它们是否共享同一个 .git,是的话尽快改成独立仓库加 alternates 的布局
- 在沙箱配置里按字面路径拒绝各 Agent 的 config、hooks、commondir 和整个 clone 目录
- 把 git push 移到沙箱外执行,并在沙箱里禁掉代码托管平台域名
worktree 的隔离是假象
- git worktree 只隔离工作文件,分支和提交对象都存在主仓库的同一个 .git 里
- Claude Code 沙箱为了让 git commit 能用,允许 Agent 写入共享的 .git 目录
- 在 agent-1 的沙箱里,git update-ref -d 删掉 agent-2 的分支、reflog expire 加 gc --prune=now 清掉其提交,三条命令全部成功
- 不需要恶意才会出事:被要求清理旧分支或释放磁盘的 Agent 就可能跑这些命令
沙箱已经挡住了什么
- 实测 Claude Code 2.1.280(macOS):写 .git/hooks 会被拒绝,防止 Agent 埋 hook 在你自己的 shell 里执行
- 改写 worktree 的 commondir 文件也会失败
- 但 refs 和 objects 因为 commit 必须写它们,所以是敞开的;git update-ref 移动 main 分支也能成功
解法:每个 Agent 一个独立仓库
- 用 git init --separate-git-dir 给每个 Agent 建独立 git 数据目录
- 通过 objects/info/alternates 借用主 clone 的对象,不复制历史,省磁盘
- 沙箱配置里只允许写自己的 git-data,按字面路径拒绝 config、hooks、commondir 和指向它的 .git 文件,整个 clone 目录也拒绝写入
- 作者逐项验证:这些危险写入在沙箱内全部失败
推送放在沙箱外做
- Agent 自己的仓库没有理由直连代码托管平台,把托管域名加进 deniedDomains
- 由沙箱外的进程从 clone 推送,用 GIT_ALTERNATE_OBJECT_DIRECTORIES 借用 Agent 的对象
- 推送固定用 --no-verify 且从不 force push,远端分支有变动时会被托管平台拒绝
这套方案的代价
- 每个 Agent 占一个 checkout 的磁盘空间(历史是借的,文件不是)
- 主 clone 的 git gc --prune 可能清掉 Agent 还在借用的对象,需关掉自动 gc
- 仓库自己的 hooks 不会在 Agent 会话里运行,检查要靠 Agent 自己跑或交给 CI
- 未推送的目录要等 PR 合并或拒绝后才能删
Tillerly 的工程化落地
- 每个工单一个独立仓库,放在任何 .git 之外的目录,借用 clone 的对象
- Runner 在 Agent 写不到的目录里先建好再移入位置,避免创建过程被碰
- Agent 只能通过 open_worktree、sync_worktree、push_branch、remove_worktree 四个工具访问
- 推送由 Runner 完成,永不 force,PR 仍由团队人工开和合并
原文:Parallel Claude Code agents need more than a worktree
来源:DEV Community · 2026-11-18
查看原文本文由 AI 阅读原文后整理,未经人工逐字核对,内容以原文为准。
登录后可以点赞、查看和发表评论