一、Codex Desktop 是什么？

Codex Desktop 是 OpenAI 推出的 AI 编程桌面客户端，官方将其定义为"用于管理 AI 编程代理（agents）的开发工作中心"。

简单来说，它就是一个 AI + IDE + 自动化开发助手，核心能力包括：

• 🤖 AI 自动编写、修改、调试代码

• 🔍 智能查 Bug 并给出修复方案

• 📝 自动生成测试用例和技术文档

• 🔄 自动化开发任务（部署、整理代码等）

• 👥 支持多个 AI Agent 同时工作，每个任务有独立 workspace

• 🌐 支持多种模型（gpt-5.3-codex、gpt-5.4 等）

• 🌍 支持中文界面

---

二、安装 Codex Desktop

macOS 用户

1. 打开 App Store

2. 搜索 Codex

3. 点击下载安装即可

Windows 用户

1. 访问微软商店：https://apps.microsoft.com/detail/9plm9xgg6vks

2. 点击 获取 / 下载

3. 按提示完成安装

系统要求：Windows 10 19041 以上，需联网

切换中文界面

安装完成后首次打开默认为英文界面，手动切换方法：

1. 打开 Codex Desktop

2. 点击左上角 File → Settings

3. 进入 General

4. 找到 Language for the app UI，选择 Chinese (China)

5. 如果未生效，请确保网络通畅（需下载语言包），然后重启软件

---

三、LetAiCode 中转 API 配置

PS：如果你已经之前通过命令行正常配置且可以正常使用codex了，那就不需要再配置了

安装完 Codex Desktop 后，还需要配置 API 才能使用。这里我们使用 LetAiCode 中转 API 平台，支持 Claude Code、Gemini Pro、OpenAI Codex 等模型，按量计费，扣费透明。

第一步：注册并获取 API Key

1. 访问 LetAiCode 官网 并注册账号

2. 登录后，点击 接口密钥 页面

3. 点击 创建新密钥

4. 关键配置（务必注意）：

• 密钥类型/分组：务必选择 codex（否则无法使用！）

• 额度：选择 无限额度，不要限制模型

• 令牌名称：随意填写

• 创建成功后，复制生成的 API Key（格式为 sk-xxx），妥善保存

⚠️ 重要提醒：API Key 只在创建时显示一次，请立即复制保存！

第二步：创建配置文件

Codex Desktop 的配置文件位于用户主目录下的 .codex 文件夹中，需要创建两个文件：auth.json 和 config.toml。

配置目录位置：

• Windows：C:\Users\<你的用户名>\.codex\

• macOS：/Users/<你的用户名>/.codex/

Windows 用户操作步骤：

1. 打开文件资源管理器，导航到 C:\Users\<你的用户名>\

2. 如果看不到 .codex 目录，请先开启 "显示隐藏的项目"（查看 → 显示 → 隐藏的项目）

3. 如果没有 .codex 文件夹，手动创建

4. 在其中创建 auth.json 和 config.toml 两个文件

macOS 用户操作步骤：

打开终端（Terminal），执行以下命令：

mkdir -p ~/.codex touch ~/.codex/auth.json touch ~/.codex/config.toml

第三步：编辑 auth.json

将以下内容写入 auth.json（将 sk-xxx 替换为你自己的 API Key）：

{"OPENAI_API_KEY": "sk-xxx"}

如果文件中已有其他内容，直接覆盖即可。

第四步：编辑 config.toml

将以下内容写入 config.toml：

model_provider = "api111" model = "gpt-5.3-codex" model_reasoning_effort = "high" disable_response_storage = true preferred_auth_method = "apikey" [model_providers.api111] name = "api111" base_url = "https://letaicode.cn/codex" wire_api = "responses"

各配置项说明：

• model_provider — 自定义提供商名称，需与下方 [model_providers.xxx] 对应

• model — 使用的模型名称，可选 gpt-5.3-codex、gpt-5.4 等

• model_reasoning_effort — 模型思考努力程度，可选 high（高）、medium（中）、low（低）

• disable_response_storage — 禁用响应存储（建议开启）

• preferred_auth_method — 认证方式，使用 API Key 时设为 apikey

• base_url — LetAiCode 中转 API 地址

• wire_api — API 协议格式，codex 使用 responses

💡 切换模型：如果想使用最新的 gpt-5.4，将 model = "gpt-5.3-codex" 改为 model = "gpt-5.4" 即可。

第五步：Desktop 客户端内指定配置路径（可选）

Codex Desktop 会自动读取 .codex 目录下的配置文件。如果配置后未生效，可手动指定：

1. 打开 Codex Desktop

2. 进入 设置 → 配置

3. 在 Custom config.toml settings 下的 user config 中填写配置文件路径

• Windows：C:\Users\<你的用户名>\.codex\config.toml

• macOS：/Users/<你的用户名>/.codex/config.toml

---

四、启动与验证

1. 打开 Codex Desktop 应用

2. 输入一句简单的测试内容，例如：hello

3. 如果能正常回复，说明 API 配置成功 ✅

---

五、使用技巧

你可以直接给 Codex 一个任务目标，它会自动规划并执行。以下是常见使用场景：

写代码 — 帮我写一个 Python 爬虫，抓取豆瓣电影 Top250

修改代码 — 给这个项目添加用户登录功能

查 Bug — 这段代码报了 NullPointerException，帮我排查

写测试 — 为 src/utils.js 中的所有函数编写单元测试

写文档 — 帮我写一份 API 接口文档

代码重构 — 重构这个模块，使用设计模式优化代码结构

自动化任务 — 帮我配置 CI/CD 流水线

使用建议：

• 给出清晰的任务目标，Codex 会自动规划并执行

• 可以同时开启多个 Agent 处理不同任务

• 查看 Code Diff 确认修改内容后再应用

---

六、常见问题排查

Q：安装后打开软件无法使用？

Codex Desktop 需要 API Key 才能调用模型，请确保已完成上文的 API 配置步骤。

Q：配置完成后无法正常响应？

按以下步骤逐一排查：

1. 确认 API Key 正确：登录 LetAiCode，检查密钥是否选择了 codex 分组、额度是否为 无限额度、模型是否 未做限制

2. 确认配置文件路径正确：Windows 为 C:\Users\<用户名>\.codex\，macOS 为 /Users/<用户名>/.codex/

3. 确认配置文件内容无误：auth.json 中的 API Key 是否正确替换，config.toml 中的 base_url 是否正确

4. 重启 Codex Desktop 后再试

Q：切换中文界面后没变化？

确保网络通畅（需要下载语言包），重新切换一次语言设置，然后重启应用。

Q：配置文件修改后不生效？

在 Desktop 客户端内手动指定配置文件路径，确认文件编码为 UTF-8，然后重启 Codex Desktop。

---

参考链接 LetAiCode 官网：https://letaicode.cn/

Codex Desktop Windows 版：https://apps.microsoft.com/detail/9plm9xgg6vks

Codex 官方文档：

https://github.com/openai/codex