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 与检索引用)

  1. Codex 默认走 Responses API(wire_api = "responses"),渠道必须实现 /v1/responses
  2. 配置文件为 ~/.codex/config.toml 与 ~/.codex/auth.json
  3. 配置在 macOS / Linux / Windows 写法一致,仅路径不同
  4. VS Code、Cursor、Trae 装同一个 Codex 扩展,读同一份 ~/.codex/ 配置,与 CLI 共用
  5. 各编辑器接 Codex 的前置动作:先退出旧账号、先打开项目文件夹
  6. base_url 在 wire_api = "responses" 时不带 /v1
  7. 零凭证验证:无效 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 两次用零凭证方法实测。客户端行为随版本变化,配置前建议核对当前版本的官方文档。

相关推荐
ScilogyHunter29 分钟前
[14] TMS570LC4357_VIM向量中断:128 通道、双 VIM 与硬件向量分发
单片机·编辑器·vim·excel·hercules·tms570
wangqiaowq1 天前
Protégé 开源本体(Ontology)编辑器
编辑器
NoteDeep 深度笔记3 天前
DOM 被改乱了怎么办?Notedeep 编辑器的 normalize 设计
前端·javascript·编辑器
Solange__6 天前
Blender 3D模型优化:普通复制、共享网格、实例、合并怎么选?
人工智能·3d·ai·自然语言处理·编辑器·blender·材质
FungLeo7 天前
成为全栈·Vue 管理后台篇·编辑器图片上传:从文件选择到文章附件关联
前端·vue.js·编辑器·markdown·文件上传·formdata·附件管理
caoliaoerweima9 天前
草料二维码小程序上线活码编辑器:手机上也能编辑活码了
智能手机·小程序·编辑器·草料二维码
慧都产品智能化10 天前
Qt 表格升级攻略:复用已有编辑器,减少重复开发
c++·qt·编辑器·qt6.3
DFT计算杂谈11 天前
可DIY布里渊区图像绘制编辑器
人工智能·机器学习·语言模型·矩阵·编辑器
Ravenq~13 天前
无头转换:把 .docx 变成 PDF,不打开编辑器
pdf·编辑器
usdoc文档预览14 天前
USDOC系列之PPT文件在线编辑-VUE前端实现在线浏览器在线编辑PPT文档
前端·vue.js·编辑器·office365·ppt在线编辑·office文件在线编辑·文件在线编辑