OpenAI Codex CLI 接入 8848API 完整指南

使用自定义 model provider 接入 8848API，完整配置 config.toml、密钥环境变量、Responses 协议和验证流程。

✅ 支持，但必须使用 Responses API

官方文档 ↗查看 8848API 模型 →

8848API 信息

Base URL

https://api.884819.xyz/v1

API Key

控制台 → 令牌管理 → 添加令牌

协议要求

OpenAI Responses API：POST /v1/responses

Codex CLI 不是普通 Chat Completions 客户端；8848API 已提供 /v1/responses。

1. 安装 Codex CLI

npm

npm install -g @openai/codex
codex --version

macOS / Linux 官方安装器

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows PowerShell

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

2. 创建专用环境变量

不要把密钥直接写进 config.toml。建议使用专用变量，避免与官方 OpenAI Key 混淆。

macOS / Linux

export API8848_KEY="你的 sk- 密钥"

Windows PowerShell

$env:API8848_KEY="你的 sk- 密钥"

3. 编辑 ~/.codex/config.toml

model_provider = "8848api"
model = "gpt-5.5"

[model_providers.8848api]
name = "8848API"
base_url = "https://api.884819.xyz/v1"
env_key = "API8848_KEY"
wire_api = "responses"

model 可替换为 8848API 当前支持 Responses API 的 Codex/GPT 模型。
base_url 到 /v1 为止，不要再拼 /responses。
wire_api 必须是 responses；旧教程中的 chat 已不适用。

4. 验证

codex exec "请只输出 OK"

收到 OK，说明模型、密钥和 Responses 协议可用。
再进入一个测试 Git 项目运行 codex，先做只读解释任务。
在 8848API 控制台核对调用记录和模型名称。

常见错误

404 /v1/responses

接口只支持 Chat Completions，不能直接给 Codex CLI 使用；必须使用支持 Responses 的渠道或协议转换。

wire_api = "chat" is no longer supported

改为 wire_api = "responses"。

provider auth env var is missing

检查 env_key 名称是否与实际环境变量完全一致，并重新打开终端。

模型不存在

复制模型页面中的完整 ID，不要使用中文显示名或自行省略后缀。