如何在 Codex CLI 中接入 CCAPI

本指南帮助你将 OpenAI Codex CLI 连接到 CCAPI，以更低的价格使用 OpenAI 系列模型。

Codex CLI 是 OpenAI 推出的开源 AI 编程 CLI 工具，支持代码生成、调试、Shell 操作、文件管理等。

前提条件

已安装 Codex CLI — npm install -g @openai/codex

CCAPI 账号 — 访问 ccapi.ai 注册

CCAPI 令牌 — 在控制台 > 令牌创建

第一步：获取 CCAPI 令牌

访问 ccapi.ai 注册或登录

进入控制台 > 令牌

点击 新建令牌，复制密钥（只显示一次）

第二步：配置 Codex CLI

方式 A：环境变量（最快）

只需设置一个环境变量即可将 Codex 指向 CCAPI：

添加到 ~/.bashrc 或 ~/.zshrc 后重启终端。

方式 B：配置文件（推荐）

编辑 ~/.codex/config.toml：

model = "gpt-4o"
model_provider = "ccapi"

[model_providers.ccapi]
name = "CCAPI Gateway"
base_url = "https://api.ccapi.ai/v1"
env_key = "CCAPI_API_KEY"
wire_api = "responses"

然后设置环境变量：

第三步：选择模型

CCAPI 支持以下 OpenAI 模型，通过 CCAPI 使用最低可至官方 1 折：

模型	说明
`gpt-4o`	多模态旗舰，质量稳定
`gpt-4.1`	1M 上下文
`gpt-5-mini`	GPT-5 家族均衡款
`gpt-5-nano`	超低成本
`gpt-4o-mini`	性价比之选
`gpt-5.4`	最新最强

切换模型：

完整模型列表和实时价格请查看模型广场。

第四步：验证

如果正常回复，说明配置成功。可以在控制台 > 日志查看调用记录。

常见问题

问题	解决方案
连接超时	确认 `OPENAI_BASE_URL` 设为 `https://api.ccapi.ai/v1`（注意有 `/v1`）
令牌无效	去控制台检查令牌状态
余额不足	去控制台 > 充值充值
模型不存在	检查模型名拼写，在模型广场确认可用模型

快速参考

Base URL：https://api.ccapi.ai/v1

认证环境变量：OPENAI_API_KEY 或自定义 env_key

配置文件：~/.codex/config.toml

模型广场：ccapi.ai/pricing

控制台：ccapi.ai/console

codex集成文档

如何在 Codex CLI 中接入 CCAPI#

前提条件#

第一步：获取 CCAPI 令牌#

第二步：配置 Codex CLI#

方式 A：环境变量（最快）#

方式 B：配置文件（推荐）#

第三步：选择模型#

第四步：验证#

常见问题#

快速参考#