Codex 接入教程

让 OpenAI Codex 通过 GodAPI 调用模型。命令行、桌面版和 IDE 扩展读的是同一个配置目录，写好一次就能共用。

准备工作

登录 GodAPI 控制台，在「密钥」页面新建一把专给 Codex 用的密钥。
记下要用的模型名称，以控制台里你这把密钥能用的为准。

项目	填写内容
接口地址	`https://godapi.dev/v1`
协议	`responses`
密钥	`sk-你的密钥`（换成你自己的）
模型	控制台里能用的完整模型名

接口地址只写到 /v1，Codex 会自己在后面加上 /responses。写成 /v1/responses 会导致 404。

写配置文件

Codex 的用户配置放在主目录下的 .codex 文件夹里：

系统	位置
macOS / Linux	`~/.codex/config.toml`
Windows	`%USERPROFILE%\.codex\config.toml`
WSL	WSL 里的 `~/.codex/config.toml`（和 Windows 那份是分开的）

动手前先把已有的 config.toml、auth.json 复制一份做备份。下面两种认证方式二选一，不要混用。

方式一：环境变量（推荐命令行用户）

密钥不落盘，原来的登录信息也不受影响。在 config.toml 里写入或合并：

model = "填你的模型名"
model_provider = "godapi"

[model_providers.godapi]
name = "GodAPI"
base_url = "https://godapi.dev/v1"
wire_api = "responses"
env_key = "GODAPI_API_KEY"

model 和 model_provider 两行必须放在文件最上面，在任何 [...] 段落之前。env_key 填的是变量的名字，不是密钥本身。然后在同一个终端里设置密钥再启动：

# macOS / Linux
export GODAPI_API_KEY="sk-你的密钥"
codex

# Windows PowerShell
$env:GODAPI_API_KEY = "sk-你的密钥"
codex

这样设置的变量只在当前终端里有效。从桌面图标打开的桌面版读不到它，桌面版请用方式二。

方式二：认证文件（桌面版、IDE 共用）

config.toml：

model = "填你的模型名"
model_provider = "godapi"
cli_auth_credentials_store = "file"

[model_providers.godapi]
name = "GodAPI"
base_url = "https://godapi.dev/v1"
wire_api = "responses"
requires_openai_auth = true

在同一目录建 auth.json，字段名必须是 OPENAI_API_KEY，值填 GodAPI 的密钥：

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

请求发到哪里由 base_url 决定，不会发去 OpenAI。macOS / Linux 建议收紧权限：

chmod 600 ~/.codex/config.toml ~/.codex/auth.json

命令行使用

npm install -g @openai/codex
codex --version
codex

macOS 也可以用 brew install --cask codex 安装。进入后输入 /status，确认当前服务商和模型都对。

桌面版与 IDE 扩展

改完配置后要彻底退出应用（macOS 按 ⌘Q），再重新打开，并新建一个任务。
VS Code / Cursor / Windsurf 里安装 OpenAI 官方的 Codex 扩展，在侧栏齿轮里选 Open config.toml，就能打开同一份配置。
扩展如果跑在 WSL、SSH 或容器里，配置也要放在那个环境的用户目录下。

确认接通

新建任务，发一句：只回复 ok，不要调用工具。
回到 GodAPI 控制台的「使用日志」，看到这条记录才说明请求确实走了 GodAPI。
需要写代码时，再让它读一个测试文件，确认工具调用也正常。

常见问题

现象	先查这里
401 / 密钥无效	密钥是否复制完整、有没有多余空格、是否已停用
404	地址应为 `https://godapi.dev/v1`，不要出现 `/v1/v1`
找不到模型	模型名是否和控制台里的一字不差
Missing environment variable	用的是方式一，但启动 Codex 的终端里没设变量
改了没反应	完全退出后重开，并新建任务
TOML / JSON 报错	检查中文引号、重复字段、末尾逗号，Windows 下文件是否被存成了 .txt

还原配置

退出所有 Codex 客户端，把备份的 config.toml 和 auth.json 放回原位就行。不要删除整个 .codex 文件夹，里面还有你的会话记录。

配置项名称参考 OpenAI 官方 Codex 配置参考。