一句话：5 分钟把 Codex CLI 接到 CodeGateway，通过 OpenAI Responses API 直接跑 GPT-5.3 Codex，按量计费，支持信用卡、支付宝与银行转账充值。
我们在自家工程里跑通过这套流程，推荐按 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 账户（绑定支付方式后赠送免费额度），在 Dashboard 中生成一个 API Key。Codex CLI 需要 Node.js 18+ 环境。
2. 安装 Codex CLI
npm install -g @openai/codex需要 Node.js 18+。winget install openai.codex 与 Homebrew 同样可用。装完若提示 codex 不是命令，是 npm 全局 bin 目录不在 PATH——完整指南的安装节 有 PATH 修复与 ~/.codex/config.toml 基础配置。
3. 配置环境变量
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 用量按统一 1.07x 倍率计费（详见 /zh/docs/tier-pricing-explained）。
codex "在 src/ 下新增一个返回 Hello World 的 TypeScript 函数"常见问题
Q: 如何安装 Codex CLI？ A: Node 18+ 下执行 npm install -g @openai/codex（macOS / Linux / Windows）；winget install openai.codex 与 Homebrew 也可。然后 codex login；无头 / CI 机器直接设置 OPENAI_API_KEY。
Q: Codex CLI 的配置文件在哪里？ A: ~/.codex/config.toml——模型、provider base URL、审批策略、MCP 服务器都配置在这里。凭据单独存放于 ~/.codex/auth.json，所以 config.toml 中不放 API key。
Q: 能把 Codex CLI 指向自定义 API base URL 吗？ A: 可以。设置 OPENAI_BASE_URL（见第 3 步）或 ~/.codex/config.toml 里的 provider base URL（例如 https://api.codegateway.dev/v1），网关 key 放进 OPENAI_API_KEY。
Q: 安装没报错，但 `codex` 不是可识别的命令？ A: npm 全局 bin 目录不在 PATH。执行 npm config get prefix，把返回的目录加入 PATH，重开终端后用 codex --version 验证。
注意：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 接入总览。