Codex Desktop App

Codex Desktop 是 OpenAI 推出的桌面端 AI 编码助手，提供图形化界面，支持多项目工作区、代码编辑与 Agent 模式。通过配置 OpenAI 兼容接口，可将 Codex Desktop 对接到 AutoRouter，使用 AutoRouter 网关分发的各类模型。

• 官方主页：https://chatgpt.com/codex
• 项目主页：https://github.com/openai/codex

Codex Desktop 与 Codex CLI 共用 ~/.codex/ 目录下的配置文件，配置一次两端均可使用。

📦 接入前准备

准备信息

• 已安装 Codex Desktop App
• 一个可用的 AutoRouter 地址（必须以 /v1 结尾）
• 一个可用的 AutoRouter API Key（在控制台生成）
• 想使用的模型名称（如 gpt-5-codex、gpt-5.4 等，需与 AutoRouter 控制台中的模型 ID 完全一致）

🚀 配置步骤

一键配置（推荐）

Codex Desktop 不读取 OPENAI_BASE_URL 环境变量，必须通过 ~/.codex/config.toml 配置。可运行以下脚本自动写入配置：

macOS / Linux

curl -fsSL https://docs.autorouter.top/helper/codex-cli-setup.sh | bash

Windows（PowerShell）

iex (irm 'https://docs.autorouter.top/helper/codex-cli-setup.ps1')

按提示输入 AutoRouter 地址和 API Key 即可。

启动使用

1. 若 Desktop 此前登录过 OpenAI 官方账号，请重启 Codex Desktop 使配置生效。
2. 在模型选择器中选择 autorouter provider 及对应模型。
3. 开始对话，模型正常响应即配置成功。

❓ 常见问题

请求仍发往 api.openai.com

Codex Desktop 不读取 OPENAI_BASE_URL 环境变量，必须在 config.toml 中通过 [model_providers.xxx] 显式配置 base_url。

报错 404 Not Found

base_url 缺少末尾的 /v1。请使用 https://autorouter.top/v1 格式。

报错 401 Unauthorized

检查 API Key 是否正确，或重新运行一键配置脚本更新密钥。

模型列表中找不到配置的模型

在 config.toml 中直接修改 model 字段为目标模型 ID，保存后重启 Desktop。