Codex 桌面版
Codex 桌面版与 CLI 共用同一份配置,装好即可用;本页说明如何确认配置已经生效。
Codex 桌面版(macOS、Windows)和 Codex CLI 读的是同一份 ~/.codex/config.toml。也就是说,上一页配好供应商之后,桌面版这边不需要再做任何设置。
还没配过的话,先看配置模型供应商。
确认配置已生效
想验证桌面版确实读到了那份配置,按下面四步比对一次。
查看已写入的配置
用 CC Switch 配的:打开 CC Switch,点开供应商条目进入编辑页,下滑到 config.toml(TOML) 区块,就能看到实际写进去的内容。
手工改配置文件的:直接打开 ~/.codex/config.toml。

供应商叫什么名字都行(上图里是 custom),只要 model_provider 和 [model_providers.…] 两处对得上就行。
打开桌面版的 config.toml
打开桌面版的设置,在左侧选配置,点右上角的打开 config.toml,文件会在系统默认编辑器里打开。

比对两份配置
重点看 model_provider 和 base_url 这两项,两边一致就说明桌面版读的是同一份配置。
发消息验证
在桌面版里发一条测试消息,能正常收到回复即接入成功。输入框右下角会显示当前模型和推理强度,点开就能在模型映射里配好的那几个模型之间切换。

常见问题排查
| 现象 | 解决办法 |
|---|---|
| 桌面版仍然要求登录 OpenAI 账号 | 配置没读到。按上面四步比对一次,确认两边的 model_provider 一致。 |
两份 config.toml 内容不一致 | CC Switch 改完配置后要重启桌面版才会重新读取。 |
| 桌面版报错但 CLI 正常 | 密钥来源不同:方式 C 把密钥放在环境变量里,而桌面版不一定继承终端的环境变量,改用 CC Switch 配置(方式 A 或 B)可避开这个问题。 |
