Skip to main content
更新日期：2026-06-06
通过 crazyrouter-hermes 可以把 Hermes Agent 的模型后端切到 Crazyrouter。配置完成后，Hermes 会使用 Crazyrouter OpenAI 兼容 base_url，并通过一个 Crazyrouter API Key 调用 Claude、GPT、DeepSeek、Gemini、Qwen 等 627+ 模型。

​
适合谁用

  • 已经安装 Hermes Agent，想直接接入 Crazyrouter 的用户
  • 想在本地 Agent 中统一使用 Crazyrouter 模型和额度的用户
  • 想用一条命令完成 OPENAI_API_KEY、OPENAI_BASE_URL 和默认模型配置的用户

​
前置条件

Hermes 使用 OpenAI 兼容配置接入 Crazyrouter，默认接入地址直接使用 https://api.crazyrouter.com/v1。如果你不确定某个客户端到底该填根域名还是 /v1，先参考 API Endpoint 说明。账号登录、充值和控制台仍使用 https://crazyrouter.com。

​
一键配置

脚本会引导你输入 Crazyrouter API Key、选择默认模型，并可选测试连接。
一键脚本会写入本机 Hermes 配置。运行前建议先备份已有的 ~/.hermes/.env 和 ~/.hermes/config.yaml。

​
手动配置

如果你不想运行脚本，也可以手动写入 Hermes 配置文件。

​
环境变量

编辑 ~/.hermes/.env：
默认保持这个国际 API 接入地址即可。该地址仅用于 API 请求，账号登录、充值和控制台仍使用 https://crazyrouter.com：

​
默认模型

编辑 ~/.hermes/config.yaml：
默认也建议保持国际 API 接入地址：
把 default 改成你在 Crazyrouter token 中已放行的模型即可。

​
切换模型

配置完成后，可以在 Hermes 内随时用 /model 切换模型：
如果切换后返回 model not allowed 或 403，通常是当前 Crazyrouter token 没有放行该模型。

​
验证清单

  • ~/.hermes/.env 中的 OPENAI_API_KEY 是有效的 Crazyrouter token
  • OPENAI_BASE_URL 是 https://api.crazyrouter.com/v1
  • ~/.hermes/config.yaml 中 provider 为 custom
  • 默认模型已在 Crazyrouter token 中放行
  • Hermes 中发送测试消息可以正常返回
  • /model gpt-5.5 或其他已放行模型可以切换成功

​
常见问题

查看 crazyrouter-hermes 仓库

查看一键配置脚本、手动配置示例和最新说明。