Integrations

Hermes by CCS

通过 CC Switch 将 Hermes 接入 UnifyLLM。

接入说明

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

先安装 Hermes

先从Hermes的官方文档或发行页安装客户端，再回到 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 Terminal2git clone https://github.com/NousResearch/hermes-agent3cd hermes-agent4./setup.sh5 6# verify the installation7hermes --version

接入前准备

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

在 CC Switch 中配置

  1. 1

    安装并打开 CC Switch

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

  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

    启用供应商

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

手动配置参考

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

bash
1export OPENAI_API_KEY="<YOUR_API_KEY>"2export OPENAI_BASE_URL="https://api.unifyllm.top/v1"3export OPENAI_MODEL="gpt-5.6-sol"

测试与排查

启用供应商后重启 Hermes，执行一个小任务，同时确认模型返回和 UnifyLLM 控制台中的用量记录。

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

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

CC Switch 官方参考

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

安全提醒

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