❇️ Codex 桌面版应用接入胜算云 API#
在 Codex 桌面版应用中配置胜算云作为模型提供商，无需 OpenAI 官方账号，图形界面开箱即用。
方式一：编辑 auth.json + config.toml（手动配置）#
Codex 桌面版与 CLI 共用同一套配置文件，手动编辑后桌面版会自动读取。1. 创建 auth.json#
在 ~/.codex/ 目录下创建 auth.json，填入胜算云 API Key：{
"OPENAI_API_KEY": "你的胜算云API Key"
}
| Mac / Linux | Windows PowerShellNew-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#
2. 选择 Codex 工具#
打开 CC Switch，在左侧工具列表中选择 Codex。3. 添加胜算云供应商#
点击右上角 ＋ 按钮，在预设供应商列表中选择 「胜算云」。4. 填写 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. 修改配置#
API Base URL：https://router.shengsuanyun.com/api/v1
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[profiles.opus]
model = "anthropic/claude-opus-4.7"
model_provider = "shengsuanyun"
[profiles.haiku]
model = "anthropic/claude-haiku-4.5"
model_provider = "shengsuanyun"
codex --profile opus 切换。 |
常见问题#
Q：提示 Support for the "chat" wire API is deprecated 怎么办？胜算云使用 wire_api = "responses" 协议，请确保 config.toml 中设置的是 wire_api = "responses" 而不是 "chat"。确认 config.toml 和 auth.json 都在 ~/.codex/ 目录下
确认 model_provider 字段值与 [model_providers.xxx] 中的 xxx 一致
检查 auth.json 中的 Key 是否正确（无多余空格和引号）
确认 env_key 的值与 auth.json 中的 Key 字段名一致
相关资源#
