这次 GPT-5.6 不再是“预览消息里看得到自己工具里摸不到”的状态了。OpenAI 官方已经写明GPT-5.6 从现在开始在 ChatGPT、Codex 和 OpenAI API 中开放全球逐步 rollout 到完整可用。也就是说它已经不是只停留在发布新闻里的模型。但真正尴尬的地方来了别人已经在 Codex 里选到 GPT-5.6 了 你更新了 Codex重启了终端打开 /model还是没有。这不是个别情况。新模型刚上线时最常见的问题不是“到底有没有上线”而是客户端更新了但终端还在调用旧 CodexCodex 模型目录没有刷新Codex / CC Switch 里的模型列表还是旧缓存config.toml改错位置实际配置没生效当前 provider 不是你以为的那个 providerKey 或模型分组没有 GPT-5.6 权限你看到的是官方账号模型列表调用时走的却是第三方 Base URL/model里没有但直接指定-m gpt-5.6-sol又能跑。所以这篇不写虚的。我按“普通用户最容易卡住的顺序”整理一套保姆级排查流程。你不要一上来就卸载重装也不要乱删.codex目录先按下面顺序查。一、先说结论正式上线了但不等于每个入口马上刷新截至我写这篇的时间也就是 2026 年 7 月 11 日OpenAI 官方公告里已经明确写到GPT-5.6 is available starting today across ChatGPT, Codex, and the OpenAI API.官方同时写了三类入口ChatGPTCodexOpenAI API。但这里一定要分清楚正式上线 ≠ 你的客户端模型列表立刻刷新 正式上线 ≠ 所有账号、所有套餐、所有第三方接入同时显示 正式上线 ≠ 你旧的 Codex 会话自动切到 GPT-5.6尤其是 Codex 这种工具它中间至少隔着几层OpenAI 模型开放 - 当前账号或 provider 权限 - Codex 远端模型目录 - 本地 Codex 客户端版本 - 本地配置和缓存 - /model 选择器显示 - 实际调用成功任何一层没同步你都会看到“别人有我没有”。二、先确认你是哪一种“没有”不要只说“我没有 GPT-5.6”。先判断是哪种没有。现象大概率问题ChatGPT 里没有 GPT-5.6账号套餐、地区、rollout、设置入口或刷新问题Codex/model里没有Codex 版本旧、模型目录没刷新、旧会话缓存Codex / CC Switch 里没有第三方工具自己的模型列表没有拉新/model没有但codex debug models里有旧会话或选择器缓存重启/新会话/直接指定模型debug models里也没有当前 Codex 没拿到新模型目录或 provider 权限不对选到了 GPT-5.6 但调用失败Key、Base URL、模型分组、模型 ID 或额度问题提示model not found模型名写错或者当前 Key 没开放这个模型提示401/403认证或权限问题提示429用量、额度、频率或并发限制这张表很重要。如果你连问题属于哪一类都没分清就会陷入一个循环更新 Codex - 看不到 - 重装 - 还是看不到 - 怀疑没上线其实很多时候不是没上线而是模型目录、配置层或 provider 没同步。三、第一步确认你真的更新到了新 Codex先在 PowerShell 里执行codex--version我写这篇时本机显示的是codex-cli 0.144.1你不一定要和我完全一样后续看到更高版本也正常。重点是确认你本机调用的不是旧版本。如果你是 npm 安装的 Codex可以更新npm install-g openai/codexlatestCodex 也提供了自更新命令可以试codex update更新后不要马上下结论先关闭当前 PowerShell重新打开一个新窗口再执行codex--version为什么要重新开终端因为很多人更新成功了但当前终端环境仍然命中旧路径。尤其是 Windows 上之前装过多个 Node、npm 或 Codex就很容易出现“你以为更新了其实运行的还是旧入口”。继续查路径Get-Commandcodex where.exe codex如果输出里有多个codex说明你电脑里可能有不止一个安装位置。优先确认当前实际执行的是哪一个。四、第二步不要只看/model先看 Codex 原始模型目录这是这篇最关键的一步。很多人只会进 Codex 后输入/model如果选择器里没有 GPT-5.6就以为自己没权限。不一定。Codex 有一个更直接的诊断命令codex debug models它会打印 Codex 当前看到的原始模型目录。官方文档里也写了这个命令用于查看 Codex 看到的 raw model catalog。在 Windows PowerShell 里可以这样筛选codex debug models|Select-String-Patterngpt-5.6|5.6如果你能看到类似gpt-5.6-sol GPT-5.6-Sol gpt-5.6-terra gpt-5.6-luna说明什么说明 Codex 当前已经能拿到 GPT-5.6 的模型目录。问题大概率不在“模型没有上线”而在当前/model页面没有刷新老会话还在使用旧状态Codex / CC Switch 没同步config.toml里默认模型没改当前 profile 或项目配置覆盖了用户配置。这时候不要继续重装直接进入下一步。五、第三步对比 bundled 目录判断是不是缓存/刷新问题继续执行codex debug models--bundled|Select-String-Patterngpt-5.6|5.6这个命令和刚才有什么区别--bundled看的是当前 Codex 二进制里自带的模型目录不去刷新远端模型目录。所以会出现三种结果。第一种codex debug models 有 GPT-5.6 codex debug models --bundled 没有 GPT-5.6这通常说明你的 Codex 通过远端刷新已经能看到新模型但当前安装包自带的旧目录里没有。只要实际调用能用问题不大。第二种两个命令都有 GPT-5.6这说明 Codex 本身已经比较新模型目录也同步了。你看不到模型多半是会话、选择器或配置覆盖问题。第三种两个命令都没有 GPT-5.6这时候才重点检查Codex 是否真的更新成功当前账号或 provider 是否有权限网络是否能刷新远端模型目录第三方接入后台是否已经开放当前是否走错 provider。这一步比盲目卸载更有用。六、第四步完全退出旧会话再新开 Codex如果codex debug models里已经能看到 GPT-5.6但/model里仍然没有先做一个最简单的动作退出当前 Codex 会话关闭终端重新打开 PowerShell再进 Codex。进入后再输入/model如果仍然没有直接用模型参数启动codex-m gpt-5.6-sol这里要注意-m只负责指定模型不负责切换 provider。也就是说如果你当前 provider 还是官方账号它就按官方账号走如果你当前 provider 是 KKFlow 或其他第三方配置它就按当前 provider 走。模型能不能调用要看当前 provider 下是否有这个模型 ID。如果你用的是 Terra 或 Luna也可以按实际模型 ID 指定例如codex-m gpt-5.6-terra codex-m gpt-5.6-luna模型名不要凭感觉编后面会讲怎么查。七、第五步检查config.toml很多人就是改错位置Windows 默认配置文件通常在notepad$env:USERPROFILE\.codex\config.tomlmacOS / Linux 通常是~/.codex/config.toml你要找的是根级model字段例如model gpt-5.6-sol如果你还有代码审查模型也可以看review_model gpt-5.6-sol这里有一个非常常见的坑不要把model gpt-5.6-sol随手加到[model_providers.xxx]里面。模型默认值通常是根级配置。Provider 表里写的是 provider 的 Base URL、认证方式、协议等信息。你把model塞进 provider 表后面不一定会按你想的方式生效。还有第二个坑项目级配置覆盖。Codex 配置不是只读一个文件。官方配置说明里提到Codex 会按优先级加载多个配置层包括 CLI 参数、项目.codex/config.toml、profile、用户~/.codex/config.toml等。所以你改了用户目录下的config.toml但当前项目里如果还有.codex/config.toml那项目配置可能会覆盖你的默认模型。进入 Codex 后可以用/debug-config看当前到底加载了哪些配置层。这个命令很适合排查“我明明改了 config.toml为什么没有生效”。八、第六步Codex / CC Switch 用户要刷新工具自己的模型列表如果你用的是 Codex、CC Switch 或 CCS 管理 provider不要只更新 Codex CLI。这些工具通常也有自己的模型列表、配置模板或导入缓存。你要做的是打开 Codex / CC Switch / CCS - 找到模型管理或模型列表 - 刷新 / 拉取最新模型列表 - 重新启用当前配置 - 退出 Codex - 新开终端再进 Codex如果后台已经能看到 GPT-5.6但工具里还是没有优先看有没有“刷新模型列表”“导入到 CCS”“重新生成配置”这类按钮。很多人卡在这里KKFlow 后台有 GPT-5.6 Codex CLI 也更新了 但 CCS 里仍然是旧模型列表这不是模型没上线而是中间工具没有同步。如果工具暂时还没拉到也可以手动在当前生效的config.toml里把根级模型改成后台实际模型 IDmodel gpt-5.6-sol保存后一定要重新启用配置并重启 Codex。九、第七步确认当前 Key 和 Base URL 真的能看到 GPT-5.6如果你走官方 API就按官方 API 后台和当前组织权限确认。如果你走 OpenAI 兼容接口或第三方 provider要先测模型列表。我自己常用的一个 AI API 统一接入入口是https://kkflow.org它常用的 OpenAI 兼容 Base URL 是https://kkflow.org/v1模型列表测试接口https://kkflow.org/v1/modelsPowerShell 里可以这样测curl.exehttps://kkflow.org/v1/models-HAuthorization: Bearer sk-你的KKFlow密钥注意公开文章、截图、群聊、视频和仓库里都不要展示真实 API Key。上面的sk-你的KKFlow密钥只是占位符。如果返回的模型列表里能看到gpt-5.6-sol gpt-5.6-terra gpt-5.6-luna说明这个 Key 所在分组可以看到对应模型。如果/v1/models里都没有那 Codex 里硬填模型名也没用。它最终还是会报model not found十、第八步用codex doctor做本地诊断如果你已经排查了版本、模型目录、配置、provider、Key还是不对可以跑codex doctor如果想拿到更完整的输出codex doctor--all官方命令说明里写得很清楚codex doctor会检查本地安装、配置、认证、运行时、Git、终端、app-server 和会话相关问题。这对排查“为什么我本机就是不对”很有用。如果你要把报错发给别人看先脱敏不要发真实 API Key不要发完整账号 token不要发公司内部项目路径可以发codex --version可以发Get-Command codex可以发脱敏后的config.toml关键片段可以发codex debug models是否能搜到5.6。十一、如果怀疑本地状态有问题用临时 CODEX_HOME 验证这个方法适合进阶一点的用户。如果你怀疑自己的.codex目录里有历史配置、旧 profile 或工具残留不建议你一上来就删整个.codex。更稳妥的方式是用一个临时干净目录验证。PowerShell 示例$env:CODEX_HOME$env:TEMP\codex-clean-testNew-Item-ItemType Directory-Force-Path$env:CODEX_HOME|Out-Nullcodex--version codex debug models|Select-String-Patterngpt-5.6|5.6这个动作不会直接动你原来的$env:USERPROFILE\.codex如果临时CODEX_HOME里能看到 GPT-5.6而原目录里看不到那就说明问题大概率在你原来的本地配置、profile 或工具生成配置里。这时候再回头查~/.codex/config.toml项目里的.codex/config.toml你是否用了--profileCodex / CC Switch 是否覆盖了配置当前 provider 是否切错不要直接删数据库文件和历史会话里面可能有你之前的记录。十二、常见问题逐条对照1. 我已经更新 Codex为什么还是没有 GPT-5.6先跑codex debug models|Select-String-Patterngpt-5.6|5.6如果这里有说明模型目录已经到了重点查旧会话、/model刷新、config.toml和第三方工具缓存。如果这里没有再查版本、provider 和权限。2./model里没有但直接codex -m gpt-5.6-sol能启动正常吗这种情况可能是选择器显示没刷新或者你当前模型列表 UI 还没同步。只要实际调用成功说明模型 ID 和 provider 链路是通的。但建议后面还是把config.toml和工具模型列表同步好否则每次手动指定会比较麻烦。3.model not found是什么意思通常是三种情况模型 ID 写错当前 Key 所在分组没有这个模型当前 Base URL 不是你以为的 provider。先测/v1/models不要靠猜。4. 我在 ChatGPT 能看到 GPT-5.6为什么 Codex 不能用ChatGPT、Codex、API、第三方 provider 不是完全同一个入口。ChatGPT 里能看到不代表你的 Codex 当前 provider 一定能调用。反过来也一样第三方接入能看到不代表你的官方 ChatGPT 账号已经同步显示。5. 我用 KKFlow 后台看到 GPT-5.6但 Codex 没有按这个顺序查后台模型列表 - /v1/models 是否返回 GPT-5.6 - CCS / CC Switch 是否刷新模型列表 - Codex 当前 provider 是否切到 KKFlow - config.toml 根级 model 是否正确 - 重启 Codex - codex debug models 是否能看到6. 我是不是要删缓存不要第一步就删。更稳妥的顺序是重启终端 - codex debug models - 刷新 Codex / CC Switch - 检查 config.toml - /debug-config - 临时 CODEX_HOME 验证确认是本地状态问题以后再考虑备份后清理对应配置。不要盲删整个.codex里面可能有历史会话、认证、日志和你的个人配置。十三、最快排查清单照着做就行如果你不想看解释直接按这套来。Windows PowerShellcodex--versionGet-Commandcodex where.exe codex codex update npm install-g openai/codexlatest关闭 PowerShell重新打开再执行codex--version codex debug models|Select-String-Patterngpt-5.6|5.6codex debug models--bundled|Select-String-Patterngpt-5.6|5.6如果能搜到 GPT-5.6codex-m gpt-5.6-sol如果还是不行打开配置notepad$env:USERPROFILE\.codex\config.toml确认根级有model gpt-5.6-sol进入 Codex 后再看/model /debug-config最后跑诊断codex doctormacOS / Linuxcodex--versionwhichcodex codex updatenpminstall-gopenai/codexlatest重新打开终端codex--versioncodex debug models|grep-igpt-5.6\|5.6codex debug models--bundled|grep-igpt-5.6\|5.6直接指定模型codex-mgpt-5.6-sol打开配置nano~/.codex/config.toml确认model gpt-5.6-sol再跑codex doctor十四、我建议新手按这个顺序接入如果你之前完全没用过 Codex或者旧配置已经很乱我建议按这个顺序来1. 更新 Codex 2. 重新打开终端 3. 确认 codex --version 4. 用 codex debug models 搜 GPT-5.6 5. 确认当前 provider 和 Base URL 6. 测 /v1/models 7. 修改 config.toml 根级 model 8. 刷新 Codex / CC Switch 模型列表 9. 重启 Codex 10. 用 codex -m gpt-5.6-sol 直接启动这比反复卸载重装靠谱。十五、最后说一下 KKFlow 的位置如果你能稳定走官方链路当然优先按官方方式用。但国内开发者实际接 Codex经常不是卡在“不会写提示词”而是卡在这些地方网络和认证Key 怎么管Base URL 填哪里模型名怎么切Codex、Claude Code、生图 API 能不能统一调用失败后去哪里看报错和用量。我自己常用的一个 AI API 统一接入入口是https://kkflow.org它的价值不是替你“绕过”什么而是把 Key、模型、接口地址和用量放到同一套后台里管理。像这次 GPT-5.6 上线真正影响体验的往往不是新闻本身而是谁能更快把模型列表、Base URL、Key 分组和客户端配置同步好。常用地址用途地址主站、登录、后台和指南https://kkflow.orgOpenAI 兼容 API Base URLhttps://kkflow.org/v1模型列表测试接口https://kkflow.org/v1/models如果你通过 KKFlow 接 Codex重点确认三件事后台是否开放 GPT-5.6 /v1/models 是否能看到 GPT-5.6 Codex 当前 provider 是否真的切到 KKFlow这三件事都通再去看 Codex 本地缓存和模型选择器。十六、总结GPT-5.6 已经正式上线但很多人更新 Codex 后还是看不到这很正常。你不要只盯着/model页面也不要一上来就重装。正确顺序是版本 - 路径 - 原始模型目录 - bundled 对比 - 配置层 - provider - /v1/models - 实际调用最关键的两个命令记住codex debug models|Select-String-Patterngpt-5.6|5.6codex doctor如果debug models里已经有 GPT-5.6但/model没有大概率是旧会话、选择器或第三方工具缓存问题。如果/v1/models里没有 GPT-5.6说明当前 Key 或分组还没看到这个模型Codex 里硬填也没用。如果你还是排不出来可以在评论区发这几项注意脱敏操作系统 codex --version Get-Command codex / which codex codex debug models 是否能搜到 5.6 用的是官方账号还是 KKFlow / 第三方 provider 脱敏后的具体报错不要发真实 API Key。我后面可以继续整理一版“Codex GPT-5.6 常见报错对照表”把model not found、401、403、429、配置不生效、CCS 不刷新这些问题单独拆开讲。参考资料OpenAI GPT-5.6 官方公告https://openai.com/index/gpt-5-6/OpenAI Codex Developer Commandshttps://learn.chatgpt.com/docs/developer-commands?surfacecliOpenAI Codex Config Basicshttps://learn.chatgpt.com/docs/config-file/config-basicKKFlowhttps://kkflow.org
GPT-5.6 正式上线了，但你的 Codex 还是看不到？这篇保姆级教程一次排查
这次 GPT-5.6 不再是“预览消息里看得到自己工具里摸不到”的状态了。OpenAI 官方已经写明GPT-5.6 从现在开始在 ChatGPT、Codex 和 OpenAI API 中开放全球逐步 rollout 到完整可用。也就是说它已经不是只停留在发布新闻里的模型。但真正尴尬的地方来了别人已经在 Codex 里选到 GPT-5.6 了 你更新了 Codex重启了终端打开 /model还是没有。这不是个别情况。新模型刚上线时最常见的问题不是“到底有没有上线”而是客户端更新了但终端还在调用旧 CodexCodex 模型目录没有刷新Codex / CC Switch 里的模型列表还是旧缓存config.toml改错位置实际配置没生效当前 provider 不是你以为的那个 providerKey 或模型分组没有 GPT-5.6 权限你看到的是官方账号模型列表调用时走的却是第三方 Base URL/model里没有但直接指定-m gpt-5.6-sol又能跑。所以这篇不写虚的。我按“普通用户最容易卡住的顺序”整理一套保姆级排查流程。你不要一上来就卸载重装也不要乱删.codex目录先按下面顺序查。一、先说结论正式上线了但不等于每个入口马上刷新截至我写这篇的时间也就是 2026 年 7 月 11 日OpenAI 官方公告里已经明确写到GPT-5.6 is available starting today across ChatGPT, Codex, and the OpenAI API.官方同时写了三类入口ChatGPTCodexOpenAI API。但这里一定要分清楚正式上线 ≠ 你的客户端模型列表立刻刷新 正式上线 ≠ 所有账号、所有套餐、所有第三方接入同时显示 正式上线 ≠ 你旧的 Codex 会话自动切到 GPT-5.6尤其是 Codex 这种工具它中间至少隔着几层OpenAI 模型开放 - 当前账号或 provider 权限 - Codex 远端模型目录 - 本地 Codex 客户端版本 - 本地配置和缓存 - /model 选择器显示 - 实际调用成功任何一层没同步你都会看到“别人有我没有”。二、先确认你是哪一种“没有”不要只说“我没有 GPT-5.6”。先判断是哪种没有。现象大概率问题ChatGPT 里没有 GPT-5.6账号套餐、地区、rollout、设置入口或刷新问题Codex/model里没有Codex 版本旧、模型目录没刷新、旧会话缓存Codex / CC Switch 里没有第三方工具自己的模型列表没有拉新/model没有但codex debug models里有旧会话或选择器缓存重启/新会话/直接指定模型debug models里也没有当前 Codex 没拿到新模型目录或 provider 权限不对选到了 GPT-5.6 但调用失败Key、Base URL、模型分组、模型 ID 或额度问题提示model not found模型名写错或者当前 Key 没开放这个模型提示401/403认证或权限问题提示429用量、额度、频率或并发限制这张表很重要。如果你连问题属于哪一类都没分清就会陷入一个循环更新 Codex - 看不到 - 重装 - 还是看不到 - 怀疑没上线其实很多时候不是没上线而是模型目录、配置层或 provider 没同步。三、第一步确认你真的更新到了新 Codex先在 PowerShell 里执行codex--version我写这篇时本机显示的是codex-cli 0.144.1你不一定要和我完全一样后续看到更高版本也正常。重点是确认你本机调用的不是旧版本。如果你是 npm 安装的 Codex可以更新npm install-g openai/codexlatestCodex 也提供了自更新命令可以试codex update更新后不要马上下结论先关闭当前 PowerShell重新打开一个新窗口再执行codex--version为什么要重新开终端因为很多人更新成功了但当前终端环境仍然命中旧路径。尤其是 Windows 上之前装过多个 Node、npm 或 Codex就很容易出现“你以为更新了其实运行的还是旧入口”。继续查路径Get-Commandcodex where.exe codex如果输出里有多个codex说明你电脑里可能有不止一个安装位置。优先确认当前实际执行的是哪一个。四、第二步不要只看/model先看 Codex 原始模型目录这是这篇最关键的一步。很多人只会进 Codex 后输入/model如果选择器里没有 GPT-5.6就以为自己没权限。不一定。Codex 有一个更直接的诊断命令codex debug models它会打印 Codex 当前看到的原始模型目录。官方文档里也写了这个命令用于查看 Codex 看到的 raw model catalog。在 Windows PowerShell 里可以这样筛选codex debug models|Select-String-Patterngpt-5.6|5.6如果你能看到类似gpt-5.6-sol GPT-5.6-Sol gpt-5.6-terra gpt-5.6-luna说明什么说明 Codex 当前已经能拿到 GPT-5.6 的模型目录。问题大概率不在“模型没有上线”而在当前/model页面没有刷新老会话还在使用旧状态Codex / CC Switch 没同步config.toml里默认模型没改当前 profile 或项目配置覆盖了用户配置。这时候不要继续重装直接进入下一步。五、第三步对比 bundled 目录判断是不是缓存/刷新问题继续执行codex debug models--bundled|Select-String-Patterngpt-5.6|5.6这个命令和刚才有什么区别--bundled看的是当前 Codex 二进制里自带的模型目录不去刷新远端模型目录。所以会出现三种结果。第一种codex debug models 有 GPT-5.6 codex debug models --bundled 没有 GPT-5.6这通常说明你的 Codex 通过远端刷新已经能看到新模型但当前安装包自带的旧目录里没有。只要实际调用能用问题不大。第二种两个命令都有 GPT-5.6这说明 Codex 本身已经比较新模型目录也同步了。你看不到模型多半是会话、选择器或配置覆盖问题。第三种两个命令都没有 GPT-5.6这时候才重点检查Codex 是否真的更新成功当前账号或 provider 是否有权限网络是否能刷新远端模型目录第三方接入后台是否已经开放当前是否走错 provider。这一步比盲目卸载更有用。六、第四步完全退出旧会话再新开 Codex如果codex debug models里已经能看到 GPT-5.6但/model里仍然没有先做一个最简单的动作退出当前 Codex 会话关闭终端重新打开 PowerShell再进 Codex。进入后再输入/model如果仍然没有直接用模型参数启动codex-m gpt-5.6-sol这里要注意-m只负责指定模型不负责切换 provider。也就是说如果你当前 provider 还是官方账号它就按官方账号走如果你当前 provider 是 KKFlow 或其他第三方配置它就按当前 provider 走。模型能不能调用要看当前 provider 下是否有这个模型 ID。如果你用的是 Terra 或 Luna也可以按实际模型 ID 指定例如codex-m gpt-5.6-terra codex-m gpt-5.6-luna模型名不要凭感觉编后面会讲怎么查。七、第五步检查config.toml很多人就是改错位置Windows 默认配置文件通常在notepad$env:USERPROFILE\.codex\config.tomlmacOS / Linux 通常是~/.codex/config.toml你要找的是根级model字段例如model gpt-5.6-sol如果你还有代码审查模型也可以看review_model gpt-5.6-sol这里有一个非常常见的坑不要把model gpt-5.6-sol随手加到[model_providers.xxx]里面。模型默认值通常是根级配置。Provider 表里写的是 provider 的 Base URL、认证方式、协议等信息。你把model塞进 provider 表后面不一定会按你想的方式生效。还有第二个坑项目级配置覆盖。Codex 配置不是只读一个文件。官方配置说明里提到Codex 会按优先级加载多个配置层包括 CLI 参数、项目.codex/config.toml、profile、用户~/.codex/config.toml等。所以你改了用户目录下的config.toml但当前项目里如果还有.codex/config.toml那项目配置可能会覆盖你的默认模型。进入 Codex 后可以用/debug-config看当前到底加载了哪些配置层。这个命令很适合排查“我明明改了 config.toml为什么没有生效”。八、第六步Codex / CC Switch 用户要刷新工具自己的模型列表如果你用的是 Codex、CC Switch 或 CCS 管理 provider不要只更新 Codex CLI。这些工具通常也有自己的模型列表、配置模板或导入缓存。你要做的是打开 Codex / CC Switch / CCS - 找到模型管理或模型列表 - 刷新 / 拉取最新模型列表 - 重新启用当前配置 - 退出 Codex - 新开终端再进 Codex如果后台已经能看到 GPT-5.6但工具里还是没有优先看有没有“刷新模型列表”“导入到 CCS”“重新生成配置”这类按钮。很多人卡在这里KKFlow 后台有 GPT-5.6 Codex CLI 也更新了 但 CCS 里仍然是旧模型列表这不是模型没上线而是中间工具没有同步。如果工具暂时还没拉到也可以手动在当前生效的config.toml里把根级模型改成后台实际模型 IDmodel gpt-5.6-sol保存后一定要重新启用配置并重启 Codex。九、第七步确认当前 Key 和 Base URL 真的能看到 GPT-5.6如果你走官方 API就按官方 API 后台和当前组织权限确认。如果你走 OpenAI 兼容接口或第三方 provider要先测模型列表。我自己常用的一个 AI API 统一接入入口是https://kkflow.org它常用的 OpenAI 兼容 Base URL 是https://kkflow.org/v1模型列表测试接口https://kkflow.org/v1/modelsPowerShell 里可以这样测curl.exehttps://kkflow.org/v1/models-HAuthorization: Bearer sk-你的KKFlow密钥注意公开文章、截图、群聊、视频和仓库里都不要展示真实 API Key。上面的sk-你的KKFlow密钥只是占位符。如果返回的模型列表里能看到gpt-5.6-sol gpt-5.6-terra gpt-5.6-luna说明这个 Key 所在分组可以看到对应模型。如果/v1/models里都没有那 Codex 里硬填模型名也没用。它最终还是会报model not found十、第八步用codex doctor做本地诊断如果你已经排查了版本、模型目录、配置、provider、Key还是不对可以跑codex doctor如果想拿到更完整的输出codex doctor--all官方命令说明里写得很清楚codex doctor会检查本地安装、配置、认证、运行时、Git、终端、app-server 和会话相关问题。这对排查“为什么我本机就是不对”很有用。如果你要把报错发给别人看先脱敏不要发真实 API Key不要发完整账号 token不要发公司内部项目路径可以发codex --version可以发Get-Command codex可以发脱敏后的config.toml关键片段可以发codex debug models是否能搜到5.6。十一、如果怀疑本地状态有问题用临时 CODEX_HOME 验证这个方法适合进阶一点的用户。如果你怀疑自己的.codex目录里有历史配置、旧 profile 或工具残留不建议你一上来就删整个.codex。更稳妥的方式是用一个临时干净目录验证。PowerShell 示例$env:CODEX_HOME$env:TEMP\codex-clean-testNew-Item-ItemType Directory-Force-Path$env:CODEX_HOME|Out-Nullcodex--version codex debug models|Select-String-Patterngpt-5.6|5.6这个动作不会直接动你原来的$env:USERPROFILE\.codex如果临时CODEX_HOME里能看到 GPT-5.6而原目录里看不到那就说明问题大概率在你原来的本地配置、profile 或工具生成配置里。这时候再回头查~/.codex/config.toml项目里的.codex/config.toml你是否用了--profileCodex / CC Switch 是否覆盖了配置当前 provider 是否切错不要直接删数据库文件和历史会话里面可能有你之前的记录。十二、常见问题逐条对照1. 我已经更新 Codex为什么还是没有 GPT-5.6先跑codex debug models|Select-String-Patterngpt-5.6|5.6如果这里有说明模型目录已经到了重点查旧会话、/model刷新、config.toml和第三方工具缓存。如果这里没有再查版本、provider 和权限。2./model里没有但直接codex -m gpt-5.6-sol能启动正常吗这种情况可能是选择器显示没刷新或者你当前模型列表 UI 还没同步。只要实际调用成功说明模型 ID 和 provider 链路是通的。但建议后面还是把config.toml和工具模型列表同步好否则每次手动指定会比较麻烦。3.model not found是什么意思通常是三种情况模型 ID 写错当前 Key 所在分组没有这个模型当前 Base URL 不是你以为的 provider。先测/v1/models不要靠猜。4. 我在 ChatGPT 能看到 GPT-5.6为什么 Codex 不能用ChatGPT、Codex、API、第三方 provider 不是完全同一个入口。ChatGPT 里能看到不代表你的 Codex 当前 provider 一定能调用。反过来也一样第三方接入能看到不代表你的官方 ChatGPT 账号已经同步显示。5. 我用 KKFlow 后台看到 GPT-5.6但 Codex 没有按这个顺序查后台模型列表 - /v1/models 是否返回 GPT-5.6 - CCS / CC Switch 是否刷新模型列表 - Codex 当前 provider 是否切到 KKFlow - config.toml 根级 model 是否正确 - 重启 Codex - codex debug models 是否能看到6. 我是不是要删缓存不要第一步就删。更稳妥的顺序是重启终端 - codex debug models - 刷新 Codex / CC Switch - 检查 config.toml - /debug-config - 临时 CODEX_HOME 验证确认是本地状态问题以后再考虑备份后清理对应配置。不要盲删整个.codex里面可能有历史会话、认证、日志和你的个人配置。十三、最快排查清单照着做就行如果你不想看解释直接按这套来。Windows PowerShellcodex--versionGet-Commandcodex where.exe codex codex update npm install-g openai/codexlatest关闭 PowerShell重新打开再执行codex--version codex debug models|Select-String-Patterngpt-5.6|5.6codex debug models--bundled|Select-String-Patterngpt-5.6|5.6如果能搜到 GPT-5.6codex-m gpt-5.6-sol如果还是不行打开配置notepad$env:USERPROFILE\.codex\config.toml确认根级有model gpt-5.6-sol进入 Codex 后再看/model /debug-config最后跑诊断codex doctormacOS / Linuxcodex--versionwhichcodex codex updatenpminstall-gopenai/codexlatest重新打开终端codex--versioncodex debug models|grep-igpt-5.6\|5.6codex debug models--bundled|grep-igpt-5.6\|5.6直接指定模型codex-mgpt-5.6-sol打开配置nano~/.codex/config.toml确认model gpt-5.6-sol再跑codex doctor十四、我建议新手按这个顺序接入如果你之前完全没用过 Codex或者旧配置已经很乱我建议按这个顺序来1. 更新 Codex 2. 重新打开终端 3. 确认 codex --version 4. 用 codex debug models 搜 GPT-5.6 5. 确认当前 provider 和 Base URL 6. 测 /v1/models 7. 修改 config.toml 根级 model 8. 刷新 Codex / CC Switch 模型列表 9. 重启 Codex 10. 用 codex -m gpt-5.6-sol 直接启动这比反复卸载重装靠谱。十五、最后说一下 KKFlow 的位置如果你能稳定走官方链路当然优先按官方方式用。但国内开发者实际接 Codex经常不是卡在“不会写提示词”而是卡在这些地方网络和认证Key 怎么管Base URL 填哪里模型名怎么切Codex、Claude Code、生图 API 能不能统一调用失败后去哪里看报错和用量。我自己常用的一个 AI API 统一接入入口是https://kkflow.org它的价值不是替你“绕过”什么而是把 Key、模型、接口地址和用量放到同一套后台里管理。像这次 GPT-5.6 上线真正影响体验的往往不是新闻本身而是谁能更快把模型列表、Base URL、Key 分组和客户端配置同步好。常用地址用途地址主站、登录、后台和指南https://kkflow.orgOpenAI 兼容 API Base URLhttps://kkflow.org/v1模型列表测试接口https://kkflow.org/v1/models如果你通过 KKFlow 接 Codex重点确认三件事后台是否开放 GPT-5.6 /v1/models 是否能看到 GPT-5.6 Codex 当前 provider 是否真的切到 KKFlow这三件事都通再去看 Codex 本地缓存和模型选择器。十六、总结GPT-5.6 已经正式上线但很多人更新 Codex 后还是看不到这很正常。你不要只盯着/model页面也不要一上来就重装。正确顺序是版本 - 路径 - 原始模型目录 - bundled 对比 - 配置层 - provider - /v1/models - 实际调用最关键的两个命令记住codex debug models|Select-String-Patterngpt-5.6|5.6codex doctor如果debug models里已经有 GPT-5.6但/model没有大概率是旧会话、选择器或第三方工具缓存问题。如果/v1/models里没有 GPT-5.6说明当前 Key 或分组还没看到这个模型Codex 里硬填也没用。如果你还是排不出来可以在评论区发这几项注意脱敏操作系统 codex --version Get-Command codex / which codex codex debug models 是否能搜到 5.6 用的是官方账号还是 KKFlow / 第三方 provider 脱敏后的具体报错不要发真实 API Key。我后面可以继续整理一版“Codex GPT-5.6 常见报错对照表”把model not found、401、403、429、配置不生效、CCS 不刷新这些问题单独拆开讲。参考资料OpenAI GPT-5.6 官方公告https://openai.com/index/gpt-5-6/OpenAI Codex Developer Commandshttps://learn.chatgpt.com/docs/developer-commands?surfacecliOpenAI Codex Config Basicshttps://learn.chatgpt.com/docs/config-file/config-basicKKFlowhttps://kkflow.org
