Codex 桌面端

OpenAI 的 Codex 图形应用（Codex App）。和 Codex CLI 共用同一份配置。

没碰过命令行？先看命令行入门（3 分钟）。如果你已经装过 Codex CLI，只需在终端里执行一条 codex app 就能打开桌面端。

打开成功的标志：弹出独立的桌面窗口。它和命令行版共用同一份配置，所以配好了 CLI，桌面端通常直接能用。

无需写代码：这是图形界面应用，装好后在设置里填接口地址、密钥、选模型即可，全程点击操作。和 Codex CLI 共用同一份配置，配好一个另一个通常直接能用。

和 Codex CLI 的关系

Codex 桌面端与 Codex CLI 是同一套东西的两个界面，读同一份配置文件 （~/.codex/config.toml 与 ~/.codex/auth.json）。

所以配置只需要做一次。 先按 Codex CLI 那页把 config.toml 配好，桌面端会自动读到 —— 不用重复配置。

第一步：安装

方式一：如果已经装了 Codex CLI

直接运行：

codex app

会启动桌面应用。首次运行可能会提示你下载安装组件，按提示走。

方式二：从官网下载

访问 OpenAI 的 Codex App 页面（chatgpt.com/codex）下载安装包，对应系统下载对应版本即可。

装完后应用里也有图形化的常用设置入口；更细的选项（例如自定义供应商）仍然读 config.toml。

第二步：配置网关

不必重新配置。桌面端读的就是你在 Codex CLI 那页写好的 ~/.codex/config.toml：

[model_providers.juheai]
name = "juheai"
base_url = "https://api.juheai.shop/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

[profiles.juheai]
model_provider = "juheai"
model = "你的模型名"

密钥仍放在环境变量 OPENAI_API_KEY 里。

桌面端对环境变量的读取可能和终端不同。 如果你是从桌面图标启动（不是从终端敲 codex app），它可能读不到你在某个终端窗口里临时 export 的变量。 用 setx（Windows）或写进 shell 配置文件 让变量成为持久设置，再重启应用。

第三步：验证

启动桌面端，开一个新会话随便问一句。能回答就说明接通了。

和 Codex CLI 的差异

项	Codex CLI	Codex 桌面端
配置来源	同一份 `~/.codex/config.toml` 与 `auth.json`
启动方式	`codex`	`codex app` 或应用图标
适合场景	脚本、远程服务器、终端习惯	图形操作、可视化 diff、多会话

想给桌面端换供应商、用图形界面管理？ 那是第三方工具 Codex++ 的活。它能图形化地管理和切换多个供应商，并写回 Codex 的配置。

排查

`codex app` 提示命令不存在

Codex CLI 版本过旧。先升级： npm install -g @openai/codex，或从官网重新下载安装包。

桌面端连不上，但 CLI 能通

十有八九是环境变量没送达 —— 桌面端从图标启动时不一定继承终端的环境。用 setx 设为持久变量，然后完全重启应用
确认 config.toml 路径正确： Windows 是 %USERPROFILE%\.codex\config.toml
确认 model 是你分组里实际开放的模型名

一直引导我用 ChatGPT 账号登录

走网关不需要官方登录。确认 config.toml 里的 model_provider 指向的是你的 [model_providers.juheai] 段，并且启动时用了对应的 profile。

官方入口：openai.com/zh-Hans-CN/codex、 github.com/openai/codex （README 里写明桌面端入口是 codex app）。

还是搞不定？把这三样发给客服，基本一看就知道问题在哪：① 终端里最后 5～10 行文字（可截图，注意别拍到密钥）② 你在本页做到第几步 ③ 报错的原文或截图。密钥属于隐私，发送前可以先给后几位打码。