ai2saveai2save

Codex CLI 自定义 Base URL:用 config.toml 接入 ai2save

本教程使用 OpenAI 的 Codex CLI,通过 ai2save 第三方网关发送请求。Base URL 是 https://ai2save.com/v1;需要本站 API Key,不是 ChatGPT 登录凭据。先在控制台选择支持 Responses API 的分组,复制已开放的模型 ID。

维护者:ai2save。更新于 2026-11-18。已用 codex-cli 0.155.1 对本地 Responses 端点验证配置;这不代表线上分组当前一定可用。

1. 安装并配置网关

运行 npm install -g @openai/[email protected] 安装验证过的版本,用 codex --version 核对。在 ~/.codex/config.toml(Windows:%USERPROFILE%\.codex\config.toml)中合并以下配置,不要覆盖已有设置。顶层键放在所有 [表名] 之前,把 YOUR_MODEL_ID 换成分组中实际开放的模型 ID。

model = "YOUR_MODEL_ID"
model_provider = "ai2save"

[model_providers.ai2save]
name = "ai2save"
base_url = "https://ai2save.com/v1"
env_key = "AI2SAVE_API_KEY"
wire_api = "responses"

首次付费调用前,可先核对 GPT 模型、公开分组价格和单次费用算例。

2. 发送一次请求

通过密钥管理器在当前终端设置 AI2SAVE_API_KEY,或交互输入,避免密钥进入命令历史。例如在 Bash 中:

read -rs -p 'ai2save API Key: ' AI2SAVE_API_KEY; echo
export AI2SAVE_API_KEY

PowerShell 7.1 及以上可使用 $env:AI2SAVE_API_KEY = Read-Host 'ai2save API Key' -MaskInput。在可信的 Git 工作目录中运行:

codex exec --ephemeral --sandbox read-only "Reply with only: OK"

成功时会输出模型回复(此例通常是 OK),退出码为 0。只出现启动横幅不算成功。CLI 会自行拼接 /responses,不要把它重复写进 Base URL。

3. 区分鉴权、模型和路径错误

  • **401 / invalid API key:**检查当前终端是否设置了 AI2SAVE_API_KEY,以及密钥是否由本站签发。不要在工单、截图或配置文件中公开密钥。
  • **模型不存在或无权限:**核对模型 ID、密钥分组及其是否支持 Responses。反复输入同一密钥不会开通模型。
  • **找不到接口路径:**核对域名和 /v1 是否只出现一次。接口路径错误与明确指出模型不可用的错误不同。

一手来源:OpenAI Codex CLI 和 Codex 官方配置参考。