Codex 桌面版

新手推荐

Codex 桌面版适合第一次接触 Codex 的用户。它可以直接选择本地项目，并用图形界面查看任务进度和文件改动，不要求提前安装 Node.js。

开始前准备

开始前请确认已经：

• 完成充值
• 创建 ApiKey，并为密钥选择可用分组

1. 安装桌面应用

前往 Codex 官方快速开始，下载适合当前系统的桌面应用。官方目前将它称为 ChatGPT 桌面应用，安装后可以在应用中选择 Codex。

桌面应用支持 Windows 和 macOS。安装完成后先打开一次，确认应用可以正常启动。

2. 导入 Codex 配置

推荐使用 CC-Switch 写入接口地址、模型和 ApiKey：

1. 下载并安装 CC-Switch。
2. 安装完成后打开一次 CC-Switch。
3. 回到后台的 API 密钥 页面，点击目标密钥旁的 导入到 CCS。
4. 在导入窗口中确认应用类型为 Codex，然后点击 导入。
5. 回到 CC-Switch 主界面，启用刚导入的配置。

需要查看完整截图时，参考 使用 CC-Switch 配置 Codex。

3. 重启桌面应用

配置文件只会在客户端启动时重新加载。导入完成后，请完全退出桌面应用，再重新打开。

如果应用仍在系统托盘或后台运行，也需要先将它退出。只关闭当前窗口可能不会重新加载配置。

4. 打开项目并测试

1. 在桌面应用中选择 Codex。
2. 打开一个本地项目文件夹。
3. 新建任务并发送一条简单指令，例如：

请先阅读这个项目的目录结构，并告诉我它使用了哪些主要技术。

能够正常收到回复，就说明桌面版已经配置完成。

常见问题

导入后仍然使用原来的配置

完全退出桌面应用后重新打开。Codex 桌面版、CLI 和 IDE 扩展共用本机的 Codex 配置，已经运行的客户端不会自动重新加载文件。

浏览器无法唤起 CC-Switch

先手动打开一次 CC-Switch，再回到后台重新点击 导入到 CCS。如果仍然失败，参考 Codex 手动配置。

提示认证、模型或余额错误

回到后台确认 ApiKey 没有被禁用、已经选择可用分组，并且账户余额或套餐仍然可用。配置内容应以后台当前生成的内容为准。

其他使用方式

习惯在终端中工作时，可以继续配置 Codex CLI。两种方式可以同时安装并共用配置。