1. 为什么要在 Claude Code 里装 skill-creator
如果你已经在用 Claude Code 写代码，大概率会遇到一个尴尬：每次让它按固定套路干活，都得把同一段提示词重新贴一遍。比如「先读项目结构，再按我们的命名规范生成组件，最后补单元测试」——这套流程你说了十遍，它还是记不住。skill-creator 就是来解决这件事的：它把「一套可复用的工作流」封装成一个技能（skill），之后你在 Claude Code 里用/技能名就能直接调用，不用再重复描述。
skill-creator 本身是 Anthropic 官方 skills 仓库里的一个技能，作用是「帮你生成技能」。你告诉它你想要什么能力，它会自动在~/.claude/skills/下生成对应的目录结构、SKILL.md描述文件和辅助脚本。适合谁？适合需要把重复性开发流程固化下来的开发者，比如前端组件生成、接口联调模板、日志排查套路、代码审查清单这类高频动作。
这篇要解决的核心链路是：Claude Code 已经装好 → 通过统一 Key/API 通道接入模型 → 安装 skill-creator → 用 settings.json 固化配置 → 创建技能 → 验证技能真的被识别并生效。很多人卡在最后一步：技能文件生成了，但/skill列表里看不到，或者调用报错。下面把每一步拆开讲，配置可以直接复制。
2. 前置准备：TaoToken 统一 Key 与 API 通道
Claude Code 要跑起来，得有一个能访问模型的通道。我这边用的是 TaoToken 的统一 Key 方案，好处是一个 Key 走通对话、编码、Agent 几类场景，不用为每个工具单独配一套凭证。官网入口在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，注册后在控制台生成 API Key。
拿到 Key 之后，Claude Code 需要知道两件事：请求发到哪个地址、用哪个 Key。TaoToken 的 API 基地址是 https://taotoken.net/api ，注意这个地址不带任何查询参数，直接作为 base URL 使用。Key 的获取页面在 https://taotoken.net/api-keys ，登录后可以创建、复制、吊销 Key。
这里有个容易踩的坑：Claude Code 读的是环境变量和settings.json两层配置，环境变量优先级更高。如果你在 shell 里 export 了一个旧的 Key，又在 settings.json 里写了新的，实际生效的是环境变量那个。排查「Key 明明换了却还报鉴权失败」时，先echo $ANTHROPIC_API_KEY看一眼当前 shell 里有没有残留。
注意：不要把 Key 硬编码进会提交到 Git 的文件里。settings.json 如果放在项目目录下，记得加进
.gitignore；更稳妥的做法是放在用户级配置~/.claude/settings.json，只对本机生效。
3. 可复制的 settings.json 配置骨架
Claude Code 的配置文件分两级：用户级~/.claude/settings.json和项目级.claude/settings.json。技能开发环境建议放用户级，这样在任何项目目录下都能用。下面是一份可以直接抄的骨架，把sk-你的Key换成自己在 https://taotoken.net/api-keys 生成的那串。
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-你的Key", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514" }, "permissions": { "allow": [ "Bash(npx skills:*)", "Read(~/.claude/skills/**)", "Write(~/.claude/skills/**)" ] }, "includeCoAuthoredBy": false }逐段解释一下。env块里三个变量是核心：ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址，ANTHROPIC_API_KEY放你的 Key，ANTHROPIC_MODEL指定默认模型。模型名按你实际可用的填，不确定就先留空让它走默认。permissions.allow是给技能安装和读写放行——npx skills是安装 skill-creator 用的命令，Read/Write ~/.claude/skills/**是让 Claude Code 能读写技能目录，否则创建技能时会卡在权限确认上。
includeCoAuthoredBy设成 false 是个人习惯，避免提交信息里带一堆署名噪音，你可以按团队规范决定。改完配置后，重启 Claude Code 会话让它重新加载。验证配置有没有被读到，可以在 Claude Code 里问它「当前 ANTHROPIC_BASE_URL 是什么」，或者直接看启动时有没有鉴权报错。
如果你更习惯用环境变量而不是写进 settings.json，等价写法是这样：
export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_API_KEY="sk-你的Key" export ANTHROPIC_MODEL="claude-sonnet-4-20250514"写进~/.zshrc或~/.bashrc后source一下。但记住前面说的优先级问题：环境变量会盖过 settings.json，两处别写冲突的值。
4. 安装 skill-creator 并创建第一个技能
配置就绪后，进入 Claude Code 会话。打开终端输入claude回车，进入交互界面。安装 skill-creator 的命令是：
npx skills add anthropics/skills --skill skill-creator这条命令会从 Anthropic 的 skills 仓库拉取 skill-creator 并装到本地技能目录。执行过程中会提示确认，按提示走完。装完后，在 Claude Code 对话框里输入/skill，还没输完就能看到补全列表里出现skill-creator，说明它已经被识别到了。这一步是判断安装成功最直接的信号——如果/skill后面什么都没有，多半是安装路径不对或权限没放行。
接下来创建技能。在对话框里输入/skill-creator加上你的需求描述，比如：
/skill-creator 创建一个技能，功能是读取当前项目的 package.json，列出所有 dependencies 并按字母排序输出skill-creator 会跟你确认技能名称、触发方式、需要哪些工具权限，然后自动在~/.claude/skills/下生成目录。生成的结构大致是这样：
~/.claude/skills/ └── list-deps/ ├── SKILL.md └── scripts/ └── list_deps.shSKILL.md是技能的核心描述文件，里面写了这个技能叫什么、什么时候触发、执行什么逻辑。scripts/下放辅助脚本。你可以直接打开SKILL.md改描述，让它更贴合你的实际用法。改完保存，Claude Code 下次会话就会加载新版本。
5. 验证技能是否真的生效
技能创建完不等于生效，得验证。第一步，重新进 Claude Code 或新开一个会话，输入/看补全列表里有没有你刚建的技能名（比如list-deps）。能看到，说明技能被扫描到了。
第二步，实际调用一次。输入/list-deps，看它有没有按你描述的逻辑执行。如果它读出了 package.json 并排序输出，链路就通了。如果报「技能不存在」或「无权限执行」，往下看排查部分。
第三步，检查文件落盘。在终端里跑：
ls -la ~/.claude/skills/ cat ~/.claude/skills/list-deps/SKILL.md确认目录和文件都在，且SKILL.md里的 frontmatter（通常是name和description字段）格式正确。frontmatter 写错是技能不被识别的常见原因，比如少了闭合的---，或者name里带了空格。
第四步，验证模型通道是否正常。如果技能逻辑本身要调模型，而你又遇到超时或鉴权错误，可以单独测一下通道。在 Claude Code 里直接对话，或者用模型对话页面 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 发一条消息，确认 Key 和 base URL 没问题。通道正常但技能不生效，问题就在技能文件本身；通道就不通，先回去检查 settings.json。
6. 本篇常见错误排查
报错一：/skill补全列表为空。先确认npx skills add那步有没有真的成功，终端里有没有报网络或权限错误。然后检查~/.claude/skills/目录是否存在、里面有没有内容。如果目录是空的，说明安装没落盘，重跑安装命令。如果目录有内容但列表还是空，检查SKILL.md的 frontmatter 格式。
报错二：鉴权失败 401。九成是 Key 问题。去 https://taotoken.net/api-keys 确认 Key 没过期、没被吊销，然后检查 settings.json 和环境变量里有没有两个不同的 Key 在打架。echo $ANTHROPIC_API_KEY和cat ~/.claude/settings.json对比一下。另外确认ANTHROPIC_BASE_URL写的是https://taotoken.net/api，末尾不要多加斜杠或路径。
报错三：技能调用时提示无权限。回到 settings.json 的permissions.allow，确认Read(~/.claude/skills/**)和Write(~/.claude/skills/**)都在。如果技能脚本要执行 shell 命令，还得放行对应的Bash(...)规则。权限是白名单机制，没列出来的操作会被拦。
报错四：技能生成了但逻辑不对。这通常是SKILL.md里的描述太模糊，模型理解偏了。打开文件，把触发条件和执行步骤写具体，比如「当用户输入 /list-deps 时，读取项目根目录的 package.json，提取 dependencies 字段的键，按字母升序排列，每行输出一个」。描述越明确，执行越稳定。
报错五：改了 SKILL.md 但没生效。Claude Code 在会话启动时加载技能，改完文件要新开会话或重启才读得到。别在当前会话里反复试，先退出再进。
7. 把技能开发流程固化下来
跑通一遍之后，你会发现真正省事的地方在于：以后新增技能不用再手动建目录、写 frontmatter，直接/skill-creator描述需求就行。如果你要长期做技能开发和 Agent 类工作，可以考虑用 Coding Plan 这类面向持续编码场景的方案，入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，配合统一 Key 减少多工具切换的配置成本。
接入相关的完整说明在文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，遇到配置细节可以对照查。Claude Code 侧的接入参考 https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，里面有 base URL 和 Key 的对应写法。
最后留一个我自己的习惯：每建一个新技能，先在~/.claude/skills/下git init一个本地仓库，把技能文件纳入版本管理。这样改坏了能回滚，换机器也能同步。技能目录本身不大，但攒多了就是一套你自己的开发工作流资产，值得管起来。
