跳转到主要内容
Codex Desktop 使用和 Codex CLI 相同的本机配置。你需要先安装 Codex Desktop，然后把控制台生成的 config.toml 和 auth.json 写入 Codex 配置目录。 如果你已经按 Codex 页面完成配置，可以直接打开或重启 Codex Desktop。无需重新创建 API Key。

​
准备工作

  • 已完成 创建账号。
  • 已完成 获取 API Key。
  • 已安装 Codex Desktop。
  • 已从控制台打开目标 API Key 的 使用密钥 弹窗。
auth.json 中的 API Key 是明文保存的本机凭证。不要把 ~/.codex/auth.json、截图或终端输出提交到仓库，也不要发到聊天工具里。

​
安装客户端

请从 OpenAI Codex app 文档 下载并安装 Codex Desktop。安装完成后打开应用，并按应用提示完成初始设置。 如果你的系统暂时没有 Codex Desktop 安装入口，可以先使用 Codex CLI 完成命令行接入。

​
从控制台复制配置

1

进入 API 密钥页面

打开控制台，进入 API 密钥 页面。
2

选择 Codex CLI

找到要给 Codex Desktop 使用的 Key，点击 使用密钥，然后选择 Codex CLI。
3

选择系统

按你的电脑选择 macOS / Linux 或 Windows。控制台会显示对应配置文件路径。
4

写入本机配置

按 Codex 页面中的对应系统步骤写入 config.toml 和 auth.json。
5

重启 Codex Desktop

保存配置后，完全退出并重新打开 Codex Desktop。

​
配置文件位置

系统config.tomlauth.json
macOS / Linux~/.codex/config.toml~/.codex/auth.json
Windows%USERPROFILE%\.codex\config.toml%USERPROFILE%\.codex\auth.json
如果你在 WSL 中使用 Codex，请配置 WSL 用户目录下的 ~/.codex/，不要只改 Windows 用户目录。 model、review_model、base_url 和 API Key 都以控制台显示为准。字段含义见 Codex 页面。

​
验证

打开 Codex Desktop，选择一个本地项目，然后发送一个低风险任务： 
请用一句话说明当前项目用途，不要修改文件。
如果 Codex Desktop 可以正常回复，并且没有认证失败或找不到模型的错误，说明配置已生效。

​
常见问题

不需要。Codex Desktop 读取同一套 ~/.codex/ 配置。完全退出并重新打开 Codex Desktop 即可。
确认新的配置放在 config.toml 文件开头。保存后完全退出 Codex Desktop，再重新打开。
检查 auth.json 是否是合法 JSON。确认 API Key 没有漏字符、换行或多余空格。
model 和 review_model 必须使用控制台显示的模型名。不要直接复制其他用户截图里的模型名。