跳到正文

OpenCode · CC Switch 配置

v1.18.52026-07-24MITGitHub
适用场景
可视化配置 OpenCode;CLI 与桌面版配置共享,配一次两边都生效
面向读者
所有 OpenCode 用户
TL;DR
CC Switch 主界面 → OpenCode 图标 → 填表单 → 选模型 → 添加

还没装 CC Switch?先看 CC Switch 安装


配置步骤

CC Switch · 配置 OpenCode(CLI / 桌面版通用)

  1. 1

    选中 OpenCode 图标,点击添加

    CC Switch 主界面:选中 OpenCode 图标,点右上角橙色添加按钮

    打开 CC Switch,顶部工具栏按名称选中 OpenCode 图标,点右上角橙色 按钮新建一项;不要依赖图标排列位置。

    CLI 和桌面版共享 ~/.config/opencode/opencode.json——只配一次,两者都生效。

  2. 2

    填写供应商信息(按模型类型选接口格式)

    GPT 分组:供应商标识填 for,接口格式选 OpenAI Responses,Base URL 填 https://foropencode.com/v1

    弹出「添加新供应商」表单。供应商标识填一个简短唯一名(如 for,只能小写字母、数字和连字符);接口格式根据模型类型选择:

    OpenAI Responses 兼容分组(上图是旧界面示例):接口格式选 OpenAI Responses,填入 API Key。本站截图中的网关地址为:

    https://foropencode.com/v1
    第三方网关示例;提交 Key 前到其控制台核对当前端点

    Claude 分组(claude-sonnet 等,下图示例):接口格式选 Anthropic,填入 API Key,Base URL 填:

    Claude 分组:接口格式选 Anthropic,Base URL 填 https://foropencode.com(不带 /v1)
    https://foropencode.com
    第三方网关示例;以其当前 Anthropic 兼容说明为准
  3. 3

    获取模型列表,选择模型 ID

    模型配置区:点击获取模型列表,点添加模型,展开箭头选模型 ID

    在「模型配置」区域操作:

    1. 点击 获取模型列表 拉取可用模型
    2. 点击 + 添加模型 插入一行空白模型条目
    3. 点击中间展开箭头,从网关实时返回的下拉列表选择 模型 ID;不要照抄旧截图中的名称
  4. 4

    配置模型属性,点击添加

    模型配置区:variants 控制推理深度,modalities 控制输入输出能力,最后点添加

    选好模型 ID 后,可为该模型设置两个可选属性。

    variants(推理深度)——每个 key 对应一个档位,值为 reasoningEffort 对象。只有当前模型、OpenCode 与网关三方资料都确认支持时,才按类似以下结构填写:

    {
      "low":    { "reasoningEffort": "low" },
      "medium": { "reasoningEffort": "medium" },
      "high":   { "reasoningEffort": "high" }
    }

    上述档位只是结构示例,不代表当前网关或任一模型支持全部值。modalities(输入输出能力)也只有在模型或网关正式文档明确支持时才填写。旧版页面把特定 GPT 模型写成确定的图片输出能力,本次无法由网关公开资料确认,故不再给出固定建议。

    {
      "input":  ["text"],
      "output": ["text"]
    }

    可用值:textimageaudiovideopdf(按模型实际能力填写,留空则由 OpenCode 自动推断)。

    两项都可以留空直接跳过。配置完毕后点右下角 + 添加,CC Switch 自动写入 ~/.config/opencode/opencode.json

  5. 5

    确认配置添加成功

    主界面出现配置行,显示橙色「移除」按钮,说明配置已添加成功

    回到主界面,配置行出现橙色 「移除」 按钮即表示配置已成功写入。

    • CLI:重启终端,下次跑 opencode 即生效
    • 桌面版:完全退出(菜单栏图标也关),重启 App

可用模型

在 CC Switch 中先使用“获取模型列表”查看网关实际返回结果。OpenAI/Anthropic 官方模型列表、截图中的旧模型和第三方网关当前能力不是一回事;上下文、最大输出、模态和 reasoning variants 只有在网关文档明确时才手动填写。


配置写到哪

CC Switch 将供应商信息写入 ~/.config/opencode/opencode.json。CLI 和桌面版共享同一份文件,配置一次两边都生效。

平台路径
Linux / macOS~/.config/opencode/opencode.json
Windows%USERPROFILE%\.config\opencode\opencode.json

OpenCode 官方文档记录的全局配置位置为 ~/.config/opencode/opencode.json(Windows 上对应用户目录下的 .config 路径)。若 CC Switch 实际写入位置与 OpenCode 读取位置不一致,请以两者当前版本的实际行为为准并核对生效情况。

下一步

资料来源:OpenCode Providers · OpenCode Config · CC Switch 官方仓库(2026-07-26 核对)