Codex 接入胜算云 API

一、下载安装 Codex 桌面端

Codex 现为桌面端应用，前往 OpenAI 官方页面下载对应平台安装包：

方式 A · Web to Agent 一键写入（推荐）

无需手动编辑配置文件：在下面卡片里输入胜算云 Key，组件自动拉取全部可用模型，授权 .codex 目录后一键写入 auth.json + config.toml（原文件自动 .bak 备份）。Codex 桌面端启动时会读取这两个文件。

1. 输入胜算云 Key在上方卡片输入胜算云 Key（旁边「🗝 控制台获取 Key」可直达密钥页）。
2. 选择默认模型组件自动拉取模型列表，下拉选择默认模型（推荐 openai/gpt-5.4）。
3. 授权写入点「写入配置」，授权访问 .codex 目录（Win: C:\Users\<你>\.codex；mac/linux: ~/.codex）。
4. 重启 Codex写入完成会自动备份原文件，完全退出 Codex 桌面端再重新打开即可使用。

方式 B · CC-Switch 桌面工具配置

CC-Switch 是桌面 GUI 工具，可管理多套供应商配置并一键切换，适合同时用多个模型供应商的开发者。

1. 下载安装 CC-Switch

按你的系统选择推荐安装包，点击直接下载（均为 v3.18.0 稳定版）：

2. 配置胜算云（详细步骤）

1. 新增供应商打开 CC-Switch，进入「供应商」管理页，点「新增供应商」。
2. 选择胜算云与 Codex在供应商列表中选择「胜算云」，工具选 Codex，API 地址格式选 OpenAI 兼容。
3. 填入 API Key填入胜算云 API Key，Base URL 自动填 https://router.shengsuanyun.com/api/v1（带 /v1）。
4. 获取模型列表点「获取模型列表」，从下拉里选默认模型。
5. 启用并重启点「启用 / 保存」，完全退出 Codex 桌面端再重新打开即可使用。

3. CC-Switch 配置注意事项

方式 C · 手动修改配置文件

Codex 桌面端用两个文件配合：auth.json 存 API Key，config.toml 配置提供商。位置都在 ~/.codex/（Win: C:\Users\<你>\.codex\）。在磁盘上建好这两个文件，Codex 桌面端启动时会自动读取。

1. 创建 auth.json

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

cat > ~/.codex/config.toml << 'EOF'
model_provider = "custom"
model = "openai/gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true

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

@'
model_provider = "custom"
model = "openai/gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true

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

3. 配置项详细解析：为什么这么改 & 这样改有什么用

Codex 启动时读 config.toml 决定走哪个供应商、用哪个模型、什么协议；读 auth.json 取 Key。每个字段作用如下：

4. 使用 Profiles 多配置（进阶）

想保留多套模型配置随时切换的，可在 config.toml 加 profiles，然后在 Codex 桌面端的会话设置里选择对应 profile：

model_provider = "custom"
model = "openai/gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true

[profiles.opus]
model = "openai/gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true

[profiles.haiku]
model = "openai/gpt-5.4-mini"
model_reasoning_effort = "high"
disable_response_storage = true

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

保存后重启 Codex 桌面端，在会话设置里即可选择 opus / haiku 等 profile。

首次运行与测试

1. 重启 Codex确认已按上面任一方式写好配置，完全退出 Codex 桌面端再重新打开。
2. 新建会话新建一个会话，输入「你好，请介绍一下你自己」。
3. 确认响应配置正确的话，Codex 会通过胜算云 API 返回模型响应。

如何更换模型

常见问题排查