企业官网建设流程全解析

1. 为什么你的 Claude Code 只发挥了 30%：从单会话到多步任务工作流

很多人第一次用 Claude Code，体验路径几乎一样：装好 CLI，敲一句需求，看它吐代码，复制粘贴，结束。用了一周之后会产生一种错觉——这东西好像也就比补全强一点。问题不在模型，而在工作流。你把它当成一个"更聪明的输入框"，它就只能回你一个"更聪明的回答"。

真正拉开差距的是三件事：任务有没有先规划、上下文有没有沉淀、重复动作有没有被封装。Claude Code 团队内部把这三点拆成了 Plan Mode、CLAUDE.md、Skills、Subagents 四个抓手，再配合并行会话、终端优化、数据查询等技巧，形成一套可复制的工作流。这篇就把这 10 个技巧按"能直接抄"的方式写出来，并且全程用统一 Key 通道接入，避免你在多个账号、多个 Base URL 之间来回切换。

先说清楚这套东西适合谁。如果你每天要写 3 个以上功能点、经常在多个分支之间跳、被 CI 失败和线上 Bug 打断节奏，那这套工作流收益最大。如果你只是偶尔写个脚本，那挑 Plan Mode 和 CLAUDE.md 两条就够了，别硬上 Subagents。

我试过最笨的用法：一个终端、一个会话、从早用到晚。结果是每次等生成的时候干瞪眼，上下文越堆越乱，改到后面 Claude 已经忘了前面约定。后来把会话拆开、把规则写进文件、把重复动作做成 Skill，同样的任务量，返工次数明显下降。下面按顺序拆。

核心检索词先给到：Claude Code 是一套跑在终端里的编码 Agent，能读写文件、执行命令、跑测试；Plan Mode 是它的"先规划后动手"模式；CLAUDE.md 是项目级规则文件；Skills 是可复用的指令封装；Subagents 是并行子任务执行单元。这四个词贯穿全文，你记住它们的分工，剩下的都是配置细节。

2. 用 TaoToken 统一 Key 接入 Claude Code：Base URL 与 auth.json 配置

在讲技巧之前，先把接入这步做干净。Claude Code 默认走官方通道，但很多开发者手上同时有多个模型来源，切换一次就要改一次环境变量，非常烦。统一 Key 通道的价值就在这：一个 Key、一个 Base URL，覆盖对话、编码、Agent 多步任务。

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 参数，配置时直接写这个。

接入 Claude Code 有两种常见方式，一种是环境变量，一种是写进配置文件。环境变量适合临时验证，配置文件适合长期使用。

先看环境变量方式。在 shell 配置文件里加：

export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_API_KEY="你的TaoToken Key"

保存后source ~/.zshrc或source ~/.bashrc，然后新开终端。这里的关键是 Base URL 必须指向 TaoToken 的 API 入口，Key 用你在控制台生成的。

再看配置文件方式。Claude Code 会读取~/.claude/settings.json，你可以把通道信息写进去：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "你的TaoToken Key" } }

如果你用的是 Codex 风格的auth.json，结构类似，把 base_url 和 api_key 对应字段填上即可。三件套永远是：Base URL、Key、Model ID。缺一个都跑不通。

Model ID 这块要注意，不同通道支持的模型名不一样。你在 TaoToken 控制台的模型列表里能看到可用 ID，填的时候原样复制，别自己猜。常见错误就是模型名写错，报错信息里会出现model not found或者reading choices相关提示。

配置完成后，用一条最小请求验证：

curl https://taotoken.net/api/v1/messages \ -H "x-api-key: 你的TaoToken Key" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "你的Model ID", "max_tokens": 64, "messages": [{"role": "user", "content": "ping"}] }'

返回里有content字段就说明通道通了。这一步别跳过，很多人后面报错排查半天，结果发现是 Key 没生效。

如果你需要更细的接入说明，可以看接入文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_campaign=rewrite 。Key 在控制台生成：https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_campaign=rewrite 。

接入干净之后，下面 10 个技巧才有意义。否则你每换一个技巧就要重新配一次通道，效率全耗在配置上。

3. 可复制配置：CLAUDE.md 模板、Plan Mode 提示词、Skills 与 Subagents 片段

这一节是全文最"能抄"的部分。我把 CLAUDE.md 模板、Plan Mode 分步提示词、Skills 配置、Subagents 调用片段都写成可直接复制的形式。你按项目实际情况改路径和规则名就行。

先给 CLAUDE.md 模板。放在项目根目录，Claude Code 启动时会自动读取：

# 项目规范 ## 代码风格 - TypeScript 使用项目内 .eslintrc.js，不要自创规则 - 变量和函数用 camelCase，React 组件用 PascalCase - 复杂逻辑必须写注释，注释用中文 ## 常见错误记录 ### Hook 命名 - 错误：useUserDataFetcher - 正确：useUserDataFetcher 改为 use-user-data-fetcher - 记录时间：2026-01-15 ### API 错误处理 - 错误：直接 fetch 不包 try-catch - 正确：所有网络调用必须包错误处理并上报 - 记录时间：2026-01-20 ## 项目约定 - 新功能先写测试再写实现 - 提交前必须跑 lint 和 test - 重大改动先在 Plan Mode 讨论 ## 详细文档索引 - 认证模块：./notes/auth.md - API 设计：./notes/api-design.md - 调试经验：./notes/debugging.md

这个模板的关键是"常见错误记录"这一段。每次 Claude 犯错，你让它自己把规则追加进去。Boris 说过 Claude 很擅长给自己写规则，实测确实如此。你纠正一次，它记一次，下次同类错误明显减少。

接着是 Plan Mode 分步提示词。复杂任务不要一上来就让它写代码，先规划：

进入 Plan Mode，帮我规划一个用户认证功能。 需求： 1. JWT 认证 2. 支持刷新令牌 3. 登出时清除服务端会话 4. 所有接口加错误处理 先列出实现步骤，不要写代码。

等它列出计划后，你追问细节：

计划基本可以，但有几个问题： 1. Token 存在哪里，localStorage 还是 httpOnly cookie 2. 刷新令牌过期时间怎么定 3. 登出时服务端要清哪些数据

讨论清楚后再让它动手：

计划确认，现在开始实现，按步骤来，每步完成后告诉我。

这套流程下来，基本一次成型，返工很少。

然后是 Skills 配置。Skills 放在.claude/skills/目录下，每个 Skill 一个 md 文件。比如一键提交：

# 提交代码并创建 PR 请执行： 1. 查看当前 git diff 2. 生成符合 Conventional Commits 的 commit message 3. 提交并推送 4. 创建 Pull Request，标题用 commit message

使用时输入/commit-pr即可。再比如代码审查 Skill：

# 代码审查 请审查当前改动： 1. 检查是否符合 CLAUDE.md 里的代码风格 2. 查找潜在空指针和边界问题 3. 检查是否有未处理的 Promise rejection 4. 给出优化建议，按优先级排序

Subagents 的调用更简单，在请求后面加一句：

use subagents

Claude 会把任务拆给多个子 Agent 并行处理。你也可以显式分派：

用 4 个 Subagents 并行处理： - Subagent 1: 生成封面图 - Subagent 2: 生成流程图 - Subagent 3: 生成示例图 - Subagent 4: 生成总结图 prompt 文件在 prompts/ 目录

这里提醒一句，Subagents 适合独立子任务，别把有强依赖的步骤拆开，否则子 Agent 之间对不上。

配置片段给完了，下面讲怎么验证它们真的生效。

4. 逐条验证：从 Plan Mode 到 Subagents 的成功结果对照

配置写完不代表生效，得逐条验证。这一节给你每个技巧的验证动作和预期结果，照着做一遍，心里就有底了。

Plan Mode 验证。输入"进入 Plan Mode，帮我规划一个登录功能"，预期结果是 Claude 不写代码，而是输出编号步骤列表。如果它直接开始写代码，说明 Plan Mode 没进去，检查你的提示词里有没有明确的"进入 Plan Mode"和"不要写代码"。

CLAUDE.md 验证。在项目里故意让 Claude 写一个违反规则的命名，比如让它写useUserDataFetcher。如果它写出来后被纠正一次，然后你让它更新 CLAUDE.md，再新开会话问同样的问题，它应该主动用 kebab-case。这一步验证的是规则有没有被读取。

Skills 验证。输入/commit-pr，预期是它执行 git diff、生成 commit message、提交、推送、建 PR。如果提示 skill not found，检查文件是不是放在.claude/skills/下，文件名和调用名是否一致。

Subagents 验证。给一个可并行的任务，比如"用 3 个 Subagents 分别检查 auth、api、utils 三个目录的重复代码"。预期是它分派子任务并汇总结果。如果它串行执行，说明 Subagents 没触发，检查提示词里有没有明确写use subagents。

通道验证。前面 curl 那条命令返回content字段，说明 Base URL 和 Key 都对。如果返回 401，看下面排障章节。

并行会话验证。开两个终端，分别 cd 到不同 worktree，各跑一个 Claude Code 会话。预期是两个会话互不干扰，各自维护上下文。如果发现上下文串了，检查是不是在同一个目录下启动的。

验证顺序建议：先通道，再 CLAUDE.md，再 Plan Mode，最后 Skills 和 Subagents。因为后面几个都依赖通道正常。

验证通过后，你会明显感觉到差别：以前是"问一句答一句"，现在是"给个目标，它自己拆步骤、自己查规则、自己并行"。这就是从 30% 到 80% 的差距。

5. 常见报错排查：401、local proxy failed、reading choices、OAuth 怎么处理

这一节按真实报错来。你大概率会碰到下面几个，我按出现频率排。

401 Unauthorized。最常见。原因通常是 Key 没生效、Key 写错、或者环境变量没 source。排查顺序：先echo $ANTHROPIC_API_KEY看有没有值，再看echo $ANTHROPIC_BASE_URL是不是https://taotoken.net/api。如果环境变量对但还报 401，检查 settings.json 里的 env 有没有覆盖掉 shell 变量。还有一种情况是 Key 复制时带了空格，重新复制一遍。

local proxy failed。这个报错通常出现在你本地配了转发但转发进程没起来。如果你没配本地转发，那检查 Base URL 是不是被别的工具改过。有些工具会往环境里塞自己的代理地址，导致请求发不出去。解决方式是显式在 settings.json 里写死 Base URL，优先级最高。

reading choices 相关报错。这个一般出现在响应解析阶段，常见原因是 Model ID 写错，或者通道返回的格式和客户端预期不一致。先确认 Model ID 是从控制台复制的，再确认 Base URL 指向的是 API 入口而不是网页入口。网页入口是https://taotoken.net/，API 入口是https://taotoken.net/api，两者不能混。

OAuth 报错。如果你用的是需要 OAuth 的客户端，报错里会出现 token 过期或 scope 不足。处理方式是重新走一遍授权，或者改用 API Key 方式接入。API Key 方式更稳定，适合长期跑 Agent 任务。

模型名不匹配。报错类似model not found。解决方式是去控制台模型列表里核对，别用记忆里的名字。不同通道模型命名规则不同，复制粘贴最稳。

配置改了不生效。Claude Code 有些配置是启动时读取的，改完要新开会话。如果你改了 settings.json 但当前会话没反应，退出重进。

排查通用思路：先确认通道（curl 能通），再确认配置（环境变量和文件一致），最后确认模型名。这三步过了，90% 的报错都能定位。

如果排查完还是不通，去看接入文档里的示例：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_campaign=rewrite 。Key 管理在控制台：https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_campaign=rewrite 。

6. 把 10 个技巧串成日常：从并行会话到数据查询的落地顺序

技巧看完了，关键是落地顺序。别一次全上，会乱。我建议按这个顺序来。

第一周，只做两件事：配好统一 Key 通道，写好 CLAUDE.md。这两件是地基。通道不通，后面全白搭；CLAUDE.md 不写，Claude 每次都从零开始理解你的项目。

第二周，加 Plan Mode。所有超过 30 分钟的任务，先规划再动手。你会发现返工次数下降得最明显。

第三周，加并行会话。用 worktree 或者多目录，开 2 到 3 个会话。一个写功能，一个写测试，一个修 Bug。等生成的时间被利用起来了。

第四周，开始攒 Skills。把你每天重复两次以上的操作写成 Skill。提交、审查、清理技术债，这三个先做。

再往后，试 Subagents。适合独立子任务，比如并行生成素材、并行检查多个目录。别用在强依赖的步骤上。

数据查询这块，如果你有数据库，可以封一个 Skill，让 Claude 用自然语言生成 SQL 并执行。团队里有人这么做之后，写 SQL 的频率大幅下降。但注意，别把生产库直连进去，用只读账号或者开发库。

终端优化是随时可以做的。换个支持同步渲染的终端，配好状态栏，给每个 tab 命名。语音输入值得试，说话比打字快，而且你会不自觉地说得更详细，prompt 质量反而更高。

最后说一句心态。这 10 个技巧不是让你全用，而是让你知道有哪些选项。有人只用 Plan Mode 和 CLAUDE.md 就够，有人重度依赖 Subagents。找到适合你项目节奏的组合，比照搬全套更重要。

需要开始的话，先去控制台拿 Key：https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_campaign=rewrite ，然后按第 2 节的配置写进 settings.json。通道通了，再回来挑技巧。想先感受模型对话效果，可以从模型对话入口试：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_campaign=rewrite 。长期跑编码和 Agent 任务的话，Coding Plan 更合适：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_campaign=rewrite 。