企业官网建设流程全解析

1. 多分支并行开发时，Claude Code 为什么总在互相打断

如果你同时维护一个修 Bug 的分支和一个加功能的分支，大概率遇到过这种场面：Claude Code 在修fix/分支的语法错误，你切到feat/分支想让它写个脚本，结果它读到的还是上一个分支的文件状态，改着改着两边改动混在一起，git status一片红。这不是模型笨，是工作目录只有一个，Claude Code 默认在当前目录里读写文件，你切分支它就跟着切，上下文全乱。

Claude Code 官方教程里创始人 Boris Cherny 分享的十大技巧，第一条就是 Git Worktree 并行任务处理。核心思路很朴素：Git Worktree 允许同一个仓库挂出多个独立工作目录，每个目录绑定不同分支，各自有独立的工作区和暂存区。你在 A 目录让 Claude 修 Bug，在 B 目录让它写新功能，两边文件互不干扰，提交历史也各走各的。等任务都完成，回主工作树合并即可。

这套用法适合谁？适合手头同时压着两三个独立任务、又不想频繁 stash 和切分支的开发者。尤其适合让 Claude Code 长时间跑一个重构任务、同时你还要处理紧急修复的场景。下面我把官方教程里的 Worktree 流程拆成可复制的步骤，再补上 TaoToken 统一 Key 接入的settings.json骨架，让多个 Worktree 里的 Claude Code 共用一套模型配置，不用每个目录重复填 Key。

2. TaoToken 前置：一个 Key 喂饱所有 Worktree

Worktree 一多，最烦的是配置重复。每个工作目录启动 Claude Code 都要读环境变量或配置文件，如果每个目录都手填一遍 API Key 和 Base URL，改一次要改 N 处。TaoToken 的作用在这里就体现出来了：它提供统一的 API 入口，你只需要在全局或项目级配置里写一次，所有 Worktree 里的 Claude Code 都走同一个 Key。

TaoToken 官网是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 入口是 https://taotoken.net/api 。注意 API 地址不带 UTM 参数，配置里填干净的这个就行。你需要先去控制台拿一个 Key，地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，Key 管理页在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。拿到 Key 后先别急着往每个 Worktree 里塞，我们用一份settings.json骨架统一管理。

这里要区分两个概念：Claude Code 自身的配置文件和项目里的.claude/settings.json。前者管模型接入，后者管项目级权限和钩子。Worktree 场景下，我建议把模型接入配置放在用户级配置里，这样所有 Worktree 自动继承；项目级.claude/settings.json只放跟项目相关的权限白名单。下面第三节给出完整骨架。

3. 可复制配置：settings.json 骨架与 Worktree 初始化

先建仓库和 Worktree。用官方教程里的 hello-world 仓库演示，你也可以换成自己的项目。

git clone https://github.com/leachim6/hello-world.git hello-world-parallel-demo cd hello-world-parallel-demo git branch -a

确认在主分支后，创建两个 Worktree，分别对应修 Bug 和加功能。官方建议放在.claude/worktrees/下，这只是组织习惯，放哪都行。

git worktree add .claude/worktrees/bugfix -b fix/hello-world-examples git worktree add .claude/worktrees/feature -b feat/enhanced-index git worktree list

git worktree list应该输出三条记录，主工作树加两个子工作树，各自绑定不同分支。到这里 Git 层面的隔离就完成了，接下来配 Claude Code。

用户级配置文件位置因系统而异，Linux/macOS 通常在~/.claude/settings.json，Windows 在%USERPROFILE%\.claude\settings.json。骨架如下：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-你的TaoToken密钥" }, "permissions": { "allow": [ "Bash(git status)", "Bash(git diff:*)", "Bash(git add:*)", "Bash(git commit:*)", "Read", "Edit", "Write" ], "deny": [ "Bash(git push:*)", "Bash(rm -rf:*)" ] } }

几个关键点。ANTHROPIC_BASE_URL填https://taotoken.net/api，不要带任何查询参数。ANTHROPIC_API_KEY填你在控制台生成的 Key。permissions.allow里放常用只读和提交命令，deny里挡掉推送和危险删除，避免 Claude 在并行任务里误操作。这份配置放在用户级目录，三个 Worktree 启动 Claude Code 时都会读到，不用每个目录复制。

如果你想让某个 Worktree 有额外权限，比如 feature 目录允许跑python，可以在该 Worktree 根目录建.claude/settings.json做项目级覆盖：

{ "permissions": { "allow": [ "Bash(python:*)", "Bash(python3:*)" ] } }

项目级配置会和用户级合并，allow 取并集。这样 bugfix 目录保持最小权限，feature 目录多出跑脚本的权限，互不影响。

4. 验证请求：三个终端并行跑起来

配置写完要验证。开三个终端标签，分别进三个目录。

终端 1 进主工作树，用于协调和最终合并：

cd hello-world-parallel-demo claude

终端 2 进 bugfix 工作树：

cd hello-world-parallel-demo/.claude/worktrees/bugfix claude

终端 3 进 feature 工作树：

cd hello-world-parallel-demo/.claude/worktrees/feature claude

每个终端启动后，先让 Claude 确认当前分支，验证它读到的上下文是否正确。在终端 2 里输入：

请执行 git branch --show-current，告诉我当前在哪个分支

预期输出fix/hello-world-examples。终端 3 同样操作，预期输出feat/enhanced-index。这一步能确认 Worktree 隔离生效，Claude 没有串目录。

接着在终端 2 让 Claude 修一个示例文件的语法问题：

请检查 p/ 目录下的 Python 示例，找出过时语法并修复，然后 git add 并 commit

在终端 3 同时让它写索引脚本：

请创建一个 generate_index.py，遍历所有语言目录，读取 HelloWorld 文件，生成 INDEX.md，包含语言名、文件路径和代码前几行

两个终端同时跑，你会看到它们各自读写自己目录的文件，git status只显示本分支改动。这就是并行任务处理的核心价值：bugfix 在改 Python 示例时，feature 在写新脚本，两边文件系统、暂存区、提交历史完全隔离。

验证 TaoToken 接入是否生效，可以在任意终端里让 Claude 回一句话，比如「用一句话说明当前模型接入的 Base URL 是什么」。如果它能正常响应，说明 Key 和 Base URL 配置正确。更直接的验证是看请求是否成功返回，没有 401 或连接错误。

两个任务都提交后，回终端 1 合并：

git merge fix/hello-world-examples git merge feat/enhanced-index git worktree remove .claude/worktrees/bugfix git worktree remove .claude/worktrees/feature git branch -d fix/hello-world-examples git branch -d feat/enhanced-index git worktree list

最后git worktree list只剩主工作树，git branch只剩 main，清理完成。

5. 本篇常见错排查

报错一：fatal: 'xxx' is already checked out at ...

原因是你想在一个 Worktree 里切到已经被另一个 Worktree 占用的分支。Git 不允许同一分支被两个工作树同时检出。解决方法是给新任务建新分支，用git worktree add <path> -b <new-branch>，不要试图复用已有分支。

报错二：Claude Code 启动后报 401 或invalid api key

先检查settings.json里ANTHROPIC_API_KEY有没有多余空格或换行。再确认ANTHROPIC_BASE_URL填的是https://taotoken.net/api，没有拼错或带多余路径。如果 Key 刚生成，去控制台确认状态是启用。改完配置要重启 Claude Code 进程，环境变量不会热加载。

报错三：Worktree 里 Claude 读到的文件是旧版本

Worktree 创建时会基于当前 HEAD 检出文件，如果你在主工作树有未提交改动，子 Worktree 不会带上。先在主工作树 commit 或 stash，再创建 Worktree。另外确认你cd进了正确的 Worktree 目录，pwd看一下路径里有没有.claude/worktrees/xxx。

报错四：合并时冲突，Claude 改的文件和主分支冲突

并行任务难免碰到同一文件。合并前先在主工作树git pull拉最新，再逐个 merge。冲突时可以让 Claude 在对应 Worktree 里先 rebase 主分支，解决完再合。注意git worktree remove前必须确保分支已合并，否则会丢改动，Git 会拦你，别强删。

报错五：settings.json改了但权限没生效

项目级.claude/settings.json只对当前项目目录生效，Worktree 是独立目录，如果项目级配置放在主工作树根目录，子 Worktree 读不到。要么把权限配置放用户级，要么在每个 Worktree 根目录各放一份。用户级配置是所有目录共享的，适合放模型接入这种全局配置。

6. 把并行任务跑顺之后，配置该放哪

Worktree 这套用法跑通后，你会发现真正的效率瓶颈不在 Git，而在配置管理。我的做法是：模型接入和通用权限放用户级settings.json，一次配好所有 Worktree 继承；项目特有的权限白名单放各 Worktree 的.claude/settings.json，按任务需要开。TaoToken 的 Key 只在用户级配一次，新增 Worktree 不用再动。

如果你主要在做长期编码和 Agent 任务，可以了解下 Coding Plan，地址是 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，适合需要稳定跑多轮任务的场景。想先验证模型对话效果，去 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=chat&utm_campaign=rewrite 。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，配置字段有疑问可以对照查。Key 管理和新建都在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。

最后提醒一个实操细节：Worktree 目录名别用中文或空格，Claude Code 和 Git 命令处理路径时容易出问题。.claude/worktrees/这个路径本身没问题，但子目录名用bugfix、feature这种纯英文短名最稳。清理 Worktree 时先git worktree remove再git branch -d，顺序反了分支删不掉。