外观
Codex 接入指南
适合使用 Codex CLI 或 Codex App 的用户。本文只保留一条可验证的 Responses 配置路径。
开始前准备
- 已在 BestAI API Keys 创建 Key。
- Key 已分配到支持 OpenAI Responses 的分组。
- 终端中可以运行
codex；如果不能运行，先完成 Codex CLI 安装。
推荐方式：先看控制台生成配置
在 API Keys 找到 Key，打开“使用密钥”并选择 Codex CLI。控制台生成的配置会随当前站点端点和客户端版本调整；如果它与本文示例不同，以控制台当前内容为准。
不要把控制台生成的“OpenAI provider + auth.json”配置和本文的自定义 bestai provider 混合写入同一个文件。选一种方式即可。
手工配置
配置文件位置
Codex 使用 $CODEX_HOME/config.toml：
| 情况 | 默认位置 |
|---|---|
| macOS / Linux | ~/.codex/config.toml |
| Windows | %USERPROFILE%\.codex\config.toml |
设置了 CODEX_HOME | $CODEX_HOME/config.toml |
如果已有配置，先备份：
bash
cp ~/.codex/config.toml ~/.codex/config.toml.bakconfig.toml
将下面内容合并到配置文件中。根级字段要放在 TOML 表之前：
toml
model_provider = "bestai"
model = "MODEL_ID_FROM_CONSOLE" # 替换为控制台配置中的模型 ID
[model_providers.bestai]
name = "bestai"
base_url = "https://api.bestai.chat"
wire_api = "responses"
env_key = "BESTAI_API_KEY"wire_api = "responses" 是 Codex 路径的关键设置。env_key 填环境变量名，不填 API Key 本身。
保存 API Key
macOS / Linux 当前终端：
bash
export BESTAI_API_KEY="sk-你的Key"长期使用可以写入 ~/.zshrc 或 ~/.bashrc，然后打开新终端：
bash
cat >> ~/.zshrc <<'EOF'
export BESTAI_API_KEY="sk-你的Key"
EOF
source ~/.zshrcPowerShell 当前窗口：
powershell
$env:BESTAI_API_KEY="sk-你的Key"Windows 长期使用请把 BESTAI_API_KEY 保存为用户环境变量，避免把 Key 写进项目文件。
检查变量是否存在，但不要输出 Key：
bash
test -n "$BESTAI_API_KEY" && echo "BESTAI_API_KEY is set" || echo "BESTAI_API_KEY is missing"验证 CLI
完全退出已有 Codex 会话，在新的终端窗口运行：
bash
codex --version
codex发送：
text
请只回复：BestAI Codex 已连接。然后打开 使用记录，按时间核对请求、模型和状态。
接入完成必须同时满足：
- Codex 返回验证句对应的回复。
- 使用记录中出现对应请求。
Codex App / Desktop
先让 CLI 跑通，再打开 App。这样可以把“网关配置问题”和“桌面环境继承问题”分开。
macOS / Linux 可以从终端打开：
bash
codex app /path/to/your/project如果 App 读不到 Key，检查：
- App 使用的
CODEX_HOME是否与终端相同。 config.toml是否位于当前CODEX_HOME下。BESTAI_API_KEY是否为用户级环境变量，而不是只存在于某个终端窗口。- 完全退出 App 后重新打开。
不要为了 App 另外维护一份互相矛盾的 provider 配置。
安装 Codex CLI
先检查：
bash
codex --version如果命令不存在，按当前 Codex 官方安装方式安装，再回到本文配置。中国大陆网络环境下，如果使用 npm 安装速度慢，可以只对当前命令指定镜像，不要默认修改全局 registry：
bash
npm install -g @openai/codex@latest --registry "https://registry.npmmirror.com"安装成功不等于接入成功，仍需完成验证句和使用记录核对。
常见问题
401 / 403
BESTAI_API_KEY是否存在且没有复制错误。env_key是否正好写成BESTAI_API_KEY。- 是否把
env_key错写成了sk-...。 - Key 对应分组是否允许 Responses。
- 账户余额和 Key 额度是否可用。
404
Codex 的 base_url 填基础地址：
text
https://api.bestai.chat不要填完整的 /v1/responses，也不要把 /v1/chat/completions 当成 Codex 的配置地址。
模型不可用
确认 model 与控制台生成配置中的模型 ID 一致，不要只根据旧截图或旧文档猜模型名。
有回复但没有使用记录
确认当前会话没有使用另一个 provider 或 profile；关闭 Codex 后重新打开，再发一次短验证句。
配置改了但没有生效
运行：
bash
printf 'CODEX_HOME=%s\n' "${CODEX_HOME:-$HOME/.codex}"
test -f "${CODEX_HOME:-$HOME/.codex}/config.toml" && echo "config.toml found" || echo "config.toml missing"如果存在多个配置文件，先确认当前 CODEX_HOME，不要同时修改多个目录。
安全与回滚
- 不要把真实 Key 写入 Git、项目
.codex/config.toml或截图。 - 修改前保留
config.toml.bak。 - 怀疑 Key 泄露时，先在 API Keys 停用旧 Key，再更新环境变量。
- 回滚配置时恢复备份，并重新启动 Codex。
完成标准
codex可以启动并返回验证句。config.toml中的wire_api是responses。env_key指向存在的环境变量，而不是密钥内容。- 使用记录 有对应请求。