Skip to content

在 Hermes 中使用 Claude Code 模型 ​

本文假设你已经在本地安装好 Hermes,并且可以正常启动。这里不介绍 Hermes 的安装方法,只说明如何通过 CC Switch 给 Hermes 配置 ClawPower Claude Code 模型。

这篇文档适合下面几类用户:

  • 已经安装并正在使用 Hermes
  • 想在 Hermes 中使用 ClawPower Claude Code 模型
  • 希望通过可视化工具配置,不想手动编辑 Hermes 配置文件

配置前,请先准备一个 ClawPower 账号。API 密钥和模型会在后面的配置步骤中处理。

第三方工具说明

本文使用的 CC Switch 是第三方开源工具,不由 Hermes 或 ClawPower 维护。工具版本更新后,页面名称和操作位置可能发生变化。

1. 下载 CC Switch ​

CC Switch 用来管理大模型供应商,不需要手动编辑 Hermes 配置文件。

请从 GitHub Releases 下载:

https://github.com/farion1231/cc-switch/releases

根据自己的系统选择安装包:

  • macOS:下载文件名中包含 .dmg 的安装包
  • Windows:下载文件名中包含 .exe 或 .msi 的安装包

CC Switch 下载页面

下载提示

请下载页面中的最新版本。截图中的版本号仅作示例,可能不是当前最新版本。

安装完成后,打开 CC Switch。

2. 准备 ClawPower API 密钥和 Claude Code 模型 ​

创建支持 Claude Code 模型的API 密钥 ​

创建API 密钥时,选择支持准备使用的 Claude Code 模型的分组,例如 Claude 精选。

API 密钥分组必须匹配

API 密钥分组必须支持你准备使用的模型,否则会提示没有权限或模型不可用。

复制模型 ID ​

打开 ClawPower 模型广场,复制准备使用的 Claude Code 模型 ID,例如 claude-sonnet-5。

模型 ID 必须与模型广场显示的内容完全一致。

从 ClawPower 模型广场复制 Claude Code 模型 ID

3. 在 CC Switch 中配置 Hermes 模型 ​

进入 Hermes 配置页面 ​

打开 CC Switch,点击顶部的 Hermes 图标,然后点击右上角的「+」。

在 Hermes 页面添加供应商

选择「自定义配置」。

选择 Hermes 自定义配置

填写基础配置 ​

按照下面的内容填写:

text
供应商标识:clawpower
供应商名称:ClawPower
官网链接:https://clawpowerai.com
API 模式:Anthropic Messages
API 端点:https://api.clawpowerai.com
API Key:刚才创建的 ClawPower API 密钥

填写 ClawPower Hermes 供应商基础配置

填写模型配置 ​

在「模型列表」中填写从模型广场复制的模型 ID。

例如,使用 claude-sonnet-5 时:

text
模型 ID:claude-sonnet-5
显示名称:claude-sonnet-5

第一个模型会作为默认模型。如果需要添加其他 Claude Code 模型,可以点击「添加模型」继续填写。

填写 API Key 和 Claude Code 模型配置

填写完成后,点击底部的「添加」。

启用 ClawPower ​

回到 Hermes 供应商列表,启用刚刚添加的 ClawPower 供应商。

启用 ClawPower Hermes 供应商

启用后,确认 ClawPower 是 Hermes 当前使用的供应商。

4. 在 Hermes 中验证 Claude Code 模型 ​

如果 Hermes 正在运行,请完全退出,然后重新打开。

在 Hermes 中创建一个新会话,发送一个简单请求:

text
北京一日游攻略

能够正常返回结果,就说明 ClawPower Claude Code 模型已经在 Hermes 中生效。

5. 常见问题 ​

Hermes 仍然使用原来的模型 ​

确认 CC Switch 中已经启用 ClawPower,然后完全退出 Hermes,再重新打开。

返回 401 或 API Key 错误 ​

重新复制 ClawPower API 密钥,确认:

  • API 密钥前后没有多余空格
  • API 密钥仍处于启用状态
  • CC Switch 中填写的是完整API 密钥

提示模型不存在或没有权限 ​

检查模型 ID 是否与模型广场完全一致,并确认当前API 密钥分组支持该模型。

修改配置后没有生效 ​

确认修改后的配置已经保存并启用。关闭已有的 Hermes 会话,再重新启动 Hermes。

联系加微信 clawpower