CLI 已经切换模型，桌面客户端却没有变化；CLI 可以正常回复，VS Code 仍提示配置异常。

这类问题通常不是安装失败，而是没有分清三端的共享配置、项目配置和独立设置。

先记住一个结论：

Codex CLI、桌面客户端和 VS Code 可以读取同一份通用配置，但当前项目、临时模型、会话状态和界面设置不会全部同步。

---

📌 一、三端关系速查

配置或状态	是否共享
用户级 ~/.codex/config.toml	三端默认共享
项目级 .codex/config.toml	打开同一项目时生效
默认模型和提供商	写入配置文件后共享
CLI 临时启动参数	仅当前运行生效
VS Code 编辑器设置	仅 VS Code 生效
当前会话和临时模型	三端各自独立
当前项目或工作目录	三端单独选择

最容易混淆的是：

共享同一份 config.toml，不代表三端当前打开的是同一个项目、会话和工作目录。

---

✅ 二、哪些配置共享

Codex 的用户级配置文件是：

~/.codex/config.toml

Codex CLI、Codex 桌面客户端和 VS Code 可以读取这份通用配置。

本系列使用的默认模型为：

model = "gpt-5.6-sol"

当默认模型、模型提供商和 API 地址等内容写入 config.toml 后，通常不需要在三端分别复制一遍。

如何打开配置文件

Codex 桌面客户端：

Settings → Configuration → Open config.toml

VS Code：

Codex 侧边栏 → 设置图标 → Codex Settings → Open config.toml

打开后重点确认：三端实际读取的是不是同一份配置文件。

项目配置可能覆盖全局配置

除了用户级配置，项目目录内还可能存在：

项目目录/.codex/config.toml

项目配置的优先级高于用户级配置。

因此，即使三端都读取：

~/.codex/config.toml

只要其中一端打开了带有项目配置的目录，最终生效的模型或其他设置就可能不同。

想让项目配置保持一致，需要确认：

• CLI 在该项目目录下运行；

• 桌面客户端打开的是同一个项目；

• VS Code 打开的是同一个工作区。

⚠️ 三端打开的项目不同，读取到的项目配置也可能不同。

auth.json 和 config.toml 别混淆

本系列配置中还会用到：

~/.codex/auth.json

两份文件的作用不同：

文件	主要作用
auth.json	保存登录或密钥信息
config.toml	保存模型、提供商和 API 地址等配置

密钥正确但模型配置错误，仍然可能无法调用；反过来，config.toml 正确但密钥类型不对，同样无法正常回复。

⚠️ auth.json 包含敏感信息，不要公开，也不要上传到 Git 仓库。

---

⚙️ 三、哪些设置独立

1. CLI 临时参数

通过 CLI 启动参数或当前会话临时切换的模型，通常只影响本次运行。

它不会自动修改：

~/.codex/config.toml

想让三端长期使用同一个默认模型，应直接修改 config.toml。

2. VS Code 编辑器设置

VS Code 插件还有一套编辑器专属设置，主要控制侧边栏、字体、输入方式和交互行为。

这类设置只在 VS Code 内生效，不会改变 Codex CLI 或桌面客户端。

💡 VS Code 界面设置与 Codex 通用配置不是一回事。

3. 当前模型与会话

在桌面客户端或 VS Code 中临时切换模型，不等于修改了全局默认模型。

三端的当前会话也彼此独立：

• CLI 中的聊天内容不会自动进入 VS Code；

• 桌面客户端选择的文件不会自动加入 CLI 会话；

• 当前会话临时使用的模型不会自动覆盖全局配置。

4. 当前项目目录

三端需要分别选择项目或工作目录。

如果桌面客户端与 VS Code 打开的不是同一个目录，看到的文件和代码修改也可能不同。

因此，出现“桌面客户端已经改完，VS Code 却看不到”的情况，应先检查两边的项目路径，而不是重新安装。

---

🔍 四、为什么三端不一致

遇到三端表现不一致，可以根据现象快速定位：

现象	优先检查
CLI 正常，VS Code 异常	工作区目录、项目配置、VS Code 独立设置
CLI 正常，桌面客户端异常	配置文件路径、当前项目、临时模型选择
三端模型不一致	全局模型、项目配置覆盖、临时切换
配置正确但无法调用	auth.json、密钥类型、API 地址
代码修改不同步	三端是否打开同一个项目目录

排查时，先检查以下三项：

1. 三端读取的是不是同一份 config.toml；

2. 三端打开的是不是同一个项目目录；

3. 当前客户端是否临时切换过模型。

很多所谓的“配置不生效”，实际是项目配置或临时选择覆盖了全局默认值。

---

💡 五、总结

Codex 三端的配置关系，可以归纳为四句话：

全局默认：修改 ~/.codex/config.toml。

项目差异：检查项目内的 .codex/config.toml。

临时选择：通常只影响当前客户端或当前会话。

界面设置：CLI、桌面客户端和 VS Code 分别管理。

如果 CLI 正常，桌面客户端或 VS Code 不生效，先不要重复安装，也不需要复制三套配置。

按照下面的顺序检查即可：

配置文件路径 → 项目目录 → 项目配置覆盖 → 临时模型选择 → 密钥信息

先确认三端读取的是不是同一份配置、打开的是不是同一个项目，通常就能找到问题。

---

🔗 相关文章

✅Windows 版 Codex + Claude Code 下载、安装、配置教程（2026年8月版）

✅Mac 版 Codex + Claude Code 下载、安装、配置保姆级教程（2026 最新版）