Codex CLI接入胜算云API

> 在 Codex CLI 中配置胜算云作为模型提供商，无需 OpenAI 官方账号，即可使用 Claude、GPT、Gemini 等全线模型。

方式一：编辑 auth.json + config.toml（推荐）

Codex CLI 通过 auth.json 存储 API Key，通过 config.toml 配置提供商信息，两者配合使用。

1. 创建 auth.json

在 ~/.codex/ 目录下创建 auth.json，填入胜算云 API Key：

{
  "OPENAI_API_KEY": "你的胜算云API Key"
}

mkdir -p ~/.codex

cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "你的胜算云API Key"
}
EOF

chmod 600 ~/.codex/auth.json

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex"

@'
{
  "OPENAI_API_KEY": "你的胜算云API Key"
}
'@ | Set-Content -Path "$env:USERPROFILE\.codex\auth.json"

2. 创建 config.toml

在 ~/.codex/ 目录下创建 config.toml，配置胜算云提供商：

model = "openai/gpt-5.4"
model_provider = "shengsuanyun"

[model_providers.shengsuanyun]
name = "胜算云"
base_url = "https://router.shengsuanyun.com/api/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

cat > ~/.codex/config.toml << 'EOF'
model = "openai/gpt-5.4"
model_provider = "shengsuanyun"

[model_providers.shengsuanyun]
name = "胜算云"
base_url = "https://router.shengsuanyun.com/api/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
EOF

@'
model = "openai/gpt-5.4"
model_provider = "shengsuanyun"

[model_providers.shengsuanyun]
name = "胜算云"
base_url = "https://router.shengsuanyun.com/api/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
'@ | Set-Content -Path "$env:USERPROFILE\.codex\config.toml"

3. 关键配置说明

4. 切换模型

临时切换（单次会话）：

codex --model openai/gpt-5.5 "你的提示"

永久切换：修改 config.toml 中的 model 字段即可。

使用 Profiles 多配置：

model = "openai/gpt-5.4"
model_provider = "shengsuanyun"

[profiles.opus]
model = "openai/gpt-5.5"
model_provider = "shengsuanyun"

[profiles.haiku]
model = "openai/gpt-5.4-mini"
model_provider = "shengsuanyun"

[model_providers.shengsuanyun]
name = "胜算云"
base_url = "https://router.shengsuanyun.com/api/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

切换：codex --profile opus "你的提示"

5. 启动验证

codex "你好，请介绍一下你自己"

如果配置正确，Codex CLI 将通过胜算云 API 返回模型响应。

方式二：使用 CC Switch 配置（最简单）

CC Switch 是一款可视化的 AI 编码工具提供商管理器，支持一键配置 Codex 的胜算云接入，无需手动编辑任何文件。

1. 下载安装 CC Switch

前往 CC Switch GitHub 下载最新版本。

2. 选择 Codex 工具

打开 CC Switch，在左侧工具列表中选择 Codex。

3. 添加胜算云供应商

点击右上角 ＋ 按钮，在预设供应商列表中选择 「胜算云」。

4. 填写 API Key

前往胜算云控制台 https://console.shengsuanyun.com/user/keys 创建并复制 API Key，粘贴到 CC Switch 的 API Key 输入框中。

5. 获取模型列表

点击 「获取模型列表」 按钮，CC Switch 会自动拉取胜算云支持的模型清单。

6. 选择模型

从模型列表中选择你想使用的模型（如 openai/gpt-5.4）。

7. 写入配置

勾选 「写入通用配置到 config.toml」，CC Switch 会自动将配置写入 ~/.codex/config.toml 和 auth.json。

如果你的模型支持 1M 上下文窗口，可额外勾选 「1M 上下文窗口」 选项以启用超长上下文能力。

8. 完成配置

点击确认，CC Switch 自动完成所有配置文件的修改。打开 Codex CLI 即可使用。

常见问题

胜算云使用 wireapi = "responses" 协议，请确保 config.toml 中设置的是 wireapi = "responses" 而不是 "chat"。

codex --model

胜算云支持 Claude 系列、GPT 系列、Gemini 系列、千问、豆包等全线模型，详见胜算云模型列表。

相关资源