夜雨聆风本教程专注于 Codex Desktop 桌面客户端的安装，以及使用 LetAiCode 提供的 API 进行完整配置流程。跟着一步步操作，几分钟即可上手。
一、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 用户
打开 App Store 搜索 Codex点击下载安装即可
Windows 用户
访问微软商店：https://apps.microsoft.com/detail/9plm9xgg6vks 点击 获取 / 下载 按提示完成安装
系统要求：Windows 10 19041 以上，需联网
切换中文界面
安装完成后首次打开默认为英文界面，手动切换方法：
打开 Codex Desktop 点击左上角 File→Settings进入 General找到 Language for the app UI，选择Chinese (China)如果未生效，请确保网络通畅（需下载语言包），然后重启软件
三、LetAiCode 中转 API 配置
安装完 Codex Desktop 后，还需要配置 API 才能使用。这里我们使用 LetAiCode 平台提供的 API ，支持 Claude Code、Gemini Pro、OpenAI Codex 等模型，按量计费，扣费透明。
第一步：注册并获取 API Key
访问 LetAiCode 官网：https://letaicode.cn/ 并使用邮箱登录 登录后，在个人中心点击 接口密钥 页面 点击 创建新密钥 关键配置（务必注意）： 密钥类型/分组：务必选择 codex（否则无法使用！） 额度：选择 无限额度，不要限制模型 令牌名称：随意填写 创建成功后，复制生成的 API Key（格式为 sk-xxx），妥善保存
⚠️ 重要提醒：API Key 只在创建时显示一次，请立即复制保存！
第二步：创建配置文件
Codex Desktop 的配置文件位于用户主目录下的 .codex 文件夹中，需要创建两个文件：auth.json 和 config.toml。
配置目录位置：
Windows： C:\Users\<你的用户名>\.codex\macOS： /Users/<你的用户名>/.codex/
Windows 用户操作步骤：
打开文件资源管理器，导航到 C:\Users\<你的用户名>\如果看不到 .codex目录，请先开启 "显示隐藏的项目"（查看 → 显示 → 隐藏的项目）如果没有 .codex文件夹，手动创建在其中创建 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 时设为apikeybase_url— LetAiCode 中转 API 地址wire_api— API 协议格式，codex 使用responses
💡 切换模型：如果想使用最新的 gpt-5.4，将
model = "gpt-5.3-codex"改为model = "gpt-5.4"即可。
第五步：Desktop 客户端内指定配置路径
Codex Desktop 会自动读取 .codex 目录下的配置文件。如果配置后未生效，可手动指定：
打开 Codex Desktop 进入 设置 → 配置 在 Custom config.toml settings 下的 user config 中填写配置文件路径 Windows： C:\Users\<你的用户名>\.codex\config.tomlmacOS： /Users/<你的用户名>/.codex/config.toml
四、启动与验证
打开 Codex Desktop 应用 输入一句简单的测试内容，例如： hello如果能正常回复，说明 API 配置成功 ✅
五、使用技巧
你可以直接给 Codex 一个任务目标，它会自动规划并执行。以下是常见使用场景：
写代码 — 帮我写一个 Python 爬虫，抓取豆瓣电影 Top250
修改代码 — 给这个项目添加用户登录功能
查 Bug — 这段代码报了 NullPointerException，帮我排查
写测试 — 为 src/utils.js 中的所有函数编写单元测试
写文档 — 帮我写一份 API 接口文档
代码重构 — 重构这个模块，使用设计模式优化代码结构
自动化任务 — 帮我配置 CI/CD 流水线
使用建议：
给出清晰的任务目标，Codex 会自动规划并执行 可以同时开启多个 Agent 处理不同任务 查看 Code Diff 确认修改内容后再应用
六、常见问题排查
Q：安装后打开软件无法使用？
Codex Desktop 需要 API Key 才能调用模型，请确保已完成上文的 API 配置步骤。
Q：配置完成后无法正常响应？
按以下步骤逐一排查：
确认 API Key 正确：登录 LetAiCode，检查密钥是否选择了 codex 分组、额度是否为 无限额度、模型是否 未做限制 确认配置文件路径正确：Windows 为 C:\Users\<用户名>\.codex\，macOS 为/Users/<用户名>/.codex/确认配置文件内容无误： auth.json中的 API Key 是否正确替换，config.toml中的base_url是否正确重启 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
