Codex配置

本页说明手动配置 Codex CLI 接入风云 API 的方法。

前置条件

• 已安装 Codex。
• 已创建 Codex 分组令牌。
• 已确认目标模型在模型广场中可见。

配置思路

Codex 通常使用 OpenAI 兼容接口。Base URL 一般填写：

https://www.windcloudai.com/v1

API Key 填写风云 API 控制台创建的 Codex 分组令牌。

环境变量方式

macOS / Linux：

export OPENAI_API_KEY="你的风云API密钥"
export OPENAI_BASE_URL="https://www.windcloudai.com/v1"

Windows PowerShell：

$env:OPENAI_API_KEY="你的风云API密钥"
$env:OPENAI_BASE_URL="https://www.windcloudai.com/v1"

配置文件方式

如果你的 Codex 版本支持配置文件，请在 ~/.codex 下按当前版本要求配置 provider，例如：

[model_providers.windcloud]
name = "WindCloud API"
base_url = "https://www.windcloudai.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

然后设置：

export OPENAI_API_KEY="你的风云API密钥"

启动测试

codex

或指定模型：

codex -m gpt-5-codex

提示

Codex 不同版本的配置文件字段可能变化。如果报 provider 配置错误，先确认你当前 Codex 的版本和配置说明。