Codex CLI

推荐方式：使用一键接入

Windows 用户可以在 API 密钥页面下载 install.ps1，按提示选择 Codex CLI 并输入 API Key。脚本会写入 Codex 配置并保留原配置备份。

手动配置

Codex 的配置文件通常位于：

Windows: %USERPROFILE%\\.codex\\config.toml
macOS/Linux: ~/.codex/config.toml

配置核心是 OpenAI Responses 兼容端点。不同 Codex 版本字段可能不同，建议以本机生成的配置模板为准，只替换 base_url 和密钥。

model = "你的分组中可用的模型"
model_provider = "sub2api"

[model_providers.sub2api]
name = "瑞科 API"
base_url = "https://api.ruikon.com/v1"
env_key = "SUB2API_API_KEY"

然后设置环境变量：

export SUB2API_API_KEY="sk-替换为你的密钥"

Windows PowerShell：

$env:SUB2API_API_KEY = "sk-替换为你的密钥"

验证

启动 Codex 后发送一句简单问题，再到使用记录查看 /v1/responses 请求。若客户端版本只发送 /v1/chat/completions，确认分组允许该端点。

常见问题

• WebSocket 是可选能力，遇到反复重连时先关闭 WebSocket，使用 HTTPS Responses。
• model 必须是分组允许的模型，不要使用上游不可见的内部名称。
• 使用脚本接入后修改配置，需要重启 Codex 进程。