在 Codex 里使用珂艾网关

能用。 Codex CLI 支持自定义 provider，改两个配置文件即可，约 5 分钟。
整理日期：2026-10-18 ｜相关：按任务选模型 · Claude Code 配置

一、配置三要素

要素	填什么	出现在哪
Base URL	`https://turbo.apimax.host/v1`	`config.toml` 的 `base_url`
API Key	`sk-` 开头的珂艾密钥	`auth.json`
Model	`gpt-5.3-codex`	`config.toml` 的 `model`

🔴 Codex 走的是 Responses API（wire_api = "responses"），不是普通的 chat completions。配置里这一项不能改成 chat，否则会失败。

二、装 Codex（按系统选一段）

Windows

先装 Git Bash（Codex 的部分操作依赖它）：到 git-scm.com 下载，一路下一步。

装 Node.js 22+：到 nodejs.org 下 LTS 版。

打开 PowerShell，装 codex：

验证：

macOS

Linux

三、写配置文件（核心两步）

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

系统	路径
Windows	`C:\Users\<你的用户名>\.codex`
macOS / Linux	`~/.codex`

Windows 下如果看不到这个文件夹，先在文件资源管理器里打开「显示隐藏的项目」。没有就自己建一个。

1. `auth.json`

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

2. `config.toml`

model_provider = "keai"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.keai]
name = "keai"
base_url = "https://turbo.apimax.host/v1"
wire_api = "responses"
requires_openai_auth = true

每一项的作用：

字段	说明
`model_provider`	与下面 `[model_providers.keai]` 的名字必须一致
`model`	网关模型 ID。可选 `gpt-5.3-codex` / `gpt-5.2-codex` / `gpt-5.1-codex` / `gpt-5-codex`
`model_reasoning_effort`	思考深度：`high` / `medium` / `low`。日常用 `medium`，复杂任务用 `high`（更慢更贵）
`disable_response_storage`	关掉响应存储，走网关时保持 `true`
`wire_api`	必须是 `responses`
`requires_openai_auth`	走 API Key 方式时保持 `true`

四、验证是否真的通了

在项目目录下启动：

发一句：

列出当前目录的文件，并说明这个项目是做什么的

判定标准：

✅ 能读目录、能回答 → 通了

❌ 启动就报鉴权错 → auth.json 路径或密钥有问题

❌ 报 404 → base_url 漏了 /v1

❌ 报模型不存在 → model 填了官网名或未上架的 ID

❌ 只聊天不读文件 → wire_api 写错了，或模型不支持工具调用

五、VSCode / Cursor 插件

Codex 也有编辑器插件。装好插件后它会复用同一份 ~/.codex 配置，所以按第三节配完，插件里通常直接可用。

如果插件里提示未登录，检查：

auth.json 是否在正确的 .codex 目录

插件是否指向了自定义配置（部分版本有独立的 API 设置项）

六、推荐模型搭配

使用场景	模型 ID	为什么
日常写代码、改 bug	`gpt-5.3-codex`	最新一代 codex，工具调用稳
省钱档	`gpt-5.1-codex-mini`	简单补全够用，单价低
需要强推理的复杂任务	`gpt-5.3-codex` + `model_reasoning_effort = "high"`	靠思考深度补，不换模型
长上下文读代码库	`gpt-5.2-codex`	稳定档，上下文表现好

七、常见报错

现象	原因	解决
`401` / 鉴权失败	`auth.json` 格式或路径错	确认文件名是 `auth.json`，内容是一行 JSON
`404`	`base_url` 漏 `/v1`	改成 `https://turbo.apimax.host/v1`
模型不存在	`model` 写错	用第五节的四个 ID 之一
报 `wire_api` 相关错误	写成了 `chat`	改回 `responses`
一直转圈 / 无输出	网络或代理	关代理重试
能对话但不能改文件	权限或模型不支持	换 `gpt-5.3-codex`；确认工作目录可写
响应很慢	`model_reasoning_effort = "high"`	日常改 `medium`
Windows 下命令找不到	没装 Git Bash / PATH 未刷新	装 Git Bash，重开终端

八、计费与分组

项目	信息
计费方式	按量计费（按输入 / 输出 token 结算）
建议分组	建令牌时选 `Codex-Gpt-1` / `Codex-Gpt-2` / `Codex-Gpt-3`，这是 Codex 专用分组
为什么要专用分组	同名模型在不同分组单价差异较大，专用分组通常更划算

实际单价以价格页为准。同一模型换分组不用改代码，只改令牌所属分组。

九、相关阅读

不确定选哪个模型：按任务选模型

同类工具：Claude Code · Cursor / Cline（见 ③ 接入配置 · 编程工具）

搞不清填什么：配置三要素

报错排查：配置报错对照表

十、更新记录

日期	改了什么
2026-10-18	重写发布。补三平台安装差异、`wire_api = "responses"` 说明、Codex 专用分组与四个模型档位

在 Codex 里使用珂艾网关

一、配置三要素#

二、装 Codex（按系统选一段）#

Windows#

macOS#

Linux#

三、写配置文件（核心两步）#

1. auth.json#

2. config.toml#

四、验证是否真的通了#

五、VSCode / Cursor 插件#

六、推荐模型搭配#

七、常见报错#

八、计费与分组#

九、相关阅读#

十、更新记录#