CC-Switch 配置 OpenCode

外接兼容说明

第三方客户端与服务端之间可能存在兼容性差异。本教程演示基础接入方式，不能保证每个模型、智能体或工具都完全兼容。遇到个别功能异常时，可以先更换模型并用最小请求验证。

提示

CC-Switch 的下载与安装见 CC-Switch配置。

一、添加供应商

打开 CC-Switch，顶部切换到 OpenCode 标签，点击右上角橙色「+」。

在「添加新供应商」页面点击左上角的「自定义配置」。

如果页面继续显示供应商类型或配置入口，选择 OpenAI 兼容格式后继续。

二、填写信息

配置项	填写内容
供应商标识	小写字母、数字和连字符，例如 yuan-api
供应商名称	自定义，例如 Yuan API
接口格式	选择 OpenAI Responses 或页面提供的兼容格式
API Key	你的 Yuan API Key
Base URL	https://api.apixhm.com/v1

三、添加模型

1. 点击「获取模型列表」自动拉取；如果无法拉取，可以手动添加模型。
2. 点击「+ 添加模型」。
3. 在模型 ID 下拉列表中选择要使用的模型。
4. 如果需要推理强度、上下文窗口等设置，展开模型的 SDK 选项后填写。
5. 完成后点击右下角「保存」。

模型 ID 请以 Yuan API 模型与价格页面为准。

四、选择模型并对话

打开 OpenCode，在 Select model 中找到 Yuan API 分组，选择刚添加的模型，然后发送：

hi

能够正常回复，即表示配置成功。

提示

工具调用或特殊智能体失败时，先关闭工具，只测试普通文本请求。进一步排查请查看外接与兼容类问题。