1. Codex 接第三方模型为什么总在 auth.json 上翻车
Codex 使用 codex++ 快速接入第三方模型这件事，卡人的地方从来不是「有没有 API Key」，而是 Codex 和第三方模型说的根本不是同一种协议。OpenAI 原版 Codex 走的是 Responses API，路径是/v1/responses；而 DeepSeek、千问、豆包这些第三方模型，绝大多数只认 Chat Completions API，路径是/v1/chat/completions。你把第三方的 Base URL 直接塞进 Codex 的配置里，它发出去的请求格式对方看不懂，返回 404 Not Found 几乎是必然的。
所以核心动作只有一个：在 Codex 和第三方模型之间加一层「翻译」。codex++ 这类带图形界面的社区版，内置了 Responses 到 Chat Completions 的协议转换，你只要把上游协议切过去，再把auth.json里的 Base URL、Key、Model ID 三件套填对，链路就能通。这篇就围绕auth.json这个文件展开，给你可直接复制的配置片段，再演示一次请求验证和几个真实报错的排查动作。
适合谁看：本地需要快速切换模型通道的开发者，手上有第三方模型的 API Key，想让 Codex 真正帮你读写文件、执行命令，而不是只会在对话框里陪你聊天。前置条件很简单：装好 codex++，拿到一个可用的第三方 API Key，知道你要用的模型名。下面所有配置都以 TaoToken 作为统一入口来写，Base URL 用https://taotoken.net/api，Key 在控制台生成，模型名按你实际要用的填。
先明确一个概念，auth.json是 Codex 读取鉴权和端点信息的核心文件，它决定了 Codex 把请求发到哪里、用什么身份发。很多人改了半天环境变量没生效，就是因为 Codex 优先读auth.json，环境变量只是兜底。所以这篇的重点就是把这个文件改对，而不是到处试。
2. TaoToken 前置准备：Key、Base URL 与模型名三件套
在动auth.json之前，你得先把三样东西准备好，缺一个后面都会报错。这三样就是 Base URL、API Key、Model ID，我习惯叫它「三件套」。很多人接不上，不是配置写错，而是这三样里有一个是拍脑袋填的。
Base URL 统一用https://taotoken.net/api。注意这里不要带任何多余路径，也不要自己拼/v1，Codex 和 codex++ 会按协议自己补全。你如果填成https://taotoken.net/api/v1/chat/completions，反而会因为路径重复导致 404。这一点我踩过坑，当时以为是 Key 的问题，查了半天才发现是 URL 多写了一截。
API Key 去控制台生成，地址是https://taotoken.net/console，进去之后找到 API Keys 页面新建一个。Key 一般以固定前缀开头，复制的时候注意别把首尾空格带进去，auth.json里多一个空格就会 401。生成之后先存到本地一个临时文件里，别直接贴在聊天窗口。
模型名这块要特别小心。第三方模型的 Model ID 和它宣传的名字经常不一致，比如你在网页上看到的是「千问 Max」，实际 API 里要填qwen-max-latest这种。填错了不会报「模型不存在」这种友好提示，往往是返回一个空响应或者reading choices相关的解析错误。所以填之前去对应平台的文档确认一遍准确的 Model ID。
如果你打算长期用 Codex 做编码和 Agent 任务，可以考虑 Coding Plan，地址是https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=codex_auth_json，它更适合高频调用场景。只是想先验证模型通不通，用模型对话页面https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=codex_auth_json发一句话就能测。接入文档在https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=codex_auth_json，参数有疑问对着看。
三件套准备好之后，先别急着改 Codex 的配置，建议先用一条 curl 命令确认 Key 和 Base URL 本身是通的。这一步能帮你把「Key 问题」和「Codex 配置问题」分开，后面排查会省很多时间。命令我放在下一节，和auth.json的写法一起给。
3. 可复制配置：auth.json 与 codex++ 设置片段
这一节是全文最核心的部分，给你可以直接复制的auth.json片段，以及 codex++ 里对应的三个开关。先说auth.json的位置，不同系统路径不一样：macOS 和 Linux 一般在~/.codex/auth.json，Windows 在%USERPROFILE%\.codex\auth.json。如果目录不存在，手动建一个.codex文件夹再放进去。
下面是最小可用的auth.json结构，把sk-开头那串换成你自己的 Key：
{ "OPENAI_API_KEY": "sk-你的TaoToken密钥", "OPENAI_BASE_URL": "https://taotoken.net/api", "OPENAI_MODEL": "qwen-max-latest" }这里有个细节，不同版本的 Codex 和 codex++ 读取的字段名可能略有差异。有的版本认OPENAI_BASE_URL，有的认base_url，还有的把模型名放在单独的config.toml里。如果你改完auth.json没生效，先确认你的版本读的是哪个字段。codex++ 的图形界面里通常有一个「高级配置」入口，能直接看到它实际读取的路径和字段，对着改最稳。
codex++ 里要动的三个设置，我按重要性排一下。第一个是上游协议，从默认的 Responses 改成 Chat Completions，这是「翻译层」的开关，接第三方模型必须打开；如果你的模型原生支持 Responses 协议，就别开。第二个是 Full Access 权限，在 Permissions 里打开，不开的话模型能聊天但不会帮你执行代码，等于白接。第三个就是上面三件套的填写，Base URL 填https://taotoken.net/api，模型名填准确的 Model ID。
如果你用的是 Codex CLI 而不是 codex++，配置会落在config.toml里，写法类似这样：
model = "qwen-max-latest" model_provider = "taotoken" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "OPENAI_API_KEY" wire_api = "chat"注意wire_api = "chat"这一行，它等价于 codex++ 里的「上游协议选 Chat Completions」，是接第三方模型的关键。漏了这行，Codex 还是会按 Responses 协议发请求，然后你就收获一个 404。改完保存，重启 Codex 或 codex++ 让配置生效。
配置写完先别急着在 Codex 里发指令，用 curl 单独验证一次，把 Key 和端点的问题先排掉：
curl https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer sk-你的TaoToken密钥" \ -H "Content-Type: application/json" \ -d '{ "model": "qwen-max-latest", "messages": [{"role": "user", "content": "只回复两个字：通了"}] }'如果这条命令返回了正常的 JSON，里面有choices字段，说明 Key、Base URL、模型名三件套都是对的，问题就只剩 Codex 侧的配置了。如果这条就报错，那先解决它，别往下走。
4. 验证请求：从 curl 到 Codex 里真正跑通
curl 通了之后，回到 codex++ 里做一次端到端验证。这一步的目的是确认「协议转换 + 权限 + 模型」三者同时生效，而不只是 API 能通。我一般会发一条能触发文件操作的指令，因为纯聊天验证不了 Full Access 有没有开。
在 codex++ 的对话框里发这句：
在当前目录创建一个 hello.py，打印 "Codex 跑通了"，然后运行它如果它真的帮你建了文件、还执行了脚本并把输出贴回来，那整条链路就通了。这里的关键是「然后运行它」这几个字，它逼着模型去调用执行能力，能顺带验证 Full Access 是否生效。只让它创建文件的话，权限没开也可能成功，验证不彻底。
如果模型回复了文字但没动文件，八成是 Full Access 没开，回设置里打开再试。如果它连文字都不回，或者报reading choices之类的解析错误，那多半是模型名填错了，或者上游协议没切到 Chat Completions。这两种报错的原因完全不同，别混在一起查。
验证通过之后，你可以再测一次模型切换。把auth.json里的OPENAI_MODEL换成另一个模型，比如从qwen-max-latest换成 DeepSeek 的模型名，重启 Codex，再发一次同样的指令。如果也能跑通，说明你的配置是通用的，以后换模型只改这一行就行。这一步很实用，因为不同任务适合不同模型，代码生成和长文本推理的偏好不一样，能快速切换才是接第三方模型的价值。
顺便说一个观察：模型回复质量和你选的模型强相关。千问在中文理解和代码生成上比较稳，DeepSeek 在复杂推理和长链路任务上强，豆包速度快但代码能力弱一些。这些差异在简单验证里看不出来，等你真拿它改一个几百行的项目时就会很明显。所以验证跑通只是第一步，选对模型才是长期体验的关键。
5. 常见报错排查：401、404、local proxy failed 与 OAuth
这一节按真实报错来对，你遇到哪个就查哪个。我把最常见的几类列出来，每条都给原因和动作，不绕弯子。
401 Unauthorized，基本就是 Key 的问题。三种可能：Key 复制时带了空格、Key 已经失效或被删、auth.json里的字段名和你的 Codex 版本不匹配导致没读到。先检查 Key 首尾有没有空格，再去控制台确认 Key 还在，最后确认字段名。如果 curl 能通但 Codex 报 401，那一定是 Codex 没读到你填的那个字段，去 codex++ 的高级配置里看它实际读的路径。
404 Not Found，这是接第三方模型最经典的报错，原因就一个：协议没对上。Codex 按 Responses 协议发到/v1/responses，第三方只认/v1/chat/completions，对方自然找不到。解决动作是回 codex++ 把上游协议切成 Chat Completions，或者在config.toml里加wire_api = "chat"。还有一种 404 是 Base URL 多写了路径，比如自己拼了/v1/chat/completions，检查一下 URL 是不是干净的https://taotoken.net/api。
local proxy failed，这个报错通常出现在你本地跑了代理转发的情况下。原因可能是本地代理进程没起来、端口填错、或者代理本身崩了。先确认本地代理在跑，再确认auth.json或 codex++ 里填的端口和代理实际监听的一致。如果你没跑本地代理却报这个，检查一下是不是环境变量里残留了旧的代理配置，把它清掉。
reading choices或类似的解析错误，意思是请求发出去了、也回来了，但返回结构里没有 Codex 期望的choices字段。常见原因是模型名填错，对方返回了一个错误结构；或者上游协议没切，返回的是 Responses 格式而 Codex 在按 Chat 格式解析。先核对模型名，再核对协议开关。
OAuth 相关报错，一般出现在你之前登录过官方账号、auth.json里残留了 OAuth token 的情况。Codex 可能优先走 OAuth 而不是你填的 API Key。解决动作是把auth.json里和 OAuth 相关的字段清掉，只保留 API Key 和 Base URL，或者干脆删掉auth.json重新生成一份干净的。这个坑比较隐蔽，因为报错信息不会直接告诉你「你在用 OAuth」。
排查顺序建议固定成：先 curl 验证三件套，再查协议开关，再查权限，最后查 OAuth 残留。按这个顺序走，基本不会绕圈。
6. 把配置固化下来，下次换模型只改一行
跑通一次不算完，真正省时间的是把配置固化。我的做法是把auth.json里的三件套抽出来，模型名单独放一行，换模型时只改这一行，Base URL 和 Key 不动。这样你从千问切到 DeepSeek，改完重启就行，不用重新走一遍配置流程。
如果你经常在多个模型之间切，可以准备几份auth.json备份，命名成auth.qwen.json、auth.deepseek.json，用的时候复制成auth.json覆盖。比在图形界面里点来点去快得多，也不容易点错。codex++ 的图形界面适合第一次配置和排查，日常切换用文件覆盖更利索。
还有一点，auth.json里存的是明文 Key，别把它提交到 Git 仓库，也别随手发到群里。本地开发机自己用没问题，但要有这个意识。如果 Key 泄露了，去控制台删掉重新生成一个，改一下auth.json就行，成本很低。
最后留一个实用习惯：每次换完模型，先用第 4 节那条「创建 hello.py 并运行」的指令测一遍。它同时验证了协议、权限、模型三件事，比单纯发一句「你好」有用得多。跑通了再拿它干正事，能省掉很多「以为配好了结果中途报错」的返工。
