把 Codex 接到本站

确认手里这把 Key 是对的

打开控制台「API 密钥」。Codex 要用带 OpenAI 标识的分组，例如 plus 号池、Pro 号池这类。分组名会变，认图标和说明里是否写给 Codex / OpenAI 用。

还没有 Key，就先去 创建密钥，用隐藏输入跑通 /v1/models 再回来。

推荐：一键写入配置

到 创建密钥 页运行一键工具，选择 Codex。工具采用 Codex 的命令认证助手，避免把 API Key 直接写进 TOML。

1. 1

   跑脚本并选 Codex

   按系统复制那一行命令。出现客户端列表时选 Codex，再按提示粘贴 OpenAI 分组 Key。屏幕上通常不会回显完整密钥。

2. 2

   看它改了哪些文件

   成功时会告诉你备份路径，以及写入了用户级 ~/.codex/config.toml。Windows 对应 %USERPROFILE%\.codex\config.toml。

3. 3

   必须完全退出再开

   Dock / 开始菜单 / VS Code 里的 Codex 都要退干净。旧窗口会记住启动时的 Provider。从 Dock 点开的 App 有时读不到你在终端里设的环境变量，所以更建议用一键工具，而不是只 export 一下。

手动配置（CLI 用户）

想看清楚每一项再写，就把下面内容放到用户级 ~/.codex/config.toml。改之前先备份：

cp ~/.codex/config.toml ~/.codex/config.toml.backup

model = "gpt-5.6-sol"
model_provider = "geili_sub2api"

[model_providers.geili_sub2api]
name = "GeiliAPI"
base_url = "https://sub.geiliapi.com/v1"
wire_api = "responses"
env_key = "GEILI_SUB2API_KEY"
requires_openai_auth = false

这几行里最容易抄错的是：

1. 1

   名字必须对得上

   model_provider = "geili_sub2api" 必须和 [model_providers.geili_sub2api] 里的这段名字完全一样。

2. 2

   地址写到 /v1 为止

   base_url 是 https://sub.geiliapi.com/v1。不要写成根路径，也不要把 /responses 拼进去。

3. 3

   关掉官方登录抢权

   requires_openai_auth 必须是 false。写成 true 时，Codex 会忽略 env_key，请求仍走官方账号。

随后在启动 Codex 的同一个终端设置环境变量：

macOS

export GEILI_SUB2API_KEY="粘贴你的 OpenAI 分组 Key"
open -a Codex

先彻底退出 Codex，再用 open -a Codex 从终端拉起，桌面端才能读到这个变量。只从 Launchpad 点图标，经常读不到。

Windows

$env:GEILI_SUB2API_KEY = "粘贴你的 OpenAI 分组 Key"

这个变量只对当前 PowerShell 窗口有效。要长期使用，请改走一键工具，或在系统环境变量里添加同名变量后注销重登。

用哪个模型

默认填 gpt-5.6-sol。要更便宜更快改成 gpt-5.6-luna，要质量和价格折中改成 gpt-5.6-terra。改的是 config.toml 里的 model = 这一行。改完必须完全退出并新建会话，旧对话会记住启动时的模型。

模型名必须存在于这把 Key 的分组里。不确定就打开 模型价格，或回头看 /v1/models 的返回。

VS Code 用户多看一眼

扩展装好后，工作区必须是受信任的。未信任时，详情页会提示扩展已禁用，配置写对了也不会发请求。

改完 config.toml 后，不要只关 Codex 面板。要把整个 VS Code 退出再开，并新建一次 Codex 会话。

验证第一次请求

1. 1

   完全退出后重开

   确认没有残留的 Codex / ChatGPT 桌面端进程。VS Code 也要退出。然后新建会话，不要继续昨天的旧线程。

2. 2

   发一句最小任务

   发送：

   给 Codex复制

   只回复 OK。不要修改任何文件。

   成功时，对话里很快出现 OK 或等价短答。不要用长任务当第一次测试，不好判断是配置问题还是任务本身失败。

3. 3

   核对使用记录

   到控制台左侧「使用记录」。应出现这把 OpenAI 分组 Key、模型 gpt-5.6-sol（或你改过的 terra / luna），以及 Responses 接口。没有新记录，说明请求还没打到本站。

这个工具的故障