Codex Desktop

Codex 桌面客户端是 OpenAI 官方提供的独立 GUI 应用，提供图形化界面进行 AI 编程，无需使用命令行。

前置条件

已创建 API 密钥

安装

前往 Codex 下载页面，下载对应系统的安装包，按提示完成安装。

Macshot Clipboard 46DBF865 2CAA 466F 8AC3 E11823A2E280

配置

Codex 桌面客户端与 CLI 共享配置文件，如果你已经配置过 Codex CLI，桌面客户端会自动读取，无需重复配置。

一站式导入（推荐）
手动配置

通过 Teio 站点一键导入，无需手动复制 Key 和地址。需要先安装 CC Switch。

打开 Teio 密钥页面，点击密钥右侧下拉按钮，选择 “CC 切换”

Macshot Clipboard CFC10349 AF02 4AF4 A24F 3E93D9BDB544

CC Switch 自动打开导入面板，补充供应商名称并选择模型
点击”导入”完成

创建 ~/.codex/config.toml 和 ~/.codex/auth.json（Windows 路径为 C:\Users\<用户名>\.codex\）。

mkdir -p ~/.codex

config.toml：

model_provider = "teio"
model = "gpt-5.4"
model_reasoning_effort = "medium"
disable_response_storage = true

[model_providers.teio]
name = "teio"
base_url = "https://teio.me/v1"
wire_api = "responses"
requires_openai_auth = true
web_search = "live"

auth.json：

{
  "OPENAI_API_KEY": "你的密钥"
}

使用

启动 Codex 桌面客户端
在对话框中输入编程需求，Codex 会直接在项目中读取和编辑代码

Macshot Clipboard EE3FE851 A8AE 4B4D 8302 740360B506F7

常见问题

桌面客户端和 CLI / VSCode 扩展有什么区别？

三者共享相同的配置文件，功能基本一致。桌面客户端提供独立的图形化界面，适合不习惯命令行的用户。

已经配置过 CLI，还需要重新配置吗？

不需要。桌面客户端会自动读取 ~/.codex/ 下的配置文件。

遇到其他问题？请参考常见问题。

Codex CLI Hermes Agent

​前置条件

​安装

​配置

​使用

​常见问题

前置条件

安装

配置

使用

常见问题