1. 为什么 Claude Code 装了还要配 skillClaude Code 本身是一个能读写文件、跑命令、改代码的终端智能体但它的“默认技能包”其实很薄。刚装完的时候你让它查一下当前有哪些 skill它往往只能列出内置的几个比如文件读写、命令执行这类通用能力。真正让它从“能干活”变成“懂你项目规矩”的是 skill 技能配置。skill 是什么你可以把它理解成给 Claude Code 装的一份“岗位说明书”。一份 skill 通常包含一段描述告诉模型什么时候该用它、一套操作步骤告诉模型具体怎么做、以及可选的脚本或模板文件。比如你团队规定每次改完代码必须生成modify.patch和update.txt这个流程写成 skill 之后Claude Code 每次遇到类似任务就会自动按你的规范走而不是每次都要你在对话里重新交代一遍。这篇是系列第二篇聚焦 skill 的安装、目录结构、config.toml骨架以及怎么通过 TaoToken 的统一 Key 和 API 通道把模型请求接进来最后给一条可复制的验证命令确认技能真的被加载和调用了。适合已经装好 Claude Code、想扩展自定义技能的开发者。如果你还没装 Claude Code建议先看第一篇把基础环境跑通。我试过在离线编译服务器上折腾 skill踩过路径写错、配置没生效、模型通道没接上这几类坑下面按顺序讲清楚。2. TaoToken 前置统一 Key 与 API 通道Claude Code 要调用模型就得有一个稳定的 API 入口。TaoToken 在这里扮演的角色是统一 Key 和 API 通道你只需要在 TaoToken 控制台创建一个 API Key然后在 Claude Code 的配置里把 base URL 指向 TaoToken 的 API 地址就能让 skill 触发的模型请求走同一条通道不用在多个供应商之间来回切换配置。具体操作路径是这样的先到 TaoToken 控制台创建一个 API Key控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 创建完把 Key 复制出来。然后 API 的基础地址用 https://taotoken.net/api 注意这个地址后面不加 UTM 参数直接写进配置即可。如果你后面要做长期编码或者 Agent 类的自动化任务可以了解下 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它更适合高频调用场景。只是想先验证模型通不通用模型对话页面就够了https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。注意API Key 属于敏感凭证不要写进会提交到代码仓库的文件里。建议用环境变量注入或者放在本地不纳入版本管理的配置文件中。3. skill 目录结构与 config.toml 骨架Claude Code 的 skill 默认放在用户目录下的.claude/skills文件夹里。Windows 环境路径是C:\Users\你的用户名\.claude\skillsLinux 或 macOS 是~/.claude/skills。如果你在配置里指定过自定义 skill 路径那就以你指定的为准。每个 skill 是skills目录下的一个子文件夹文件夹名就是 skill 名。一个标准的 skill 目录结构大概是这样~/.claude/skills/ └── svn-diff-check/ ├── SKILL.md # 技能说明模型靠它判断何时调用 ├── config.toml # 技能级配置可选 ├── scripts/ │ └── gen_patch.sh # 可执行脚本 └── templates/ └── update.tpl # 输出模板SKILL.md是核心里面用自然语言写清楚这个技能干什么、什么时候用、步骤是什么。config.toml用来放技能级参数比如脚本路径、默认输出文件名、模型通道引用等。下面给一份config.toml骨架把 TaoToken 的通道配置也带进去# ~/.claude/skills/svn-diff-check/config.toml [skill] name svn-diff-check description 检测代码差异生成 patch 和更新说明 version 1.0.0 [model] # 统一走 TaoToken 的 API 通道 provider taotoken base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY # 从环境变量读取不硬编码 model claude-sonnet [output] patch_file modify.patch update_file update.txt encoding utf-8 [scripts] gen_patch scripts/gen_patch.sh这里api_key_env指向环境变量名实际 Key 通过环境变量注入。Linux/macOS 下可以这样设置export TAOTOKEN_API_KEY你的KeyWindows PowerShell$env:TAOTOKEN_API_KEY你的Key设置完之后Claude Code 在调用 skill 时就会读取这个环境变量把请求发到 TaoToken 的 API 地址。这样 skill 和模型通道就解耦了换 Key 不用改 skill 文件。4. 可复制配置从安装到接入的完整步骤先说在线安装。如果你的环境能访问 GitHub启动 Claude Code 后在对话里输入/plugin marketplace add anthropics/skills /plugin install example-skillsanthropic-agent-skills这两条命令会拉取官方 skill 市场并安装示例技能包。装完之后让 Claude 查一下当前 skill 列表确认是否增加。如果开发环境不能连外网就走本地安装。从官方仓库https://github.com/anthropics/skills下载 skill 文件夹解压后整个文件夹放到~/.claude/skills下。放好后让 Claude 重新查询 skill正常情况下新技能就会出现。如果没有出现直接把问题反馈给 Claude它会一步步帮你排查路径和权限。本地安装完成后你会看到官方包里带了一个skill-creator它的作用就是帮你创建新 skill。下面用“代码改动检测 生成更新说明”这个真实需求走一遍创建流程。第一步验证 Claude 能不能自动检测代码改动。在代码路径下启动 Claude Code让它执行svn st看差异然后把差异整理成modify.patch。命令大意是当前路径下执行 svn st把新增和修改的代码生成一个 modify.patch 文件Claude 会跑命令、读差异、输出 patch 文件格式符合要求就说明检测能力没问题。第二步验证更新说明生成。继续在对话里输入根据这个 patch 的修改点帮我整理一个更新说明输出到 update.txtClaude 会输出update.txt描述详细、格式规整。这两步都通过后再让它把整个流程固化成 skill不要一上来就生成 skill那样改起来效率低。第三步生成 skill。对话里输入将这个差异对比并生成 patch 和更新说明的功能制作一个标准的 skill名字叫 svn-diff-check过程中可能会弹权限确认允许即可。skill 制作完成后 Claude 会自动测试验证。第四步实际使用。让 Claude 查询 skill 列表确认svn-diff-check已存在。然后跑一次真实任务观察它是否自动调用这个 skill。实测下来用了 skill 之后生成 patch 和更新说明的速度明显更快输出格式也更稳定。5. 验证请求与成功结果配置写完得有一条能直接复制、确认技能被正确加载和调用的命令。最直接的方式是在 Claude Code 对话里查询 skill 列表查询下所有的 skill罗列下如果svn-diff-check出现在列表里说明 skill 已被加载。接下来验证调用在代码路径下输入用 svn-diff-check 技能检测当前改动生成 patch 和更新说明成功的标志有三个终端里能看到 Claude 读取了SKILL.md的描述、执行了scripts/gen_patch.sh、并在当前目录生成了modify.patch和update.txt。打开update.txt内容应该按模板格式分点描述改动而不是一段散乱的文字。如果你想单独验证 TaoToken 通道是否通可以用 curl 发一条最小请求curl -s https://taotoken.net/api/v1/messages \ -H Content-Type: application/json \ -H x-api-key: $TAOTOKEN_API_KEY \ -d { model: claude-sonnet, max_tokens: 64, messages: [{role: user, content: ping}] }返回里有正常的模型响应内容就说明 Key 和通道都没问题。这一步和 skill 验证分开做能快速定位是通道问题还是 skill 配置问题。6. 本篇常见错排查skill 放了但列表里没有。先确认文件夹层级对不对必须是skills/技能名/SKILL.md不能多套一层。再确认SKILL.md文件名大小写Linux 下大小写敏感。最后检查自定义 skill 路径有没有在配置里覆盖默认路径。config.toml 改了不生效。Claude Code 一般在启动时读取配置改完要重启会话。另外 TOML 语法对缩进和引号敏感api_key_env写成了实际 Key 字符串而不是环境变量名也会导致读取失败。模型请求 401 或 403。多半是环境变量没设对或者 Key 复制时带了空格。用echo $TAOTOKEN_API_KEY确认变量有值再确认 base URL 写的是https://taotoken.net/api没有多余斜杠或参数。skill 被加载但不自动调用。问题通常出在SKILL.md的描述太模糊。模型靠描述判断“这个任务该不该用这个技能”描述里要写清楚触发场景比如“当用户要求检测代码差异并生成更新说明时使用”。脚本执行权限不足。Linux/macOS 下给脚本加执行权限chmod x scripts/gen_patch.sh。Windows 下确认脚本用对应解释器调用别直接当可执行文件跑。排障过程中如果怀疑是接入层的问题可以去接入文档对照配置https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。需要重新生成或管理 Key去 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你用的是 Claude Code 的 Anthropic 兼容模式参考这个页面https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后提醒一句skill 做出来之后别急着让它自动提交代码。代码提交涉及审核保留人工确认这一步更稳妥。skill 负责把 patch 和说明生成好提交动作交给人来做这样既省了重复劳动又不会绕过流程。
