Codex 配置方法

本文介绍如何让 Codex 桌面应用（UI 客户端） 使用 wylon 部署的模型，适合不习惯使用终端的用户。

配置原理

Codex 桌面应用启动时，会读取同一个隐藏文件夹下的两个配置文件：

• config.toml：决定模型请求发往哪里、使用哪个模型——我们把它指向 wylon 的服务。
• auth.json：用于绕过 Codex 自身的登录校验。Codex 只检查该文件是否存在，不校验 key 是否真实，因此填入一个假 key 即可跳过 OpenAI 登录。

配置文件夹位置：

• macOS：~/.codex/
• Windows：C:\Users\你的用户名\.codex\

情况 A：尚未安装 Codex

第 1 步：下载安装（装好后先不要打开）

• macOS：在 OpenAI 官网 Codex 页面（developers.openai.com/codex）下载 Mac 版应用。
• Windows：在 Microsoft Store 搜索「Codex」安装。

第 2 步：修改 config.toml

配置文件路径：

# macOS
~/.codex/config.toml

# Windows
$env:USERPROFILE\.codex\config.toml

请先复制一份 config.toml 作为备份，命名为 config.toml.bak。然后把下面内容粘贴进去，建议按顺序放在文件开头，且不要有重复配置：

model = "GLM5.2"                          # 改成实际模型名
model_provider = "wylon"
disable_response_storage = true          # 重要：会话内容不依赖服务端存储

[model_providers.wylon]
name = "wylon"
base_url = "https://api.wylon.cn/v1"
requires_openai_auth = false
experimental_bearer_token = "你的API-Key" # 在 wylon 控制台申请 API Key 后填入

第 3 步：跳过 ChatGPT 登录

推荐做法：直接打开 Codex 应用，点击「使用其他方式登录」，随便填一个值，例如：

sk-dummy

填完后应用会自动写入 auth.json，登录即可通过。这个假 key 不会被用于任何请求。

备选做法：如果你的版本登录界面没有 API key 选项，可手动创建文件。

macOS 终端执行：

printf '{ "OPENAI_API_KEY": "sk-dummy" }' > ~/.codex/auth.json

Windows PowerShell 执行：

Set-Content -Path $env:USERPROFILE\.codex\auth.json -Value '{ "OPENAI_API_KEY": "sk-dummy" }'

然后启动应用。

第 4 步：使用

到这里就可以直接使用了。

情况 B：已安装 Codex 且登录过 ChatGPT

第 1 步：退出登录

先退出登录——目前 Codex 在登录 OpenAI 账号的状态下不支持使用自定义模型。退出后 Codex 会进入登录欢迎界面，点击「使用其他方式登录」，与情况 A 第 3 步一致，填入 sk-dummy 并登录。登录完成后完全关闭 Codex。

第 2 步：按情况 A 配置 config.toml

与情况 A 一致，配置好 config.toml 后重启 Codex 即可使用。

恢复方法

1. 将当前 config.toml 改名为 config.toml.wylon，再把 config.toml.bak 改回 config.toml。
2. 删除 auth.json。
3. 重新启动 Codex，即可回到正常登录界面。

注意事项