❇️ Codex 桌面版应用接入胜算云 API

在 Codex 桌面版应用中配置胜算云作为模型提供商，无需 OpenAI 官方账号，图形界面开箱即用。

前提条件

已安装 Codex 桌面版应用（VS Code 扩展或 Codex Desktop）

已获取胜算云 API Key：https://console.shengsuanyun.com/user/keys

方式一：编辑 auth.json + config.toml（手动配置）

Codex 桌面版与 CLI 共用同一套配置文件，手动编辑后桌面版会自动读取。

1. 创建 auth.json

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

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

Mac / Linux

Windows PowerShell

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

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

安全提醒

auth.json 包含明文密钥，切勿提交到 Git 仓库或分享给他人。

2. 创建 config.toml

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

model = "anthropic/claude-sonnet-4.6"
model_provider = "shengsuanyun"

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

Mac / Linux

Windows PowerShell

@'
model = "anthropic/claude-sonnet-4.6"
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. 关键配置说明

字段	说明
`model`	默认使用的模型，可在胜算云模型列表中复制模型 ID
`model_provider`	提供商标识，对应 `[model_providers.xxx]` 中的 `xxx`
`base_url`	胜算云 API 地址，勿修改
`env_key`	从 `auth.json` 中读取的 Key 字段名，保持 `OPENAI_API_KEY` 即可
`wire_api`	协议类型，胜算云使用 `"responses"`

4. 重启桌面版应用

配置文件保存后，完全退出并重新打开 Codex 桌面版应用（或重启 VS Code），应用会自动读取新的配置。

方式二：使用 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. 选择模型

从模型列表中选择你想使用的模型（如 anthropic/claude-sonnet-4.6）。

7. 写入配置

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

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

8. 重启应用生效

配置写入后，完全退出并重新打开 Codex 桌面版应用，即可开始使用胜算云。

方式三：VS Code 扩展内配置

如果你使用的是 VS Code 中的 Codex 扩展，还可以通过 VS Code 设置界面进行配置。

1. 打开 VS Code 设置

按 Ctrl + ,（Windows）或 Cmd + ,（Mac）打开设置面板，搜索 Codex。

2. 修改配置

找到 Codex 相关配置项，设置自定义端点：

API Base URL：https://router.shengsuanyun.com/api/v1

API Key：填入你的胜算云 API Key

3. 重新加载 VS Code

按 Ctrl + Shift + P → 输入 Reload Window → 回车，重新加载窗口后生效。

此方式同样依赖 ~/.codex/auth.json 和 ~/.codex/config.toml，因此方式一和方式二的配置对 VS Code 扩展同样有效。

在桌面版中切换模型

方法一：修改 config.toml

编辑 ~/.codex/config.toml，修改 model 字段：

model = "anthropic/claude-opus-4.7"
model_provider = "shengsuanyun"

保存后重启桌面版应用。

方法二：使用 Profiles

在 config.toml 中定义多配置：

[profiles.opus]
model = "anthropic/claude-opus-4.7"
model_provider = "shengsuanyun"

[profiles.haiku]
model = "anthropic/claude-haiku-4.5"
model_provider = "shengsuanyun"

CLI 中使用 codex --profile opus 切换。

常见问题

Q：提示 Support for the "chat" wire API is deprecated 怎么办？

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

Q：配置后桌面版仍然连接 OpenAI 官方？

确认 config.toml 和 auth.json 都在 ~/.codex/ 目录下

确认 model_provider 字段值与 [model_providers.xxx] 中的 xxx 一致

完全退出并重新打开桌面版应用（不是最小化）

Q：提示认证失败 / 401 错误？

检查 auth.json 中的 Key 是否正确（无多余空格和引号）

确认胜算云账号余额充足

确认 env_key 的值与 auth.json 中的 Key 字段名一致

Q：支持哪些模型？

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

❇️ Codex 桌面版应用接入胜算云API

❇️ Codex 桌面版应用接入胜算云 API

方式一：编辑 auth.json + config.toml（手动配置）

1. 创建 auth.json

2. 创建 config.toml

3. 关键配置说明

4. 重启桌面版应用

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

1. 下载安装 CC Switch

2. 选择 Codex 工具

3. 添加胜算云供应商

4. 填写 API Key

5. 获取模型列表

6. 选择模型

7. 写入配置

8. 重启应用生效

方式三：VS Code 扩展内配置

1. 打开 VS Code 设置

2. 修改配置

3. 重新加载 VS Code

在桌面版中切换模型

常见问题

相关资源

❇️ Codex 桌面版应用接入胜算云API

❇️ Codex 桌面版应用接入胜算云 API#

方式一：编辑 auth.json + config.toml（手动配置）#

1. 创建 auth.json#

2. 创建 config.toml#

3. 关键配置说明#

4. 重启桌面版应用#

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

1. 下载安装 CC Switch#

2. 选择 Codex 工具#

3. 添加胜算云供应商#

4. 填写 API Key#

5. 获取模型列表#

6. 选择模型#

7. 写入配置#

8. 重启应用生效#

方式三：VS Code 扩展内配置#

1. 打开 VS Code 设置#

2. 修改配置#

3. 重新加载 VS Code#

在桌面版中切换模型#

常见问题#

相关资源#

❇️ Codex 桌面版应用接入胜算云 API

方式一：编辑 auth.json + config.toml（手动配置）

1. 创建 auth.json

2. 创建 config.toml

3. 关键配置说明

4. 重启桌面版应用

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

1. 下载安装 CC Switch

2. 选择 Codex 工具

3. 添加胜算云供应商

4. 填写 API Key

5. 获取模型列表

6. 选择模型

7. 写入配置

8. 重启应用生效

方式三：VS Code 扩展内配置

1. 打开 VS Code 设置

2. 修改配置

3. 重新加载 VS Code

在桌面版中切换模型

常见问题

相关资源