什么是 Worktree？

Worktree（工作树）是 Git 的一个功能，允许你在同一个仓库下创建多个独立的工作目录，每个目录有自己的分支和文件。Claude Code 利用这个机制实现多任务并行隔离执行。

基本用法

指定名称创建 worktree：

claude --worktree feature-auth

• 在 .claude/worktrees/feature-auth/ 下创建独立工作目录
• 自动创建分支 worktree-feature-auth
• 在其中启动一个独立的 Claude Code 会话

自动生成名称：

claude --worktree

自动生成随机名称如 bright-running-fox。

在会话中请求创建：

work in a worktree

并行工作示例

# 终端1：做功能开发
claude --worktree feature-auth

# 终端2：同时修 bug
claude --worktree bugfix-123

两个会话完全隔离，互不干扰。

自动清理

复制 gitignore 文件

在项目根目录创建 .worktreeinclude 文件，自动复制环境配置到新 worktree：

.env
.env.local
config/secrets.json

子代理隔离

在 Agent 工具中也可以使用 worktree 隔离：

isolation: worktree

子代理在独立 worktree 中执行，完成后自动清理。

注意事项

• 建议在 .gitignore 中添加 .claude/worktrees/
• 每个 worktree 需要独立安装依赖（如 npm install）
• 也可以手动用 Git 创建再进入：

  git worktree add ../my-feature -b my-feature
  cd ../my-feature && claude

感谢您的阅读、关注、点赞。