Hermes Agent
最近更新：2026年8月26日
通过 Hermes Agent 的自定义端点配置接入 Amux，运行一次 hermes model 即可完成设置。
Hermes Agent 是一个支持多轮工具调用、浏览器自动化、代码执行和文件操作的 Agent 框架，使用 OpenAI 协议。
推荐：用 CC Switch 配
CC Switch 支持 Hermes Agent，添加一个供应商（Base URL 填 https://gateway.amux.ai/v1）即可。切换之后重开终端。
下面是手动配置的写法。
一、创建 Amux 密钥
在控制台的密钥页创建一把。创建后仍可在该页面再次查看，无需重新生成。
二、跑配置向导
hermes model它是交互式的，不需要手改文件。在供应商列表里选「自定义端点」（Custom endpoint），然后依次填：
| 提示 | 填什么 |
|---|---|
| API Base URL | https://gateway.amux.ai/v1 |
| API Key | 你的 Amux 密钥 |
| 模型名 | 规范 ID，例如 anthropic/claude-opus-5 |
/v1 要带上：OpenAI 系客户端在它后面直接拼 /chat/completions。
三、结果写在哪
向导把答案写进 ~/.hermes/config.yaml，provider 会是 custom，base_url 指向上面那个地址。排查时可以直接打开这个文件核对。
四、验证
启动 Hermes Agent 后发送一条测试消息，或给它一个需要使用工具的小任务（例如“读取当前目录的 README 并概括”）。由于它高度依赖工具调用，仅发送普通文本不足以验证整条链路。
选模型
再跑一次 hermes model 即可。
模型名使用规范 ID，不限于 OpenAI 的模型。但 Hermes Agent 对工具调用能力依赖较高，建议优先查看模型详情页中的能力标注；工具调用能力不足的模型，通常无法稳定完成 Agent 任务。
要锁定供应商或指定路由策略，在模型名后加冒号（anthropic/claude-opus-5:@reliability），见 API 参考。长任务场景中可以优先考虑 :@reliability，以提升整体执行稳定性。
常见问题
鉴权失败
密钥是否复制完整，控制台里是否还启用，工作区余额是否充足。也确认 Base URL 带了 /v1——地址少一段报的也是鉴权类错误。
配置改了没生效
重开终端。也可以直接看 ~/.hermes/config.yaml，确认 provider 是 custom、base_url 是你填的那个。
工具调用一直失败
通常是模型本身不适合该场景，而不是配置问题。建议切换到工具调用能力更强的模型，模型详情页有能力标注。
长任务跑到一半断了
用 :@reliability 后缀让路由优先挑成功率高的供应商。另外确认工作区余额够——余额不足会在中途失败，而 Agent 已经跑了一段。