跳到主要内容

Codex 配置（CLI / VS Code 插件）

本页适用于 Codex CLI 和 VS Code 中的 Codex 插件。 ChatGPT 桌面端请读 ChatGPT 桌面版配置。

Codex 需要两个配置文件：

文件作用
config.toml设置模型、187API 服务地址、请求协议
auth.json保存 API Key

:::tip 先看 Codex CLI 需要 Node.js。未安装先看 Node.js 环境准备。 :::

接入要点​

项值
base_urlhttps://187api.com/v1 ← 必须带 /v1
wire_apiresponses
auth.json 中的 key纯 sk- 字符串，不带 Bearer

第一步：安装 Codex CLI​

Windows​

npm install -g @openai/codex@latest

macOS​

npm install -g @openai/codex@latest
# 权限不足时
sudo npm install -g @openai/codex@latest

Linux​

npm install -g @openai/codex@latest

验证​

codex --version

第二步：配置 config.toml​

Windows​

New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
notepad "$HOME\.codex\config.toml"

macOS​

mkdir -p ~/.codex
touch ~/.codex/config.toml
open -e ~/.codex/config.toml

Linux​

mkdir -p ~/.codex
nano ~/.codex/config.toml

粘贴后按 Ctrl+O 保存、回车确认，Ctrl+X 退出。

填入内容​

删除原内容，完整粘贴：

model = "MiniMax-M2.5"
model_provider = "187api"
model_reasoning_effort = "medium"

[model_providers.187api]
name = "187api"
base_url = "https://187api.com/v1"
wire_api = "responses"
requires_openai_auth = true

:::warning 三个易错点

  1. base_url 必须以 /v1 结尾，少了会 404
  2. model 要填控制台里真实可用的模型名，见 模型清单
  3. wire_api = "responses" 不要改，Codex 走 /v1/responses 协议 :::

第三步：配置 auth.json​

Windows​

notepad "$HOME\.codex\auth.json"

macOS​

touch ~/.codex/auth.json
open -e ~/.codex/auth.json

Linux​

nano ~/.codex/auth.json

删除原内容，只保留：

{
  "OPENAI_API_KEY": "你的API_KEY"
}

第四步：创建令牌并填入​

  1. 187api.com → 令牌管理 → 添加令牌
  2. 分组选 default（或控制台指定分组）
  3. 模型可用列表留空
  4. 提交后复制完整 key
  5. 回到 auth.json，只替换 你的API_KEY

第五步：启动测试​

codex

输入一句 hi，能回复即接通。

换个模型调用​

改 config.toml 里的 model 字段即可，base_url 和 key 都不用动：

model = "其他模型名"

可用模型名用 /v1/models 查：

curl https://187api.com/v1/models \
  -H "Authorization: Bearer ***"

常见报错​

报错原因处理
404 Not Foundbase_url 少了 /v1补上 /v1
401 Unauthorizedkey 不完整 / 带了 Bearer重新复制纯 key
model not found模型名不在分组内用 /v1/models 查实际可用
403 Forbidden模型可用列表限制清空该字段
启动报 config 错误TOML 语法错检查引号、[model_providers.xxx] 段名是否与 model_provider 一致

model_provider 的值必须与 [model_providers.xxx] 里的 xxx 完全一致。