一句话: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
npm install -g @openai/codex3. 配置环境变量
Codex CLI 通过 OPENAI_BASE_URL 和 OPENAI_API_KEY 环境变量定位上游。把 base URL 指向 CodeGateway:
export OPENAI_BASE_URL="https://api.codegateway.dev/v1"
export OPENAI_API_KEY="<你的 CodeGateway API Key>"4. 验证连接
运行下面的命令应当返回模型清单(包含 gpt-5.3-codex):
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)。
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 接入总览。