学习精选 · AI 工具
Claude 与 Skill

多个 Claude Code 并行跑任务?光靠 worktree 隔离不够,一个 Agent 能删光另一个的提交

DEV Community2026-11-18约 4 分钟读完AI 整理查看原文

很多人以为给每个 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 阅读原文后整理,未经人工逐字核对,内容以原文为准。

登录后可以点赞、查看和发表评论