OpenAI Codex 接入中转教程：自定义 Base URL 配置 GPT

发布时间2026年8月30日 09:08
语言zh

OpenAI Codex（Codex CLI）终端编码代理接入教程：安装、通过环境变量或 config.toml 配置自定义 Base URL 与密钥，使用 GPT 模型。

一、Codex 是什么

OpenAI Codex（Codex CLI） 是 OpenAI 官方的终端编码代理，支持自定义 API 端点。把它指向本站网关的 OpenAI 兼容入口，即可用 GPT 系列模型与你的 sk- 密钥。

二、安装 Codex CLI

npm install -g @openai/codex

安装后终端输入 codex；用 codex --model gpt-5.5 或交互中的模型选择切换模型。

三、配置 Codex

① 环境变量（最快）

export OPENAI_BASE_URL="https://www.relay-api.com/v1"
export OPENAI_API_KEY="sk-你的密钥"
codex --model gpt-5.5

② config.toml（推荐，便于长期使用）

# ~/.codex/config.toml
[model_providers.myrelay]
name = "极智API中转"
base_url = "https://www.relay-api.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

[model]
model_provider = "myrelay"
model = "gpt-5.5"

保存后运行 codex --model gpt-5.5 即可。

四、接口地址对照

模型分组	本站入口（Base URL）	协议
Claude / Anthropic	`https://www.relay-api.com`	Anthropic Messages
GPT / OpenAI	`https://www.relay-api.com/v1`	OpenAI Chat Completions
Gemini	`https://www.relay-api.com/v1beta`	Google generateContent

五、常见问题排查

现象	处理
401 / 403	密钥无效、未启用或余额不足；确认 `sk-` 正确并充值。
404 / 模型不可用	模型名与平台 slug 不一致，或该模型未启用；核对模型 ID。
Unknown model	填的模型 id 要精确（含大小写），用模型广场核对。

安全建议：密钥别写法进公开仓库，用 .env 或环境变量；生成类任务 token 消耗大，注意余额。

Base URL 说明：本站同时接受 /v1beta/models/... 与 /v1beta/v1beta/models/...（以及 /v1/... 与 /v1/v1/...），所以客户端是否自己补 /v1、/v1beta 都不影响调用：Base URL 填域名根或填带 /v1beta 的地址都能用。模型 ID 请在控制台「令牌」页右上角「模型 ID」里查询复制。