1. 从 SkillHub 逛一圈回来，为什么你的 Claude 和 Codex 还是跑不通
你大概已经知道 Skill 是什么了。一句话说，Skill 就是给 AI 的办事说明书，它把「遇到这类任务该按什么步骤做、用哪个工具、注意哪些坑」提前写清楚，让 Claude、Codex 这类工具不用每次从零听你讲规则。SkillHub 上那些写作类、办公类、编程类 Skill，看一圈确实很直观，你会觉得「原来 AI 还能这么用」。
但真正动手的人会卡在下一步：Skill 文件下载好了，Claude Code 里怎么让它生效？Codex 那边又该怎么配？更现实的问题是，Claude 和 Codex 各自要一套 Key、一套 Base URL、一套环境变量，你只是想验证一个 Skill 调用，结果光在账号和密钥上就折腾半天。我见过太多人 SkillHub 逛得很开心，回到终端就懵了。
这篇就解决这个断层。目标很明确：用 TaoToken 的统一 Key，把 Claude 和 Codex 的 Skill 调用一次性跑通，让你在 SkillHub 逛完后能立刻验证第一个 Skill 示例。适合刚接触 Claude、Codex、MCP 的开发者，不需要你先把每个工具的文档啃完。
核心检索词先摆出来：Skill 是给 AI 的任务说明书，SkillHub 是现成 Skill 的展示和分享社区，而 TaoToken 是帮你把 Claude 与 Codex 的调用入口统一起来的那层配置。三者关系理顺了，后面就顺了。
先说清楚 Skill 和 MCP 的边界，避免混淆。Skill 管的是「怎么做」，是一份流程和规则；MCP 管的是「能接什么工具」，是让 AI 连上外部能力的插座。你可以同时用 Skill 规定步骤、用 MCP 提供工具，但它们是两层东西。这篇聚焦 Skill 调用跑通，MCP 只在你需要接工具时再展开。
为什么强调「统一 Key」？因为 Claude Code 和 Codex 的配置格式不一样。Claude Code 走环境变量和 settings 文件，Codex 走 auth.json 和 config.toml。如果你分别去搞两套密钥，验证一个 Skill 的时间成本会翻倍。TaoToken 提供统一的 API 入口，你只需要维护一份 Key，分别填进两个工具的配置里，就能让它们都指向同一个调用通道。这样你验证 Skill 时，注意力能放在 Skill 本身，而不是密钥管理。
下面按顺序来：先讲清楚 Skill 在 Claude 和 Codex 里分别长什么样、放在哪，再给 TaoToken 的前置准备，然后是可复制的配置片段，接着是一次真实的 Skill 调用验证，最后把常见报错逐个拆掉。你跟着做，半小时内应该能看到第一个 Skill 跑起来的结果。
2. TaoToken 前置准备：统一 Key 与 Claude、Codex 的 Skill 目录约定
在写配置之前，先把两件事定下来：TaoToken 的 Key 怎么拿，以及 Claude 和 Codex 各自把 Skill 放在哪个目录。这两件事不清楚，后面配置填错路径就会一直报错。
先说 TaoToken 这边。你需要一个统一 Key，它同时用于 Claude 和 Codex 的调用。获取入口在控制台的 API Keys 页面，登录后新建一个 Key，复制出来保存好。这个 Key 就是你后面所有配置里填的凭证。注意，Key 只在创建时完整显示一次，丢了就重新建一个，别到处找。
TaoToken 的 API 入口是 https://taotoken.net/api ，所有请求都走这个 Base URL。Claude Code 和 Codex 的配置里，Base URL 都填这个，不要带多余的路径后缀。模型对话、Coding Plan、控制台、API Keys、接入文档这些入口，你按需访问即可，本文重点用 API Keys 和接入文档。
再说 Skill 的目录约定，这是很多人跑不通的根因。Claude Code 的 Skill 放在项目根目录下的.claude/skills/里，每个 Skill 一个子目录，目录名就是 Skill 名，里面至少有一个SKILL.md描述文件。Codex 这边，Skill 和项目规则、插件配合使用，通常放在项目根目录的.codex/相关目录下，具体以你使用的 Codex 版本为准，核心是让 Codex 能读到 Skill 说明和项目规则文件。
这里有个容易踩的坑：Skill 目录是项目级的，不是全局的。你在 A 项目里配好的 Skill，切到 B 项目不会自动生效。所以验证 Skill 时，先固定在一个项目目录里操作，别一边切项目一边怀疑配置。
Claude Code 的配置分两层：环境变量负责认证和 Base URL，settings 文件负责模型和其他行为。环境变量里最关键的是ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN，前者填 TaoToken 的 API 地址，后者填你的统一 Key。settings 文件里指定模型 ID，这个模型 ID 要和 TaoToken 支持的模型对上。
Codex 的配置走auth.json和config.toml。auth.json里放 Key，config.toml里放 Base URL 和模型 ID。三件套必须齐全：Base URL、Key、Model ID，缺一个都会在请求阶段失败。很多人只填了 Key 忘了 Base URL，结果请求打到默认地址，报 401 或者连接失败。
把这三件套记牢：Base URL 是 https://taotoken.net/api ，Key 是你刚建的统一 Key，Model ID 是你实际要调用的模型标识。Claude 和 Codex 的配置里都要出现这三样，只是文件位置和字段名不同。
还有一点，Skill 本身不负责认证。Skill 是任务说明，它不会帮你带 Key。认证永远在工具层的配置里完成。所以「Skill 跑不通」很多时候不是 Skill 写错了，而是工具的 Key 或 Base URL 没配对。先把工具层调通，再谈 Skill 逻辑。
准备阶段做完，你应该手上有：一个 TaoToken 统一 Key、确认好的项目目录、知道 Claude 的.claude/skills/和 Codex 的 Skill 位置。接下来进入配置环节。
3. 可复制配置：Claude settings 与 Codex auth.json 三件套
这一节给可直接复制的配置片段。路径和字段名按你实际环境来，别照抄路径里的用户名。先配 Claude，再配 Codex，两边都指向 TaoToken 的统一入口。
Claude Code 这边，先设环境变量。在终端里执行，或者写进你的 shell 配置文件里持久化：
export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_AUTH_TOKEN="你的TaoToken统一Key"这两行是认证和入口，必须对。ANTHROPIC_BASE_URL不要加/v1之类的后缀，就填到/api。ANTHROPIC_AUTH_TOKEN填你复制的 Key，注意别把引号也复制进去。
然后是 Claude Code 的 settings 文件。项目根目录下建.claude/settings.json，内容如下：
{ "model": "你的模型ID", "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "你的TaoToken统一Key" } }这个文件把模型 ID 和环境变量都固定下来，避免每次开终端都要重新 export。模型 ID 要填 TaoToken 实际支持的，填错会在请求时返回模型不存在。settings 文件里的 env 和终端环境变量作用一样，二选一即可，同时存在时以文件为准更稳。
接着放 Skill。在项目根目录建.claude/skills/，把你从 SkillHub 拿到的 Skill 目录整个放进去。比如你下载了一个叫humanizer的 Skill，结构应该是：
项目根目录/ .claude/ settings.json skills/ humanizer/ SKILL.mdSKILL.md里是 Skill 的说明和步骤。Claude Code 启动时会扫描这个目录，按需加载。你不需要在对话里手动 import，只要目录结构对，它就能被识别。
Codex 这边，配置走auth.json和config.toml。先建auth.json，放在 Codex 读取的配置目录下，内容：
{ "OPENAI_API_KEY": "你的TaoToken统一Key" }再建config.toml，同样放在配置目录下：
model = "你的模型ID" model_provider = "taotoken" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" wire_api = "chat"这里三件套齐了：base_url是 TaoToken 入口，OPENAI_API_KEY是统一 Key，model是模型 ID。wire_api按你实际使用的协议填，不确定就先按文档给的默认值。Codex 的 Skill 和项目规则配合，把 Skill 说明放在 Codex 能读到的项目目录里，同时确保config.toml里的 provider 指向 TaoToken。
如果你用 CC Switch 这类工具在多个配置间切换，记得把 TaoToken 这套配置单独存一份，切换时确认 Base URL、Key、Model ID 三件套都跟着切，别只切了 Key 忘了 Base URL。
Cline MCP 场景下，如果你要让 Cline 通过 MCP 调用，配置里同样要出现 Base URL、Key、Model ID。MCP 负责工具连接，认证还是走这三件套。别把 MCP 配置和 Skill 配置混在一个文件里，分开管理更清晰。
配完检查一遍：Claude 的 settings.json 里 Base URL 和 Key 对不对，Codex 的 auth.json 和 config.toml 三件套齐不齐，Skill 目录结构对不对。这三处没问题，就可以进入验证。
4. 验证请求：一次 Skill 调用从发起到看到结果
配置写完不验证，等于没配。这一节做一次真实的 Skill 调用，从发起请求到看到结果，把中间每一步说清楚。
先确认环境变量生效。在终端里执行：
echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_AUTH_TOKEN第一行应该输出 https://taotoken.net/api ，第二行输出你的 Key。如果第一行是空的，说明环境变量没生效，检查你是不是在正确的 shell 里，或者 settings 文件有没有被读到。
然后启动 Claude Code，在项目目录下运行。启动后它会读取.claude/settings.json和.claude/skills/。你可以先问一句让它确认模型：
你现在用的是哪个模型？如果配置正确，它会返回你在 settings 里填的模型 ID。这一步能过，说明认证和入口都通了。
接下来触发 Skill。假设你放了一个写作类 Skill 叫humanizer，在对话里说：
用 humanizer 这个 Skill，帮我把下面这段话改得更像人写的： 「本方案旨在通过多维度协同，实现效能的全面提升。」如果 Skill 被正确加载，Claude 会按SKILL.md里定义的步骤处理，而不是随便改。你会看到它先识别任务类型，再按 Skill 规定的风格输出。这就是 Skill 生效的标志：它的行为受 Skill 说明约束，而不是自由发挥。
Codex 这边验证类似。在项目目录下启动 Codex，先确认模型和 provider：
当前使用的模型和 provider 是什么？返回的 provider 应该是 taotoken，模型是你配的 ID。然后触发一个 Skill 任务，比如让 Codex 按某个项目规则改代码。如果它能读到 Skill 说明并按步骤执行，说明 Codex 侧的 Skill 调用也通了。
验证成功的标志有三个：请求没有报 401，返回内容里模型 ID 正确，Skill 的行为符合SKILL.md的描述。三个都满足，你就算跑通了第一个 Skill 示例。
如果中间卡住，先别改 Skill，回到工具层查。绝大多数失败发生在认证和入口，不在 Skill 逻辑。下一节把常见报错逐个拆开。
5. 常见报错排查：401、local proxy failed、reading choices、OAuth
这一节按真实报错来。你遇到哪个，直接对号入座。
401 是最常见的。表现是请求被拒，提示未授权。原因通常是 Key 没填对、Key 过期、或者 Base URL 和 Key 不匹配。排查顺序：先确认ANTHROPIC_AUTH_TOKEN或OPENAI_API_KEY里填的是 TaoToken 的统一 Key，没有多余空格和引号；再确认 Base URL 是 https://taotoken.net/api ，没有拼错；最后确认这个 Key 在控制台里还是启用状态。三件套里 Key 和 Base URL 必须成对，只改一个就会 401。
local proxy failed 通常出现在你本地有代理配置干扰的时候。表现是请求发不出去，提示本地代理失败。排查：检查环境里有没有HTTP_PROXY、HTTPS_PROXY这类变量指向了一个不可用的本地端口。如果有，临时 unset 掉再试。另外确认你的网络能正常访问 TaoToken 的 API 入口。这个报错和 Skill 无关，是网络层的问题。
reading choices 这类报错，一般出现在响应解析阶段。表现是请求发出去了，但返回结构不符合预期，工具在读取choices字段时失败。原因可能是模型 ID 填错，导致返回的不是标准对话结构；或者wire_api协议和实际接口不匹配。排查：确认模型 ID 是 TaoToken 支持的对话模型，确认 Codex 的wire_api按文档填对。改完重启工具再试。
OAuth 相关报错，通常是你用了需要 OAuth 登录的默认配置，但实际走的是 Key 认证。表现是提示需要登录或授权。排查：确认你没有同时启用两套认证。Claude Code 里如果既设了 OAuth 又设了ANTHROPIC_AUTH_TOKEN，可能冲突。把 OAuth 相关配置清掉，只保留 TaoToken 的 Key 认证。Codex 同理，auth.json里只放 TaoToken 的 Key，别混入其他登录态。
还有一个隐蔽的坑：Skill 目录放对了，但SKILL.md文件名大小写不对。有些系统区分大小写，skill.md和SKILL.md不是一回事。确认文件名和工具要求的一致。
排查原则：先工具层，再 Skill 层。工具层看三件套（Base URL、Key、Model ID），Skill 层看目录结构和SKILL.md内容。按这个顺序，大部分问题五分钟内能定位。
6. 跑通之后：把 Skill 调用接进你的日常编码流
第一个 Skill 跑通后，你可以把它接进日常流程。Claude 和 Codex 都指向 TaoToken 统一入口，意味着你换工具时不用换 Key，维护成本降下来了。
如果你要长期做编码和 Agent 任务，可以考虑用 Coding Plan，把调用额度集中管理。验证模型行为时，用模型对话快速试；查 Key 和配置，去 API Keys 和接入文档。这几个入口按需用，别一次全开。
Skill 的价值在于复用。你从 SkillHub 拿到的 Skill，跑通一次后，把它固化在项目里，下次同类任务直接触发。慢慢你会攒出自己的 Skill 集合，这才是效率提升的来源。
