1. 四类扩展机制到底在解决什么问题Claude Code 用久了会遇到一个分水岭一开始你只是让它读代码、改文件、跑命令感觉像个聪明的终端助手但当你想让它遵守团队规范、访问外部系统、复用一套固定流程、或者在每次写文件后自动跑检查时单靠对话就不够了。这时候需要的是扩展机制而 Claude Code 恰好提供了四类Skill、MCP、Plugin、Hook。它们名字都挺唬人但定位差异其实很清楚选错了会浪费大量 token 或者根本达不到预期效果。先把这四类机制用一句话说清楚。Skill 是「可复用的说明、知识和流程」本质是渐进式披露的 Markdown 加资源文件Claude 平时只加载名称和描述匹配到相关任务才读完整内容。MCP 是「连接外部服务和数据的开放协议」让 Claude 能查数据库、发 Slack、控制浏览器、访问 GitHub。Plugin 是「把多个自定义项打包成可分发单元」把斜杠命令、子代理、MCP 配置、Hook、Skill 捆成一个可安装的包。Hook 是「基于事件触发的确定性脚本」不经过 LLM 判断触发器一到就执行比如每次编辑文件后跑 ESLint。这四者的核心区别在于「谁来做决定」。Skill 和 MCP 是给模型提供能力或知识模型自己判断要不要用Hook 是确定性的事件触发就执行模型没有否决权Plugin 是分发层本身不提供新能力而是把其他几类打包。理解这条主线选型就不会乱。我见过最常见的误用是把该用 Hook 的事情写成 Skill。比如「每次写完文件都要跑格式化」如果你写成 Skill 里的一句说明模型可能记得也可能忘尤其在长对话里注意力会漂移。但写成 PostToolUse Hook只要 Write 工具被调用脚本一定执行这才是确定性自动化该有的样子。反过来把「如何做代码审查」这种需要判断和上下文的工作流写成 Hook 也不合适因为 Hook 不理解代码语义它只能跑固定命令。还有一个容易混淆的点是 Skill 和 CLAUDE.md。CLAUDE.md 是每次对话都会加载的持久上下文适合放「始终执行 X」这类项目惯例比如「请使用 pnpm 而不是 npm」。但 CLAUDE.md 内容一多就会持续占用上下文而且它是全量加载的。Skill 则是按需加载元数据只占 30 到 50 token匹配到才读全文适合放那些只在特定任务里才需要的专业知识和流程。所以判断标准很简单如果这条规则每次对话都必须生效放 CLAUDE.md如果只在做某类任务时才需要做成 Skill。面向需要在真实项目中组合使用它们的开发者这篇会交付一份可复制的选型对照表、每类机制的最小配置示例以及逐项验证动作。你可以跟着一步步配配完就知道某个需求到底该落到哪种机制上。下面先从接入准备讲起因为不管用哪类扩展你都需要一个稳定的模型接入点来跑通验证。2. 接入准备用 TaoToken 打通 Claude Code 的模型通道在折腾扩展机制之前得先保证 Claude Code 本身能正常跑起来。Claude Code 默认走 Anthropic 官方通道但很多开发者的网络环境和账号条件不一定顺畅这时候可以用兼容 Anthropic 接口的接入服务来替代。TaoToken 提供的就是这样一个入口官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 它兼容 Anthropic 的 Messages 接口格式Claude Code 可以直接对接。这里要强调一点TaoToken 是合规的 API 接入服务不是所谓的「中转」或灰色通道它提供的是标准的模型调用能力。你用它来跑 Claude Code本质上和用官方 API 是一样的只是接入地址和鉴权方式不同。配置的时候把 Base URL 指向 TaoToken 的 API 地址Key 用你在控制台生成的令牌Model ID 填你套餐里支持的模型名这三件套齐了就能通。具体操作上先去控制台创建 API Key。打开 https://taotoken.net/console 登录后进入 API Keys 页面点创建新密钥复制出来保存好这个 Key 只显示一次。然后确认你要用的模型 ID可以在模型对话页面 https://taotoken.net/model-chat 里先试一下看看哪些模型可用、响应是否正常。如果你打算长期用 Claude Code 做编码和 Agent 任务可以看下 Coding Plan https://taotoken.net/coding-plan 它针对编码场景做了额度优化比按量计费更适合高频使用。配置 Claude Code 的时候环境变量是最直接的方式。在终端里设置ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY然后启动 Claude Code 即可。如果你用的是 Claude Code 的配置文件方式也可以写进 settings.json。这里给一个环境变量的写法Linux 和 macOS 下export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的TaoToken密钥Windows PowerShell 下$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_API_KEYsk-你的TaoToken密钥设置完之后运行claude启动随便问一句「你好帮我看看当前目录有哪些文件」如果它能正常调用工具并返回结果说明通道打通了。这一步很关键因为后面所有扩展机制的验证都依赖这个基础通道。如果这里就不通先别急着配 Skill 和 MCP先把接入问题解决掉。关于模型选择Claude Code 对模型的工具调用能力有要求建议选支持 function calling 的模型。你可以在模型对话页面先测一下工具调用是否正常再放到 Claude Code 里用。另外TaoToken 的接入文档在 https://taotoken.net/doc 里面有更详细的参数说明和示例遇到鉴权或路径问题可以对照查。接入准备好之后就可以开始逐个配置四类扩展机制了。下面按 Skill、MCP、Hook、Plugin 的顺序给最小可复制配置每类都配一个验证动作确保你配完能立刻知道有没有生效。3. 四类机制的最小可复制配置这一节是全文的核心每一类机制我都给一份能直接复制的最小配置路径和原文保持一致你照着放到对应位置就能用。配完先别急着组合逐个验证通过再往下走。3.1 Skill 的最小配置Skill 存放在.claude/skills/目录下每个 Skill 一个文件夹里面至少有一个SKILL.md。Claude 启动时只扫描名称和描述匹配到相关任务才加载完整内容。下面是一个「部署检查清单」Skill 的最小示例。目录结构.claude/skills/deploy-check/ └── SKILL.mdSKILL.md内容--- name: deploy-check description: 部署前检查清单包含环境变量、数据库迁移、回滚方案三项确认。当用户提到部署、上线、release 时使用。 --- # 部署检查清单 执行部署前逐项确认以下内容 1. 环境变量确认 .env.production 中的数据库连接串、API Key 已更新。 2. 数据库迁移运行 pnpm db:migrate 并确认无报错。 3. 回滚方案确认上一个版本的镜像 tag 已记录可随时回滚。 全部确认后输出一份检查结果表格。这个 Skill 的元数据只有名称和描述大约 40 token平时不占上下文。当你让 Claude「帮我准备部署」时它匹配到描述里的关键词才会加载完整清单。验证动作在 Claude Code 里输入「我要部署了帮我检查一下」看它是否输出三项检查清单。如果没触发检查description里有没有包含你实际会说的关键词。3.2 MCP 的最小配置MCP 配置一般写在~/.claude/settings.json或项目级的.mcp.json里。下面给一个 filesystem MCP 的最小配置让 Claude 能安全地访问指定目录。{ mcpServers: { filesystem: { command: npx, args: [ -y, modelcontextprotocol/server-filesystem, /path/to/allowed/dir ] } } }把/path/to/allowed/dir换成你实际允许访问的目录。这个配置启动后Claude 会多出一组文件操作工具但只能在你指定的目录里操作这是 MCP 的权限控制设计。验证动作重启 Claude Code输入「列出 /path/to/allowed/dir 下的文件」看它是否通过 MCP 工具返回结果。如果报错找不到命令确认本机装了 Node.js 和 npx。这里要提醒一个坑MCP 的工具定义会消耗 token。原文提到58 个工具的五台服务器架构在任何对话开始前就会消耗超过 55000 个 token。所以别一次性装一堆 MCP只装当前项目真正需要的。常用的是 GitHub、Filesystem、Context7、Playwright、PostgreSQL、Sequential Thinking 这几个按需选。3.3 Hook 的最小配置Hook 配置写在.claude/settings.local.json里基于事件触发。下面给一个 PostToolUse Hook每次 Write 工具执行后跑一次 ESLint。{ hooks: { PostToolUse: [ { matcher: Write, command: npx eslint --fix $FILE } ] } }可选的 Hook Points 有 PreToolUse工具调用前可阻塞、PostToolUse工具执行后、权限请求出现权限对话框时、SessionStart会话开始时。验证动作让 Claude 创建一个新文件观察终端是否自动跑了 ESLint。如果没跑检查matcher是否匹配工具名以及命令路径是否正确。Hook 的价值在于确定性。它不经过 LLM 判断触发器一到就执行适合质量门控、通知日志、自动格式化、CI/CD 集成。但要注意Hook 命令失败可能会阻塞流程所以脚本本身要健壮别写一个动不动就报错的命令。3.4 Plugin 的最小配置Plugin 是把多个自定义项打包成可分发单元结构如下my-plugin/ ├── .claude-plugin/ │ └── plugin.json ├── commands/ ├── agents/ ├── skills/ ├── hooks/ ├── .mcp.json └── README.mdplugin.json放元数据和配置。安装方式/plugin install github.com/username/my-plugin /plugin list /plugin disable my-pluginPlugin 适合团队标准化和分发比如你们团队有一套固定的代码审查流程包含斜杠命令、子代理、Hook 和 Skill打包成一个 Plugin新成员一条命令就能装上。验证动作安装后运行/plugin list确认插件在列表里然后调用它提供的斜杠命令看是否生效。四类配置都配完之后建议先单独验证每一类再组合使用。组合的时候注意 token 预算MCP 和 Skill 都会占上下文Hook 和 Plugin 本身不直接占但 Plugin 里打包的 MCP 和 Skill 会占。下面一节讲怎么验证请求和排查常见错误。4. 逐项验证与成功结果判断配完不等于生效得逐项验证。这一节给每类机制的验证动作和成功结果判断标准你照着做一遍就知道哪类配对了、哪类还有问题。Skill 的验证在 Claude Code 里说一句会触发描述关键词的话比如「帮我准备部署」。成功结果是它输出你在SKILL.md里定义的检查清单。如果它没触发先确认.claude/skills/路径对不对再确认description里的关键词是不是你实际会说的。Skill 是相关性匹配描述写得太窄或太宽都不好。我试过把描述写得太泛结果每次对话都触发反而干扰写得太窄又从来不触发。建议描述里包含 2 到 3 个具体场景词。MCP 的验证重启 Claude Code 后输入一个需要外部数据的请求比如「列出允许目录下的文件」。成功结果是它通过 MCP 工具返回文件列表而不是说「我无法访问文件系统」。如果报local proxy failed或连接错误检查 MCP server 的命令是否能独立跑起来先在终端手动执行npx -y modelcontextprotocol/server-filesystem /path看有没有报错。Hook 的验证让 Claude 写一个文件观察终端输出。成功结果是 ESLint 自动执行并输出结果。如果没执行检查.claude/settings.local.json的 JSON 格式是否正确Hook 配置对格式很敏感少一个括号就不生效。另外确认matcher的工具名大小写和实际一致。Plugin 的验证运行/plugin list看是否列出再调用它提供的命令。成功结果是命令正常执行。如果安装失败检查 GitHub 仓库地址是否可访问以及plugin.json格式是否正确。组合验证的时候建议按「Hook 优先、Skill 次之、MCP 按需、Plugin 最后打包」的顺序。因为 Hook 是确定性的先保证自动化跑通Skill 提供知识再保证模型知道怎么做MCP 提供外部能力按项目需要加Plugin 是分发层等前面都稳定了再打包。这样排查问题时层次清晰不会一锅乱。成功结果还有一个隐性判断标准token 消耗是否合理。如果你发现对话还没开始就消耗了大量 token多半是 MCP 装多了。回到配置里删掉不用的 MCP server只留必要的。Skill 的元数据消耗很小一般不用担心但如果 Skill 数量上百元数据累积也会占一些定期清理不用的 Skill。验证通过之后你就有了一套能跑的扩展组合。但实际使用中还是会遇到报错下面一节把常见错误和排查方法列出来对照着查能省不少时间。5. 常见报错与排查对照扩展机制用起来之后报错是难免的。这一节把四类机制最常见的报错和排查方法列出来你遇到问题时对照着查。每个报错都给真实的表现和对应的解决动作。401 鉴权失败是最常见的接入问题。表现是 Claude Code 启动后任何请求都返回 401。原因通常是 API Key 没设对或者 Base URL 写错了。排查动作确认ANTHROPIC_API_KEY是 TaoToken 控制台生成的完整 Key没有多余空格确认ANTHROPIC_BASE_URL是https://taotoken.net/api结尾没有多余的斜杠。如果还不行去模型对话页面用同一个 Key 测一下能通说明 Key 没问题问题在 Claude Code 的配置。local proxy failed通常出现在 MCP 场景。表现是 Claude 调用 MCP 工具时报连接失败。原因是 MCP server 进程没起来或者命令路径不对。排查动作在终端手动执行 MCP 配置里的command和args看能否独立启动。如果手动能跑但 Claude 里不行检查 settings.json 的 JSON 格式以及 npx 是否在 PATH 里。reading choices这类报错一般和模型响应格式有关。表现是请求发出后解析响应失败。原因可能是模型 ID 填错或者该模型不支持工具调用。排查动作确认 Model ID 是 TaoToken 支持的、且具备 function calling 能力的模型。可以在模型对话页面先测工具调用再放到 Claude Code 里。OAuth 相关报错出现在 Plugin 安装或 MCP 连接需要鉴权的服务时。表现是提示授权失败或 token 过期。排查动作检查对应服务的 token 是否有效比如 GitHub MCP 需要GITHUB_TOKEN确认 token 有对应权限且没过期。Plugin 安装如果走 GitHub确认仓库是公开的或者你有访问权限。Hook 不执行也是高频问题。表现是配了 Hook 但触发时没反应。排查动作先确认.claude/settings.local.json是合法 JSON可以用cat .claude/settings.local.json | python -m json.tool验证再确认matcher的工具名和实际调用一致最后确认命令本身能独立跑通。Skill 不触发的问题前面提过核心是描述关键词。如果确认路径和格式都对但还是不触发试着把描述改得更贴近你的实际说法或者临时把描述写宽一点测试触发后再收窄。排查的时候有个通用思路先隔离再组合。把出问题的机制单独拿出来用最小配置验证通了再放回组合里。这样能快速定位是机制本身的问题还是组合冲突。另外TaoToken 的接入文档 https://taotoken.net/doc 里有接口层面的说明遇到鉴权和路径问题可以对照查。6. 选型决策与后续接入把四类机制过一遍之后选型其实可以归纳成一张对照表。下面这张表把每类机制的定位、适用场景、配置位置和验证动作列在一起你可以直接拿去对照自己的需求。机制定位适用场景配置位置验证动作Skill可复用说明与流程重复任务、专业知识、检查清单.claude/skills/说触发词看是否加载清单MCP连接外部服务访问数据库、GitHub、浏览器、API~/.claude/settings.json请求外部数据看是否返回Hook事件触发确定性脚本质量门控、格式化、通知、CI/CD.claude/settings.local.json触发事件看脚本是否执行Plugin打包分发单元团队标准化、工作流分享安装后/plugin管理/plugin list看是否列出选型的判断顺序可以这样走先问「这个需求需要模型判断吗」。如果不需要判断、只要事件触发就执行选 Hook。如果需要模型理解上下文并决定怎么做再问「这是知识流程还是外部能力」。知识流程选 Skill外部能力选 MCP。如果这套东西要分发给团队或跨项目复用最后用 Plugin 打包。举个实际例子。团队要求「每次提交前跑测试并格式化」这是确定性动作选 Hook配 PreToolUse 或 PostToolUse。团队要求「代码审查时按这份清单逐项检查」这是需要模型判断的知识流程选 Skill。团队要求「审查时能查 Jira 上的关联 issue」这是外部能力选 MCP。这三样打包成一个「团队审查套件」选 Plugin 分发。四类机制各司其职组合起来才顺。后续接入方面如果你还没配好模型通道先去 https://taotoken.net/api-keys 生成 Key再对照 https://taotoken.net/doc 的文档配置 Claude Code。想先验证模型能力可以去 https://taotoken.net/model-chat 试一下工具调用。如果打算长期用 Claude Code 做编码和 Agent 任务Coding Plan https://taotoken.net/coding-plan 在额度上更适合高频场景。Claude Code 相关的接入细节可以参考 https://taotoken.net/claude-code 。最后给一个实用建议别一上来就把四类机制全配上。先用 Hook 解决一个具体的自动化需求跑通之后再考虑 Skill然后按需加 MCP最后才打包 Plugin。每加一类都验证一遍确保 token 消耗和实际收益匹配。扩展机制是为了让 Claude Code 更贴合你的工作流不是为了堆配置。配得少但配得准比配一堆用不上的强。