企业官网建设流程全解析

1. 先把“进阶路径”这个念头放下

如果你正在用 Claude Code，大概率见过这样的说法：Commands 是入门，Skills 是进阶，Agents 才是高手玩法。于是很多人按这个顺序配，先写几个/xxx命令，再补 Skills，最后才敢碰 Agents。配完之后发现行为跟预期对不上：命令触发了但没干活，Skill 该自动加载时没动静，Agent 明明定义了却从不被调用。

问题不在你写得不够多，而在这条“进阶路径”本身就是错的。Commands、Skills、Agents 不是三个难度等级，而是同一套系统里三个分工不同的角色。Commands 和 Skills 解决的是“什么时候执行”——前者靠你手动敲/触发，后者靠 Claude 读上下文自动识别；Agents 解决的是“执行什么”——它带着独立上下文、指定工具和角色设定去干活。Command 可以调 Agent，Skill 也可以调 Agent，Agent 本身可简可繁，跟“新手还是高手”没有半点关系。

这篇面向已经用过 Claude Code、但配置越堆越乱的人。我会先给出一份settings.json里三者共存的骨架配置，再用 TaoToken 把 Key 和 API 通道统一起来，最后一步步验证：Command 是否按预期触发、Skill 是否被加载、Agent 是否被正确调度。全程可复制，不需要你重装环境。

2. 用 TaoToken 统一 Key 与 API 通道

在验证三者协作之前，得先让 Claude Code 有一个稳定、统一的模型入口。否则你排查“Agent 没被调用”时，可能实际是请求根本没发出去。TaoToken 在这里的作用很单纯：提供一个兼容 Anthropic 接口的 API 通道，把 Key 管理、模型调用收敛到一处，省得你在多个配置文件里各写一份。

官网地址是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 端点是 https://taotoken.net/api （这个不加 UTM）。你需要先在控制台创建一个 API 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 之后，Claude Code 通过环境变量读取它。我习惯把它写进 shell 配置，而不是散落在项目里：

# ~/.zshrc 或 ~/.bashrc export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_API_KEY="sk-你的TaoToken密钥"

改完执行source ~/.zshrc让变量生效。这里有个容易踩的点：ANTHROPIC_BASE_URL末尾不要带/v1，Claude Code 会自己拼接路径，多写一段会导致 404。验证变量是否生效：

echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_API_KEY | head -c 8

第二条只打印前 8 位，确认 Key 非空即可，别把完整 Key 贴到终端历史里。如果你在 CI 或容器里跑，用对应的 secrets 机制注入同名变量，逻辑一样。

注意：TaoToken 只是模型调用的通道，它不替代 Claude Code 本身，也不改变 Commands/Skills/Agents 的加载逻辑。三者是否生效，取决于你的文件放对位置、格式写对，跟通道无关。

3. settings.json 里三者共存的骨架配置

Claude Code 的配置分两层：用户级在~/.claude/，项目级在项目根目录的.claude/。三者各占一个子目录，互不干扰：

~/.claude/ ├── settings.json ├── commands/ │ └── codehygiene.md ├── skills/ │ └── react-patterns/ │ └── SKILL.md └── agents/ └── code-hygiene-checker.md

settings.json负责全局行为，比如权限模式、默认模型、允许的工具。一份能同时容纳三者的骨架长这样：

{ "model": "claude-sonnet-4-5", "permissions": { "allow": ["Read", "Grep", "Glob", "Bash(git diff:*)", "Bash(git status:*)"], "deny": ["Bash(rm -rf:*)"] }, "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api" } }

这里permissions.allow决定了 Agent 能用哪些工具。如果你在 Agent 文件里写了tools: Read, Grep, Glob, Bash，但settings.json没放行Bash，Agent 执行到 git 命令时会被拦下，表现就是“Agent 跑了但没结果”。这是配置混乱时最常见的假故障之一。

Command 文件放在commands/下，文件名就是触发词。比如codehygiene.md对应/codehygiene：

--- description: Run code hygiene check on recent changes --- Code Hygiene Review Use the code-hygiene-checker agent to verify recent changes are structurally complete and no technical debt was introduced. 1. Launch the code-hygiene-checker agent to verify: - Changes are fully integrated across all layers - Old code and unused implementations are removed - No development artifacts remain - Dependencies and configurations are updated consistently 2. After the agent returns results, organize suggestions by priority.

Skill 放在skills/<name>/SKILL.md，靠 description 里的关键词被自动匹配：

--- name: react-patterns description: Best practices for React components. Use when working with React code or discussing component architecture. --- When writing React components: - Prefer composition over prop drilling - Keep hooks at the top level - Use descriptive component names

Agent 放在agents/下，头部声明工具和模型：

--- name: code-hygiene-checker description: Reviews code for structural completeness and cleanliness. Use after refactors or before merging PRs. tools: Read, Grep, Glob, Bash model: sonnet --- Your role is to inspect code changes and prevent technical debt. Review scope: recent changes, dead code, dev artifacts, dependency hygiene. Output findings as: Blocking Issues / Technical Debt Risks / Suggestions.

三个文件格式都是 Markdown，但角色完全不同。Command 和 Skill 是触发器，Agent 是执行者。把它们放进同一个settings.json管辖的目录树里，系统会各取所需，不存在“先配哪个后配哪个”的顺序问题。

4. 验证触发、加载与调度是否生效

配好之后别急着写业务，先做一次最小验证。我试过最省事的办法是分三步走，每步只验证一个环节。

第一步，验证 Command 触发。在 Claude Code 里输入/，看补全列表里有没有codehygiene。有，说明文件被扫描到了；没有，检查路径是不是~/.claude/commands/codehygiene.md，以及 frontmatter 的---是否闭合。然后直接敲/codehygiene，观察输出里是否出现“Launch the code-hygiene-checker agent”这类动作描述。

第二步，验证 Skill 加载。Skill 不会在补全列表里出现，它靠语义匹配。你可以直接问 Claude：“我在写 React 组件，有什么要注意的？”如果react-patterns的 description 命中了，Claude 的回答会带上你写的三条规则。没命中就调整 description，把触发场景写得更具体，比如加上“when refactoring hooks”这类词。

第三步，验证 Agent 调度。这一步最容易出问题。在项目里随便改一个文件，然后敲/codehygiene。正常流程是：Command 运行 → 指示 Claude 调用code-hygiene-checker→ Agent 加载自己的上下文和工具 → 用 Grep/Read/Bash 检查 → 返回结构化报告。

如果卡在某一步，用下面这张表对照：

验证通过的标准很简单：你敲一次命令，Agent 真的去读了代码、跑了 git diff、返回了分优先级的报告。到这一步，三者协作就算跑通了。

5. 本篇常见错排查

配置混乱的人，错误往往集中在几个固定位置。下面这些是我在排查时反复遇到的。

把 Skill 当 Command 用。有人写了SKILL.md却期待输入/skill-name触发。Skill 没有手动触发入口，它只在 Claude 判断上下文匹配时加载。想手动触发就写 Command，想自动介入就写 Skill，别混。

Agent 里写了工具但没在 settings.json 放行。Agent 文件的tools字段是“声明我想用”，settings.json的permissions.allow是“实际允许用”。两者都满足才生效。只写前者，Agent 会在调用工具时被静默拦下。

Command 和 Agent 重名导致覆盖。比如commands/review.md和agents/review.md同时存在，虽然目录不同，但在日志里容易看混。建议命名上区分，Command 用动词短语，Agent 用-checker、-reviewer这类后缀。

BASE_URL 末尾多写/v1。这是接入 TaoToken 时最高频的 404 来源。Claude Code 内部会拼/v1/messages，你再写一层就变成/v1/v1/messages。正确写法就是https://taotoken.net/api。

改了配置没重启会话。Claude Code 在启动时读取settings.json和目录结构，运行中新增文件不一定被扫描。改完配置后退出重进，或者用/config确认当前生效值。

Skill 的 description 写成功能说明而非触发条件。写“这个 Skill 提供 React 最佳实践”没用，要写“Use when working with React code or discussing component architecture”。Claude 匹配的是场景，不是功能名。

排障时如果拿不准是通道问题还是配置问题，可以先用模型对话入口单独测一次请求，确认 Key 和端点通不通：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 。通道通了再回头查文件，能省一半时间。

6. 按“谁来触发、谁来执行”重新组织你的配置

回到开头那个问题：Commands、Skills、Agents 到底怎么选？答案不是“先学哪个”，而是问自己两句话——这件事谁来决定什么时候执行？执行时需要独立上下文和工具吗？

需要你明确控制时机的，写 Command；希望 Claude 自己识别场景主动介入的，写 Skill；需要隔离上下文、限定工具、按固定方法论干活的，写 Agent。Command 和 Skill 都能调 Agent，Agent 不关心自己被谁唤起。三者是协作关系，不是升级关系。

如果你打算长期在编码和 Agent 调度上投入，可以把 Key 和通道固定到 TaoToken 的 Coding Plan，省去每次配环境的重复动作：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。接入细节和字段说明在文档里：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。Claude Code 相关的接入示例也有单独页面：https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_content=claudecode&utm_campaign=rewrite 。

最后留一个我自己的习惯：每加一个 Command 或 Agent，先在空项目里跑一次最小验证，确认触发和调度都对，再放进真实项目。配置乱，往往不是写得少，而是没验证就往上堆。