Codex CLI

Codex CLI 是 OpenAI 官方的命令行编程助手。它支持自定义模型提供方，所以可以接到我们这里用 Grok 跑。

已经装好 Codex 了？直接改一个配置文件，见下面。

⚠️ 先记住：Codex 的 Base URL 要带 `/v1`

这点和 Claude Code 正好相反，很多人两个都配过就会搞混：

工具	Base URL
Claude Code	`https://api.wxiai.com` ← 不带 `/v1`
Codex CLI	`https://api.wxiai.com/v1` ← 要带 `/v1`

配置

编辑 ~/.codex/config.toml（Windows 是 C:\Users\你的名字\.codex\config.toml），文件不存在就新建：

toml

# ~/.codex/config.toml

model = "grok-4.6"
model_provider = "wxiai"
model_reasoning_effort = "high"

[model_providers.wxiai]
name = "WXIAI"
base_url = "https://api.wxiai.com/v1"
wire_api = "responses"
env_key = "WXIAI_API_KEY"

然后设置环境变量并启动：

bash

export WXIAI_API_KEY="sk-你的APIKey"
cd /你的项目目录
codex

三个会让 Codex 直接启动失败或静默失效的坑

wire_api 必须写 "responses"。旧版教程里的 wire_api = "chat" 已被 Codex 移除（2026 年 2 月起），写了会启动失败。其实现在 "responses" 是默认值，不写也行。
配置必须放在用户级 ~/.codex/config.toml。放在项目里的 .codex/config.toml 会被忽略，Codex 只会在启动时打个警告——很多人就是这里卡住。
不能覆盖内置的 openai 提供方。openai、ollama、lmstudio 这三个 ID 是保留的，所以要像上面那样新建一个 [model_providers.wxiai]，而不是改 [model_providers.openai] 的地址。

验证是否接通

启动 codex 后随便让它做点小事，比如「说明一下当前目录是干什么的」。能正常回答就通了。

没通的话，去 https://api.wxiai.com 的日志页看有没有 POST /v1/responses 的记录：

有记录但报错 → 看下面的排查表
完全没记录 → 配置没生效，检查是不是放错了文件位置

关于「Unknown model」警告

用 env_key 方式配置时，Codex 可能会提示类似 Unknown model ... fallback metadata。

这是正常的——Codex 想拉取模型清单来获取上下文长度等信息，但我们这边不为它提供这个目录。它会用默认值继续跑，不影响使用。

想消掉这个警告，可以把 env_key 换成「命令式」取密钥：

toml

[model_providers.wxiai.auth]
command = "sh"
args = ["-c", "echo $WXIAI_API_KEY"]

Windows 上用 PowerShell：

toml

[model_providers.wxiai.auth]
command = "powershell"
args = ["-NoProfile", "-Command", "Write-Output $env:WXIAI_API_KEY"]

还没装 Codex CLI？

看安装步骤 → 安装 Codex CLI

常见报错

现象	原因	怎么办
启动就失败 / 报 `wire_api` 相关错误	写了 `wire_api = "chat"`	改成 `"responses"` 或删掉这行
配置了但完全没生效	放在项目级 `.codex/config.toml` 了	移到用户级 `~/.codex/config.toml`
`401` / 认证失败	`env_key` 指定的环境变量没设置	确认 `export WXIAI_API_KEY=...` 在当前终端生效
`model_not_found`	模型名不存在	用 `GET /v1/models` 查到的名字
改了内置 openai 提供方但没用	内置 ID 不可覆盖	新建 `[model_providers.自定义名]`

省钱建议

Codex 这类工具上下文消耗比你想的大得多——它每一轮都会把仓库文件、工具输出、思考过程重新发给模型。三个控制手段：

model_reasoning_effort 调低：日常改代码用 "low" 或 "medium" 就够，别一直开着 "high"。
挑便宜模型做琐碎活：简单改动不需要旗舰模型。
盯住用量：在 https://api.wxiai.com 看消费记录。

⚠️ 先记住：Codex 的 Base URL 要带 /v1 ​

配置 ​

验证是否接通 ​

关于「Unknown model」警告 ​

还没装 Codex CLI？ ​

常见报错 ​

省钱建议 ​

相关页 ​

⚠️ 先记住：Codex 的 Base URL 要带 `/v1`

配置

验证是否接通

关于「Unknown model」警告

还没装 Codex CLI？

常见报错

省钱建议

相关页