跳到正文
HopBase 文档
登录控制台

Codex App

让 OpenAI 的 Codex 桌面应用通过 HopBase 调用 GPT 模型。

Codex App 是 OpenAI 的 Codex 桌面应用，和 Codex CLI 读同一套用户配置 ~/.codex/config.toml。配好这份配置和密钥，重开应用即可使用 HopBase。

项目值
配置文件~/.codex/config.toml 与 ~/.codex/auth.json
Base URLhttps://api.hop-base.com/v1
协议wire_api = "responses"
密钥Codex Plus 或 Codex Pro 分组的密钥

推荐：一键接入或 CC Switch

两种方式都会写好 config.toml 和 auth.json，Codex App 直接可用。

写入配置

在控制台「API 密钥」页找到 Codex 分组的密钥，任选一种：点「一键接入」选 Codex CLI，复制命令到终端执行；或按 CC Switch 指南点「导入 CCS」，同样选 Codex CLI。

完全退出并重开 Codex App

退出整个应用再重新打开，macOS 可按 Cmd+Q。只关窗口时，应用不会重新读取配置。

新建任务验证

新建一个任务，让它只回一个词。成功后到控制台「使用记录」能看到这次请求。

手动配置

Codex App 从图形界面启动，不一定能读到终端里设置的环境变量。因此手动配置时用 auth.json 存密钥，不用 env_key。

系统配置目录
macOS / Linux~/.codex/
WindowsC:\Users\你的用户名\.codex\

文件不存在就新建。

config.toml：

model_provider = "hopbase"
model = "gpt-6-astra"
model_reasoning_effort = "high"

[model_providers.hopbase]
name = "HopBase"
base_url = "https://api.hop-base.com/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json：

{
  "OPENAI_API_KEY": "sk-你的密钥"
}
两种密钥写法不要混用：

requires_openai_auth = true 配 auth.json，env_key 配环境变量，只选一种。两者写进同一份配置时，Codex 0.153 实测不发送密钥，网关返回 401 missing_api_key。

切换模型

改 config.toml 里的 model 和 model_reasoning_effort，完全退出并重开 Codex App，再新建任务。已有任务可能沿用创建时的模型。

Codex 分组可用的模型 ID 和推理档位见 Codex CLI；以当前密钥调 GET /v1/models 的返回为准。

更多细节

下一步

本页目录

推荐：一键接入或 CC Switch写入配置完全退出并重开 Codex App新建任务验证手动配置切换模型更多细节下一步