Codex CLI 接入统一模型 API 网关配置教程

2026-09-27 · 原创·接入指南

Codex CLI 接入统一模型 API 网关配置教程

工具简介

Codex CLI 是 OpenAI 开源的终端编码助手，支持在命令行中直接与大语言模型交互，完成代码生成、补全与问答等任务。通过配置自定义模型提供商，Codex CLI 可接入统一模型 API 网关，用一个 API Key 调用全部在售模型。

接入准备

1. 注册与创建 API Key：在平台控制台注册账号后，进入控制台创建 API Key，并记录生成的 Key（格式形如 `sk-...`）。同时可在控制台查看账户余额与用量明细。

2. 获取接入信息：进入平台接入文档页，获取 Base URL 与目标模型 ID（如 `gpt-5.3-codex`）。平台同时兼容 OpenAI 与 Anthropic 接口规范，支持文本对话、图片生成、视频生成及向量端点，按 token 用量计费。

接入步骤

第一步：编辑配置文件

打开或创建 `~/.codex/config.toml`，写入以下完整配置：

model = "gpt-5.3-codex"
model_provider = "hefubao"

[model_providers.hefubao]
name = "hefubao"
base_url = "https://你的BaseURL"
wire_api = "responses"
env_key = "HEFUBAO_API_KEY"

> 注意：配置区块名称为 `[model_providers.hefubao]`，其中 `model_providers` 为复数形式，切勿写成 `model_provider`。`base_url` 请使用平台接入文档页提供的实际地址。

第二步：设置环境变量

在终端中执行以下命令，将 API Key 导入环境变量：

export HEFUBAO_API_KEY=sk-你的实际Key

建议将该命令写入 `~/.bashrc` 或 `~/.zshrc`，使其在每次终端启动时自动生效。

第三步：启动 Codex CLI

完成上述配置后，直接在终端运行 Codex CLI 即可。工具会自动读取 `config.toml` 中的提供商配置，通过环境变量获取 API Key，向指定 Base URL 发起请求。

接入后的实用玩法

玩法一：终端内多模型代码问答

接入后，可在终端中直接向模型提问代码相关问题，如函数实现、Bug 分析、重构建议等。由于平台支持一个 Key 调用全部在售模型，开发者可在 `config.toml` 中切换不同模型 ID 进行对比测试，选择最适合任务需求的模型。

玩法二：结合图片生成与向量端点

平台不仅支持文本对话，还提供图片生成、视频生成与向量端点能力。开发者可在同一 API Key 下，先用文本模型生成需求描述或代码框架，再调用图片生成端点产出可视化素材，或使用向量端点进行语义检索，构建端到端的开发辅助流程。

常见问题排查

| 错误码 | 含义 | 排查建议 |

|--------|------|----------|

| 401 | 鉴权失败 | 检查环境变量 `HEFUBAO_API_KEY` 是否已正确设置，Key 是否以 `sk-` 开头且完整无多余空格；确认 Key 未在控制台被删除或禁用。 |

| 404 | 模型不存在 | 核对 `config.toml` 中的 `model` 值与平台接入文档页列出的模型 ID 完全一致，注意大小写与版本号后缀。 |

| 402 | 余额不足 | 登录控制台查看账户余额，余额耗尽时需充值后重试。可结合用量明细判断消耗趋势。 |

---

完成接入后，可前往模型广场浏览全部在售模型，或在 Codex CLI 中实际体验终端编码助手的工作流程。