Codex 接入指南

速查配置

项目	值
Base URL	https://api.bestai.chat
Wire API	responses
环境变量名	CODEX_API_KEY
API Key	你在控制台创建的 Key（sk- 开头）

配置步骤

1. 设置环境变量

在 ~/.zshrc（macOS）或 ~/.bashrc（Linux）末尾添加：

export CODEX_API_KEY="sk-你的Key"

保存后执行 source ~/.zshrc 或重新打开终端。

2. 编辑 config.toml

Codex 配置文件路径：

版本	路径
Codex CLI	~/.codex/config.toml
Codex App（GAC）	~/.codex-gac/config.toml

在配置文件中写入：

model_provider = "bestai"
model = "gpt-5.5"

[model_providers.bestai]
name = "bestai"
base_url = "https://api.bestai.chat"
wire_api = "responses"
env_key = "CODEX_API_KEY"

3. 验证

启动 Codex：

codex

发一条消息确认模型回复正常。检查 余额页面 出现对应扣费记录。

配置说明

wire_api

必须设置为 "responses"。Codex 使用 OpenAI Responses API 协议通信，BestAI 完整支持该协议。

model

BestAI 支持的 OpenAI 系列模型均可使用，常用值：

• gpt-5.5 — 最新旗舰
• o3 — 推理模型
• o4-mini — 轻量推理

也可以使用 Claude 模型（通过 BestAI 的协议转换）：

• claude-opus-4
• claude-sonnet-4

env_key

指定 Codex 从哪个环境变量读取 API Key。设为 "CODEX_API_KEY" 后，Codex 会从 $CODEX_API_KEY 取值。

注意：env_key 填的是环境变量名，不是 Key 本身。不要写成：

env_key = "sk-xxx"  # 错误！这里应该填变量名

Codex App / Desktop

Codex App 和 CLI 共享 config.toml 配置，但注意路径区别：

• CLI: ~/.codex/config.toml
• App: ~/.codex-gac/config.toml

App 从桌面图标启动时可能读不到 shell 环境变量。解决方案：

1. 从终端启动：codex app（继承当前 shell 环境）
2. 或者在两个 config.toml 中都写好配置

多 Provider 切换

如果你同时配置了多个 provider：

model_provider = "bestai"

[model_providers.bestai]
name = "bestai"
base_url = "https://api.bestai.chat"
wire_api = "responses"
env_key = "CODEX_API_KEY"

[model_providers.openai]
name = "openai"
base_url = "https://api.openai.com"
wire_api = "responses"
env_key = "OPENAI_API_KEY"

切换 model_provider 的值即可在不同服务之间切换。

常见问题

连接失败或 404

检查 base_url 是否正确为 https://api.bestai.chat（末尾无斜杠，无额外路径如 /v1）。

认证失败 (401)

1. 确认 env_key 设置的环境变量名与实际 export 的变量名一致
2. 运行 echo $CODEX_API_KEY | head -c 5 确认变量有值
3. 确认 Key 以 sk- 开头且完整
4. 检查 余额 是否充足

模型不可用

确保 model 字段的值是 BestAI 支持的模型名。访问 模型价格页 查看可用模型。

有回复但余额没有记录

说明请求没走 BestAI。检查：

1. model_provider 是否设为 "bestai"
2. 是否有其他 provider 配置在前面覆盖了
3. Codex 启动时的终端是否能读到正确的环境变量