.worktreeinclude,Claude Code 并行 worktree 里的本地配置搬运工

📅 2026/7/21 23:36:38
.worktreeinclude,Claude Code 并行 worktree 里的本地配置搬运工
我今天梳理 Claude Code 的worktree机制时,最容易被忽略的不是claude --worktree feature-auth这条命令,而是项目根目录里那个很小的.worktreeinclude文件。它看起来像一个边角配置,实际却经常决定一个并行开发会话能不能正常启动。尤其在前端仓库、Node.js 服务、SAP Commerce Cloud storefront、本地代理服务、OAuth 回调调试这些项目里,代码本身能被 Git 带进新目录,但.env、.env.local、config/secrets.json这类本地文件经常因为被.gitignore忽略而消失。Claude Code 开了一个新的worktree,代码有了,依赖脚本也在,偏偏本地环境变量没了,任务就会卡在启动阶段。Anthropic 官方文档对worktree的定义很直接,git worktree是一个独立工作目录,有自己的文件和分支,但共享主仓库的历史与远程信息。Claude Code 把每个并行会话放进独立worktree后,一个会话修改登录页,另一个会话修复 bug,文件编辑就不会互相踩踏。官方也说明,CLI 的--worktree或-w会在仓库根目录下创建类似.claude/worktrees/value/的目录,并基于新分支启动 Clau