下载安装
从官方页面下载对应系统版本。
新手图文教程
Codex Desktop
跟着截图配好
Codex Desktop 按截图配置。若使用 Codex CLI、Claude Code 或 Gemini CLI，请改走主站完整安装文档。
Windows / macOS / Linux · Desktop 图文 · CLI 走主站文档
完整流程
图文版照着做，不用来回切换
创建密钥
选择购买的订阅分组并创建 API 密钥。
粘贴配置
把配置内容放入 config.toml 和 auth.json。
重启并验证
保存文件后重启 Codex，发送简单任务测试。
先准备好这两样东西
已兑换的订阅套餐和刚创建的 API 密钥。Desktop 用下面截图；CLI / Claude / Gemini 用主站文档。
主站文档
打开完整安装指南 ↗
CLI 与多客户端不要只看这一页
主站安装指南覆盖 Node.js、Codex CLI、Claude Code、Gemini CLI，以及各系统权限与 PATH 问题。Desktop 自定义网关以各官方客户端是否支持为准。
01
下载安装
先安装 Codex Desktop
打开官方页面，根据你的操作系统选择版本并完成安装。
官方入口
打开官方下载页 ↗
下载 ChatGPT Desktop
Codex 已集成在 ChatGPT Desktop 中。
安装完成后
打开桌面端并登录，继续完成密钥和配置。
02
控制台操作
创建 API 密钥并选择订阅分组
兑换套餐后，创建一个 Codex 专用密钥。
进入 API 密钥
点击“API 密钥”→“创建密钥”。
选择购买的分组
选择已购买的 Plus、Plus++、Pro 或 Pro+。
创建并保存密钥
填写名称并创建，复制密钥备用（仅显示一次）。
03
客户端配置
把密钥和配置放进 Codex
手动编辑 config.toml 和 auth.json，也可以用 CC Switch 导入。
配置目录
找到 `.codex` 文件夹
Windows 找到用户目录下的 `.codex`；macOS / Linux 使用 ~/.codex。
C:\\Users\\你的用户名\\.codex
文件一
编辑 `config.toml`
打开文件，粘贴配置并保存。
文件二
编辑 `auth.json`
打开文件，填入刚复制的 API 密钥。
~/.codex/auth.json
{
"OPENAI_API_KEY": "sk-你的API密钥"
}密钥安全
把示例中的 `sk-你的API密钥` 替换为你自己的完整密钥。不要把密钥发到群聊、截图、GitHub 或公开网页。
04
可选快捷方式
使用 CC Switch 一键导入
不想手动编辑时，使用 CC Switch 导入。
第三方工具
打开下载页 ↗
CC Switch 官方下载
请从官网或 GitHub Releases 下载。
找到导入按钮
在 API 密钥列表点击导入图标。
导入后检查
确认 API 地址、密钥和订阅分组。
最后一步
重启并验证
保存文件，重启 Codex 后发送简单任务测试。
重新启动
关闭 Codex Desktop 后重新打开，让新的配置文件生效。
发送测试任务
先让 Codex 只读分析项目，不要一开始就提交复杂或高风险任务。
请只读分析当前项目，告诉我技术栈和启动方式，不要修改文件。确认请求正常
先确认订阅分组可以正常响应，再开始正式使用。
选
最后推荐 · 可选功能
需要时再开启付费回落
订阅额度够用时无需开启。只有已经充值余额，并希望订阅用完或暂时不可用时自动继续使用，才建议打开这个功能。
使用前提先充值余额 → 再开启付费回落 → 订阅不可用时自动扣余额没有余额时不要开启；主订阅仍够用时，也不需要开启。
编辑密钥
回到 API 密钥列表，找到要使用的密钥，点击右侧编辑按钮。
打开付费回落
确认账户已经充值余额，再滚动到编辑窗口最下方，打开“付费回落”开关。
添加付费分组
选择用于余额扣费的分组，确认提示后点击“更新”。
常见问题
遇到问题先看这里
提交问题时请提供操作系统、Codex 版本和脱敏后的错误信息，不要发送完整密钥。
不需要。订阅额度够用时，直接使用订阅分组即可。付费回落是给已经充值余额、希望在订阅额度用完或暂时不可用时自动继续使用的用户准备的。
必须先充值余额，再添加付费分组并开启付费回落。余额不足时，回落请求无法继续；主订阅仍可用时，系统优先使用订阅，不会因为开启回落就每次扣余额。
Windows 可以在地址栏输入 `%USERPROFILE%\\.codex`；macOS / Linux 可以在终端执行 `mkdir -p ~/.codex`。如果文件夹不存在，可以手动创建。
先确认 `config.toml` 和 `auth.json` 位于同一个 `.codex` 文件夹，检查文件扩展名是否正确，然后完全退出并重新打开 Codex。仍有问题时再联系售后，并提供脱敏错误信息。
准备好了
从第一步开始，按截图完成配置
套餐兑换、创建密钥和配置文件完成后，就可以开始使用；CLI 与其它客户端请对照主站文档。付费回落请按需选择。