企业官网建设流程全解析

1. 从零跑通 Claude Code：为什么新手总卡在 Key 和配置上

Claude Code 是 Anthropic 推出的命令行编程 agent，它本身就是一个 agent，能读写文件、执行终端命令、调用工具链。适合谁？适合已经会用终端、想让 AI 直接改项目代码而不是复制粘贴的开发者。但新手第一次装完，最容易卡在两件事：一是 Key 怎么填、base-url 写什么；二是 skills、subagents、mcp 这三类能力到底怎么在settings.json里落地。

我见过太多人装完 Claude Code，输入claude之后报 401，或者 agent 起来了但 skills 不生效、subagents 调不动、mcp 连不上。问题往往不在工具本身，而在配置骨架没搭对。这篇就围绕一个目标：用 TaoToken 的统一 Key，把 agent、skills、subagents、mcp 四件事一次性配通，并给出逐项验证动作。

先说清楚概念，避免后面混淆。Claude Code 本身是 agent，所以它的 skills 叫 agent skills；在它下面再写的 agent，叫 subagent。skills 会继承主对话上下文，适合处理与上下文关联大、但对上下文影响小的任务；subagents 有独立上下文、独立工具、独立 skills，干完活只把最终结果汇报回来。mcp 则是外部工具接入协议，比如把 Figma 的远程 mcp 挂进来。这三类能力加上统一 Key，就是新手接入 agent 工作流的最小闭环。

TaoToken 在这里的角色是统一入口：一个 Key 走通模型对话、coding plan、api-keys 管理，省得你在 DeepSeek、千问、Claude 之间来回换 base-url。官网入口见 https://taotoken.net/?utm_source=taotoken_aicg_blog_end ，API 地址是 https://taotoken.net/api ，注意 API 地址不加 UTM。

2. TaoToken 前置准备：拿 Key、装 Claude Code、定目录

2.1 安装 Claude Code

官方快速开始文档在 https://code.claude.com/docs/zh-CN/quickstart#homebrew 。macOS 用 Homebrew 最省事：

brew install --cask claude-code

Linux 和 Windows 按文档走对应安装方式。装完后终端输入claude --version，能打印版本号就说明二进制就位了。

2.2 拿 TaoToken 统一 Key

打开 https://taotoken.net/api-keys ，登录后创建一个 API Key，复制出来形如sk-xxxx。这个 Key 后面会同时用于ANTHROPIC_AUTH_TOKEN和 mcp 相关配置。如果你还没决定用哪个模型，可以先在模型对话页 https://taotoken.net/models 试一下，确认 Key 可用再往下配。

2.3 确定配置目录

Claude Code 读取配置的优先级是：项目级./.claude/settings.json> 用户级~/.claude/settings.json。新手建议先配用户级，全局生效，避免每个项目重复写。

mkdir -p ~/.claude touch ~/.claude/settings.json

Windows 用户注意，Claude Code 在 Windows 上主要通过环境变量读取，路径是%USERPROFILE%\.claude\settings.json，但更稳的方式是用 PowerShell 设用户级环境变量，后面会给命令。

3. 可复制的 settings.json 配置骨架

3.1 用户级 settings.json 完整骨架

下面这份骨架把 env、skills、subagents、mcp 四块都留了位置。你可以直接复制，把sk-你的TaoToken密钥替换成真实 Key。

{ "env": { "ANTHROPIC_AUTH_TOKEN": "sk-你的TaoToken密钥", "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "API_TIMEOUT_MS": "600000", "ANTHROPIC_MODEL": "claude-sonnet-4-5", "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1" }, "permissions": { "allow": [ "Bash(npm run *)", "Bash(git status)", "Read", "Write" ] }, "mcpServers": { "figma-remote-mcp": { "type": "http", "url": "https://mcp.figma.com/mcp" } } }

几个关键点解释一下。ANTHROPIC_BASE_URL填https://taotoken.net/api，不要带 UTM 参数，否则部分客户端会把它当成路径的一部分导致 404。API_TIMEOUT_MS给到 600000，是因为 agent 跑长任务时容易超时，默认值偏短。ANTHROPIC_SMALL_FAST_MODEL用于轻量任务，能省 token。

3.2 Windows 环境变量写法

Windows 上如果不想用 settings.json，可以用 PowerShell 设用户级变量：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://taotoken.net/api", "User") [System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的TaoToken密钥", "User") [System.Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "600000", "User") [System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-4-5", "User") [System.Environment]::SetEnvironmentVariable("ANTHROPIC_SMALL_FAST_MODEL", "claude-haiku-4-5", "User") [System.Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", "User")

设完要重开终端才生效。注意ANTHROPIC_AUTH_TOKEN和ANTHROPIC_API_KEY二选一即可，同时存在时以 AUTH_TOKEN 优先。

3.3 skills 目录骨架

skills 放在~/.claude/skills/下，每个 skill 一个文件夹，里面放SKILL.md。骨架长这样：

~/.claude/skills/ └── code-review/ └── SKILL.md

SKILL.md的 frontmatter 里name和description决定 Claude 什么时候调用它：

--- name: code-review description: 当用户要求审查代码、检查潜在 bug 或安全问题时使用 --- # Code Review Skill 审查步骤： 1. 读取目标文件 2. 检查空指针、边界条件、资源泄漏 3. 输出问题清单和修复建议

3.4 subagents 目录骨架

subagents 放在~/.claude/agents/下，每个 subagent 一个 md 文件：

~/.claude/agents/ └── test-runner.md

内容示例：

--- name: test-runner description: 独立运行测试套件并汇报失败用例 tools: Bash, Read --- 你是一个测试执行 agent。收到任务后： 1. 运行 npm test 2. 解析失败输出 3. 只汇报失败用例和原因，不返回完整日志

subagent 的tools字段限定它能用的工具，description决定主 agent 什么时候委派给它。

4. 逐项验证：agent、skills、subagents、mcp 是否真的生效

4.1 验证 agent 启动与 Key 生效

终端输入：

claude

进入交互后随便问一句「当前目录有哪些文件」。如果返回正常，说明 Key 和 base-url 通了。如果报 401，回到第 5 节排查。想恢复上次对话上下文用：

claude -c

4.2 验证 skills 生效

在交互里输入/skills，应该能看到你放在~/.claude/skills/下的 skill 列表。如果列表为空，检查目录名和SKILL.md的 frontmatter 是否写对。也可以显式引导：

/code-review 帮我审查 src/index.js

如果 Claude 按 SKILL.md 里的步骤执行，说明 skills 生效。

4.3 验证 subagents 可调用

输入/agents查看已注册的 subagent。然后显式委派：

用 test-runner 跑一下测试

观察它是否开辟独立上下文、只返回失败用例。如果它把完整日志都倒回主对话，说明tools或 description 写得不够收敛。

4.4 验证 mcp 连接成功

输入/mcp查看当前挂载的 mcp 服务。如果figma-remote-mcp显示 connected，说明 settings.json 里的mcpServers被正确读取。也可以用命令行临时加：

claude mcp add --transport http figma-remote-mcp https://mcp.figma.com/mcp

加完再/mcp确认。mcp 连不上时，先确认 url 可访问，再确认 settings.json 是合法 JSON（多余逗号是最常见的坑）。

5. 本篇常见错排查

5.1 401 / 403：Key 或 base-url 写错

最常见的是 base-url 带了 UTM 参数，或者把https://taotoken.net/api写成了https://taotoken.net/api/（末尾斜杠有时会出问题）。检查ANTHROPIC_AUTH_TOKEN是否以sk-开头、有没有多余空格。改完 settings.json 后要重开终端。

5.2 skills 不生效：目录层级或 frontmatter 错

skills 必须是~/.claude/skills/<skill-name>/SKILL.md这种两层结构，不能直接把SKILL.md放在 skills 根目录。frontmatter 的---必须顶格，name和description缺一不可。

5.3 subagents 调不动：description 太模糊

主 agent 靠 description 判断何时委派。如果写「处理测试相关」，它可能永远不触发。改成「当用户要求运行测试套件并汇报失败用例时使用」这种具体描述。

5.4 mcp 连接失败：JSON 语法或网络

先用python -m json.tool ~/.claude/settings.json校验 JSON 合法性。再确认 mcp url 在浏览器能打开。如果公司网络限制，mcp 的 http 传输可能被拦，换成本地 stdio 类型的 mcp 试试。

5.5 上下文被塞满：skills 和 subagents 用混了

skills 继承主对话上下文，跑长任务会把上下文窗口塞满。涉及大量日志、大量文件扫描的任务，应该交给 subagents，让它独立上下文跑完只回传结论。这是两者最大的区别，配错了会明显感觉对话变慢、变贵。

6. 把统一 Key 用顺：后续接入与长期编码

配置骨架搭好之后，日常使用还有几个提效点。上下文查看用ctrl+o，压缩用/compact，可以带策略比如/compact 重点保留代码；直接清空用/clear。回滚按两次esc或/rewind。后台任务用! npm run dev加ctrl+b，再用/tasks查看或 kill。

项目级设定写在./CLAUDE.md，全局设定写在~/.claude/CLAUDE.md，用/init生成当前目录级别的，用/memory编辑。hooks 类似切面，能在特定事件前后插入动作，文档在 https://code.claude.com/docs/zh-CN/hooks 。

如果你打算长期用 Claude Code 做编码和 agent 工作流，建议把 Key 管理收敛到 TaoToken 的 coding plan，入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite ，一个 Key 覆盖模型对话、api-keys 和接入文档，省得每个模型单独配。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，遇到 base-url 或模型名不确定时先查这里。模型对话验证在 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite ，api-keys 管理在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite 。

最后留一个我踩过的坑：改完settings.json一定要重开终端，Claude Code 不会热加载配置。另外 skills 和 subagents 的目录名不要用中文或空格，否则在某些系统上会静默不加载。把这两点避开，第 4 节的四项验证基本一次过。