OriginCoder

Codex CLI 接入自定义 API 地址：OriginCoder 配置教程

发布于 2026-11-11

Codex CLI 支持自定义模型供应商，所以任何实现了 OpenAI Responses API 的网关都能接。本文教你把它接到 OriginCoder 这个 AI API 网关上：用 config.toml 里的供应商配置加环境变量，或用 CC-Switch 一键导入。如果你搜的是「Codex API」，这就是落地版本：Base URL 写在哪、协议格式怎么设、密钥放哪里。

Claude Code 的对应教程见 Claude Code 接入自定义 API 地址。两个工具的请求格式不同，Base URL 的写法也不同，下文会标明。

准备工作

  • 已安装 Codex CLI（例如 npm install -g @openai/codex；如果你的系统上 OpenAI 官方安装方式不同，以官方说明为准）。
  • 一个 OriginCoder 账号，并有余额或有效订阅。注册账号，各模型价格见模型价格页面。
  • 一个属于 OpenAI 模型分组（OpenAI 平台分组）的 API Key。只属于 Claude 分组的 Key 不能给 Codex 用。

第 1 步：创建 API Key

登录后在控制台打开 API 密钥 页面，创建密钥，并选择一个提供 OpenAI 模型的分组。复制后当作密码保管。分组决定这个 Key 能调用哪些模型、按什么倍率计费。

第 2 步，方式 A：CC-Switch 一键导入

CC Switch 用来管理 Claude Code、Codex 和 Gemini CLI 的供应商配置。对于 OpenAI 分组的 Key，控制台里的 导入到 CCS 按钮会创建一个 Codex 供应商。

  1. 安装 CC Switch 并启动一次。
  2. 在控制台里点击你的 Key 上的 导入到 CCS，在浏览器提示中确认。
  3. 在 CC Switch 里选中新建的供应商，重启 Codex。

部分部署会隐藏这个导入按钮。没有反应时请用方式 B。

第 2 步，方式 B：config.toml 加环境变量

先导出密钥。变量名可以自己定，只要和下面的 env_key 一致：

export ORIGINCODER_API_KEY="sk-xxxx"

然后编辑 ~/.codex/config.toml（Windows 是 %userprofile%\.codex\config.toml）：

model_provider = "origincoder"
model = "你分组里的某个模型"

[model_providers.origincoder]
name = "OriginCoder"
base_url = "https://origincoder.com/v1"
env_key = "ORIGINCODER_API_KEY"
wire_api = "responses"
requires_openai_auth = false

几个关键点：

  • base_url 要带 /v1。 Codex 会自己拼接 /responses，不会补 /v1。这和 Claude Code 正好相反：ANTHROPIC_BASE_URL 末尾不能带 /v1。
  • wire_api = "responses"。 当前版本的 Codex 对自定义供应商使用 Responses API，网关的 /v1/responses 端点提供的就是它。
  • requires_openai_auth = false 告诉 Codex 这个供应商不需要 OpenAI 登录。
  • model 必须是你 Key 所在分组提供的模型。请从模型价格页里挑，不要猜。
  • 密钥放环境变量，别写进会提交的文件。控制台 使用密钥 对话框生成的配置可能用了别的变量名，或把密钥直接写进文件，只要各部分一致都能用。你账号的准确 Base URL 和取值，以该对话框的输出为准。

Codex 的配置项会随版本变化。如果某个字段被拒绝，请查阅 OpenAI 当前的 Codex 文档以及控制台 使用密钥 对话框的输出。

第 3 步：验证

在任意项目里运行 codex，随便问一句。然后打开 OriginCoder 控制台的 使用记录：这次请求应该已经出现，带有 token 数和费用。不借助 Codex 单独测试接口：

curl https://origincoder.com/v1/responses \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{"model": "你分组里的某个模型", "input": "ping"}'

常见问题排查

现象 可能原因 处理
401 或「API Key 无效」 Key 错误，或当前终端里没有设置环境变量 用 echo 检查变量名（不要打印值）是否已设置，然后重开终端
每个请求都 404 base_url 缺少 /v1 或写了两遍 严格使用 https://origincoder.com/v1
「模型不存在」或 403 Key 所在分组不提供该模型 换一个列出的模型，或换用正确分组的 Key
Codex 要求登录 OpenAI requires_openai_auth 没设为 false，或没有选中该供应商 把 model_provider 设为你的供应商名
配置不生效 文件位置错误，或 TOML 语法错误 检查 ~/.codex/config.toml 和引号
余额相关报错 没有余额或订阅已过期 在控制台充值或续费

费用与安全说明

  • 每次请求从余额或订阅额度扣费，并记录 token 数和费用。
  • 网关是请求链路上的第三方，你的代码上下文会经过它。请先阅读服务条款。
  • OriginCoder 是独立平台，与 OpenAI 没有任何关联。

下一步：Claude Code 替代方案：官方订阅还是 API 网关，或在 AI 网关是什么里了解网关本身。

全部教程

更多教程