我今天梳理 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
