Hermes Agent 一键接入 Crazyrouter：用国内接口跑 Claude Opus 4.8、GPT-5.5 和 DeepSeek V4 Flash

Hermes Agent 一键接入 Crazyrouter：用国内接口跑 Claude Opus 4.8、GPT-5.5 和 DeepSeek V4 Flash#

如果你正在用 Hermes Agent 做本地 AI 助手，最容易卡住的地方通常不是模型能力，而是配置：API Key 写在哪里？Base URL 要不要带 /v1？默认模型怎么选？配置错了怎么恢复？

crazyrouter-hermes 这个脚本就是为了解决这类问题：一条命令把 Hermes Agent 接到 Crazyrouter，并默认使用国内接口。

GitHub 脚本：

https://github.com/xujfcn/crazyrouter-hermes

默认接入地址：

https://cn.crazyrouter.com/v1

默认推荐模型：

claude-opus-4-8
gpt-5.5
deepseek-v4-flash

为什么 Hermes Agent 需要自定义模型配置？#

Hermes Agent 是一个可以在本地运行的 AI Agent 工具。它能帮你处理代码、命令行、文件和日常开发任务。

但要让 Hermes Agent 使用你想要的模型，通常需要配置：

手动配置当然可以，但新手很容易把 base_url 写错。比如少了 /v1：

https://cn.crazyrouter.com

正确应该是：

https://cn.crazyrouter.com/v1

一键脚本的价值就是把这些容易出错的步骤固定下来。

Linux / macOS / WSL2 一键安装#

执行：

curl -fsSL https://raw.githubusercontent.com/xujfcn/crazyrouter-hermes/main/setup.sh | bash

脚本会做这些事：

1. 检查 Hermes Agent 是否存在；
2. 创建 ~/.hermes 目录；
3. 提示输入 Crazyrouter API Key；
4. 选择默认模型；
5. 写入 .env；
6. 写入或更新 config.yaml；
7. 可选测试连接。

执行完成后，启动 Hermes：

hermes

然后可以在 Hermes 内切换模型：

/model claude-opus-4-8
/model gpt-5.5
/model deepseek-v4-flash

Windows PowerShell 一键安装#

Windows 用户可以执行：

irm https://raw.githubusercontent.com/xujfcn/crazyrouter-hermes/main/setup.ps1 | iex

如果你担心远程执行脚本，可以先下载：

iwr https://raw.githubusercontent.com/xujfcn/crazyrouter-hermes/main/setup.ps1 -OutFile setup.ps1

打开看一遍源码，再执行：

.\setup.ps1

这更适合公司电脑或对安全比较敏感的环境。

脚本写入了哪些文件？#

主要是两个文件：

~/.hermes/.env
~/.hermes/config.yaml

.env 示例：

OPENAI_API_KEY=sk-your-crazyrouter-key
OPENAI_BASE_URL=https://cn.crazyrouter.com/v1

config.yaml 示例：

model:
  provider: "custom"
  default: "claude-opus-4-8"
  base_url: "https://cn.crazyrouter.com/v1"

脚本覆盖旧配置前会生成 .bak 备份。

如果配置错了，可以用备份恢复：

~/.hermes/.env.bak
~/.hermes/config.yaml.bak

推荐模型怎么选？#

1. Claude Opus 4.8#

适合：

• 复杂代码理解；
• 长任务规划；
• 多步骤 Agent 工作流；
• 深度分析。

切换命令：

/model claude-opus-4-8

2. GPT-5.5#

适合：

• 通用开发任务；
• 快速问答；
• 代码补全；
• 文档生成。

切换命令：

/model gpt-5.5

3. DeepSeek V4 Flash#

适合：

• 快速响应；
• 日常轻量任务；
• 成本敏感型开发工作流；
• 简单代码解释。

切换命令：

/model deepseek-v4-flash

常见错误排查#

1. API Key 为空#

脚本会提示输入 API Key。不要直接回车。

2. Base URL 写错#

必须使用：

https://cn.crazyrouter.com/v1

不要少写 /v1。

3. Hermes 没有重启#

配置完成后，重新打开 Hermes 再测试。

4. 模型名写错#

先用脚本默认模型测试：

claude-opus-4-8
gpt-5.5
deepseek-v4-flash

确认能用后，再换其它模型。

总结#

Hermes Agent 接入 Crazyrouter 的核心配置只有三个：

API Key
Base URL
Model

但手动改配置容易出错。crazyrouter-hermes 脚本把这些步骤自动化：

• 默认使用 https://cn.crazyrouter.com/v1；
• 支持 Claude Opus 4.8、GPT-5.5、DeepSeek V4 Flash；
• 自动写入 .env 和 config.yaml；
• 修改前备份；
• 支持连接测试。

脚本地址：

https://github.com/xujfcn/crazyrouter-hermes

如果你想让 Hermes Agent 快速接入多个 AI 模型，这个脚本是最省心的起点。