1. 传统分支切换的痛：stash 来 stash 去，任务只能串行
手上功能写了一半，线上突然出了紧急 Bug，老办法还是git stash→git checkout→ 修 → 切回来 →git stash pop。切回来那一刻，刚才的思路已经碎了一半。等你想让 Claude Code 在另一个分支里并行修 Bug 时，又发现 Key 和模型通道得单独配一遍。这篇文章就用 Git Worktree 把多任务拆成独立工作现场，再用 TaoToken 把多个 Claude Code 会话的认证统一起来。
先看看没有 Worktree 时的日常。你正在feature/user-auth分支上写登录功能，线上突然报了一个登录崩溃的 Bug，于是开始熟悉的流程：
# 保存当前进度 git add . git stash -m "WIP: user auth 开发到一半" # 切到主分支修 Bug git checkout main git checkout -b hotfix/login-crash # 修完，测试，提交 git commit -m "fix: login crash" # 回到原来的开发分支 git checkout feature/user-auth git stash pop这套流程最伤人的不是敲命令，而是第四步。等你stash pop之后，看着满屏半成品代码，要花十分钟才想起来刚才想到哪个方案、那个 TODO 注释是想干什么、这个函数的参数为什么要那么传。上下文切换成本高、开发环境要重新装依赖、A 任务没做完就不能切去 B 任务，所有事情天然串行。
更麻烦的是，当你想让 Claude Code 参与进来时，问题会放大一个量级：你给 Claude Code 讲了一遍任务背景，它刚进入状态，你又让它切去处理另一个需求，它的上下文里残留着上一个任务的信息，文件改了一半又没法安全切换分支。这种情况下，「让人工智能并行」反而变成了一种负担。
2. Git Worktree 是什么：一个仓库，多份独立工作现场
Git Worktree 的解决方案很直接：同一个 Git 仓库，同时 checkout 多个分支到不同的目录。每个目录都是一个完整的工作现场，有自己的文件、自己的依赖目录、自己的运行环境，互不干扰。
一个 Git 仓库 → 多个工作目录 ~/project/main <- 主工作区（feature/user-auth 分支，你自己写代码） ~/project/project-hotfix <- 热修复区（hotfix/login-crash 分支，Claude Code 在修 Bug） ~/project/project-experiment <- 实验区（experiment/new-algo 分支，Claude Code 在跑实验）关键点在于它们共享同一个.git目录。Git 对象、提交历史、引用全部共用，不会因为开了几个 worktree 就把磁盘重复占满；但每个 worktree 的工作区文件是独立的，npm install、构建产物、本地配置各自隔离。
同时有一条硬性规则：同一个分支不能同时出现在两个 worktree 中。也就是说，你不能在主目录 checkoutfeature/user-auth，又在另一个 worktree 里 checkout 同一个分支，Git 会直接拒绝，这是后面避坑部分会提到的经典报错。
3. 为什么 Worktree 是 Claude Code 并行任务的最佳拍档
Claude Code 这类 CLI 编程助手，在一次会话中会做大量文件读写、搜索和上下文分析。如果让它中途切换任务，问题非常明显：
- 上下文污染：A 任务和 B 任务的代码信息混在同一段对话里，Claude Code 说着说着就把文件路径搞混了。
- 文件冲突：AI 改了 A 任务的文件还没提交，这时候切分支，要么被 Git 拒绝，要么被迫 stash。
- 解释成本高：每次切换任务都要重新交代一遍背景，等于把 AI 的进度条清零重来。
Worktree 的解法相当于给每个任务开一间独立工位：
终端窗口 1：~/project/main 分支：feature/user-auth 角色：你本人，开发登录功能，手动编码 + AI 辅助 终端窗口 2：~/project/project-hotfix 分支：hotfix/login-crash 角色：Claude Code 会话 A，修线上支付回调 Bug 终端窗口 3：~/project/project-experiment 分支：experiment/recommend-ab 角色：Claude Code 会话 B，搭建推荐算法 A/B 测试框架三个任务同时推进，Claude Code 在任何目录下直接claude启动，不会互相踩到文件。需要切换时，cd到对应目录就行，几乎零成本。
但新问题随之而来：多个 Claude Code 会话各自都要过认证，Key 和模型通道来回切，很容易串台。这也是我后来把整个流程换成 TaoToken 统一接入的原因，后面配置章节会细说。
4. Worktree 基础操作：add / list / remove 一条龙
先过一遍基础命令，后面实战就用得上。
# 创建 worktree：基于现有分支 git worktree add ../project-hotfix hotfix/login-crash # 创建 worktree：同时新建分支 git worktree add -b feature/product-detail ../project-detail main # 基于指定 commit 创建（detached HEAD 也可以） git worktree add ../project-experiment a1b2c3d路径命名建议用「项目名-用途」的格式，放在项目目录的同级，一眼能看出哪个 worktree 在做什么。
查看和管理：
# 列出所有 worktree git worktree list # 删除 worktree git worktree remove ../project-hotfix # 如果 worktree 里有未提交修改，Git 会拒绝删除，加上 --force 强制删 git worktree remove --force ../project-hotfix # 手动删目录后清一次元数据 git worktree prune在 worktree 里工作跟普通仓库没有区别，git status、git add、git commit都能用。唯一要记住的是：每个 worktree 需要独立安装依赖，npm install各跑一遍。
5. 实战：三个 Worktree 并行跑，Claude Code 各干各的
5.1 场景设定
假设你在做一个电商项目，手头同时压着三个任务：
| 任务 | 优先级 | 预计工作量 |
|---|---|---|
| 商品详情页重构 | 中 | 2 天 |
| 支付回调验签 Bug | 紧急 | 2 小时 |
| 推荐算法 A/B 测试 | 低 | 1 天 |
以前只能先修紧急 Bug，再做详情页，A/B 测试基本排不上。现在用 Worktree 拆分，你主攻详情页，Claude Code 的会话 A 修 Bug，会话 B 搭 A/B 测试框架。
5.2 搭建并行工作环境
cd ~/projects/ecommerce # 确保主工作区干净 git status # 创建三个 worktree，都基于 main git worktree add -b feature/product-detail ../ecommerce-detail main git worktree add -b hotfix/payment-callback ../ecommerce-hotfix main git worktree add -b experiment/recommend-ab ../ecommerce-abtest main5.3 启动 Claude Code 前，先把认证统一到 TaoToken
这一步是对应原本启动claude之前的认证环节。以前你要么去官方后台生成 Token，要么在多个环境变量之间来回切换，几个会话跑起来之后谁用的是哪个 Key 都分不清。现在统一走 TaoToken：打开 TaoToken 注册并创建一个 API Key，然后在 Claude Code 的配置文件里把 Base URL 指过去。
我推荐直接在~/.claude/settings.json里写全局配置，这样所有 worktree 里的 Claude Code 都自动生效，不用每个目录配一遍：
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_MODEL": "从模型广场复制的模型ID" } }注意几个容易踩的点：
ANTHROPIC_BASE_URL填https://taotoken.net/api，末尾不要加/v1。很多工具默认会在后面补/v1，你手动再加就会变成/api/v1，请求直接 404。YOUR_API_KEY是占位符，实际值从 TaoToken 控制台创建，不要把官网链接地址当成 Key 填进去。ANTHROPIC_MODEL填什么，以 TaoToken 的模型广场为准，里面写的模型 ID 是什么就复制什么。
如果你不想写全局配置，也可以在终端里用环境变量，效果一样：
export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY" export ANTHROPIC_MODEL="从模型广场复制的模型ID"5.4 分配任务并启动会话
配置写好后，每个 worktree 里直接claude启动，不需要再关心认证问题。
# 终端 2：ecommerce-hotfix，让 Claude Code 修支付 Bug cd ~/projects/ecommerce-hotfix claude # 会话中输入： # "帮我定位并修复支付回调验签失败的 Bug，相关日志在 logs/payment.log"Claude Code 会在隔离的 worktree 里完成搜索、分析、修改、测试和提交，全程不碰你主工作区的文件。
# 终端 3：ecommerce-abtest，让 Claude Code 搭 A/B 测试框架 cd ~/projects/ecommerce-abtest claude # 会话中输入： # "基于 feature flag 模式，帮我搭建推荐算法的 A/B 测试框架"两个 Claude Code 会话共用同一把 TaoToken Key，互不影响。你回到终端 1 继续写详情页代码，三个任务真正并行。
5.5 合并结果
任务完成后回到主仓库统一合并：
cd ~/projects/ecommerce git checkout main git pull origin main git merge hotfix/payment-callback git merge feature/product-detail git merge experiment/recommend-ab # 解决冲突、测试、推送 git push origin main5.6 清理现场
# 任务全部完成，删除 worktree git worktree remove ../ecommerce-hotfix git worktree remove ../ecommerce-abtest git worktree remove ../ecommerce-detail6. 进阶技巧：环境变量隔离、多端口运行、脚本一键建现场
6.1 环境变量隔离
每个 worktree 需要不同配置时，用.env.local并加入.gitignore：
# ecommerce-detail/.env.local DB_HOST=localhost DB_NAME=ecommerce_dev PORT=3001 # ecommerce-hotfix/.env.local DB_HOST=localhost DB_NAME=ecommerce_test PORT=3002这样一来，Claude Code 在 hotfix worktree 里改代码时读的是测试库配置，不会污染你的开发库。
6.2 同时运行多个实例
如果项目是 Web 服务，不同 worktree 可以跑在不同端口：
# 终端 1 cd ~/projects/ecommerce && PORT=3000 npm run dev # 终端 2 cd ~/projects/ecommerce-hotfix && PORT=4000 npm run dev # 终端 3 cd ~/projects/ecommerce-abtest && PORT=5000 npm run dev三个浏览器标签页分别预览三个分支的效果，互不干扰。
6.3 依赖安装策略
每个 worktree 默认都要npm install一次，磁盘和时间上确实有点代价。如果不想每个都装，推荐用 pnpm，它会通过硬链接共享依赖存储，同时每个 worktree 里仍然有独立的 node_modules 视图。手动软链接 node_modules 不推荐，版本容易不一致，AI 在某个 worktree 里装了额外依赖，另一个 worktree 感知不到。
6.4 脚本一键创建 worktree
频繁开 worktree 的话，可以写个脚本顺手装依赖：
#!/bin/bash PROJECT_DIR=$(pwd) TASK_NAME=$1 BRANCH_PREFIX=$2 BASE_BRANCH=${3:-main} worktree_dir="../$(basename "$PROJECT_DIR")-$TASK_NAME" branch_name="$BRANCH_PREFIX/$TASK_NAME" git worktree add -b "$branch_name" "$worktree_dir" "$BASE_BRANCH" cd "$worktree_dir" && npm install echo "worktree 就绪：$worktree_dir" echo "进入并启动 Claude Code：cd $worktree_dir && claude"6.5 Claude Code 专属技巧
Claude Code 支持从任意目录启动，配合 Worktree 很顺：
# 在 worktree 里启动全新会话 cd ~/projects/ecommerce-hotfix && claude # 继续之前的会话 cd ~/projects/ecommerce-hotfix && claude --resume # 直接给一个明确指令，让它后台跑完整个流程 cd ~/projects/ecommerce-hotfix && claude -p "定位并修复支付回调验签失败的 Bug，完成后 commit 并说明修改内容"-p模式特别适合不需要交互的独立任务，Claude Code 会自己分析、修改、测试、提交，做完就退出，也不占用你的终端。
7. 常见问题和避坑：Worktree 报错对照 + TaoToken 认证排障
7.1 不能在两个 worktree 里 checkout 同一个分支
fatal: 'feature/login' is already checked out at '/Users/me/project'这是 Worktree 最常见的报错。解法很简单：每个 worktree 用独立分支，需要共享代码时走 merge 而不是共享分支。
7.2 不要 rebase 另一个 worktree 正在使用的分支
如果你在主目录对某个分支执行 rebase，而另一个 worktree 正 checkout 着这个分支，那个 worktree 的文件状态可能变得不可用。操作前先用git worktree list确认没有 worktree 正在操作目标分支。
7.3 不要跨 worktree 直接改文件
比如在~/projects/ecommerce里去编辑../ecommerce-hotfix/src/payment.js，虽然技术上能改，但文件监听、构建缓存都可能出错。每个 worktree 的改动在自己的目录内完成，这是并行开发的底线。
7.4 TaoToken 认证相关的典型报错
如果配置完之后 claude 启动请求失败，按下面顺序排查：
第一，请求 404。检查ANTHROPIC_BASE_URL是不是写成了https://taotoken.net/api/v1。TaoToken 的接口地址是https://taotoken.net/api，末尾不要带/v1，工具会自动补全。
第二，请求 401。检查ANTHROPIC_AUTH_TOKEN是不是把官网链接地址当成 Key 填了，或者 Key 复制的时候多复制了一个空格。Key 从 TaoToken 控制台创建，复制完整字符串。
第三，模型不存在。检查ANTHROPIC_MODEL填的 ID 是否在模型广场里存在。不同渠道的模型命名可能不一样，不要凭记忆写，去模型广场复制最稳。
7.5 验证 TaoToken 是否生效
随便挑一个 worktree，进入后启动 claude，让它做一次轻量请求，比如让它读一下当前目录的package.json并总结项目结构。如果它正常响应，说明认证已经通了。之后回到官网控制台，能看到刚才这次请求的用量记录，账对上就说明整条链路没问题。
8. 收尾：Worktree + Claude Code 并行开发的新范式
用了这个工作流之后，我的习惯已经完全变了：每个新任务进同一个仓库都会先开一个 worktree，再让 Claude Code 在里面跑，不再有「等一个任务做完再开下一个」的焦虑。你可以把 worktree 理解成给每个任务安排一间独立操作间，Claude Code 在哪个操作间开工，取决于你cd到哪个目录。而 TaoToken 在这套流程里扮演的是「一把钥匙开多个门」的角色——多个 worktree 里的 Claude Code 共用同一把 Key 做统一接入，不用在官方后台和工具配置之间反复折腾。
如果你也想让手头的并行任务真正跑起来，建议先去 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 注册、创建一把 API Key，按第 5.3 节的配置写完，再创建一个 worktree 试一次最简单的请求。跑通之后，你就能体会到「三个任务同时推进、上下文互不串台」的开发节奏了。
