
如何清理 Claude Code、Cursor 和 Codex 遗留的 worktree
来源标题:How to clean up the worktrees Claude Code, Cursor and Codex leave behind
Claude Code、Cursor 和 Codex 等编码代理会在 git worktree 中运行,每个 worktree 都是完整检出并带有独立的 node_modules 和构建产物,长期积累可达数十 GB。各工具只会按数量或时间清理自己创建的 worktree,自动清理并不彻底,甚至曾误删用户需要的文件。可以先用 git worktree list 列出仓库内的 worktree,再用 du -sh 查看各目录占用空间。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
作者:Suman Maharjan · 发布于 2026 年 11 月 10 日
编程智能体在 git worktree 中工作,这样多个智能体可以同时运行。每个 worktree 都是一份完整的检出,带有自己的 node_modules 和构建产物,而每个工具只会按数量或按时间清理自己创建的 worktree。它们会悄无声息地累积起来,常常达到几十 GB。
一个 worktree 在装好依赖之后,成本相当于一次全新的 clone。以下是一些实测示例:
来源:Anthropic 关于 worktree 和桌面应用的文档、Cursor 的 worktree 设置,以及 OpenAI 的 Codex worktree 页面。细节会因版本而异。有 bug 报告称旧版 Claude Code 使用 ~/.claude-worktrees,所以也去那里看看。
自动清理并不能覆盖所有情况,而且它们还删除过人们想要保留的工作:一个被 git 忽略的图片文件夹(issue 98186),以及没人推送过的 submodule 改动(issue 107997)。Cursor 的文档并未承诺会保留有未提交改动的 worktree,所以在归档某个智能体之前,请先提交或 stash。
在某个仓库内部,列出它的 worktree,无论智能体把它们放在哪里:
git worktree list
要查看它们有多大,而不改动任何东西:
du -sh .claude/worktrees/* 2>/dev/null | sort -h du -sh ~/.cursor/worktrees// 2>/dev/null | sort -h du -sh ~/.codex/worktrees/* 2>/dev/null | sort -h
在你使用 Claude Code 的每个仓库内运行第一行。另外两行会一次性覆盖所有仓库。
在这些命令中,<path> 是 worktree 的文件夹,<branch> 是它的分支。如果你的仓库主分支不叫 main,请使用你的仓库的主分支名。
没有未提交的内容。当 worktree 干净时,这条命令不输出任何内容:
git -C <path> status --short
被忽略的文件里没有你需要的东西。删除 worktree 也会在未经询问的情况下删除 git 忽略的文件,例如 .env、node_modules 和构建产物。请先列出它们,并复制你想保留的任何内容:
git -C <path> status --short --ignored
分支已合并。当分支上的每个提交都已经在 main 中时,这条命令不输出任何内容:
git log --oneline main..<branch>
GitHub 上的 squash merge 会让该分支的提交不出现在 main 中,因此上面的命令仍会把它们列出来。改用 gh 命令询问 GitHub:
gh pr list --head <branch> --state merged --json number,headRefOid git rev-parse <branch>
如果某个已合并 pull request 的 headRefOid 与第二行匹配,说明该分支上的所有内容都进入了那个 pull request。
对于 Codex 的 worktree(它们不在分支上),请检查是否存在只存在于那里的提交。当每个提交也都在某个分支或远程上时,这条命令不输出任何内容:
git -C <path> log --oneline HEAD --not --branches --remotes
删除它
先关闭使用该 worktree 的智能体会话。然后,在仓库中执行:
git worktree remove <path>
如果 worktree 有未提交的改动或未跟踪的文件,git 会拒绝执行,这正是你想要的。分支会保留下来,所以已提交的内容不会丢失。一旦你不再需要该分支,用 git branch -d <branch> 删除它;如果分支未合并,该命令会拒绝执行。在 squash merge 之后,git 仍会认为它未合并;一旦 gh 确认了合并,git branch -D <branch> 就会删除它。
某些版本的 Codex 应用保存崩溃报告的速度太快,以至于一位用户的文件夹在一天内增长了 4.9 GB 和 54,504 个文件(Codex issue 25921)。OpenAI 表示修复已合并。要检查,请运行:
du -sh ~/Library/Application\ Support/Codex/Crashpad/pending
~/Library/Application\ Support/com.openai.codex/web/Crashpad/pending 2>/dev/null
如果它很大,请退出 Codex,用 Finder 的「前往 › 前往文件夹」打开该文件夹,并把 pending 里的文件移到废纸篓。报告该 bug 的人就是这样释放空间的。
让 Mopup 找到它们
Mopup 的 Projects 部分会向 git 询问你代码文件夹中各仓库的每个 worktree(无论智能体把它放在哪里),并对照你的 main 分支以及通过你的 gh 命令对照 GitHub 逐一检查,因此 squash merge 也会被计入。它只删除已完成工作的 worktree:已合并、没有未提交的内容、里面除了生成的文件别无他物。删除时运行 git worktree remove,绝不使用 --force,保留分支,并先列出 .env 等被忽略的文件。它还能找到智能体遗留仍在运行的开发服务器。
扫描免费,前 2 GB 的清理免费。需要 macOS 15 或更高版本。
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。