Codex 能聊天却一跑工具调用就 400？TaoToken 这样改 model_providers

Codex 能聊天却一跑工具调用就返回 400报错里还经常夹着 schema、tool call、responses 这些词这时最该做的不是继续换 API Key也不是把模型名从 A 改成 B。先去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 注册 TaoToken创建一把 Key再回到 ~/.codex/config.toml 检查 model_providersbase_url 写 https://taotoken.net/apienv_key 只写环境变量名真实 Key 放环境变量里。下面按排障顺序把 Codex 工具调用 400 的来龙去脉拆开。这个现象很典型你在 Codex 里发一句普通聊天它回得挺快一旦让它读文件、改代码、跑命令或者进入带 tool call 的链路立刻 400。很多人第一反应是 Key 失效、额度不够、模型下线于是反复新建 Key、来回换模型名最后配置越改越乱。其实聊天能通说明网络、Key、模型名至少大方向没全错。工具调用才挂更像是 Codex 的 provider 协议和请求格式没对齐尤其是 model_providers 里的 base_url、env_key、模型能力这几处。1. Codex 工具调用 400先别改 Key先看 model_providers 协议1.1 聊天通、工具挂说明问题在请求格式Codex 的聊天请求和工具调用请求在底层并不是完全同一种东西。聊天大多是一条 user 消息进去一条 assistant 消息出来工具调用会额外带上工具描述、参数 schema、调用结果回填、多轮上下文。只要中间有一段格式不被服务端接受返回的就不是“模型不会”而是 HTTP 400。所以“能聊天”只能证明最小请求链路基本可用不能证明 provider 配置全对。尤其当你把 base_url 指到某个兼容通道时聊天可能刚好命中简单接口工具调用却走了另一套 schema。Codex 的 model_providers 配置里真正影响这条链路的是 provider 名称、base_url、env_key 和模型 ID。Key 正确只解决鉴权不解决格式。先做一个动作把 Codex 的报错完整看一遍。不要只看最后一句“400 Bad Request”往前翻看它有没有提到tools、tool_choice、input、responses、schema。如果出现这些词基本可以先把 Key 问题放一边进入格式排查。1.2 错误里的 schema、tool call、responses 在提示什么schema通常和工具参数描述有关。Codex 会把可用的工具能力整理成一段结构化定义发给模型服务端如果服务端不认这种结构就会在请求体校验阶段拒绝。tool call更直接说明请求已经进入工具调用分支而不是普通聊天。responses则可能和 Codex 选择的 wire API 有关有的版本默认走 Responses 风格接口有的兼容通道只接受 Chat Completions 风格两边字段名不同硬拼就会 400。这里最容易踩的坑是看到 400 就改模型名。模型名错了通常更接近 404鉴权错了更接近 401。400 更像“我认得你但你的请求体我不接受”。所以排障顺序要反过来先确认请求地址和协议再确认模型是否支持工具调用最后才去看 Key 和额度。1.3 值不值得接第三方模型先算清楚再动 config.toml原文里有一句判断很值得保留先想清楚值不值得再动配置。Codex 接第三方模型不是把 base_url 一换就完事。你要考虑三件事模型是否支持工具调用通道是否兼容 Codex 当前版本的请求格式你愿不愿意为稳定性做小步验证。如果只是偶尔聊天官方通道够用没必要折腾。如果你已经被官方额度、多 Key 切换、模型选择卡住希望把 Codex 接到一个统一入口再通过兼容通道走不同模型那 TaoToken 这种一站接入方式才值得配。它的价值不在“多一个地址”而在把 Key、模型广场、用量和兼容通道收在一处减少你在多个平台之间来回复制粘贴。2. 准备 TaoToken Key 与 Codex 的 model_providers 三段式2.1 在官网创建 YOUR_API_KEY不要把真实 Key 写进 TOML打开 TaoToken注册并进入控制台创建一把 API Key。本文所有示例都用占位符YOUR_API_KEY你替换成自己刚创建的那把即可。创建完成后先别急着贴进 Codex 的 TOML 文件真实 Key 只放环境变量。为什么强调这一点因为~/.codex/config.toml很容易被同步、备份、截图、发群。Key 写进去等于把钥匙插在门上。正确做法是TOML 里只写环境变量名系统环境变量里放真实值。Codex 启动时自己去读不经过聊天内容也不经过 AGENTS.md。2.2 ~/.codex/config.toml 里真正要改的字段Codex 的 provider 配置可以理解成三段第一段告诉 Codex 默认用哪个模型第二段告诉它默认走哪个 provider第三段定义这个 provider 的地址和鉴权变量名。你不需要推翻整个文件只改和新增这几处。先找到或创建~/.codex/config.toml。如果里面已经有官方 provider不要删新增一个自定义 provider 即可。关键字段如下字段填什么注意modelYOUR_MODEL_ID以模型广场当时列表为准model_providertaotoken要和下面的段名一致base_urlhttps://taotoken.net/api末尾不加/v1不加参数env_keyTAOTOKEN_API_KEY只写变量名不写真实 Key这张表建议对照着改。Codex 对 provider 段名和 model_provider 的对应关系比较敏感名字不一致时容易走到默认 provider表现就是聊天也许能通工具调用却按另一套配置发出去。2.3 模型 ID 从模型广场复制别编日期后缀模型 ID 必须有出处。不要看别人文章里写了某个带日期后缀的名字就照抄也不要自己拼一个看起来很像的 ID。以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 模型广场当时列表为准复制完整的模型 ID填到model字段。如果你不确定某个模型是否支持工具调用先选列表里明确标注支持工具能力的那类。Codex 的工具调用链路比普通聊天更长模型本身不支持 function calling或者通道不支持对应字段都会让请求在服务端校验时挂掉。模型名写错常见 404模型能力不匹配常见 400这两个不要混。3. base_url 填 https://taotoken.net/api 后config.toml 这样写3.1 一份可复制的 Codex provider 配置下面是一份最小可复制示例。注意base_url是https://taotoken.net/api不是官网地址也不要加/v1。官网地址只用于注册、创建 Key、看模型广场和用量。model YOUR_MODEL_ID model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY如果文件里已有其他[model_providers.xxx]保留它们不要互相覆盖。model_provider taotoken只是把默认线路切到这一段。以后想切回官方把这一行改回原来的 provider 名即可不用把整份配置删掉。提示Codex 不同版本对 provider 字段的支持可能有差异。你只需要确保base_url指向https://taotoken.net/apienv_key指向环境变量名不要在 TOML 里出现真实 Key。3.2 环境变量按系统设置不进 AGENTS.mdmacOS 或 Linux 下可以临时在终端里设置export TAOTOKEN_API_KEYYOUR_API_KEYWindows PowerShell 下$env:TAOTOKEN_API_KEYYOUR_API_KEY临时变量只对当前终端会话有效关掉窗口就没了。要长期使用把它写进~/.zshrc、~/.bashrc或系统环境变量设置里。真实 Key 从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 创建创建后只放在环境变量。不要写进AGENTS.md不要写进项目 README更不要作为聊天内容发给 Codex 让它“帮你记住”。3.3 不要发 Key 让 Codex 帮你改配置这一点看似省事实际后患很大。你把 Key 发进对话Codex 可能把它写进它生成的配置片段、日志或上下文里。正确流程是你自己在本地编辑~/.codex/config.toml自己设置环境变量Codex 只负责在你修好之后做验证。它不需要知道真实 Key也不该替你保存。如果你确实想让它检查配置把 Key 替换成YOUR_API_KEY再发。检查base_url、env_key、model三个字段即可。真实值永远留在环境变量里。4. 按小步验证一句话、README 前三段、hello.txt4.1 第一句只验证基础响应改完配置后先重启终端再启动 Codex。不要一上来就让它在整个仓库里重构代码。第一轮只发一句“请只回复一句话你现在可以正常响应”这句话不带工具调用只验证 Key、模型 ID、base_url 是否基本可用。如果这句都失败先回到第 5 节看 401 和 404不要继续测工具。如果这句正常回复说明最小链路已经通了可以进下一步。4.2 第二句验证上下文传递第二轮让它在项目根目录读 README 前三段并概括。你可以说“请概括当前项目 README 的前三段不要读其他文件。”这一步开始引入上下文传递。如果 Codex 能读到文件并给出合理概括说明它不仅能聊天也能处理本地上下文。此时如果报 400重点看请求里是否带了工具描述以及当前模型是否支持工具能力。不要立刻换 KeyKey 在这一步不是主要变量。4.3 第三句验证工具调用链路不再 400第三轮做一个最小工具调用测试。由你在本地终端创建临时文件不要让 Codex 去碰生产目录或真实业务库mkdir -p /tmp/codex-tool-test cd /tmp/codex-tool-test printf hello from tao token test\n hello.txt然后回到 Codex让它读取/tmp/codex-tool-test/hello.txt并返回内容。这个动作足够小能验证工具调用链路是否稳定。如果它成功读取并回复说明model_providers的地址、环境变量、模型工具能力基本对齐之前那个 400 大概率已经过去。注意Codex 只负责生成、解释、对照代码或命令涉及生产库、生产机器、诊断 SQL、编译运行等操作必须由你在本地或对应环境执行再把结果贴回对话。5. 仍然 400按鉴权、模型名、请求格式倒查5.1 base_url 多了 /v1 或参数最常见的是把base_url写成https://taotoken.net/api/v1或者在后面加了查询参数。Codex 自己会按 provider 协议拼路径你再加一层服务端可能收到重复路径或未知字段。正确写法只有https://taotoken.net/api末尾不带/v1也不要把官网的?utm_source...参数粘贴进去。官网链接和接口地址要分清楚注册、创建 Key、看模型广场、看用量走https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content填进 Codex 的 Base URL只写https://taotoken.net/api。两者不要混用。5.2 env_key 与真实环境变量名不一致TOML 里写env_key TAOTOKEN_API_KEY环境变量却叫OPENAI_API_KEY或TAOTOKEN_KEYCodex 找不到值请求可能直接失败。还有人把 Key 写进 TOML又在环境变量里留了旧值结果两套配置打架。改完后一定要重启终端让新变量生效。检查方式很简单在终端里输出变量名确认存在且不是旧 Key。不要把完整 Key 打印到公共日志里。5.3 模型 ID 和协议不匹配模型 ID 从模型广场复制不要自己拼。另一个容易忽略的是协议类型Codex 当前版本走哪种请求格式和你选的兼容通道是否匹配。如果你按别人的配置抄了某个协议字段但你的 Codex 版本或模型不支持工具调用就会在 schema 校验阶段 400。这时候不要继续瞎改 Key。先回到最小聊天确认基础响应再只做一次文件读取最后才做工具调用。每一步都保留 Codex 的完整报错看它到底在拒绝哪个字段。5.4 401、404、400 的判断顺序排障时记住这个顺序401 多半是鉴权404 多半是模型名400 更常见是请求格式不被支持。错误信息里出现 schema、tool call、responses就优先查 provider 配置和协议而不是反复新建 Key。你可以按这个清单走一遍401检查YOUR_API_KEY是否来自 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 创建的那把 Keyenv_key名是否一致。404检查model是否从模型广场复制是否有多余空格或日期后缀。400检查base_url是否为https://taotoken.net/api是否多了/v1或参数模型是否支持工具调用。仍然 400用一句话、README 前三段、hello.txt 三步缩小范围保留日志再判断。6. Codex 跑稳后去控制台核对这次调用6.1 同一把 Key 在模型对话发一条Codex 里跑通之后不要马上结束。打开 TaoToken 模型对话用同一把 Key 发一条测试消息确认模型 ID 和 Base URL 没填错。模型对话能通、Codex 工具调用也能通才说明这条线路真正稳定。如果模型对话正常、Codex 工具调用仍 400问题更可能在 Codex 的 provider 协议字段而不是 Key。回到~/.codex/config.toml只动model_providers相关段不要整份重写。6.2 长期写代码看 Coding Plan如果你准备把 Codex 当成日常编码工具频繁读文件、改代码、做多轮工具调用可以打开 Coding Plan 看套餐是否够用。不要只看单价要看工具调用场景下的实际消耗。Codex 的上下文和工具回合比普通聊天重配之前先估一下每天大概用多少。6.3 创建 Key 与 Claude Code 文档入口需要新建或轮换 Key去 控制台 API Keys。如果你同时也在用 Claude Code环境变量和接入方式可以对照 Claude Code 接入文档。Codex 这边记住三件事base_url填https://taotoken.net/api真实 Key 只进环境变量模型 ID 以模型广场当时列表为准。配完这轮再回到控制台看看这次调用的记录心里就有数了。