Codex Desktop 接入 OpenAI Hub 教程

这篇教你怎么把 Codex Desktop 的请求改走 OpenAI Hub，5 分钟跑通，不用写一行代码。

准备工作

你需要两样东西：

装好的 Codex Desktop（官网下载即可：https://chatgpt.com/codex ）
OpenAI Hub 的 API Key，去 https://openai-hub.com 注册后在控制台创建，格式是 sk-xxxx，只显示一次，立刻复制保存

第一步：找到配置目录

Codex Desktop 所有配置都在用户目录下的 .codex 文件夹里。

Windows：C:\Users\你的用户名\.codex\
macOS：~/.codex/（也就是 /Users/你的用户名/.codex/）

如果看不到 .codex 文件夹：

Windows：打开文件资源管理器 → 顶部「查看」→ 勾选「显示隐藏的项目」
macOS：在 Finder 里按 Command + Shift + . 显示隐藏文件

找不到这个文件夹？直接手动新建一个，名字就叫 .codex（注意前面有个点）。

第二步：建两个配置文件

在 .codex 文件夹里新建两个空文件：

auth.json
config.toml

Windows 用户注意：新建时如果系统隐藏了扩展名，可能保存成了 auth.json.txt，会导致后面读不到配置。先在「查看」里勾上「文件扩展名」，确认后缀对。

macOS 用户可以直接在终端跑：

mkdir -p ~/.codex
touch ~/.codex/auth.json ~/.codex/config.toml

第三步：写 auth.json

用记事本（Windows）或者文本编辑器（macOS）打开 auth.json，粘贴下面内容：

{
  "OPENAI_API_KEY": "sk-your-api-key"
}

把 sk-your-api-key 换成你在 OpenAI Hub 拿到的真实 Key。

第四步：写 config.toml

打开 config.toml，把下面这段整个粘进去：

model = "gpt-5-codex"
model_provider = "openaihub"
model_reasoning_effort = "medium"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.openaihub]
name = "openaihub"
base_url = "https://api.openai-hub.com/v1"
wire_api = "responses"
requires_openai_auth = true

几个字段说明（不想看可以跳过）：

model：你想用的模型名，换成 OpenAI Hub 后台支持的任何一个模型都行
model_reasoning_effort：推理强度，可选 minimal / low / medium / high
base_url：固定写 https://api.openai-hub.com/v1，末尾的 /v1 不能丢
wire_api：必须是 responses，不能写成 chat，这是 Codex 最容易踩的坑

第五步：重启 Codex Desktop

完全退出 Codex Desktop（macOS 用 Command + Q，Windows 在托盘里右键退出），然后重新打开。

打开后随便问一句「你好」，能正常回话就接通了。

常见踩坑

1. 提示要登录 Claude / OpenAI 账号

说明配置文件没生效。先看路径对不对、文件名对不对（特别是 Windows 的 .json.txt 问题），再确认 auth.json 里 Key 的格式没有多空格、多引号。

2. 报 404 或 "Unknown endpoint"

大概率是 base_url 漏了 /v1，或者 wire_api 写成了 chat。Codex 走的是 responses 协议，这两个都得对上。

3. 模型名报错 "model not found"

去 OpenAI Hub 控制台的模型列表里复制确切的模型名，别凭感觉写。大小写、连字符都要一致。

4. Windows 沙盒权限问题

如果跑命令时一直提示没权限，在 config.toml 里加一段：

[windows]
sandbox = "elevated"

5. 改完配置不生效

一定要完全退出 Codex Desktop 再开，不是关掉窗口就行，托盘/Dock 里还在跑就没用。

配好这一套，OpenAI Hub 上能用的模型在 Codex Desktop 里都能直接选，一个 Key 全搞定。