1. 多分支并行开发时Claude Code 会话为什么会互相打架如果你同时推进两个需求一个在feature-a上写接口另一个在bugfix-123上修线上问题最省事的做法通常是来回git stash、git checkout。但只要 Claude Code 介入这套流程很快就会失控你在 A 分支让 Claude 改了一个文件切到 B 分支时它读到的还是同一份工作目录上下文、未提交改动、临时文件全混在一起最后连自己都分不清哪次修改属于哪个任务。Git 工作树worktree解决的正是这个问题。它允许同一个仓库同时检出多个分支到不同目录每个目录有独立的工作区文件状态但共享同一份 Git 历史和远程配置。换句话说你可以在../project-feature-a里跑一个 Claude Code 会话在../project-bugfix里跑另一个两边互不干扰谁也不会覆盖谁的未提交改动。这篇内容面向的是已经在用 Claude Code、并且需要并行处理多任务的开发者。核心交付三样东西一套可复制的 Git 工作树操作流程、一份通过 TaoToken 统一 Key 接入的settings.json与config.toml骨架、以及会话隔离和配置生效的验证动作。TaoToken 在这里的角色是统一 API 通道让你多个工作树里的 Claude Code 会话共用同一个 Key 和接入地址不用每个目录单独配一遍。2. 前置准备TaoToken 统一 Key 与工作树环境在动手建工作树之前先把两件事准备好Git 版本和 TaoToken 的接入凭证。Git 工作树功能从 2.5 版本开始支持先确认一下git --version # 期望输出类似 git version 2.40.0如果低于 2.5升级 Git 即可。接着开启工作树独立配置这一步很关键因为后面每个工作树要能读取自己的配置git config extensions.worktreeConfig true然后是 TaoToken 侧的准备。访问官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 了解接入方式然后到控制台创建 API Key控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Key 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite创建好 Key 之后先记下来后面配置里要用。API 基础地址统一用https://taotoken.net/api注意这个地址不带 UTM 参数是纯接口地址。提示TaoToken 是统一的 API 接入通道多个工作树里的 Claude Code 会话共用同一个 Key 即可不需要为每个目录单独申请。这样做的直接好处是配额和调用记录集中在一处排查问题时不用在多个 Key 之间来回切换。环境准备好后进入下一步建工作树。3. 可复制配置工作树创建 settings.json config.toml3.1 创建隔离的工作树目录假设主仓库在~/projects/myapp当前在main分支。为两个并行任务各建一个工作树cd ~/projects/myapp # 用新分支创建 feature-a 工作树 git worktree add ../myapp-feature-a -b feature-a # 用已有分支创建 bugfix 工作树 git worktree add ../myapp-bugfix bugfix-123 # 查看所有工作树 git worktree list输出会类似/home/you/projects/myapp abc1234 [main] /home/you/projects/myapp-feature-a def5678 [feature-a] /home/you/projects/myapp-bugfix aaa1111 [bugfix-123]每个目录都是独立的文件工作区改动互不影响。接下来在每个工作树里初始化开发环境比如 Node 项目cd ../myapp-feature-a npm install3.2 Claude Code 的 settings.json 骨架Claude Code 的配置分两层全局配置和项目级配置。项目级配置放在工作树目录下的.claude/settings.json这样每个工作树可以有自己的行为设置但 API 接入统一走 TaoToken。在myapp-feature-a/.claude/settings.json写入{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的_TaoToken_API_Key, ANTHROPIC_MODEL: claude-sonnet-4-20250514 }, permissions: { allow: [ Read, Edit, Bash(git status), Bash(git diff:*) ], deny: [ Bash(rm -rf:*), Bash(git push:*) ] } }几个要点说明ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址这是所有会话共用的通道。ANTHROPIC_AUTH_TOKEN填你在控制台创建的 Key。permissions里我特意把git push放进 deny因为并行会话里最怕的就是某个 Claude 实例自作主张推代码隔离环境里先禁掉更稳妥。同样的文件复制到myapp-bugfix/.claude/settings.json内容可以完全一致因为 Key 和通道是统一的。如果你希望两个工作树用不同的模型只改ANTHROPIC_MODEL即可。3.3 config.toml 骨架如果你用的是支持config.toml的客户端形态比如某些 CLI 封装或本地代理层配置骨架如下[api] base_url https://taotoken.net/api api_key 你的_TaoToken_API_Key model claude-sonnet-4-20250514 timeout_seconds 120 [session] # 每个工作树独立会话避免上下文串台 isolate true workdir . [permissions] allow [Read, Edit, Bash(git status), Bash(git diff:*)] deny [Bash(rm -rf:*), Bash(git push:*)]isolate true是并行场景的关键它保证每个工作树目录下的会话上下文独立。workdir .表示以当前工作树根目录为工作区这样 Claude 读写的文件天然被限制在本工作树内。注意config.toml和settings.json不要同时配同一项否则可能出现优先级冲突。选一种你实际使用的形态即可本文两种都给出来是为了覆盖不同客户端。4. 验证请求确认会话隔离与配置生效配置写完不代表生效必须验证。分三步走。4.1 验证工作树隔离在两个工作树里各制造一个改动确认互不影响# 在 feature-a 工作树 cd ~/projects/myapp-feature-a echo feature a change README.md git status # 切到 bugfix 工作树 cd ~/projects/myapp-bugfix git status预期结果myapp-bugfix的git status里看不到README.md的改动。如果看到了说明你其实还在同一个工作目录里检查pwd确认路径。4.2 验证 TaoToken 配置生效在每个工作树里启动 Claude Code然后发一个最小请求确认通道打通cd ~/projects/myapp-feature-a claude进入会话后输入一句简单指令比如让它读取当前目录的package.json并总结依赖。如果配置正确Claude 会正常返回内容如果 Key 或地址有问题会直接报鉴权或连接错误。你也可以用 curl 单独验证 API 通道不依赖 Claude Codecurl -s https://taotoken.net/api/v1/messages \ -H x-api-key: 你的_TaoToken_API_Key \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-20250514, max_tokens: 64, messages: [{role: user, content: ping}] }返回里带content字段就说明通道正常。这一步能快速区分是「Key 问题」还是「Claude Code 配置问题」。4.3 验证并行会话不串台同时开两个终端分别进入两个工作树启动 Claude Code# 终端 1 cd ~/projects/myapp-feature-a claude # 终端 2 cd ~/projects/myapp-bugfix claude在终端 1 里让 Claude 修改feature-a相关的文件在终端 2 里让它修改bugfix相关文件。完成后各自git diff确认改动只出现在对应工作树里。这一步通过说明会话隔离和配置生效都到位了。如果你更想先在网页端验证模型通道是否正常可以直接用模型对话入口试一句https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite5. 本篇常见错排查5.1 工作树创建报「already exists」fatal: ../myapp-feature-a already exists原因通常是目录已存在但没被 Git 识别为工作树。先确认git worktree list如果列表里没有这个路径说明是残留目录删掉再建或者用-f强制git worktree add -f ../myapp-feature-a feature-a5.2 手动删目录后git worktree list显示 prunable直接rm -rf删工作树目录Git 元数据还在。清理git worktree prune5.3 配置改了但 Claude Code 没生效最常见的原因是配置文件放错位置。项目级配置必须在工作树根目录下的.claude/settings.json不是主仓库的。确认cat ~/projects/myapp-feature-a/.claude/settings.json另外检查环境变量有没有被 shell 里的旧值覆盖echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_AUTH_TOKEN如果 shell 里设了旧值会优先于配置文件。清掉再试unset ANTHROPIC_BASE_URL unset ANTHROPIC_AUTH_TOKEN5.4 报鉴权失败 401先确认 Key 没写错、没多空格。然后用 4.2 的 curl 单独测通道。如果 curl 也 401去控制台确认 Key 状态是否正常https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite5.5 两个会话仍然互相影响检查是不是两个终端其实指向了同一个目录。用pwd确认。另外确认config.toml里isolate true已设置或者settings.json里没有把工作目录指向主仓库。5.6 工作树路径迁移后失效手动移动过工作树目录Git 找不到链接关系。修复git worktree repair /new/path/to/worktree想避免这个问题可以开启相对路径git config worktree.useRelativePaths true6. 长期并行编码把统一 Key 和 Coding Plan 用起来工作树 统一 Key 这套组合短期看是解决多分支并行时的会话隔离长期看是让多个 Claude Code 会话共享同一条 API 通道和配额。如果你经常同时跑三四个任务建议把接入方式固定下来避免每次新建工作树都重新配一遍。对于需要长期跑编码任务、或者把 Claude Code 接入 Agent 工作流的场景可以了解 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite接入细节和参数说明统一看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite如果你用的是 Claude Code 的 Anthropic 兼容接入形态这个入口有专门说明https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite我自己的习惯是主仓库只用来做合并和发布所有实际开发都在工作树里进行每个工作树配一份.claude/settings.jsonKey 和地址统一指向 TaoToken。这样即使同时开四个会话也不会出现「改了 A 分支结果 B 分支跟着变」的情况。工作树用完及时git worktree remove保持目录干净比攒一堆残留目录再prune省心得多。