1. 为什么你的 Claude Code 总是“记不住事”很多人用 Claude Code 的路径都差不多一开始觉得挺惊艳写个函数、改个 bug 都挺顺手用着用着就开始不对劲了——代码风格飘忽不定审查总是漏掉关键点跑个大任务十几轮对话之后上下文直接爆掉AI 开始“健忘”你只能一遍遍重复同样的指令。问题不在于模型不够强而在于你只用了它最表层的能力。Claude Code 真正的扩展体系由四个机制组成Hook、Skill、Subagent、Plugin。它们分别解决四个层次的问题——Hook 管“规矩”Skill 管“知识”Subagent 管“分身”Plugin 管“分发”。只靠斜杠命令等于只用了这套体系很小的一部分。这篇不打算只讲概念。我会以 TaoToken 统一 Key 作为接入层把 settings.json 和 config.toml 的可复制骨架给出来然后一步步演示 Hook 怎么触发、Skill 怎么加载、Subagent 怎么调度、Plugin 怎么注册最后跑一遍全链路验证。你照着做能一次把四个机制串起来。适合谁看已经在用 Claude Code、但还没系统配置过扩展机制的开发者或者团队里想统一 AI 工作流、又不想每个人各配一套的人。2. 接入层准备用 TaoToken 统一 Key 打通 Claude Code2.1 为什么先搞接入层Claude Code 的四个扩展机制最终都要落到“模型请求”上。Hook 触发时要调模型做格式化判断Skill 加载后要执行指令Subagent 调度要开独立上下文Plugin 注册后里面每个能力都要发请求。如果每个环节的 Key 和通道各管各的配置会散得到处都是排障时根本找不到是哪一层出的问题。所以第一步是把接入层统一一个 Key、一个 API 通道四个机制共用。TaoToken 在这里扮演的就是这个统一入口的角色——你不需要在每个配置文件里塞不同的凭证只需要在 Claude Code 的配置里指向同一个 API 地址和 Key。2.2 拿 Key 和确认通道先去控制台创建一个 API Key。地址是https://taotoken.net/console创建完之后你会拿到一个以sk-开头的 Key。这个 Key 后面会同时用在 settings.json 和 config.toml 里。API 通道地址统一用https://taotoken.net/api注意这里不要加任何多余的路径后缀Claude Code 的配置里会自己拼接具体端点。2.3 环境变量方式推荐最省事的方式是把 Key 放进环境变量配置文件里只引用变量名这样 Key 不会硬编码进 Git 仓库export TAOTOKEN_API_KEYsk-你的KeyWindows 下用 PowerShell$env:TAOTOKEN_API_KEYsk-你的Key如果你想让它在每次开终端时自动生效Linux/macOS 写进~/.bashrc或~/.zshrcWindows 写进系统环境变量。2.4 验证接入层是否通在正式配 Claude Code 之前先用一条 curl 确认通道是活的curl -s https://taotoken.net/api/v1/models \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ | head -c 300如果返回里能看到模型列表的 JSON 片段说明 Key 和通道都没问题。这一步别跳过——后面四个机制出问题时你至少能确定不是接入层挂了。3. 可复制配置骨架settings.json 与 config.toml3.1 settings.json 骨架Claude Code 的用户级配置在~/.claude/settings.json项目级在.claude/settings.json。项目级优先级更高团队协作时建议把项目级配置提交到 Git。下面是一份包含接入层和 Hook 的完整骨架{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的Key }, hooks: { PostToolUse: [ { matcher: Write, hooks: [ { type: command, command: eslint --fix ${FILE_PATH} } ] } ], PreToolUse: [ { matcher: Bash, hooks: [ { type: command, command: bash .claude/hooks/block-dangerous.sh } ] } ] } }这里env段就是接入层四个机制共用。hooks段先放两个最常用的写文件后自动 ESLintBash 调用前做危险命令拦截。3.2 config.toml 骨架如果你用的是支持 TOML 配置的客户端或工具链对应的骨架是这样[api] base_url https://taotoken.net/api api_key sk-你的Key timeout 60 [subagent] default_model claude-sonnet max_parallel 3 [skill] auto_match true search_paths [.claude/skills, ~/.claude/skills] [plugin] marketplace superpowers-marketplace auto_update false[api]段是接入层[subagent]控制子智能体的默认模型和并行数[skill]控制技能自动匹配和搜索路径[plugin]控制插件市场来源。四个机制在配置层面就分开了排障时一眼能看出是哪块的问题。3.3 危险命令拦截脚本上面 settings.json 引用的block-dangerous.sh内容如下放在.claude/hooks/目录#!/bin/bash input$(cat) if echo $input | grep -qE rm -rf /|drop table|sudo rm; then echo ERROR: 危险命令被拦截 2 exit 2 fi exit 0退出码是关键0表示放行2表示阻止执行仅 PreToolUse 有效其他非零值表示出错但继续。这个脚本不需要调模型纯本地判断所以不消耗 Token。4. 四个机制逐个跑通触发、加载、调度、注册4.1 Hook 触发验证配好 settings.json 后重启 Claude Code然后让它写一个文件帮我在 src/utils.ts 里加一个格式化日期的函数Claude 调用 Write 工具写入文件后PostToolUse 的 Hook 会自动触发eslint --fix。你怎么确认它真的触发了看终端输出——如果 ESLint 有格式化动作会打印处理信息。或者故意写一段格式混乱的代码Hook 跑完后文件应该被自动修正。想临时关掉某个 Hook 做对比测试/hook disable PostToolUse再写一次文件这次不会被格式化。确认差异后重新启用/hook enable PostToolUse4.2 Skill 加载验证Skill 放在.claude/skills/下每个技能一个文件夹文件夹名用 kebab-case。最小结构只需要一个SKILL.md--- name: python-code-review description: 对 Python 代码进行 PEP8 规范审查、漏洞检测、可读性优化 version: 1.0.0 --- # Python 代码审查技能 ## 执行步骤 1. 读取待审查代码解析语法结构 2. 校验命名、缩进、注释规范 3. 检测潜在 bug 4. 输出结构化审查报告Skill 的核心是渐进式加载会话启动时只加载 YAML 元数据name description大概几十 Token当你的问题匹配到 description 里的关键词时才加载 SKILL.md 正文scripts/ 和 references/ 里的附件只在执行时按需读取。所以你放几十个 Skill 也不会撑爆上下文。验证加载直接问一个匹配 description 的问题比如“帮我审查这段 Python 代码的规范问题”。如果 Skill 生效Claude 会按 SKILL.md 里的步骤走而不是自由发挥。也可以手动加载/skill load ./.claude/skills/python-code-review/4.3 Subagent 调度验证Subagent 放在.claude/agents/下用 Markdown 定义YAML 头配属性正文是 System Prompt--- name: code-reviewer description: 独立进行代码审查不占用主会话上下文 tools: [Read, Grep, Glob] disallowedTools: [Write, Edit, Bash] model: claude-sonnet --- 你是一个独立的代码审查专家。深入理解指定模块的代码逻辑 检查潜在 bug、性能问题和安全隐患输出结构化审查报告。 审查过程的所有细节留在你自己的上下文中 只向主会话返回问题汇总 严重程度 建议修改方案。tools是白名单disallowedTools是黑名单。上面这个配置保证审查 Agent 只能读不能写不会误改代码。验证调度让主 Agent 派一个任务给 Subagent用 code-reviewer 子智能体审查 src/services/ 目录下的所有文件关键观察点是主对话的上下文长度。Subagent 在独立窗口里读了 20 个文件、做了大量分析但主对话里只出现一条精简摘要。这就是上下文隔离的价值——同样一个审查任务用 Skill 在主对话里跑50 个文件读下来 Token 消耗可能是 Subagent 的几十倍。想看 Subagent 的执行细节开调试模式DEBUGclaude:subagents claude4.4 Plugin 注册验证Plugin 是 Skill Subagent Hook 的打包集合。添加市场源并安装/plugin marketplace add superpowers-marketplace /plugin install superpowerssuperpowers-marketplace安装完成后插件里的 Skill、Subagent、Hook 会自动出现在对应目录。验证方式是列一下当前可用的技能和 Agent/skill list如果能看到插件带来的技能比如 systematic-debugging、writing-plans说明注册成功。Plugin 解决的是分发问题——团队里每个人装同一个插件工作流模板和调试规范就统一了不会出现“在我电脑上能跑”的情况。5. 全链路串起来一个任务走完四个机制光逐个验证还不够得看它们协同起来是什么样。假设你给 Claude Code 一个任务帮我审查这次提交的代码并生成对应的单元测试整个链路的执行顺序是这样的Plugin 层先提供能力——superpowers 插件里打包了 code-review 技能、test-generator 子智能体和格式化 Hook装一次就全有了。Hook 层在幕后执行——Claude 每次写文件PostToolUse 的 ESLint Hook 自动格式化你甚至感知不到它在跑。Skill 层执行标准化审查——code-review 技能被语义匹配激活按 SKILL.md 里定义的步骤逐项检查输出结构化报告。Subagent 层做独立分析——test-generator 子智能体在自己的上下文窗口里分析代码结构、生成测试用例最后只把摘要返回主对话。主对话最终整合结果给你。整个过程中Hook 不占上下文Skill 只在匹配时加载正文Subagent 的细节全留在独立窗口。四个机制各司其职主对话的 Token 消耗被压到很低。这里有个容易踩的坑如果你把代码审查写成 Skill 而不是 Subagent50 个文件读下来主上下文直接爆掉Auto-Compaction 一触发前面聊的关键信息全丢了。所以选型上记住一条——单点标准化任务用 Skill大批量探索任务用 Subagent。6. 本篇常见错排查配置跑不通的时候按下面这个顺序查基本能定位到问题。Hook 不触发先确认 settings.json 的 JSON 格式没问题用jq . ~/.claude/settings.json校验一下。然后确认 matcher 写对了——Write和write是区分大小写的。最后看脚本有没有执行权限chmod x .claude/hooks/block-dangerous.sh。Skill 不加载检查文件夹名是不是 kebab-caseSKILL.md是不是严格大写放在根目录。YAML 头里的name和description必须存在description 里的关键词要能匹配到你的提问方式。如果自动匹配不生效先用/skill load手动加载确认技能本身没问题。Subagent 调度失败确认.claude/agents/下的 Markdown 文件 YAML 头完整name和description不能少。如果报工具权限错误检查tools和disallowedTools有没有冲突——同一个工具不能既在白名单又在黑名单。Plugin 装不上市场源地址要写全/plugin marketplace add后面跟的是市场标识不是 URL。安装后如果技能没出现重启一次 Claude Code 让配置重新加载。接入层报 401 或 403回到第 2 步的 curl 验证确认 Key 有效、通道地址没写错。settings.json 里的ANTHROPIC_BASE_URL结尾不要带斜杠ANTHROPIC_API_KEY确认没有多余空格。Token 消耗异常高大概率是把该用 Subagent 的任务写成了 Skill。检查一下你的大批量任务是不是都在主对话里跑。另外确认 Skill 的渐进式加载有没有被破坏——如果 SKILL.md 正文写得过长每次匹配都会加载全部内容。7. 把接入层和扩展机制固定下来四个机制跑通之后最该做的一件事是把配置提交到 Git。.claude/settings.json、.claude/skills/、.claude/agents/、.claude/hooks/全部纳入版本控制团队新成员克隆项目后接入层和扩展能力一次性到位不用每个人重新配一遍。接入层这块统一用 TaoToken 的 Key 和通道四个机制共用一个入口排障时只需要查一个地方。如果你还没创建 Key去控制台建一个https://taotoken.net/api-keys配置细节和参数说明在接入文档里https://taotoken.net/doc想先验证模型通道是否正常可以直接在模型对话里发一条测试请求https://taotoken.net/models如果你打算长期用 Claude Code 做编码和 Agent 调度Coding Plan 里把接入层和扩展机制的配置模板都整理好了可以直接参考https://taotoken.net/coding-plan最后提醒一句Hook 从 PostToolUse ESLint 开始配这是回报最高的一步Subagent 优先于 Skill 用在批量任务上Token 账单的差别会很明显Plugin 先从社区现成的开始用跑通了再改造成团队自己的版本。
1. 为什么你的 Claude Code 总是“记不住事”很多人用 Claude Code 的路径都差不多一开始觉得挺惊艳写个函数、改个 bug 都挺顺手用着用着就开始不对劲了——代码风格飘忽不定审查总是漏掉关键点跑个大任务十几轮对话之后上下文直接爆掉AI 开始“健忘”你只能一遍遍重复同样的指令。问题不在于模型不够强而在于你只用了它最表层的能力。Claude Code 真正的扩展体系由四个机制组成Hook、Skill、Subagent、Plugin。它们分别解决四个层次的问题——Hook 管“规矩”Skill 管“知识”Subagent 管“分身”Plugin 管“分发”。只靠斜杠命令等于只用了这套体系很小的一部分。这篇不打算只讲概念。我会以 TaoToken 统一 Key 作为接入层把 settings.json 和 config.toml 的可复制骨架给出来然后一步步演示 Hook 怎么触发、Skill 怎么加载、Subagent 怎么调度、Plugin 怎么注册最后跑一遍全链路验证。你照着做能一次把四个机制串起来。适合谁看已经在用 Claude Code、但还没系统配置过扩展机制的开发者或者团队里想统一 AI 工作流、又不想每个人各配一套的人。2. 接入层准备用 TaoToken 统一 Key 打通 Claude Code2.1 为什么先搞接入层Claude Code 的四个扩展机制最终都要落到“模型请求”上。Hook 触发时要调模型做格式化判断Skill 加载后要执行指令Subagent 调度要开独立上下文Plugin 注册后里面每个能力都要发请求。如果每个环节的 Key 和通道各管各的配置会散得到处都是排障时根本找不到是哪一层出的问题。所以第一步是把接入层统一一个 Key、一个 API 通道四个机制共用。TaoToken 在这里扮演的就是这个统一入口的角色——你不需要在每个配置文件里塞不同的凭证只需要在 Claude Code 的配置里指向同一个 API 地址和 Key。2.2 拿 Key 和确认通道先去控制台创建一个 API Key。地址是https://taotoken.net/console创建完之后你会拿到一个以sk-开头的 Key。这个 Key 后面会同时用在 settings.json 和 config.toml 里。API 通道地址统一用https://taotoken.net/api注意这里不要加任何多余的路径后缀Claude Code 的配置里会自己拼接具体端点。2.3 环境变量方式推荐最省事的方式是把 Key 放进环境变量配置文件里只引用变量名这样 Key 不会硬编码进 Git 仓库export TAOTOKEN_API_KEYsk-你的KeyWindows 下用 PowerShell$env:TAOTOKEN_API_KEYsk-你的Key如果你想让它在每次开终端时自动生效Linux/macOS 写进~/.bashrc或~/.zshrcWindows 写进系统环境变量。2.4 验证接入层是否通在正式配 Claude Code 之前先用一条 curl 确认通道是活的curl -s https://taotoken.net/api/v1/models \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ | head -c 300如果返回里能看到模型列表的 JSON 片段说明 Key 和通道都没问题。这一步别跳过——后面四个机制出问题时你至少能确定不是接入层挂了。3. 可复制配置骨架settings.json 与 config.toml3.1 settings.json 骨架Claude Code 的用户级配置在~/.claude/settings.json项目级在.claude/settings.json。项目级优先级更高团队协作时建议把项目级配置提交到 Git。下面是一份包含接入层和 Hook 的完整骨架{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的Key }, hooks: { PostToolUse: [ { matcher: Write, hooks: [ { type: command, command: eslint --fix ${FILE_PATH} } ] } ], PreToolUse: [ { matcher: Bash, hooks: [ { type: command, command: bash .claude/hooks/block-dangerous.sh } ] } ] } }这里env段就是接入层四个机制共用。hooks段先放两个最常用的写文件后自动 ESLintBash 调用前做危险命令拦截。3.2 config.toml 骨架如果你用的是支持 TOML 配置的客户端或工具链对应的骨架是这样[api] base_url https://taotoken.net/api api_key sk-你的Key timeout 60 [subagent] default_model claude-sonnet max_parallel 3 [skill] auto_match true search_paths [.claude/skills, ~/.claude/skills] [plugin] marketplace superpowers-marketplace auto_update false[api]段是接入层[subagent]控制子智能体的默认模型和并行数[skill]控制技能自动匹配和搜索路径[plugin]控制插件市场来源。四个机制在配置层面就分开了排障时一眼能看出是哪块的问题。3.3 危险命令拦截脚本上面 settings.json 引用的block-dangerous.sh内容如下放在.claude/hooks/目录#!/bin/bash input$(cat) if echo $input | grep -qE rm -rf /|drop table|sudo rm; then echo ERROR: 危险命令被拦截 2 exit 2 fi exit 0退出码是关键0表示放行2表示阻止执行仅 PreToolUse 有效其他非零值表示出错但继续。这个脚本不需要调模型纯本地判断所以不消耗 Token。4. 四个机制逐个跑通触发、加载、调度、注册4.1 Hook 触发验证配好 settings.json 后重启 Claude Code然后让它写一个文件帮我在 src/utils.ts 里加一个格式化日期的函数Claude 调用 Write 工具写入文件后PostToolUse 的 Hook 会自动触发eslint --fix。你怎么确认它真的触发了看终端输出——如果 ESLint 有格式化动作会打印处理信息。或者故意写一段格式混乱的代码Hook 跑完后文件应该被自动修正。想临时关掉某个 Hook 做对比测试/hook disable PostToolUse再写一次文件这次不会被格式化。确认差异后重新启用/hook enable PostToolUse4.2 Skill 加载验证Skill 放在.claude/skills/下每个技能一个文件夹文件夹名用 kebab-case。最小结构只需要一个SKILL.md--- name: python-code-review description: 对 Python 代码进行 PEP8 规范审查、漏洞检测、可读性优化 version: 1.0.0 --- # Python 代码审查技能 ## 执行步骤 1. 读取待审查代码解析语法结构 2. 校验命名、缩进、注释规范 3. 检测潜在 bug 4. 输出结构化审查报告Skill 的核心是渐进式加载会话启动时只加载 YAML 元数据name description大概几十 Token当你的问题匹配到 description 里的关键词时才加载 SKILL.md 正文scripts/ 和 references/ 里的附件只在执行时按需读取。所以你放几十个 Skill 也不会撑爆上下文。验证加载直接问一个匹配 description 的问题比如“帮我审查这段 Python 代码的规范问题”。如果 Skill 生效Claude 会按 SKILL.md 里的步骤走而不是自由发挥。也可以手动加载/skill load ./.claude/skills/python-code-review/4.3 Subagent 调度验证Subagent 放在.claude/agents/下用 Markdown 定义YAML 头配属性正文是 System Prompt--- name: code-reviewer description: 独立进行代码审查不占用主会话上下文 tools: [Read, Grep, Glob] disallowedTools: [Write, Edit, Bash] model: claude-sonnet --- 你是一个独立的代码审查专家。深入理解指定模块的代码逻辑 检查潜在 bug、性能问题和安全隐患输出结构化审查报告。 审查过程的所有细节留在你自己的上下文中 只向主会话返回问题汇总 严重程度 建议修改方案。tools是白名单disallowedTools是黑名单。上面这个配置保证审查 Agent 只能读不能写不会误改代码。验证调度让主 Agent 派一个任务给 Subagent用 code-reviewer 子智能体审查 src/services/ 目录下的所有文件关键观察点是主对话的上下文长度。Subagent 在独立窗口里读了 20 个文件、做了大量分析但主对话里只出现一条精简摘要。这就是上下文隔离的价值——同样一个审查任务用 Skill 在主对话里跑50 个文件读下来 Token 消耗可能是 Subagent 的几十倍。想看 Subagent 的执行细节开调试模式DEBUGclaude:subagents claude4.4 Plugin 注册验证Plugin 是 Skill Subagent Hook 的打包集合。添加市场源并安装/plugin marketplace add superpowers-marketplace /plugin install superpowerssuperpowers-marketplace安装完成后插件里的 Skill、Subagent、Hook 会自动出现在对应目录。验证方式是列一下当前可用的技能和 Agent/skill list如果能看到插件带来的技能比如 systematic-debugging、writing-plans说明注册成功。Plugin 解决的是分发问题——团队里每个人装同一个插件工作流模板和调试规范就统一了不会出现“在我电脑上能跑”的情况。5. 全链路串起来一个任务走完四个机制光逐个验证还不够得看它们协同起来是什么样。假设你给 Claude Code 一个任务帮我审查这次提交的代码并生成对应的单元测试整个链路的执行顺序是这样的Plugin 层先提供能力——superpowers 插件里打包了 code-review 技能、test-generator 子智能体和格式化 Hook装一次就全有了。Hook 层在幕后执行——Claude 每次写文件PostToolUse 的 ESLint Hook 自动格式化你甚至感知不到它在跑。Skill 层执行标准化审查——code-review 技能被语义匹配激活按 SKILL.md 里定义的步骤逐项检查输出结构化报告。Subagent 层做独立分析——test-generator 子智能体在自己的上下文窗口里分析代码结构、生成测试用例最后只把摘要返回主对话。主对话最终整合结果给你。整个过程中Hook 不占上下文Skill 只在匹配时加载正文Subagent 的细节全留在独立窗口。四个机制各司其职主对话的 Token 消耗被压到很低。这里有个容易踩的坑如果你把代码审查写成 Skill 而不是 Subagent50 个文件读下来主上下文直接爆掉Auto-Compaction 一触发前面聊的关键信息全丢了。所以选型上记住一条——单点标准化任务用 Skill大批量探索任务用 Subagent。6. 本篇常见错排查配置跑不通的时候按下面这个顺序查基本能定位到问题。Hook 不触发先确认 settings.json 的 JSON 格式没问题用jq . ~/.claude/settings.json校验一下。然后确认 matcher 写对了——Write和write是区分大小写的。最后看脚本有没有执行权限chmod x .claude/hooks/block-dangerous.sh。Skill 不加载检查文件夹名是不是 kebab-caseSKILL.md是不是严格大写放在根目录。YAML 头里的name和description必须存在description 里的关键词要能匹配到你的提问方式。如果自动匹配不生效先用/skill load手动加载确认技能本身没问题。Subagent 调度失败确认.claude/agents/下的 Markdown 文件 YAML 头完整name和description不能少。如果报工具权限错误检查tools和disallowedTools有没有冲突——同一个工具不能既在白名单又在黑名单。Plugin 装不上市场源地址要写全/plugin marketplace add后面跟的是市场标识不是 URL。安装后如果技能没出现重启一次 Claude Code 让配置重新加载。接入层报 401 或 403回到第 2 步的 curl 验证确认 Key 有效、通道地址没写错。settings.json 里的ANTHROPIC_BASE_URL结尾不要带斜杠ANTHROPIC_API_KEY确认没有多余空格。Token 消耗异常高大概率是把该用 Subagent 的任务写成了 Skill。检查一下你的大批量任务是不是都在主对话里跑。另外确认 Skill 的渐进式加载有没有被破坏——如果 SKILL.md 正文写得过长每次匹配都会加载全部内容。7. 把接入层和扩展机制固定下来四个机制跑通之后最该做的一件事是把配置提交到 Git。.claude/settings.json、.claude/skills/、.claude/agents/、.claude/hooks/全部纳入版本控制团队新成员克隆项目后接入层和扩展能力一次性到位不用每个人重新配一遍。接入层这块统一用 TaoToken 的 Key 和通道四个机制共用一个入口排障时只需要查一个地方。如果你还没创建 Key去控制台建一个https://taotoken.net/api-keys配置细节和参数说明在接入文档里https://taotoken.net/doc想先验证模型通道是否正常可以直接在模型对话里发一条测试请求https://taotoken.net/models如果你打算长期用 Claude Code 做编码和 Agent 调度Coding Plan 里把接入层和扩展机制的配置模板都整理好了可以直接参考https://taotoken.net/coding-plan最后提醒一句Hook 从 PostToolUse ESLint 开始配这是回报最高的一步Subagent 优先于 Skill 用在批量任务上Token 账单的差别会很明显Plugin 先从社区现成的开始用跑通了再改造成团队自己的版本。
