一、原问题与场景Codex 跑 /tdd 为什么容易断掉红-绿-重构这篇讲的是把 mattpocock/skills 里的 /tdd 交给 Codex 跑时Key 换成 TaoToken官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content的完整配置。很多人的卡点不是 /tdd 这个斜杠命令本身而是 Codex 的 config.toml 里 base_url、env_key、model_provider 没有对齐结果 /tdd 明明触发了模型请求却跑偏或者直接 401。下面从 Skill 工作流、TaoToken 前置、可复制配置、验证请求和常见错排查一路写清楚。mattpocock/skills 不是普通提示词集合它的核心是一批 SKILL.md 文件。每个技能文件会定义触发条件、执行步骤和约束。比如 /tdd 要求模型按红-绿-重构循环推进先写一个会失败的测试再写最小实现让测试通过最后在测试保护下重构。问题在于普通对话式提示词没有状态。你在第一轮说“先写失败测试”模型可能第二轮就绕过测试直接给实现你让它“小步提交”它可能一次性把整个模块写完。Codex 这类编程助手虽然能读文件、跑命令但如果只靠聊天历史仍然容易把技能步骤当成建议而不是当成必须执行的工作流。Skill 和 MCP 在这个场景里要分开看。Skill 负责流程约束它告诉 Codex 什么时候该做什么、每一步的完成标准是什么MCP 更适合把外部工具接进来比如查询 Issue、访问文档、调用某个服务。两者不能互相替代。也不要为了省事去找所谓 MCP 直连库来绕过模型配置因为 /tdd 的每一步约束最终仍然要落到模型请求上。请求通道不稳定Skill 写得再细也会被模型忽略。TaoToken 在这里承担的是模型请求承载层Codex 通过 config.toml 指向 TaoToken 的 API/tdd 每次读 SKILL.md、生成测试、实现、重构时请求都走同一套配置技能里的步骤才有机会真正被执行。所以本篇的目标很具体先把 TaoToken 的 Key 准备好再把 Key 填进 Codex 的模型配置Base URL 填 https://taotoken.net/api注意不要带 /v1。然后安装 mattpocock/skills勾选 /setup-matt-pocock-skills最后在 Codex 里调用 /tdd观察它是否按红-绿-重构推进。只要这条链路通了Codex mattpocock/skills 的 /tdd 工作流就能固定下来。二、TaoToken 前置在 Codex 的 config.toml 之前先准备 Key安装技能之前先打开 TaoToken 官网注册并创建 Key。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。注册完成后进入控制台在 API Keys 页面创建 Key。本文里的 Key 统一写成 YOUR_API_KEY你实际使用时替换成自己创建的那一串。不要把 Key 写进项目仓库也不要把 Key 提交到 Git。推荐用环境变量注入Codex 的 config.toml 只引用变量名不直接写明文。API 的基础地址是 https://taotoken.net/api这个地址后面不带 /v1。Codex 的 config.toml 里填 Base URL 时也填这个不要自己加 /v1否则容易出现路径重复比如变成 /api/v1/chat/completions 之类的组合导致 404 或 405。Key 用 YOUR_API_KEY 占位模型 ID 用 MODEL_ID 占位模型 ID 以你 TaoToken 控制台或模型列表里实际可用的为准不要照抄别人的模型名。如果你同时把同一套技能装到 Claude Code配置入口不是 Codex 的 config.toml而是 Claude Code 的 settings.json相关变量通常围绕 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 这类 ANTHROPIC_* 配置。本篇只处理 Codex /tdd 这条链路Claude Code 的配置不要和 Codex 的 config.toml 混在一起改。先确认 Codex 侧 Key 可用再继续安装 mattpocock/skills。三、可复制配置mattpocock/skills 安装 Codex config.toml先安装 mattpocock/skills。推荐在目标项目根目录执行因为 /tdd 会依赖当前仓库的测试结构、文档路径和 Issue 配置npx skillslatest add mattpocock/skills执行后会出现交互式选择。关键点有三个选择要安装的技能时至少勾选tdd。一定要把/setup-matt-pocock-skills一起勾选很多工程类技能依赖它做仓库级初始化。选择 coding agent 时选 Codex。如果你后面还要装到 Claude Code 或 Cursor可以再跑一次安装但本篇先保证 Codex 可用。安装完成后配置 Codex 的模型提供方。Codex 的配置文件通常在~/.codex/config.toml不同版本可能略有差异以你本机实际路径为准。可复制内容如下# ~/.codex/config.toml model MODEL_ID model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chat注意几个点。base_url必须是https://taotoken.net/api不要写成https://taotoken.net/api/v1。env_key是环境变量名不是 Key 本身。wire_api先用chat因为大多数兼容接口按 chat completions 工作。model_provider要指向taotoken否则 Codex 可能仍然走默认提供方。model填你实际要用的 MODEL_ID比如你在 TaoToken 控制台里确认可用的模型。然后在 shell 里注入 Key。临时生效可以这样export TAOTOKEN_API_KEYYOUR_API_KEY如果你用 zsh想持久化可以追加到~/.zshrcecho export TAOTOKEN_API_KEYYOUR_API_KEY ~/.zshrc source ~/.zshrc如果你用 bash则写入~/.bashrc后执行source ~/.bashrc。改完后重新打开终端或者至少在当前终端重新 source确保 Codex 能读到这个环境变量。接着进入项目根目录启动 Codexcodex在 Codex 里运行初始化命令/setup-matt-pocock-skills它会问你几个配置项通常包括问题追踪器类型比如 GitHub、Linear 或本地文件/triage使用的标签词表以及创建文档的保存路径。按当前项目实际情况填写。初始化完成后再调用/tdd这时 /tdd 才会结合仓库里的 SKILL.md、上下文文档和测试结构开始工作。你可以给一个很小的需求来验证例如让它在当前模块里增加一个校验函数并要求先写失败测试再最小实现最后重构。不要一上来就给大功能先用小切片确认工作流是否按红-绿-重构推进。四、验证请求与成功结果/tdd、/setup-matt-pocock-skills 是否真的生效配置完成后不要直接开大任务先验证 TaoToken 请求是否通。用 curl 发一个最小请求确认 Key、Base URL、模型 ID 三项没有错。命令如下curl -sS https://taotoken.net/api/chat/completions \ -H Authorization: Bearer YOUR_API_KEY \ -H Content-Type: application/json \ -d { model: MODEL_ID, messages: [ {role: user, content: 只回复 pong} ] }如果返回 JSON 里能看到正常的内容字段说明 Key 和 API 地址基本可用。如果返回 401优先检查 Key 是否复制完整、环境变量是否生效、Bearer 后面有没有多余空格。如果返回 404 或 405优先检查 base_url 是否误加了/v1以及wire_api是否和接口模式匹配。如果返回模型不存在去 TaoToken 控制台或模型列表确认 MODEL_ID不要用猜测的模型名。接着验证 Codex 侧。启动codex后用/status或/model查看当前 provider 和 model。成功状态下provider 应该指向你配置的taotokenmodel 应该是你填写的 MODEL_ID。如果 Codex 仍然显示默认提供方回到~/.codex/config.toml检查model_provider taotoken是否写对以及[model_providers.taotoken]这一节是否存在。再验证 /tdd 是否真的触发。进入一个已有测试框架的项目输入/tdd给一个小需求。成功结果不是模型立刻贴一大段实现而是按步骤推进先读仓库里的 SKILL.md 和 CONTEXT.md 等上下文文件。列出要新增或修改的测试并说明测试验证的是行为不是实现细节。运行测试确认新测试先失败。写最小实现让测试通过。在测试通过的前提下重构。最后跑回归测试确认没有破坏已有行为。如果 Codex 能按这个顺序输出并且每一步都有命令或文件改动作为证据说明 TaoToken 承载的模型请求和 mattpocock/skills 的 /tdd 已经接上了。反过来如果 /tdd 只是被当成普通文本发给模型模型跳过失败测试直接实现或者不跑测试就宣称完成就要回到配置和技能安装环节排查。五、本篇常见错排查config.toml、base_url、env_key 与 /tdd 触发失败第一类错是base_url写错。最常见的是写成https://taotoken.net/api/v1。本文要求填https://taotoken.net/api不要带/v1。路径重复后Codex 请求的完整路径可能变成/api/v1/...服务端可能返回 404。改回https://taotoken.net/api后重启 Codex。第二类错是env_key和环境变量名不一致。config.toml 里写env_key TAOTOKEN_API_KEY那 shell 里就必须有TAOTOKEN_API_KEY。可以在终端执行echo $TAOTOKEN_API_KEY看是否为空。如果为空重新 export或者把 export 写进~/.zshrc、~/.bashrc后 source。注意不要写成env_key YOUR_API_KEY那会把变量名当错。第三类错是model_provider没指向taotoken。只写了[model_providers.taotoken]还不够上面必须有model_provider taotoken。否则 Codex 可能仍然使用默认 provider你的 Key 和 Base URL 根本没被用上。检查方式是看/status里的 provider 名称。第四类错是wire_api不匹配。先用wire_api chat。如果你改成了responses但 TaoToken 当前配置或模型不支持该模式就可能报 404、405 或无法解析响应。改回chat后重试。不要同时保留多个冲突配置。第五类错是安装了技能但没有勾选/setup-matt-pocock-skills。很多人只装了tdd结果 /tdd 依赖的 Issue 追踪器、标签词表、文档路径没有初始化工作流第一步就卡住。重新执行npx skillslatest add mattpocock/skills把 setup 技能一起勾选然后在 Codex 里运行/setup-matt-pocock-skills。第六类错是安装时选错了 agent。安装交互里如果选了 Cursor 或 Claude Code但你在 Codex 里调用 /tddCodex 自然找不到技能。回到安装流程确认 agent 选的是 Codex。如果同时用多个助手可以分别安装不要假设一套目录所有工具共用。第七类错是工作目录不对。/tdd 依赖当前仓库的测试结构和文档路径。如果你在用户主目录启动 Codex或者在一个空目录里输入 /tdd技能可能无法定位测试文件。进入目标项目根目录再启动codex并确认当前目录里有测试框架配置和至少一个已有测试文件作为参照。第八类错是 Key 权限或余额状态异常。如果 curl 验证返回 401 或 403先去 API Keys 页面确认 Key 是否启用、是否被删除、是否复制了多余空格。重新创建一个 Key替换YOUR_API_KEY再重启终端和 Codex。不要在同一篇配置里混用多个 Key否则排查时无法判断是哪一个生效。六、语义一致 CTA把 Codex /tdd 工作流固定到 TaoToken如果你在 config.toml、base_url、env_key 或 /setup-matt-pocock-skills 上卡住先去 API Keys 页面确认 Key 状态再对照接入文档检查 Codex 的 provider 配置。排障和接入阶段用这两个入口最直接API Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite如果你已经配通 Codex想先验证模型返回是否正常可以到模型对话页做最小请求测试模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite如果你准备长期在 Codex 里跑 /tdd、/grill-me、/to-issues 这类 Agent 工作流把模型请求固定到 TaoToken 后再看 Coding Plan避免每次换项目都重新折腾 Key 和 Base URLCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite核心动作还是那几步在 TaoToken 创建 Key把 Key 填进 Codex 的 config.tomlBase URL 填 https://taotoken.net/api不要带 /v1安装 mattpocock/skills 时勾选 /setup-matt-pocock-skills最后在 Codex 里用 /tdd 跑一个小切片。只要请求链路稳定/tdd 的红-绿-重构才不会被 Codex 当成建议跳过。