Codex CLI 接入

先完成最小接口验证#

先按快速开始查询模型并完成一次请求。若命令行请求本身失败，先解决密钥、分组或余额问题，再调整 Codex。本文面向支持自定义 provider 的 Codex CLI；桌面应用和其他客户端的配置能力以其版本为准。

准备配置文件#

用户配置通常位于 ~/.codex/config.toml。Windows 为用户目录中的 .codex\config.toml；在 WSL 运行 Codex 时，读取的是 Linux 用户目录中的配置。

model_provider = "sotaai"
model = "YOUR_MODEL"

[model_providers.sotaai]
name = "SOTA AI"
base_url = "https://sotaai.org/v1"
env_key = "SOTAAI_API_KEY"
wire_api = "responses"
requires_openai_auth = false
supports_websockets = false

把 YOUR_MODEL 换成已验证的实际模型 ID。此示例选择 HTTP/SSE 传输；env_key 填变量名称，不能填密钥本身。

在同一个终端启动#

export SOTAAI_API_KEY='YOUR_API_KEY'
codex

$env:SOTAAI_API_KEY = 'YOUR_API_KEY'
codex

修改配置后重新启动 Codex，让新进程读取配置与环境变量。从桌面图标打开的进程，不一定继承刚才终端的临时变量。已有官方登录可以保留；当前任务使用哪个服务取决于所选 provider。

验证当前任务的提供方#

1. 进入一个可信任的项目目录，再启动 Codex。
2. 查看当前会话状态，确认 provider 和模型与配置一致。
3. 先提交一个短任务，例如“只回复 OK”。
4. 回到 SOTA 使用记录，确认该请求确实经过本站。

如果出现模型不支持、找不到变量或 401，逐项对照模型 ID、当前终端变量、配置路径和 Base URL。不要通过关闭所有权限保护来解决接入问题。