Codex Desktop 安装配置保姆级教程

很多人装完 Codex Desktop 后，第一反应是：软件能打开，但不知道怎么配置 API，也不知道为什么发消息没反应。

其实流程并不复杂，关键是把 安装、中文界面、API Key、配置文件路径 这几步做对。

这篇主要整理 Codex Desktop 桌面客户端的安装方法，以及使用 LetAiCode 中转 API 的完整配置流程。照着一步步做，新手也能快速上手。

unsetunset一、Codex Desktop 是什么？unsetunset

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

简单理解，它更像是一个 AI + IDE + 自动化开发助手，可以帮你把一些开发任务拆解、执行、修改和验证。

它的核心能力包括：

• 🤖 AI 自动编写、修改、调试代码
• 🔍 智能查 Bug，并给出修复思路
• 📝 自动生成测试用例和技术文档
• 🔄 处理自动化开发任务，比如部署、整理代码等
• 👥 支持多个 AI Agent 同时工作，每个任务有独立 workspace
• 🌐 支持多种模型，比如 gpt-5.3-codex、gpt-5.4 等
• 🌍 支持中文界面

📌 简单说，如果你想用 AI 帮你读项目、改代码、查问题，Codex Desktop 会比单纯聊天窗口更适合开发场景。

unsetunset二、安装 Codex Desktopunsetunset

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
5. 选择 Chinese (China)

⚠️ 如果切换后没有生效，通常是语言包没有正常下载。保持网络通畅后，重启软件再试一次。

unsetunset三、LetAiCode 中转 API 配置unsetunset

PS：如果你之前已经通过命令行正常配置，并且 Codex 可以正常使用，这一步一般不需要重复配置。

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

第一步：注册并获取 API Key

1. 访问 LetAiCode 官网：https://letaicode.cn/?aff=KbmuqF 并注册账号
2. 登录后，点击 接口密钥 页面
3. 点击 创建新密钥

关键配置一定要注意：

• 密钥类型 / 分组：务必选择 codex
• 令牌名称：随意填写
• 创建成功后，复制生成的 API Key，格式一般为 sk-xxx

⚠️ 重要提醒： API Key 通常只在创建时显示一次，生成后请立刻复制并妥善保存。

第二步：创建配置文件

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

• auth.json
• config.toml

配置目录位置：

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

Windows 用户操作步骤：

1. 打开文件资源管理器
2. 进入：

C:\Users\<你的用户名>\

1. 如果看不到 .codex 目录，先开启：

查看 → 显示 → 隐藏的项目

1. 如果没有 .codex 文件夹，手动创建
2. 在 .codex 文件夹中创建：

auth.jsonconfig.toml

macOS 用户操作步骤：

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

mkdir -p ~/.codextouch ~/.codex/auth.jsontouch ~/.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 = truepreferred_auth_method = "apikey"[model_providers.api111]name = "api111"base_url = "https://quiz.playoffer.cn/codex"wire_api = "responses"requires_openai_auth = false

各配置项说明：

💡 切换模型： 如果想使用最新的 gpt-5.4，把这一行：

model = "gpt-5.3-codex"

改成：

model = "gpt-5.4"

保存后重启 Codex Desktop 即可。

第五步：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

⚠️ 如果你改完配置后没反应，优先检查路径是否写错，其次重启客户端。

unsetunset四、启动与验证unsetunset

配置完成后，可以按下面方式验证：

1. 打开 Codex Desktop 应用
2. 输入一句简单测试内容，例如：

hello

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

如果没有响应，不要急着反复改配置，先看下面的常见问题排查。

unsetunset五、使用技巧unsetunset

Codex Desktop 的使用方式，不是只问一句“帮我写代码”，而是可以直接给它一个明确任务目标，让它规划并执行。

常见使用场景：

使用建议：

• ✅ 任务目标要写清楚，不要只说“帮我优化一下”
• ✅ 可以同时开启多个 Agent，分别处理不同任务
• ✅ 应用修改前，先查看 Code Diff，确认改动内容
• ⚠️ 涉及生产项目时，不建议直接让它大范围改代码，最好先限定目录和文件范围

unsetunset六、常见问题排查unsetunset

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

Codex Desktop 需要 API Key 才能调用模型。

如果软件能打开，但无法正常回复，先确认是否已经完成上面的 API 配置步骤。

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

可以按下面顺序排查：

1. 确认 API Key 是否正确登录 LetAiCode，检查密钥是否选择了 codex 分组。

2. 确认配置文件路径是否正确

Windows：C:\Users\<用户名>\.codex\macOS：/Users/<用户名>/.codex/

1. 确认配置文件内容是否正确检查 auth.json 里的 API Key 是否已替换，config.toml 里的 base_url 是否正确。

2. 重启 Codex Desktop 后再试很多配置不生效，重启后才会重新读取。

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

一般是语言包没有下载成功。

建议保持网络通畅后，重新切换一次语言设置，然后重启应用。

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

可以重点检查这几点：

• Desktop 客户端内是否手动指定了配置文件路径
• config.toml 路径是否写对
• 文件编码是否为 UTF-8
• 修改配置后是否重启 Codex Desktop

⚠️ 配置文件这类问题，最常见的不是内容错，而是路径错、文件名错、保存格式错。

unsetunset参考链接unsetunset

LetAiCode 官网：https://letaicode.cn/

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

Codex 官方文档：https://github.com/openai/codex

如果你正在折腾 Codex Desktop，可以先收藏这篇，后面配置 API、切换模型、排查问题时会用得上。