Codex CLI 配置

Codex CLI 使用 OpenAI Responses API。请选择支持 /v1/responses 的 OpenAI 分组。

配置 API 密钥

PowerShell

[Environment]::SetEnvironmentVariable(
  "CLOUD_AI_API_KEY",
  "sk-your-key",
  "User"
)

macOS / Linux

export CLOUD_AI_API_KEY="sk-your-key"

重新打开终端，使用户级环境变量生效。

编辑 config.toml

Codex 配置文件位于：

Windows

%USERPROFILE%\.codex\config.toml

macOS / Linux

~/.codex/config.toml

加入自定义模型提供商：

model = "gpt-5.6-sol"
model_provider = "cloud_ai"

[model_providers.cloud_ai]
name = "Cloud AI"
base_url = "https://cloud.examplea.xyz/v1"
env_key = "CLOUD_AI_API_KEY"
wire_api = "responses"

base_url 在 Codex 配置中需要包含 /v1，wire_api 必须使用 responses。

启动与检查

codex

出现认证错误时，先确认新终端可以读取 CLOUD_AI_API_KEY。不要把完整密钥打印到截图中。

常见问题

返回 404

确认 base_url 为 https://cloud.examplea.xyz/v1，不要写成带 /responses 的完整接口路径。

模型不可用

当前密钥关联的分组必须支持配置中的模型。使用 /v1/models 检查模型名称，或在密钥页面更换分组。

流中途断开

长任务可能受上游连接波动影响。先重试一次；持续出现时查看渠道状态，并切换到对应的稳定分组。

配置字段说明以 Codex 官方配置参考 为准。