1. Codex 旧模型停用到底影响谁先搞清楚迁移范围Codex 旧模型停用这件事真正麻烦的地方不在于模型选择器里点一下换新模型而在于那些藏在配置文件、定时任务和自定义 Agent 里的旧模型名称。2026 年 8 月 31 日之后使用 ChatGPT 账号登录 Codex 的用户将不能继续选择 GPT-5.4 和 GPT-5.4 mini官方给出的迁移关系很明确GPT-5.4 对应 GPT-5.6 TerraGPT-5.4 mini 对应 GPT-5.6 Luna。如果你只是偶尔在对话框里手动选模型停用后手动换一下就行。但如果你的工作区默认模型、保存的模型偏好、企业统一管理配置、自定义 Agent、Scheduled Tasks、CLI 命令和自动化脚本里写死了旧模型名称那停用后这些任务可能直接启动失败。受影响的主要是通过 ChatGPT 账号登录 Codex 桌面端、CLI、IDE 扩展、网页端以及使用套餐额度运行的自动化任务。需要特别注意的是OpenAI API 以及使用自己 API Key 认证的 Codex 会话暂时不受这次停用影响。所以迁移的核心动作不是“学会选新模型”而是做一次全量排查把项目里所有出现gpt-5.4和gpt-5.4-mini的地方找出来按对应关系替换然后逐个验证。下面我会按实际迁移顺序从环境准备、配置修改、验证请求到常见报错排查给出一份可以直接照着做的清单。2. 迁移前的前置准备TaoToken 接入与 Codex 环境确认在动手改配置之前先把 Codex 的运行环境和接入方式确认清楚。很多迁移失败的案例其实不是模型名称写错而是 Base URL 和认证方式没配对。如果你使用的是自建 API Key 认证的 Codex 会话可以通过 TaoToken 这类兼容接口来统一管理模型调用。它的 API 地址是https://taotoken.net/api模型对话、Coding Plan、控制台和 API Keys 都可以在官网找到入口。先确认你当前 Codex 的认证方式。打开终端执行codex --version如果版本低于官方要求的最低版本先升级客户端。旧版本可能不认识gpt-5.6-terra和gpt-5.6-luna这两个模型 ID导致即使配置写对了也报模型不存在。升级命令根据安装方式不同npm install -g openai/codex或者如果你用的是 Homebrewbrew upgrade codex升级完成后检查当前 Codex 的配置目录。默认情况下Codex 的配置文件位于用户目录下的.codex文件夹ls -la ~/.codex你会看到auth.json、config.toml等文件。auth.json负责认证信息config.toml负责模型和运行参数。迁移时这两个文件都要检查。如果你是通过 TaoToken 接入的Base URL 需要指向https://taotoken.net/apiAPI Key 在控制台的 API Keys 页面生成。这里有一个容易踩的坑有些人把 Base URL 写成了带路径的完整地址比如https://taotoken.net/api/v1/chat/completions但 Codex 的配置项通常只需要填到/api这一层具体路径由客户端自己拼接。写多了反而会导致 404。确认好这两项之后再进入下一步的配置修改。3. 可复制的 Codex auth.json 与 config.toml 配置清单这一节是迁移的核心。你需要修改的文件主要有两个~/.codex/auth.json和~/.codex/config.toml。先看auth.json它的作用是告诉 Codex 用哪个 Key 和哪个 Base URL 去请求模型。一个可复制的示例如下{ OPENAI_API_KEY: sk-your-taotoken-api-key, OPENAI_BASE_URL: https://taotoken.net/api }注意两点第一OPENAI_API_KEY填你在 TaoToken 控制台生成的 Key不要填 ChatGPT 账号的登录凭证第二OPENAI_BASE_URL只写到/api不要追加/v1或其他路径。如果你之前用的是 ChatGPT 账号登录方式auth.json里可能没有这两个字段迁移到 API Key 认证时需要补上。接下来是config.toml它决定默认模型和运行参数。迁移时把旧模型名称替换成新模型model gpt-5.6-terra model_reasoning_effort medium [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key OPENAI_API_KEY如果你原来用的是gpt-5.4-mini把model改成gpt-5.6-luna。这里的三件套必须写全Base URL、Key、Model ID。缺任何一个都会导致请求失败。Base URL 是https://taotoken.net/apiKey 来自控制台Model ID 是gpt-5.6-terra或gpt-5.6-luna。对于使用 CLI 命令直接指定模型的场景迁移时逐条替换codex --model gpt-5.6-terra codex exec --model gpt-5.6-terra 检查当前项目 codex --model gpt-5.6-luna如果你在项目里用了 Cline MCP 或类似的 Agent 配置也要检查对应的 settings 文件。比如 Cline 的 MCP 配置里如果写死了模型名称同样需要替换。Codex 的auth.json和config.toml改完之后建议先不要急着跑复杂任务用一个最简单的请求验证配置是否生效。4. 验证请求与成功结果逐项确认迁移生效配置改完后必须做验证。最直接的方式是发一个最小请求确认模型能正常响应。先用 CLI 测试codex exec --model gpt-5.6-terra 输出当前目录的文件列表如果返回了文件列表说明 Base URL、Key 和 Model ID 三件套都配对了。如果报 401说明 Key 有问题如果报 model not found说明模型 ID 写错了如果报连接失败说明 Base URL 不对。接着验证config.toml里的默认模型是否生效。不指定--model参数直接运行codex exec 用一句话说明当前项目使用的语言如果它能正常回答说明默认模型已经切换成功。然后检查定时任务。打开 Scheduled Tasks 面板逐个查看任务使用的模型把gpt-5.4替换为gpt-5.6-terra把gpt-5.4-mini替换为gpt-5.6-luna手动执行一次检查输出、权限和运行记录。自定义 Agent 的验证稍微复杂一些。你需要打开 Agent 定义文件确认里面没有残留旧模型名称然后手动触发一次 Agent 任务观察它是否能正常读取项目、运行命令、输出结果。迁移后至少验证五项能否读取正确项目、能否正常运行命令、输出格式是否保持一致、是否出现新的权限请求、任务消耗是否符合预期。如果你在项目里用 grep 搜索旧模型名称可以执行grep -R gpt-5.4 .Windows PowerShell 用Get-ChildItem -Recurse -File | Select-String gpt-5.4重点检查.codex目录、Agent 配置、项目脚本、CI 配置、Shell 脚本、团队共享模板和内部文档。文档里的示例也建议同步更新避免团队成员之后继续复制旧配置。5. 迁移后常见报错排查401、model not found 与 OAuth 问题迁移过程中最容易遇到的报错有几类逐个说清楚排查方法。第一类是 401 认证失败。报错信息通常是401 Unauthorized或invalid api key。原因一般是auth.json里的 Key 写错、Key 已过期或者 Base URL 和 Key 不匹配。排查时先确认OPENAI_API_KEY是不是从 TaoToken 控制台生成的再确认OPENAI_BASE_URL是不是https://taotoken.net/api。如果之前用的是 ChatGPT 账号登录切换到 API Key 认证后需要重新生成 Key。第二类是model not found或reading choices报错。这通常说明模型 ID 写错了或者客户端版本太旧不认识新模型。先确认写的是gpt-5.6-terra或gpt-5.6-luna注意中间是连字符不是下划线。然后升级 Codex 客户端到最新版本。如果报错信息里出现reading choices说明请求发出去了但返回结构不符合预期多半是 Base URL 多写了路径检查是不是写成了/api/v1。第三类是local proxy failed或连接超时。这类报错通常和网络环境有关检查 Base URL 是否可达可以用 curl 测试curl -I https://taotoken.net/api如果返回 200 或 401 都说明地址可达返回超时则说明网络配置有问题。第四类是 OAuth 相关报错。如果你之前用 ChatGPT 账号登录迁移到 API Key 后可能残留 OAuth 缓存。删除~/.codex下的认证缓存文件重新用 API Key 认证即可。排查顺序建议是确认模型名称、更新 Codex 客户端、新建一个简单任务测试、再运行原任务、检查日志和权限、最后调整提示词。不要一出现结果差异就判断新模型能力不足先确认任务是否成功启动、工具是否正常、输入范围是否一致。6. 迁移完成后的长期使用建议与接入入口迁移完成后建议把新配置固化下来避免下次再遇到类似停用通知时手忙脚乱。具体做法是把config.toml里的默认模型设为gpt-5.6-terra把轻量任务统一用gpt-5.6-luna并在团队文档里记录这次迁移的对应关系。对于长期编码和 Agent 任务可以考虑使用 Coding Plan 来统一管理额度需要验证模型效果时用模型对话页面快速测试接入配置和 Key 管理在 API Keys 和接入文档页面。如果你还没有配置好接入环境可以按这个顺序操作先到官网注册并生成 API Key然后参考接入文档配置auth.json和config.toml最后用codex exec发一个最小请求验证。整个迁移过程的核心就是三件事找全旧模型名称、按对应关系替换、逐个验证任务。8 月 31 日之前完成这些检查日常开发和后台自动化就不会因为模型停用而突然中断。