胜算云 胜算云 文档中心 ↗ 精益社区

OpenCode 接入胜算云

OpenCode 是一款开源 AI 编程助手 IDE,支持 macOS、Windows 和 Linux。通过胜算云 API,你可以一键接入数十种主流大模型。

开源 AI 编程 IDE 支持 Web to Agent 一键写入 可批量配置全部模型

方式 A · 用 CC-Switch 一键接入胜算云

  1. 下载并安装 CC-Switch前往 GitHub Releases 下载对应平台安装包。
  2. 打开供应商设置打开 CC-Switch,点击「供应商」。
  3. 选择胜算云在供应商列表中选择「胜算云」,API Key 和 Base URL 会自动填充。
  4. 填入 API Key输入你的胜算云 API Key。
  5. 写入通用配置勾选「写入通用配置」以覆盖已有配置。
  6. 启用并重启点击启用,重启对应工具即可使用。

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

  1. 打开设置打开 OpenCode 设置页面(Settings)。
  2. 选择 Provider在 Provider 中选择 Custom provider。
  3. 填写 Base URLBase URL 填入下方地址:
    https://router.shengsuanyun.com/api/v1
OpenCode 选择 Custom Provider 截图

2. 填写 Base URL 和 API Key

OpenCode 填写 Key 截图
  1. 填入 API Key前往个人控制台获取 API Key 并填入。
  2. 其他字段可随意自定义。
  3. 关于模型 ID需准确复制对应的模型名。在模型列表里点击「复制」按钮选择你想在 OpenCode 里使用的模型,可多选添加常用的模型。
  4. 完成配置配置完成提交后,在聊天框里就能选择你配置好的模型开始编码了。
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-compatibleOpenAI 兼容协议(本例)。一个供应商就能配 GPT / Gemini / DeepSeek / Claude 等所有模型,适合一次性批量配置;timeout 是请求超时毫秒数。
@ai-sdk/anthropicAnthropic 原生协议,只用于 Claude 模型。CC-Switch 的胜算云预设就是用它,并额外加 "setCacheKey": true 开启 Anthropic 提示缓存(prompt caching),重复上下文更省 token、响应更快。如果你主要用 Claude,建议把 npm 换成它并加上这个开关。
disabled_providers禁用 OpenCode 内置的官方 OpenAI/Anthropic/Google 供应商,避免和你自建的胜算云供应商混淆。

保存并重启

完成:保存文件后,重启 OpenCode,你就能看到所有配置好的可用模型了。