Hermes 安装与配置指南

通过 CC Switch 接入自定义 API 供应商，在 Hermes 桌面端使用第三方模型。

官网地址：https://hermes-agent.nousresearch.com/

---

目录

• 第一步：下载安装包
• 第二步：安装 Hermes
• 第三步：配置 CC Switch
• 第四步：启动使用
• 常见问题

---

第一步：下载安装包

打开官网后，页面会自动识别当前系统（Windows / macOS），直接点击对应版本的下载按钮即可。

💡 首页同时提供 INSTALL VIA TERMINAL 终端安装方式，可按需切换 macOS / Linux / Windows 命令。

---

第二步：安装 Hermes

下载完成后直接双击安装包，按提示完成安装。

⚠️ 安装完成后请先关闭 Hermes，再去配置 CC Switch。配置完成后重新打开才能读取到新的供应商信息。

---

第三步：配置 CC Switch

3.1 添加供应商

打开 CC Switch，在顶部的应用图标栏中选中 Hermes 图标，然后点击 添加供应商。

如果你之前已有配置，也可以点击 导入当前配置，所有数据会安全保存在 default 供应商中。

3.2 填写供应商信息

在「编辑供应商」页面按下表填写：

字段	填写内容	说明
接口格式	OpenAI Compatible	选择 AI 服务的 API 接口格式
API Key	你的密钥	由服务方提供
Base URL	https://www.fastaitoken.com	自定义 API 端点地址
额外选项	键名 setCacheKey，值 true	开启缓存键

填写完成后：

1. 点击右侧 获取模型列表，自动拉取可用模型。
2. 在「模型配置」区域用下拉箭头选择 模型 ID，并填写 显示名称。
3. 点击右下角 保存。

3.3 启用供应商

回到供应商列表，找到刚创建的条目（例如 fastaitoken），点击绿色的 + 添加 按钮完成启用。

---

第四步：启动使用

配置保存后，重新打开 Hermes 即可正常使用。

---

常见问题

问题	排查方向
Hermes 里看不到新模型	确认配置 CC Switch 前已完全退出 Hermes，保存后再重启
获取模型列表失败	检查 API Key 是否正确、Base URL 是否有多余的斜杠或空格