OpenCode 接入胜算云
OpenCode 是一款开源 AI 编程助手 IDE,支持 macOS、Windows 和 Linux。通过胜算云 API,你可以一键接入数十种主流大模型。
方式 A · 推荐
CC-Switch 一键接入
GUI 工具自动写入配置,30 秒完成,无需手动编辑。
方式 B
IDE 内图形配置
在 OpenCode 设置页里选 Provider 填 Key,所见即所得。
方式 C · 进阶
配置文件批量配置
编辑 opencode.json,一次性添加所有常用模型。
方式 A · 用 CC-Switch 一键接入胜算云
- 下载并安装 CC-Switch前往 GitHub Releases 下载对应平台安装包。
- 打开供应商设置打开 CC-Switch,点击「供应商」。
- 选择胜算云在供应商列表中选择「胜算云」,API Key 和 Base URL 会自动填充。
- 填入 API Key输入你的胜算云 API Key。
- 写入通用配置勾选「写入通用配置」以覆盖已有配置。
- 启用并重启点击启用,重启对应工具即可使用。
OpenCode 使用 CC-Switch 注意事项:配置 OpenCode 时务必勾选「写入通用配置」;选择供应商为「胜算云」后,API Key 和 Base URL 会自动填充。
下载 CC-Switch
| macOS | 支持 brew install 或直接下载 .dmg 安装包 |
|---|---|
| Windows | 下载 .msi 安装包,双击安装 |
| Linux | 提供 .deb 和 .rpm 安装包 |
| 多工具支持 | 支持 Claude Code、Codex、OpenCode、OpenClaw、Hermes Agent 等多工具一键配置 |
| 核心能力 | 自动管理 API Key 和 Base URL,无需手动编辑配置文件 |
方式 B · IDE 内图形配置
最新 OpenCode 桌面版 IDE 下载地址:https://opencode.ai/download(现已推出适用于 macOS、Windows 和 Linux 的 Beta 版本)
1. 打开设置并选择 Custom Provider
- 打开设置打开 OpenCode 设置页面(Settings)。
- 选择 Provider在 Provider 中选择 Custom provider。
- 填写 Base URLBase URL 填入下方地址:
https://router.shengsuanyun.com/api/v1
2. 填写 Base URL 和 API Key
- 填入 API Key前往个人控制台获取 API Key 并填入。
- 其他字段可随意自定义。
- 关于模型 ID需准确复制对应的模型名。在模型列表里点击「复制」按钮选择你想在 OpenCode 里使用的模型,可多选添加常用的模型。
- 完成配置配置完成提交后,在聊天框里就能选择你配置好的模型开始编码了。
方式 C · 打开配置文件(进阶批量配置)
如果觉得一个一个添加模型太麻烦,可修改 .config 的 json 文件,一次性添加所有模型。
mkdir -p $env:USERPROFILE\.config\opencode
notepad $env:USERPROFILE\.config\opencode\opencode.json
mkdir -p ~/.config/opencode
nano ~/.config/opencode/opencode.json
输入配置代码
请在文件中输入以下配置代码:
{
"$schema": "https://opencode.ai/config.json",
"model": "shengsuanyun/openai/gpt-5.4",
"small_model": "shengsuanyun/openai/gpt-5.4-mini",
"provider": {
"shengsuanyun": {
"npm": "@ai-sdk/openai-compatible",
"name": "胜算云 Router",
"options": {
"baseURL": "https://router.shengsuanyun.com/api/v1",
"apiKey": "在此处填入你的API_KEY",
"timeout": 300000
},
"models": {
"openai/gpt-5.5": { "name": "GPT-5.5" },
"openai/gpt-5.4": { "name": "GPT-5.4" },
"openai/gpt-5.4-mini": { "name": "GPT-5.4 Mini" },
"openai/gpt-4.1": { "name": "GPT-4.1" },
"anthropic/claude-opus-4.8": { "name": "Claude Opus 4.8" },
"anthropic/claude-sonnet-5": { "name": "Claude Sonnet 5" },
"anthropic/claude-haiku-4.5": { "name": "Claude Haiku 4.5" },
"google/gemini-2.5-pro": { "name": "Gemini 2.5 Pro" },
"google/gemini-2.5-flash": { "name": "Gemini 2.5 Flash" },
"deepseek/deepseek-v3.2": { "name": "DeepSeek V3.2" },
"ali/qwen3-max": { "name": "Qwen3 Max" },
"moonshot/kimi-k2": { "name": "Kimi K2" },
"bigmodel/glm-4.7": { "name": "GLM-4.7" }
}
}
},
"disabled_providers": ["openai", "anthropic", "google"]
}
请务必在代码中的 "apiKey": "" 处填入你的 API Key。更多模型请参考胜算云控制台模型列表,按 "模型ID": { "name": "显示名称" } 格式添加即可。
npm 与协议为什么这么选
"npm" 决定 OpenCode 用什么协议调用模型,要和你选的模型匹配:
| @ai-sdk/openai-compatible | OpenAI 兼容协议(本例)。一个供应商就能配 GPT / Gemini / DeepSeek / Claude 等所有模型,适合一次性批量配置;timeout 是请求超时毫秒数。 |
|---|---|
| @ai-sdk/anthropic | Anthropic 原生协议,只用于 Claude 模型。CC-Switch 的胜算云预设就是用它,并额外加 "setCacheKey": true 开启 Anthropic 提示缓存(prompt caching),重复上下文更省 token、响应更快。如果你主要用 Claude,建议把 npm 换成它并加上这个开关。 |
| disabled_providers | 禁用 OpenCode 内置的官方 OpenAI/Anthropic/Google 供应商,避免和你自建的胜算云供应商混淆。 |
保存并重启
完成:保存文件后,重启 OpenCode,你就能看到所有配置好的可用模型了。