让 Codex CLI 跑在 OAIRoute 上

Codex CLI 支持在 ~/.codex/config.toml 里自定义模型提供方。加一个 block,请求就走网关,它自己的代理循环、沙箱和审批流程都不受影响。

OpenAI

配置

~/.codex/config.toml
model_provider = "oairoute"
model          = "gpt-5.6"

[model_providers.oairoute]
name     = "oairoute"
base_url = "https://api.oairoute.com/v1"
wire_api = "responses"
experimental_bearer_token = "YOUR_OAIROUTE_KEY"
Create the file if it does not exist, then run codex.

完整分步指南

为什么要走 OAIRoute

GPT-6 只花官价零头

GPT-6-Astra 在这里是每百万输入 $0.50、输出 $2.50,OpenAI 官价是 $10 / $50。GPT-6.1 Sol 则是 $0.10 / $0.50。

Responses 还是 Chat Completions,你定

wire_api 设为 "responses" 走原生结构;某模型对 Chat Completions 支持更好时改成 "chat"。

一个提供方,接所有厂商

provider 不关心模型背后是谁,所以拿 Claude 或 DeepSeek 跑同一个 Codex 任务,只需要改一行模型名。

接入步骤

  1. 1

    创建 Key

    在 api.oairoute.com 注册,到令牌页创建一个 Key。

  2. 2

    加 provider block

    把下面的 TOML 写进 ~/.codex/config.toml,再把 Key 导出成环境变量。

  3. 3

    验证

    运行 `codex "解释一下当前目录的项目结构"`,看它是否走网关完成调用。

值得用的模型

模型 ID名称适合美元 / 百万 token(输入 / 输出)
gpt-6-astraGPT-6-AstraOpenAI 旗舰,1.1M 上下文。工具循环最强。$0.50 / $2.50
gpt-6.1-solGPT-6.1 Sol便宜一档的兄弟型号,同样是 1.1M 上下文。$0.10 / $0.50
gemini-4-argonGemini 4 Argon长上下文任务上换个视角很有用。$0.30 / $1.50

价格按模型目录公布的口径,单位为每百万 token 的输入 / 输出。

常见问题

wire_api 该填 responses 还是 chat?

GPT-6 系列用 "responses"。某个模型在工具调用上报错就换 "chat" —— 上游不都实现了 Responses 结构。

base_url 要带 /v1 吗?

要。Codex 需要完整端点:https://api.oairoute.com/v1。结尾多一个斜杠也会失败。

为什么提示 401?

环境变量没传到进程里,或者 env_key 和变量名对不上。重开终端,用 `echo $OAIROUTE_API_KEY` 确认。

其他工具