Hermes 配置教程
添加 QuickRouter 为自定义供应商,并选择 Hermes 使用的模型。
先安装 Hermes,并创建 QuickRouter API Key。
推荐用 QuickRouter Switch 一键配置。已安装 CC-Switch 的用户也可选择备选方式。
使用 QuickRouter Switch 配置
还没安装?下载并安装 QuickRouter Switch。
- 添加供应商
打开 QuickRouter Switch,在左边选「Hermes」,点「添加供应商」。
- 填写 API Key
把自己的 API Key 粘贴到同名输入框。地址和接口格式已经填好。模型可换成自己实际要用、当前 Key 能调用的模型。
图 17 核对 Hermes 的 API 模式、端点和 API Key。 图 18 可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。 - 添加并打开工具
点右下角「添加」。若卡片还在「可添加」区,点卡片上的「添加」。在 QuickRouter 卡片的「更多」菜单里点「设为默认」。再运行
hermes chat。
查看具体参数和更多操作
「API 模式」保留「Anthropic Messages」,「API 端点」用 https://api.quickrouter.ai/v1,模型示例为 claude-sonnet-5-5。预填模型仅作示例,可换成自己实际要用的模型。请填写当前 API Key 可调用的完整模型 ID。 需要更换默认模型时,把要用的模型放在列表第一项。
填好后点右下角「添加」。如果 QuickRouter 仍在「可添加」区,再点卡片上的「添加」,使其进入「已添加」。 在「已添加」卡片的「更多」中选择「设为默认」。重新运行 hermes chat,用新会话确认实际模型。
使用 CC-Switch 配置
还没安装?下载并安装 CC-Switch。
- 添加供应商
打开 CC Switch,在左侧选择Hermes,点击添加供应商,选择自定义配置。
- 填写连接信息
- 供应商标识填
quickrouter,名称填QuickRouter。 - API 模式选 OpenAI Chat Completions,API 端点填
https://api.quickrouter.ai/v1,API Key 填自己的令牌。

Hermes:API 模式选 OpenAI Chat Completions,第一项模型为 gpt-6-sol。 - 供应商标识填
- 设置模型
- 模型列表第一项的 ID 填
gpt-6-sol,显示名称填gpt-6-sol。
示例模型可以换成自己实际要用的模型,使用 模型价格页中的完整模型 ID,并确认 API Key 有权限。
- 模型列表第一项的 ID 填
- 保存供应商
在表单底部点添加,确认 Hermes 的供应商列表出现 QuickRouter 卡片。
- 启用并打开工具
本节直接写入客户端配置。
如果卡片在「可添加」,先点添加。在「已添加」的 QuickRouter 卡片右侧点更多(⋯)→ 设为默认,确认卡片显示「默认」。Hermes 会使用配置中排在第一位的模型。
在终端运行
hermes chat,输入/new新建会话。图中 QuickRouter 卡片已显示「默认」。如未设为默认,从卡片的「更多」菜单选择「设为默认」。 - 发送消息验证
在 Hermes 新会话发送「请只回复 OK」。看到回复后,打开QuickRouter 使用日志,核对请求时间、模型 ID 和成功状态。
查看配置细节与排错
配置写入 ~/.hermes/config.yaml 的 custom_providers。切换为默认供应商后,检查 model.provider = quickrouter 与 model.default = gpt-6-sol。显示名称仅用于界面。本节直接使用 Chat 接口,无需 CC Switch 本地路由。
确认配置生效
打开 Hermes 的新会话,选择刚配置的模型,发送「请只回复 OK」。在 QuickRouter 使用日志核对发送时间和实际请求模型。遇到 401 或 403 时,先检查令牌和模型权限。
查看原有安装、手动配置与排错
适用范围:Hermes Agent 的 custom 提供商与手动模型配置;一键脚本为独立 QuickRouter 辅助项目。
版本与验证:2026-09-28 核对本文配置项、步骤和资料入口,补齐验证与排错说明。未在真实账号中验证付费模型调用。
配置速查
| 配置项 | 填写内容 | 注意事项 |
|---|---|---|
| OPENAI_API_KEY | QuickRouter API Key | 写入 ~/.hermes/.env。 |
| OPENAI_BASE_URL | https://api.quickrouter.ai/v1 | 与 config.yaml 的 base_url 一致。 |
| model.provider | custom | 手动选择自定义提供商。 |
| model.default | gpt-6-sol | 以当前模型权限为准。 |
还没有 API Key?注册获取免费体验额度 · 已注册:进入控制台创建 API Key
为此工具单独创建令牌,并设置合理额度和模型权限。截图中的模型仅作示例,以账号当前可用模型为准;不要公开密钥或上传含密钥的配置文件。
第 1 步:确认 Hermes 已安装
按 Hermes 官方说明安装并确认可以启动。本文介绍手动配置 custom 提供商。使用当前安装版本的官方配置说明核对设置。
第 2 步:配置本地凭据
编辑当前用户的 ~/.hermes/.env,合并以下变量,保留其他已有设置。
OPENAI_API_KEY=YOUR_QUICKROUTER_API_KEY
OPENAI_BASE_URL=https://api.quickrouter.ai/v1第 3 步:配置默认模型与提供商
在 ~/.hermes/config.yaml 中修改 model 节点,不用片段覆盖整份文件。
model:
provider: "custom"
default: "gpt-6-sol"
base_url: "https://api.quickrouter.ai/v1"custom 提供商、OpenAI 兼容端点与模型须同时满足当前 Hermes 版本要求。
第 4 步:重启并核对实际后端
关闭已有 Hermes 进程后重新启动,先发一条短消息,再测试读取 README。若使用 /model 切换模型,重新确认实际提供商;只改模型名称不足以证明请求仍走同一个后端。
连接失败时按这几步排查
运行 hermes model 配置 Custom endpoint,API base URL 为 https://api.quickrouter.ai/v1;模型、provider 与 URL 应作为同一组设置。
- 退出当前会话,在终端运行 hermes model,选择 Custom endpoint,填写 Base URL、Key 和真实模型 ID。
- 保留 ~/.hermes/config.yaml 与 ~/.hermes/.env 的其他设置;检查 model.provider、model.default、model.base_url 是否对应同一服务。
- 新开会话确认实际 provider;会话内 /model 切换与终端 hermes model 添加提供商不是同一步操作。
容易混淆的情况
- CLI、守护进程或其他运行环境可能读取不同环境变量;终端成功时仍需核对实际运行进程。
- 短文本成功但 Agent 出错时,检查工具协议及上下文限制;上下文长度应按真实模型能力设置。
怎样确认修复成功
新会话先发短消息,再授权读取测试文件。若仍失败,查看本机 hermes logs,分享前删除密钥、私有提示词和敏感路径。
记录所装客户端版本、模型 ID、请求时间、最终路径与脱敏状态。本节为配置核对指南,未新增客户端付费调用实测;保留原文已有验证记录的适用范围。
怎样确认配置已生效
- 运行中的 Hermes 读取更新后的 .env 和 config.yaml。
- /model 显示目标模型,短消息有日志。
接入失败时逐项检查
| 现象 | 检查与处理 |
|---|---|
| 切换后 model not allowed | 核对当前令牌允许的模型与分组。 |
| 手动修改没有生效 | 重新启动 Hermes,确认配置目录和当前运行用户一致。 |
| 辅助脚本下载失败 | 改用本页手动配置;不要将辅助脚本视为 Hermes 官方安装器。 |
资料与下一步
遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID,联系支持时先隐藏 API Key。