Codex 桌面版

Codex 桌面版与 CLI 共用同一份配置，配好 CLI 即可使用。本页说明如何确认配置已经生效。

Codex 桌面版（macOS、Windows）和 Codex CLI 读的是同一份 ~/.codex/config.toml。也就是说，Codex 那页配好供应商之后，桌面版这边不需要再做任何设置。

还没配过的话，先完成 Codex 页的配置步骤。

确认配置已生效

按下面四步比对一次。

手工改配置文件的：直接打开 ~/.codex/config.toml，确认 model_provider 和 [model_providers.…] 区块都在。

用 CC Switch 配的：打开 CC Switch，点供应商条目进入编辑页，下滑到 config.toml（TOML） 区块，就能看到实际写进去的内容。

供应商叫什么名字都行，只要 model_provider 和 [model_providers.…] 两处对得上。

打开桌面版的设置，左侧选配置，点右上角的打开 config.toml，文件会在系统默认编辑器里打开。

重点看 model_provider 和 base_url 两项，一致就说明桌面版读的是同一份配置。对不上的话，通常是改完配置后桌面版没重启。

在桌面版里发送任意消息，收到正常回复即表示接入成功。输入框附近会显示当前模型，点开可以在模型映射里配好的那几个模型之间切换。

现象	解决办法
桌面版仍然要求登录 OpenAI 账号	配置没读到。按上面四步比对一次，确认两边的 `model_provider` 一致。
CLI 能用，桌面版不能用	两种可能：一是桌面版启动时才读一次配置，改完配置后要完全退出再重开，仅关窗口不够；二是密钥来源不同——方式 A 把密钥放在环境变量里，而桌面版不一定继承终端的环境变量，改用 CC Switch 配置可以避开这个问题。
两份 `config.toml` 内容不一致	CC Switch 改完配置后要重启桌面版才会重新读取。
报鉴权错误	方式 A 检查 `env_key` 指向的环境变量是否设置正确；方式 B 在 CC Switch 里重新填一遍 API Key，保存后重启桌面版。
桌面版模型下拉是空的	走方式 B 时，在 CC Switch 的模型映射里点「获取模型列表」拉取，然后重启桌面版。
多轮对话第二轮开始报错	配置里漏了 `disable_response_storage = true`，详见 Codex。