Codex CLI 接入教程

5 分钟用 CodeGateway 接入 OpenAI Codex CLI(gpt-5.3-codex):安装、配置 base_url、验证连接、开始编码。

一句话:5 分钟把 Codex CLI 接到 CodeGateway,通过 OpenAI Responses API 直接跑 GPT-5.3 Codex,按量计费,支持 CNY 充值。

我们在自家工程里跑通过这套流程,推荐按 5 步走完再调整(每步都给了可以直接复制的命令)。

本教程介绍如何在 Codex CLI 中使用 CodeGateway 接入 GPT-5.3 Codex 模型。Codex CLI 是 OpenAI 推出的命令行编码助手,使用 OpenAI Responses API 协议,CodeGateway 通过 /v1/responses 端点完整兼容。

参考链接:OpenAI Codex CLI 仓库 | OpenAI Responses API 文档 — 协议参数与端点定义。

1. 准备工作

注册 CodeGateway 账户(绑定支付方式后赠送 $2 免费额度),在 Dashboard 中生成一个 API Key。Codex CLI 需要 Node.js 18+ 环境。

2. 安装 Codex CLI

bash
npm install -g @openai/codex

3. 配置环境变量

Codex CLI 通过 OPENAI_BASE_URL 和 OPENAI_API_KEY 环境变量定位上游。把 base URL 指向 CodeGateway:

bash
export OPENAI_BASE_URL="https://api.codegateway.dev/v1"
export OPENAI_API_KEY="<你的 CodeGateway API Key>"

4. 验证连接

运行下面的命令应当返回模型清单(包含 gpt-5.3-codex):

bash
curl https://api.codegateway.dev/v1/models \
-H "Authorization: Bearer $OPENAI_API_KEY"

5. 开始使用

在任意项目目录运行 codex,即可让 GPT-5.3 Codex 帮你写代码。所有请求都会经 CodeGateway 边缘节点路由,按 token 用量按阶梯倍率计费(详见 /zh/docs/tier-pricing-explained)。

bash
codex "在 src/ 下新增一个返回 Hello World 的 TypeScript 函数"

注意:GPT 系模型的区域限制

GPT-5.3 Codex 等 GPT 系模型可能受上游服务商地区策略影响:上游按网关出口地区判定时会返回 unsupported country/region/territory。这通常是瞬态的——实测重试即可恢复(唯一一次受控重试:94 秒后成功;48 小时内 10 次该类拒绝的恢复时间中位数约 3 分钟,属上界口径)。网关因此返回 503(可重试)并带 Retry-After,SDK / Codex 会自动重试。

  • 先做:等几秒重试(多数情况一次重试就过)。

  • 若持续失败:改用不受限的模型(DeepSeek / Kimi / GLM / Qwen 系,如 deepseek-v4-pro、kimi-k2.7-code),或让网络流量从受支持的地区出口(如部署在支持地区的机器上运行 Codex CLI)。

模型通路规则汇总见 Agent CLI 接入总览。

相关资料

把这篇文档跑成一次真实调用

注册后创建一把 sk-cg- 密钥,把 base URL 指向 CodeGateway,现有 SDK 与 CLI 不用改代码即可切换。按量计费,绑卡赠 $2 额度。

免费注册
作者:CodeGateway 团队最后审稿:2026-09-05