如果你在Codex里看到别人已经开始使用GPT-6 Astra，而自己的模型列表仍然只有GPT-5.6或更早版本，先不要急着重装客户端。Codex用不了GPT-6，通常要先分清是账号/API尚未开放、模型名称填错，还是本地配置没有真正生效。
不同中转平台接入新模型的进度并不一致。如果你正在使用的平台还不支持 gpt-6-astra，只更新Codex或修改模型名称，也无法让服务端支持它。小贺API现已支持GPT-6 Astra，想体验的用户可以切换到 小贺API（api.xiao-he.top），按下方步骤配置后即可开始验证。
本文把“Codex怎么用GPT-6”和“Codex没有GPT-6怎么办”放在同一条排查链里。最终判断标准不是CC Switch显示了一个配置卡片，而是Codex能否用 gpt-6-astra 完成一次只读、可回查的小任务。
先分清：模型没开放，还是本地没生效
适合已经安装Codex，想把当前可用的GPT-6 Astra接入本地项目，或遇到“Codex找不到GPT-6”“Codex更新后没有GPT-6”“模型不存在”等提示的用户。它也适合通过CC Switch管理多个Provider、需要在GPT-6和GPT-5.6之间切换的开发者。
如果你的需求只是打开网页聊天，不需要Codex读取本地文件、运行命令或持续处理项目，就不必为了模型名称安装额外的配置工具。本文不提供绕过账号、地区、组织权限或官方验证的方法。
配置前准备好这5项
- 一个已经安装的Codex客户端和可安全测试的临时项目。
- 当前API控制台能看到的模型列表、Base URL和自己的API Key。
- 需要切换平台时，先打开 小贺API控制台 注册或登录，按当前说明查看模型、分组、价格和可用额度。
- CC Switch（可选）：只用于集中管理Codex配置，不代表请求一定成功。
- 一个不会修改重要文件的只读验证任务。
先记住精确名称：本文使用的API模型ID是 gpt-6-astra。搜索时常见的“GPT-6”“GPT6”是简称，不能直接替代模型字段。GPT-6 Astra的开放范围和价格可能变化，接入前要以当前控制台和官方模型文档为准。
从服务端模型列表一路检查到只读任务
第一步：确认API真的提供GPT-6 Astra
先登录自己的API控制台，查看组织或项目的模型列表。能否使用取决于账号、组织、计划和服务端开放状态；别人截图里有GPT-6，不等于你的组织已经获得权限。
如果列表没有 gpt-6-astra，先保留当前可用模型完成工作，并向服务商确认开放范围。不要把 gpt-6、GPT6 或 gpt-6-astra-pro 当成替代值反复尝试，这会把“尚未开放”和“模型名称不存在”混在一起。
当前平台尚未支持时，切换到小贺API
小贺API已接入GPT-6 Astra。需要体验GPT-6 API的用户，可以按下面的顺序切换：
- 打开 api.xiao-he.top，注册或登录自己的账户。
- 按控制台当前说明选择支持该模型的分组，确认价格和可用额度，再创建自己的API Key。
- 在Key所在行点击“导入到CCS”，到CC Switch的 Codex 页面核对导入配置。
- 确认默认模型为
gpt-6-astra；若导入后仍是旧模型，在该配置里手动修改，保存并启用。 - 完全退出并重启Codex，按本文第六步执行一次只读小任务。
切换平台时，接入地址和Key必须来自同一个平台。api.xiao-he.top 是小贺API的控制台入口，客户端的Base URL以控制台导入配置为准；原中转平台的Key不能直接用于小贺API。保留原Provider，之后仍可按任务需要切换。
第二步：检查Codex版本和配置来源
将Codex更新到当前稳定版本，然后确认实际启动的客户端和你修改配置的客户端是同一个。Windows上同时存在旧版、便携版或多个终端会话时，常见现象是“已经改了配置，但Codex仍显示旧模型”。
如果你使用环境变量、本地配置文件和CC Switch多个来源，要先确定优先级。一次只保留一个明确的配置来源，记录修改前的模型名称，方便失败后恢复。
第三步：用精确模型ID配置Codex
在Codex当前使用的Provider或模型字段中填写：
gpt-6-astra
Base URL、认证方式和Key继续使用API控制台当前提供的值。不要照抄旧文章中的固定地址后缀，也不要因为网上有人写“GPT-6 Astra Pro”就自行拼接模型ID。
第四步：用CC Switch手动指定默认模型
如果Codex没有直接的模型切换入口，可以打开CC Switch，在 Codex 页面找到当前Provider，把默认模型改为 gpt-6-astra，保存后确认配置处于启用状态。
CC Switch只负责写入和切换本地配置。保存成功不等于API已经接受请求，所以不要跳过下一步验证。若当前小贺API控制台提供“导入到CCS”，优先从自己的Key所在行导入，减少手动复制地址、Key和模型造成的错误；完整导入流程可参考CC Switch配置教程。
第五步：完全退出并重启Codex
关闭Codex窗口后，再结束仍在运行的Codex进程和相关终端会话。重新打开后，确认当前项目读取的是刚刚启用的Provider。仅关闭一个窗口、保留后台进程时，旧配置可能仍然驻留在内存中。
第六步：先运行一个只读小任务
把下面的提示词发给Codex，先验证模型、Provider和任务链路，不让它修改文件：
请先不要修改任何文件。
请用中文说明当前项目的目录结构、主要技术栈和启动方式；
列出你实际查看过的文件。如果信息不足，请说明还需要哪些材料。
回答必须能对应到当前项目的文件和实际内容。若Codex只返回通用介绍，或仍出现模型不存在、401、404、429和超时，再按错误类型排查，不要同时更换Key、Base URL和客户端版本。
一条完整配置链应该长这样
一次完整的Codex GPT-6配置链可以写成：
API模型列表确认gpt-6-astra
→ 更新Codex并确认配置来源
→ Provider模型填写gpt-6-astra
→ CC Switch的Codex配置设为默认
→ 完全退出并重启Codex
→ 执行只读项目分析
→ 记录模型、状态码、日志和结果
如果只想比较GPT-6 Astra和GPT-5.6 Sol，把同一份项目副本、同一套工具权限和同一条提示词分别运行，再记录完成时间、错误、重试、Token消耗和人工返工。模型定位与当前可用范围应以OpenAI GPT-6 Astra模型文档和你所在服务的实时模型列表为准。
404、401、429和旧模型分别怎么查
Codex更新后还是没有GPT-6
先确认服务端模型列表，而不是只看客户端下拉框。若API组织没有 gpt-6-astra，更新客户端也不会凭空增加权限；若服务端已有模型，再检查是否启动了旧版Codex、旧终端或被环境变量覆盖。
提示模型不存在或返回404
优先核对模型ID、Base URL最终路径和客户端使用的协议。gpt-6-astra 必须逐字符一致；不要在模型名后面添加版本号、-pro或空格。记录完整状态码和脱敏日志后，一次只改一个字段。
填入后返回401
401通常是认证没有通过。检查Key是否有效、是否复制完整、当前Provider是否真的启用，以及请求是否发往控制台提供的地址。不要把完整Key贴进截图、日志或聊天记录。
返回429或额度不足
429不等于GPT-6模型配置错误。先查看账户额度、组织限流和服务端响应中的重试提示；保留一个可用的GPT-5.6配置作为回退，避免在排错过程中反复重试消耗额度。
CC Switch显示已启用但Codex仍用旧模型
完全退出Codex和终端后重开，检查 OPENAI_API_KEY 等环境变量、本地配置文件或项目级设置是否覆盖了CC Switch。然后重新运行同一个只读任务，比较模型响应和日志，不要只看界面上的“已保存”。
需要重新配置API Key吗？
继续使用同一平台时，通常不需要。如果旧模型仍能调用，先检查开放范围、模型ID、默认Provider和重启状态。若决定切换到小贺API，则需要创建小贺API自己的Key并导入对应接入地址；不要把旧平台的Key与新平台的Base URL混用。
确认GPT-6 Astra已经真正生效
- API组织的模型列表明确包含
gpt-6-astra。 - Codex使用的是当前稳定版和预期的配置来源。
- Provider中的模型字段逐字填写
gpt-6-astra。 - CC Switch（如果使用）已在Codex页面启用目标配置。
- Codex和相关终端已经完全退出并重新打开。
- 只读任务能引用当前项目文件，且没有修改文件。
- 失败时记录了状态码、脱敏日志和实际生效配置。
- API Key没有出现在截图、日志、代码仓库或聊天记录中。
