手把手排查|Codex 桌面版接入 GPT-5.6 报错排查清单
Codex 桌面版配置完成却没有回复,先看具体表现:
-
出现
401:检查auth.json -
模型无响应:检查 API Key 和
config.toml -
修改不生效:检查配置目录和读取路径
-
中文没变化:检查网络和语言包
按照下面的顺序逐项排查,不需要反复修改全部配置。
📌 快速定位
| 问题 | 优先检查 |
|---|---|
401 |
API Key、auth.json |
| 模型无响应 | 密钥分组、模型、接口地址 |
| 配置不生效 | 文件目录、读取路径 |
| 中文未生效 | 网络、语言包 |
⚠️ 一、401:查 auth.json
打开 auth.json,确认文件中只有一行:
{"OPENAI_API_KEY":"sk-xxx"}
将 sk-xxx 替换成自己的 API Key,并检查:
-
API Key 是否复制正确
-
文件中是否存在其他内容
-
LetAiCode 密钥分组是否选择
codex
⚠️
auth.json中不要加入其他配置,否则可能出现401。
保存文件,重启 ChatGPT 桌面应用。
🔑 二、无响应:查密钥和模型
没有明确报错,但模型一直不回复,重点检查下面三项。
检查密钥
登录 LetAiCode,确认:
-
API Key 分组为
codex -
auth.json中填写的是当前 API Key
检查 config.toml
正确配置如下:
model_provider = "letaicode"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.letaicode]
name = "letaicode"
base_url = "https://letaicode.cn/codex"
wire_api = "responses"
requires_openai_auth = false
重点确认:
-
配置放在
config.toml最上方 -
model_provider为letaicode -
base_url为https://letaicode.cn/codex -
wire_api为responses
检查模型名称
| 模型 | 配置 |
|---|---|
gpt-5.6-sol |
model = "gpt-5.6-sol" |
gpt-5.6-terra |
model = "gpt-5.6-terra" |
gpt-5.6-luna |
model = "gpt-5.6-luna" |
修改完成后,保存文件并重启应用。
⚙️ 三、不生效:查配置路径
Codex 默认读取用户目录下的 .codex 文件夹。
| 系统 | 配置目录 |
|---|---|
| Windows | C:\Users\<你的用户名>\.codex\ |
| macOS | /Users/<你的用户名>/.codex/ |
目录中应该包含:
auth.json
config.toml
同时确认:
-
两个文件已经保存
-
config.toml内容位于文件最上方 -
文件编码为 UTF-8
手动指定配置路径
如果 Codex 仍未读取配置:
-
打开 ChatGPT 桌面应用并进入 Codex。
-
进入“设置”→“配置”。
-
找到
Custom config.toml settings。 -
在
user config中填写路径。
Windows:
C:\Users\<你的用户名>\.codex\config.toml
macOS:
/Users/<你的用户名>/.codex/config.toml
保存后,完全退出并重新打开应用。
💡 四、中文没变化:重新加载语言包
依次进入:
File → Settings → General → Language for the app UI
选择:
Chinese (China)
确认网络正常,等待语言包下载完成,然后重启应用。
✅ 五、最后确认
最后检查以下内容:
-
密钥分组选择了
codex -
auth.json中只保留 API Key -
config.toml位于正确目录 -
接口地址和模型名称填写正确
-
修改配置后已经重启应用
进入 Codex,输入:
hello
能够正常回复,说明 API Key、配置文件和 GPT-5.6 模型均已生效。
🔗 系列文章
更多推荐



所有评论(0)