Integrations

OpenCode by CCS

通过 CC Switch 将 OpenCode 接入 UnifyLLM。

接入说明

本页说明如何通过 CC Switch 将 OpenCode 接入 UnifyLLM。在「统一供应商」中新增 UnifyLLM，预设类型选择 NewAPI，启用 OpenCode，端点填写带 /v1 的地址，API 格式选择 OpenAI Compatible。

先安装 OpenCode

先从OpenCode的官方文档或发行页安装客户端，再回到 CC Switch 配置供应商。下面是常见的 npm/pipx 安装方式；如果当前版本官方命令不同，以官方页面为准。

  • macOS / Linux：使用 Terminal、iTerm2 或 bash/zsh；安装后重新打开终端，让 PATH 生效。
  • Windows：推荐使用 Windows Terminal 或 PowerShell；Node.js 工具使用 npm，Python 工具使用 pipx，并避免混用不同 Python 环境。
  • 安装后先执行工具的 --version 或官方启动命令，确认客户端本身可以运行，再配置 API。
bash
1# macOS / Linux / Windows Terminal2npm install -g opencode-ai3 4# verify the installation5opencode --version

接入前准备

  • API Base URL：https://api.unifyllm.top/v1
  • 一个有效的 UnifyLLM API Key
  • 一个当前可用的模型 ID，例如 gpt-5.6-sol。模型、分组和价格可能变化，请以价格页及控制台模型列表为准。

在 CC Switch 中配置

  1. 1

    安装并打开 CC Switch

    打开供应商管理页面，在应用切换器中选择 OpenCode。

  2. 2

    进入统一供应商

    点击 +，在「统一供应商」中新增 UnifyLLM，不要放到应用专属供应商列表。

  3. 3

    选择 NewAPI 预设

    预设类型选择 NewAPI，供应商名称填写 UnifyLLM。

  4. 4

    选择格式并填写端点

    API 格式选择 OpenAI Compatible；端点填写 https://api.unifyllm.top/v1，再粘贴 API Key。不要把 Key 写入截图、代码仓库或公开日志。

  5. 5

    添加并选择模型

    添加模型 gpt-5.6-sol 或从“获取模型”列表中选择准确的模型 ID；如果模型列表为空，先检查端点、Key 和 /v1 是否重复。

  6. 6

    启用供应商

    点击启用并按 OpenCode 的要求重启工具。在「统一供应商」中新增 UnifyLLM，预设类型选择 NewAPI，启用 OpenCode，端点填写带 /v1 的地址，API 格式选择 OpenAI Compatible。

手动配置参考

如果你没有使用 CC Switch，下面是对应工具常见配置格式的参考。不同版本的配置字段可能变化，优先以工具本身文档为准。

json
1{2  "$schema": "https://opencode.ai/config.json",3  "provider": {4    "unifyllm": {5      "npm": "@ai-sdk/openai-compatible",6      "name": "UnifyLLM",7      "options": { "baseURL": "https://api.unifyllm.top/v1", "apiKey": "<YOUR_API_KEY>" },8      "models": { "gpt-5.6-sol": { "name": "gpt-5.6-sol" } }9    }10  }11}

测试与排查

在 CC Switch 中启用供应商，重启 OpenCode，选择 UnifyLLM 供应商和模型，再执行一个小型修改或解释任务。

接口参考：Chat Completions、Responses、Messages 和 Generate Content。

  • 先使用一个短请求测试，不要一开始就运行大批量任务。
  • 确认模型 ID 与价格页/控制台完全一致，尤其注意分组前缀。
  • 到控制台用量日志查看请求是否到达、实际模型、Token 用量和错误信息。
  • 如果工具自动追加 /v1，而你又手动填写了 /v1，请删除重复部分。

CC Switch 官方参考

本文参考 CC Switch 官方的软件介绍、添加供应商和编辑供应商。CC Switch 更新后，字段名称和配置路径可能变化，请以其最新版文档和应用界面为准。

安全提醒

API Key 等同于账户调用凭据。请使用专用 Key，限制暴露范围，发现泄露后立即在控制台禁用并重新创建。不要把 Key 放入前端代码、公开仓库、截图或第三方同步服务。