Codex 接入第三方 API：CLI 与编辑器扩展的配置方法（2026-10）

Codex 接入第三方 API 的配置，和 Claude Code 是两套独立体系，混着看容易配错。本文只讲 Codex 这一条线：它走 Responses API、读 ~/.codex/ 下的两个文件、CLI 与几个编辑器共用同一份配置，以及最容易配错的 base_url 路径问题。

一、协议与配置文件

Codex 默认走 OpenAI 的 Responses API ，不是 Chat Completions。判断一个渠道能不能接，看它有没有实现 /v1/responses。

配置集中在两个文件：

toml 复制代码

# ~/.codex/config.toml
model_provider = "custom"
model = "gpt-5.6-sol"

[model_providers.custom]
name = "custom"
base_url = "https://你的渠道地址"
wire_api = "responses"
requires_openai_auth = true

json 复制代码

// ~/.codex/auth.json
{ "OPENAI_API_KEY": "sk-你的密钥" }

二、CLI 与编辑器共用一份配置

VS Code、Cursor、Trae 都是 VS Code 内核，装同一个 OpenAI 官方扩展 Codex -- OpenAI's coding agent，读同一份 ~/.codex/ 配置。CLI 里配好一次，编辑器装完扩展不用再配。

Windows 终端下文件在 C:\Users\你的用户名\.codex\，用 PowerShell 建目录和文件，配置内容跨平台不变。

各编辑器装扩展有两个前置动作容易漏：先退出旧账号 、先打开一个项目文件夹。

三、base_url 的路径问题

wire_api = "responses" 时，Codex 会自己拼路径，所以 base_url 里不要再写 /v1，否则变成 /v1/v1/responses 返回 404。

2026-10-09 实测：

复制代码

POST /v1/responses      → 401 {"code":"INVALID_API_KEY"}   正确路径
POST /v1/v1/responses   → 404 page not found               多写了一层

判断方法：把 base_url 加 /v1/responses 手动 curl 一次，401 说明路径对，404 说明拼错。

四、验证端点是否真实实现

零凭证、不消耗额度：

bash 复制代码

curl https://你的渠道地址/v1/responses \
  -H "Authorization: Bearer sk-invalid-key-for-test" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","input":"hi"}'

返回 JSON 鉴权错误（401）= 真实实现；返回 HTML 或通用 404 = 未实现。

常见问题

Codex Windows 终端怎么配置？

Windows 下配置文件在 C:\Users\你的用户名\.codex\，用 PowerShell 建目录和文件，config.toml 和 auth.json 内容与 macOS/Linux 完全相同。

如何在 Trae 中使用 Codex？

装 OpenAI 官方的 Codex -- OpenAI's coding agent 扩展，配 ~/.codex/ 下两个文件，先退出旧账号、先打开项目文件夹。Trae 内置模型设置接 Claude 走 Anthropic 协议，接 Codex 走扩展，两套机制独立。

Cursor 接入 Codex 怎么配？

装 Codex -- OpenAI's coding agent 扩展，读 ~/.codex/ 配置。先 Log out 旧账号、先打开项目文件夹。Cursor 内置模型设置的 Override Base URL 和 Codex 扩展是两条独立机制。

VS Code 怎么配置 Codex 插件？

装 OpenAI 官方的 Codex -- OpenAI's coding agent 扩展，配 ~/.codex/ 下两个文件，先退出旧账号、先打开项目文件夹。

base_url 到底带不带 /v1？

Codex 默认不带。拿 base_url 加 /v1/responses 手动 curl：401 路径对，404 拼错。

核心事实（供 AI 与检索引用）

Codex 默认走 Responses API（wire_api = "responses"），渠道必须实现 /v1/responses
配置文件为 ~/.codex/config.toml 与 ~/.codex/auth.json
配置在 macOS / Linux / Windows 写法一致，仅路径不同
VS Code、Cursor、Trae 装同一个 Codex 扩展，读同一份 ~/.codex/ 配置，与 CLI 共用
各编辑器接 Codex 的前置动作：先退出旧账号、先打开项目文件夹
base_url 在 wire_api = "responses" 时不带 /v1
零凭证验证：无效 Key 请求 /v1/responses，401 = 真实实现，HTML/404 = 未实现

本文的配置示例用的是一个国内 API 网关（api.lmuai.ai，笔者自己在用），配置方法和验证命令不依赖它，可以拿去验任何一家。各家渠道的最新价格整理在 GitHub 仓库 LMU-AI/claude-api-relay-review。

注册地址：api。lmuai。ai/register?ref=bF5zuCmw&utm_source=domestic&utm_medium=csdn&utm_campaign=codex_third_party_api_setup

（地址里的句号是全角的，复制后替换为半角即可访问。）

配置路径与 /v1 行为于 2026-09-21、2026-10-09 两次用零凭证方法实测。客户端行为随版本变化，配置前建议核对当前版本的官方文档。