企业官网建设流程全解析

1. 为什么你的 Claude Code 需要 Subagent 和 Skills

Claude Code 用久了会遇到一个瓶颈：所有任务都堆在同一个对话里，上下文越来越长，模型开始"忘事"，同一个项目里前端规范和后端规范互相打架，你每次都要重复交代"用 TypeScript、遵循 Airbnb 风格、提交信息按 Conventional Commits 写"。Subagent 和 Skills 就是解决这个问题的两把钥匙。

Subagent 可以理解成"给主 Agent 雇的专家"。主 Agent 是项目经理，Subagent 是前端工程师、后端工程师、文档写手，每个 Subagent 有独立的角色定位、工具白名单和领域知识，主 Agent 判断任务类型后把活派给对应的专家。Skills 则是"专家的标准操作手册"，把可复用的流程固化成文件，多个 Subagent 可以共享同一本手册，改一处全局生效。

这套机制适合谁？适合已经在用 Claude Code 做真实项目、被上下文污染和规范不一致折磨过的开发者。如果你还在单文件脚本阶段，可以先跳过；一旦项目超过三个模块、团队超过两个人，Subagent + Skills 的收益会非常明显。

这篇会从 settings.json 骨架讲起，带你定义第一个 Subagent、挂载第一个 Skill，并且用 TaoToken 统一 Key 和 API 通道接入，最后跑一次真实请求验证整条链路通不通。全程可复制，跟着敲就行。

2. TaoToken 前置：统一 Key 与 API 通道

Claude Code 默认走 Anthropic 官方通道，但很多人在多模型、多工具混用的场景下，希望有一个统一的入口来管理 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 Key。登录后进入控制台，在 API Keys 页面创建一个新 Key，复制出来形如sk-xxxxxxxx。这个 Key 就是后面 settings.json 里要填的凭证。

注意：Key 只显示一次，创建后立刻保存到本地密码管理器或环境变量里，不要直接提交到 Git 仓库。

拿到 Key 之后，Claude Code 的接入方式是在 settings.json 里配置环境变量。Claude Code 读取的是ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY这两个变量，把 base URL 指向 TaoToken 的 API 端点，Key 填你刚创建的那个，请求就会走统一通道。

如果你还没创建 Key，可以直接打开 https://taotoken.net/api-keys 操作；想先看看模型对话效果，可以到 https://taotoken.net/models 试一下；长期做编码和 Agent 任务的，建议了解 https://taotoken.net/coding-plan 的额度方案。

3. 可复制配置：settings.json 骨架 + Subagent + Skills

这一节是全文的核心，我们分三步走：先写 settings.json 骨架，再定义 Subagent，最后挂载 Skill。

3.1 settings.json 骨架

Claude Code 的配置文件放在项目根目录的.claude/settings.json，也可以放在用户目录做全局配置。项目级配置优先级更高，推荐放在项目里，方便团队共享。

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-你的Key填这里", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514" }, "permissions": { "allow": [ "Read", "Write", "Edit", "Bash(git status)", "Bash(git diff)", "Bash(npm run test)" ], "deny": [ "Bash(rm -rf *)", "Bash(curl *)" ] }, "agents": { "dir": ".claude/agents" }, "skills": { "dir": ".claude/skills" } }

几个关键点解释一下。env块里三个变量分别控制 API 端点、Key 和默认模型，把 base URL 指向 TaoToken 后，所有请求都走统一通道。permissions是工具白名单和黑名单，allow里列出的工具 Subagent 才能用，deny里的操作会被硬拦截，这是防止 Agent 误删文件的第一道防线。agents.dir和skills.dir告诉 Claude Code 去哪里加载 Subagent 和 Skill 定义。

提示：ANTHROPIC_MODEL可以按需换成你账号下可用的模型名，具体可用列表在控制台里能看到。

3.2 定义第一个 Subagent

Subagent 定义文件放在.claude/agents/目录下，用 Markdown 写，头部是 YAML frontmatter，正文是角色提示词。我们定义一个前端工程师 Subagent：

--- name: frontend-engineer description: 前端工程师，负责 React/Vue 组件开发、样式优化、前端性能调优 tools: ["Read", "Write", "Edit", "Bash", "Grep", "Glob"] skills: ["component-scaffold", "git-commit"] --- 你是一个资深前端工程师，擅长 React 生态和现代 CSS。 ## 核心职责 1. 开发可复用的 React 组件 2. 优化样式性能和浏览器兼容性 3. 进行前端性能审计 ## 技术约束 - 遵循 React Hooks 最佳实践 - 使用 TypeScript 进行类型约束 - 遵循 Airbnb JavaScript Style Guide ## 工作流程 当用户提出前端开发需求时： 1. 分析需求，确认技术栈 2. 设计组件结构 3. 编写代码 4. 测试验证 5. 优化性能 ## 代码规范 - 组件文件使用 PascalCase（MyComponent.tsx） - Props 类型使用 PascalCase + Props 后缀 - 避免使用 !important

frontmatter 里四个字段是核心：name是唯一标识，主 Agent 靠它派活；description决定主 Agent 什么时候想起你；tools是工具白名单，只给必需的；skills是挂载的技能列表。正文部分就是角色提示词，写得越具体，Subagent 的行为越稳定。

3.3 挂载第一个 Skill

Skill 定义文件放在.claude/skills/目录下，同样用 Markdown。我们写一个组件脚手架 Skill：

--- name: component-scaffold description: 快速生成符合团队规范的 React 组件项目结构和模板代码 --- # React 组件脚手架生成 ## 使用场景 当需要创建新的 React 组件时使用此技能 **触发条件**： - 用户说"创建新组件"、"生成组件模板"、"初始化组件" **输入**：组件名称、组件类型（functional/class）、是否需要样式文件 **输出**：完整的组件文件结构和初始代码 ## 标准执行流程 ### Phase 1: 信息收集 使用 AskUserQuestion 工具提问： - 组件名称是什么？ - 组件类型是 functional 还是 class？ - 是否需要独立的样式文件？ ### Phase 2: 文件生成 使用 Write 工具创建： 1. `src/components/{ComponentName}/index.tsx` - 组件主文件 2. `src/components/{ComponentName}/{ComponentName}.module.css` - 样式文件 3. `src/components/{ComponentName}/index.test.tsx` - 测试文件 ### Phase 3: 验证与输出 1. 运行 `npx tsc --noEmit` 检查类型 2. 输出生成的文件清单和下一步操作提示 ## 质量检查清单 - [ ] 组件有 TypeScript 类型定义 - [ ] 复杂逻辑有注释 - [ ] 可访问性（ARIA 标签） - [ ] 文件编码为 UTF-8

Skill 的关键是"可操作性"：每一步都有明确的工具调用，任何人执行都能得到相同结果。触发条件写清楚，Subagent 才知道什么时候该读这个文件。

3.4 目录结构总览

配置完成后，你的项目目录应该长这样：

.claude/ ├── settings.json ├── agents/ │ └── frontend-engineer.md └── skills/ ├── shared/ │ └── git-commit.md └── frontend-engineer/ └── component-scaffold.md

shared/放通用技能，多个 Subagent 共享；{agent-name}/放专属技能，只被特定 Subagent 使用。这个组织方式在团队协作时特别有用，新人入职直接拉代码就能用上全套规范。

4. 验证请求：跑通第一个 Subagent 与 Skill 调用

配置写完了，得验证整条链路通不通。分两步：先验证 API 通道，再验证 Subagent 和 Skill 是否被正确加载。

4.1 验证 TaoToken 通道

在项目根目录打开终端，用 curl 直接打一次 API，确认 Key 和端点没问题：

curl https://taotoken.net/api/v1/messages \ -H "x-api-key: sk-你的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": "回复 OK 两个字母"}] }'

如果返回里能看到"content": [{"type": "text", "text": "OK"}]这样的结构，说明通道正常。如果返回 401，检查 Key 是否复制完整；返回 404，检查 base URL 是否写成了https://taotoken.net/api而不是带/v1的完整路径。

4.2 验证 Subagent 加载

启动 Claude Code，在对话里输入：

列出当前可用的 Subagent

正常情况下会看到frontend-engineer出现在列表里。如果没出现，检查.claude/agents/frontend-engineer.md的 frontmatter 格式，YAML 头部必须用---包裹，name字段不能有空格。

4.3 触发一次真实调用

在 Claude Code 里输入：

帮我创建一个新的 React 组件，叫 UserCard

预期行为是：主 Agent 识别到这是前端任务，派给frontend-engineer；Subagent 读取component-scaffoldSkill，按 Phase 1 用 AskUserQuestion 问你组件类型和样式需求；你回答后，它按 Phase 2 生成三个文件，最后跑npx tsc --noEmit验证。

如果这一步成功，你会看到类似这样的输出：

组件脚手架已生成 📦 组件信息: UserCard (functional) 生成的文件: - src/components/UserCard/index.tsx - src/components/UserCard/UserCard.module.css - src/components/UserCard/index.test.tsx 🔧 下一步: 运行 npm run dev 查看效果

到这一步，Subagent + Skills + TaoToken 整条链路就通了。

5. 本篇常见错排查

配置过程中最容易踩的坑集中在几个地方，我按出现频率排一下。

报错一：401 Unauthorized。九成是 Key 问题。检查 settings.json 里ANTHROPIC_API_KEY是否有多余空格，或者 Key 是否已经过期。TaoToken 控制台里可以重新生成 Key，生成后记得同步更新配置文件。

报错二：Subagent 不生效，主 Agent 还是自己干活。先确认.claude/agents/目录名没写错，再检查 frontmatter 的description是否足够具体。如果 description 写得太泛（比如"处理各种任务"），主 Agent 判断不出什么时候该派活，就会自己上。把 description 写成"负责 React/Vue 组件开发"这种明确领域，命中率会高很多。

报错三：Skill 读不到，Subagent 说找不到文件。检查 Subagent 的skills字段里写的名字，必须和 Skill 文件的name字段完全一致，大小写敏感。另外 Skill 文件路径要放在.claude/skills/下，子目录层级不影响加载，但文件名建议和 name 保持一致。

报错四：工具被拒绝，Subagent 报 permission denied。这是 settings.json 的permissions.allow没放行对应工具。比如 Subagent 要用Bash跑测试，但 allow 列表里只有Read和Write，就会被拦。按需往 allow 里加，但别图省事写Bash(*)，那等于把黑名单废了。

报错五：模型名不识别。ANTHROPIC_MODEL填的模型必须是你账号下可用的。不确定的话，先不填这个字段，让 Claude Code 用默认模型，跑通后再换。

报错六：改了配置不生效。Claude Code 启动时读一次配置，改完 settings.json 要重启会话。Subagent 和 Skill 文件是运行时读取的，改完不用重启，但建议新开一个对话避免上下文干扰。

6. 下一步：把配置沉淀成团队资产

跑通第一个 Subagent 和 Skill 之后，真正有价值的事情是把团队的最佳实践固化下来。我自己的做法是维护一个shared/目录，把 git-commit 规范、code-review 流程、部署手册都写成 Skill，所有 Subagent 通过skills字段引用。新人入职拉下代码，Claude Code 自动就带着全套规范干活，比写十页 onboarding 文档管用。

如果你还没开始，建议从两个 Skill 入手：一个是git-commit，统一提交信息格式；一个是code-review，把团队的检查清单固化。这两个通用性最强，收益也最直接。

需要创建更多 Key 或查看额度，可以到 https://taotoken.net/api-keys 操作；想先体验模型对话效果，打开 https://taotoken.net/models 试一下；长期做编码和 Agent 任务的，建议看看 https://taotoken.net/coding-plan 的方案；接入过程中遇到问题，文档在 https://taotoken.net/doc 里能查到详细说明。