1. 多分支并行开发为什么总在切分支上翻车如果你同时维护三四个功能分支大概率经历过这种场面刚在feature/login改完两个文件测试同学催你修hotfix/pay的线上问题你git stash一半发现 stash 列表已经堆了七条切过去编译又发现依赖装错目录。等回到原分支Claude Code 的会话上下文已经断了只能重新描述一遍需求。问题不在你手速慢而在于「一个工作目录只能停在一个分支」这个默认设定和「多个任务同时推进」的真实节奏天然冲突。Claude Code 的 Hooks 和 worktree 组合恰好是冲着这个痛点来的。Hooks 是事件驱动的确定性逻辑能在会话启动、工具调用前、权限请求、任务停止这些节点自动执行你写好的脚本worktree 让同一个仓库同时挂载多个工作目录每个目录锁在不同分支上互不干扰。把两者串起来你就能做到开五个 worktree每个里面跑一个 Claude Code 会话各自负责一个任务SessionStart 钩子自动注入项目上下文Stop 钩子自动戳它继续推进PermissionRequest 钩子把敏感操作推到你手机上等批准。这套流水线跑顺之后切分支这个动作基本从日常里消失了。这篇面向的是已经在用 Claude Code、但还停留在「单会话单分支」阶段的个人开发者和团队。我会给出可直接复制的settings.jsonHooks 配置片段、worktree 初始化脚本以及通过 TaoToken 统一 Key 接入的 Base URL 配置示例最后附一条从触发到验证的完整操作清单。你不需要先成为 Git 高手照着改路径和分支名就能跑起来。先说清楚一个前提Hooks 和 worktree 都是 Claude Code 本身的能力TaoToken 在这里的角色是统一 API 通道——你不需要为每个 worktree 单独配一套 Key一个 Key 走同一个 Base URL所有并行会话共用。这样多开的时候不会因为 Key 管理混乱导致某个会话 401。2. TaoToken 统一 Key 接入一个 Base URL 管住所有并行会话多 worktree 并行最容易被忽略的坑是凭证管理。你开五个终端每个终端里 Claude Code 都要读一次配置。如果每个会话用不同的 Key或者环境变量在不同 shell 里没对齐就会出现「三个会话正常、两个报 401」这种让人抓狂的情况。TaoToken 的做法是提供一个统一的 API 通道你只需要在配置里写一次 Base URL 和 Key所有 worktree 里的会话都指向同一个入口。先拿 Key。打开 TaoToken 控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite在 API Keys 页面创建一个新 Key。建议按用途命名比如claude-code-worktree方便后面在多个项目里复用时一眼认出。创建完复制出来注意它只完整显示一次。接下来是配置。Claude Code 读取配置的优先级大致是项目级.claude/settings.json 用户级~/.claude/settings.json 环境变量。多 worktree 场景我建议用用户级配置打底项目级做覆盖。用户级配置里写死 Base URL 和 Key 的引用项目级只写跟这个仓库相关的 Hooks 和权限。用户级~/.claude/settings.json的关键片段长这样{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥 } }注意 Base URL 写的是https://taotoken.net/api不要带任何查询参数。Key 直接填在env里是最省事的做法但如果你会把配置文件提交到仓库就别这么干——改用环境变量引用在 shell 的~/.zshrc或~/.bashrc里 exportexport ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的TaoToken密钥然后settings.json里就不用写env段了Claude Code 会自动读环境变量。这样五个 worktree 开五个终端每个终端继承同一套环境变量Key 天然统一。模型 ID 这块Claude Code 默认会用它自己的模型映射。如果你想显式指定可以在项目级配置里加{ model: claude-sonnet-4-20250514 }具体可用的模型 ID 以 TaoToken 文档为准https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite。多 worktree 并行时我习惯给不同任务配不同模型重构类任务用能力强的跑测试和格式化这类确定性任务用轻量快的成本能压下来不少。这里有个容易踩的坑如果你之前配过别的通道~/.claude/settings.json里可能残留旧的ANTHROPIC_BASE_URL。多 worktree 启动时某个会话读到了旧配置就会出现「有的会话通、有的会话不通」。排查方法是在任意一个 worktree 里跑claude进入交互模式输入/config看当前生效的 Base URL 是不是https://taotoken.net/api。不是的话检查环境变量和两级 settings 文件的覆盖顺序。Key 统一之后worktree 的初始化脚本就可以放心地批量创建会话不用担心凭证问题。下一节进入具体的 Hooks 配置和 worktree 脚本。3. 可复制配置settings.json Hooks 片段与 worktree 初始化脚本这一节是整篇的核心所有片段都可以直接复制改路径使用。先讲 Hooks 配置再讲 worktree 脚本最后把两者串起来。3.1 settings.json 里的 Hooks 配置Claude Code 的 Hooks 定义在settings.json的hooks字段下按事件类型分组。每个事件下是一个数组数组里每个元素包含matcher匹配条件和hooks要执行的命令列表。我常用的四个事件是SessionStart、PreToolUse、PermissionRequest、Stop。项目级.claude/settings.json完整片段{ hooks: { SessionStart: [ { matcher: *, hooks: [ { type: command, command: bash .claude/hooks/session-start.sh } ] } ], PreToolUse: [ { matcher: Bash, hooks: [ { type: command, command: bash .claude/hooks/pre-bash.sh } ] } ], PermissionRequest: [ { matcher: *, hooks: [ { type: command, command: bash .claude/hooks/notify-permission.sh } ] } ], Stop: [ { matcher: *, hooks: [ { type: command, command: bash .claude/hooks/on-stop.sh } ] } ] } }SessionStart钩子用来在会话启动时注入当前 worktree 的分支名和任务描述让 Claude 一上来就知道自己在哪个分支、要干什么。.claude/hooks/session-start.sh内容#!/usr/bin/env bash BRANCH$(git rev-parse --abbrev-ref HEAD 2/dev/null || echo no-git) TASK_FILE.claude/task.md echo 当前 worktree 分支: $BRANCH if [ -f $TASK_FILE ]; then echo 任务描述: cat $TASK_FILE fi这个脚本的输出会作为上下文注入会话。你可以在每个 worktree 里放一份不同的.claude/task.md写明这个分支要做什么Claude 启动就能读到。PreToolUse匹配Bash用来拦截危险命令。.claude/hooks/pre-bash.sh读 stdin 的 JSON检查命令里有没有rm -rf /、git push --force这类操作有就返回非零退出码阻断#!/usr/bin/env bash INPUT$(cat) CMD$(echo $INPUT | jq -r .tool_input.command // empty) if echo $CMD | grep -qE rm -rf /|git push --force|DROP TABLE; then echo 拦截危险命令: $CMD 2 exit 2 fi exit 0退出码 2 表示阻断并把 stderr 反馈给 Claude它会换一种方式重试。PermissionRequest钩子把权限请求推送到手机。最简单的做法是调一个 webhook比如企业微信或飞书的机器人#!/usr/bin/env bash INPUT$(cat) TOOL$(echo $INPUT | jq -r .tool_name // unknown) curl -s -X POST https://你的webhook地址 \ -H Content-Type: application/json \ -d {\msgtype\:\text\,\text\:{\content\:\Claude 请求权限: $TOOL\}} exit 0Stop钩子最实用——Claude 停下来时自动戳它继续。.claude/hooks/on-stop.sh#!/usr/bin/env bash INPUT$(cat) STOP_REASON$(echo $INPUT | jq -r .stop_hook_active // false) if [ $STOP_REASON true ]; then exit 0 fi echo 继续推进当前任务如果已完成请输出 DONE exit 0注意stop_hook_active这个字段它是防止无限循环的开关。第一次 Stop 时它是 false你输出继续指令Claude 再次 Stop 时它变成 true你就退出避免死循环。3.2 worktree 初始化脚本手动git worktree add太慢写个脚本批量创建。放在项目根目录scripts/new-worktree.sh#!/usr/bin/env bash set -e BRANCH$1 WORKTREE_DIR../wt-$BRANCH if [ -z $BRANCH ]; then echo 用法: ./scripts/new-worktree.sh branch-name exit 1 fi git worktree add -b $BRANCH $WORKTREE_DIR 2/dev/null || \ git worktree add $WORKTREE_DIR $BRANCH mkdir -p $WORKTREE_DIR/.claude/hooks cp -r .claude/hooks/* $WORKTREE_DIR/.claude/hooks/ 2/dev/null || true cp .claude/settings.json $WORKTREE_DIR/.claude/settings.json 2/dev/null || true echo worktree 已创建: $WORKTREE_DIR (分支: $BRANCH) echo 进入目录后运行: claude用法./scripts/new-worktree.sh feature/payment它会在上级目录创建wt-feature/payment把 Hooks 脚本和 settings 复制过去然后你cd进去跑claude就行。开五个任务就执行五次每个 worktree 独立。如果你用 Claude Code 自带的claude -w命令它会自动创建 worktree 并启动会话但不会复制你的 Hooks 配置。所以要么用上面的脚本要么在claude -w之后手动补配置。我倾向脚本因为可控。3.3 把 Hooks 和 worktree 串成流水线完整流程先跑./scripts/new-worktree.sh feature/a进入../wt-feature/a写一份.claude/task.md描述这个分支的任务然后claude启动。SessionStart 钩子自动读 task.md 注入上下文PreToolUse 拦截危险命令Stop 钩子自动推进PermissionRequest 推手机。五个 worktree 并行每个都跑这套。这套配置的关键在于「确定性」——Hooks 是脚本行为可预测不会因为模型状态波动而变。worktree 是 Git 原生能力隔离性有保障。两者叠加你得到的是一个可重复、可审计的并行开发环境。4. 验证请求从触发到成功的完整操作清单配置写完不验证等于没写。这一节给一条从零到跑通的清单每一步都有预期结果对不上就按第五节排查。第一步确认 TaoToken 通道通。在任意终端跑curl -s https://taotoken.net/api/v1/messages \ -H x-api-key: sk-你的TaoToken密钥 \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d {model:claude-sonnet-4-20250514,max_tokens:64,messages:[{role:user,content:回复 OK}]}预期返回 JSON 里content数组第一项text包含OK。如果返回 401说明 Key 不对返回 404检查 Base URL 是不是写成了https://taotoken.net/api不要带/v1后缀Claude Code 会自己拼。第二步创建 worktree。在项目根目录跑./scripts/new-worktree.sh test/verify预期输出worktree 已创建: ../wt-test/verify。cd ../wt-test/verify跑git branch --show-current预期输出test/verify。第三步确认 Hooks 配置被复制。在 worktree 里跑ls .claude/hooks/预期看到session-start.sh、pre-bash.sh、notify-permission.sh、on-stop.sh四个文件。cat .claude/settings.json确认hooks字段存在。第四步启动会话验证 SessionStart。跑claude进入交互模式后输入/config确认 Base URL 是https://taotoken.net/api。然后随便问一句「当前分支是什么」Claude 应该能答出test/verify说明 SessionStart 钩子注入成功。第五步验证 PreToolUse 拦截。让 Claude 执行rm -rf /tmp/test-guard如果/tmp/test-guard不存在命令本身无害但你的钩子匹配的是rm -rf /这种模式所以不会触发。换个测试让 Claude 执行git push --force预期被拦截Claude 会收到「拦截危险命令」的反馈并换方式。第六步验证 Stop 钩子。给 Claude 一个多步任务比如「创建三个文件 a.txt、b.txt、c.txt每个写入一行内容」。观察它完成第一步后是否被 Stop 钩子推着继续直到三个文件都创建完。完成后ls确认。第七步验证 PermissionRequest。让 Claude 执行一个需要权限的操作比如写文件到项目外目录。预期你的手机收到 webhook 通知。如果没收到检查 webhook 地址和网络。第八步多 worktree 并行验证。再开两个 worktree分别跑claude同时给三个会话下不同任务。观察三个终端是否各自独立推进互不干扰。这一步跑通整套流水线就算成了。实测下来从第一步到第八步大概十五分钟。最容易卡住的是第一步的 curl 验证和第四步的 Base URL 确认这两个过了后面基本顺。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth多 worktree 并行时报错往往集中在凭证和配置覆盖上。这一节列四个高频错误每个都给现象、原因、修法。401 Unauthorized。现象某个 worktree 里的会话报 401其他 worktree 正常。原因通常是这个终端的环境变量没继承或者项目级settings.json里写了旧的 Key 覆盖了用户级配置。修法在这个 worktree 里跑echo $ANTHROPIC_API_KEY确认输出的是 TaoToken 的 Key再跑cat .claude/settings.json | jq .env如果这里有ANTHROPIC_API_KEY且值不对删掉这个字段让它回落到环境变量。三件套检查Base URL 是https://taotoken.net/apiKey 是sk-开头Model ID 是有效值。local proxy failed。现象会话启动时报连接失败提示本地代理错误。原因是你之前配过某个本地代理工具环境变量里残留了HTTP_PROXY或HTTPS_PROXYClaude Code 尝试走代理但代理没开。修法跑env | grep -i proxy如果有输出在~/.zshrc里 unset 掉unset HTTP_PROXY HTTPS_PROXY http_proxy https_proxy然后source ~/.zshrc重开会话。注意不要用任何网络代理工具TaoToken 的通道直连即可。reading choices 报错。现象会话返回内容解析失败日志里出现reading choices或类似字段。原因通常是 Base URL 配错了把 OpenAI 格式的端点填给了 Claude Code。Claude Code 走的是 Anthropic Messages 格式端点应该是https://taotoken.net/api不要填/v1/chat/completions这种。修法检查ANTHROPIC_BASE_URL确保没有多余路径。如果你在 Cline 或 Codex 里也配了 TaoToken注意它们的配置格式不同——Cline 用 MCP 配置Codex 用auth.json别把 Claude Code 的配置直接复制过去。OAuth 相关报错。现象提示 OAuth token 失效或无法刷新。原因是你之前登录过 Claude 官方账号本地缓存了 OAuth 凭证和 API Key 模式冲突。修法找到~/.claude/下的凭证缓存文件通常是credentials.json或类似名字备份后删除然后重新用 API Key 模式启动。Claude Code 检测到ANTHROPIC_API_KEY存在时会优先用 Key但残留的 OAuth 缓存有时会干扰。删掉缓存后重开即可。补充一个 worktree 特有的坑如果你在 worktree 里改了.claude/settings.json但主仓库的.claude/settings.json没同步下次新建 worktree 时复制过去的是旧配置。修法是把 Hooks 配置放在用户级~/.claude/settings.json里项目级只放跟仓库相关的部分。这样所有 worktree 天然共享同一套 Hooks。排查的核心思路是「先确认通道再确认配置覆盖顺序最后确认 worktree 隔离」。通道用 curl 验配置用/config看隔离用git branch --show-current确认。三步走完大部分问题都能定位。6. 把并行流水线跑成日常从单会话到多 worktree 的迁移路径如果你现在还是单会话单分支别一上来就开五个 worktree。迁移路径建议分三步走。第一步先把 TaoToken 的 Base URL 和 Key 配到用户级settings.json在单会话里跑通。确认/config显示正确curl 验证通过。这一步解决凭证统一问题。第二步加 Hooks。先只加SessionStart和Stop两个前者注入上下文后者自动推进。跑几天感受一下「Claude 不停下来」的节奏。这两个钩子风险最低不会拦截你的正常操作。第三步引入 worktree。先用./scripts/new-worktree.sh开两个一个跑主任务一个跑杂事。习惯之后再加到三到五个。PreToolUse和PermissionRequest钩子可以在这时候加上前者防手滑后者让你离开电脑也能批准操作。长期编码和 Agent 类任务可以考虑 TaoToken 的 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite多 worktree 并行时额度消耗比单会话高包月方案比按量更可控。如果你只是想先验证模型对话效果用模型对话页面https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite试几句也行。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteAPI Keys 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite。最后说一个我踩过的坑worktree 目录别放在项目内部否则 Git 会把它们当成未跟踪文件git status一片红。放在项目同级目录用../wt-分支名这种命名干净。还有每个 worktree 的.claude/task.md记得写这是 SessionStart 钩子注入上下文的来源不写的话 Claude 启动时不知道自己要干什么等于白开。整套跑顺之后你的日常会变成早上开三个 worktree各写一份 task.md三个终端跑claude然后去干别的事。手机收到权限请求就点一下Stop 钩子推着会话往前走。切分支这个动作基本从你的工作流里消失了。