Hermes 配置教程

Hermes Agent 是 Nous Research 的自我提升 Agent 运行时，可以直接走 PrimeRouter。推荐使用一键脚本，按提示选择 Anthropic（Claude）或 OpenAI（Codex）通道。

两条通道，二选一

通道	基础地址	示例模型
Anthropic（Claude）	https://primerouter.ai	claude-opus-4-8
OpenAI（Codex）	https://primerouter.ai/v1	gpt-5.6-sol

Claude / Anthropic 接口不要带 /v1；OpenAI / Codex 接口必须带 /v1。

推荐方式：交互式一键脚本

运行后选择通道、粘贴 API Key、从实时模型列表中选择模型，脚本会写入 ~/.hermes/config.yaml：

macOS / Linux / WSL

curl -fsSL https://primerouter.ai/install/hermes.sh | bash

Windows PowerShell

irm https://primerouter.ai/install/hermes.ps1 | iex

💡 脚本只写配置，不会安装或重装 Hermes 本体。未检测到 hermes 命令时，脚本会给出安装提示（见下）。请先在 控制台 → 令牌 获取对应分组的 API Key。

配置完成后启动：

hermes

单发一句验证：

hermes chat -q "你好，介绍一下你自己"

备用方式：手动安装与配置 Hermes

需要审查命令、或一键脚本不可用时再展开

第一步：安装 Hermes 本体（二选一）

pipx install hermes-agent

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

第二步：选择接入通道，写入 ~/.hermes/config.yaml

把 YOUR_API_KEY 换成你的 PrimeRouter 令牌：

Anthropic（Claude）

model:
  default: claude-opus-4-8
  provider: primerouter-claude
providers:
  primerouter-claude:
    api_mode: anthropic_messages
    base_url: https://primerouter.ai
    api_key: YOUR_API_KEY
    default_model: claude-opus-4-8
    models:
      - claude-opus-4-8

OpenAI（Codex）

model:
  default: gpt-5.6-sol
  provider: primerouter-codex
providers:
  primerouter-codex:
    api_mode: codex_responses
    base_url: https://primerouter.ai/v1
    api_key: YOUR_API_KEY
    default_model: gpt-5.6-sol
    models:
      - gpt-5.6-sol

Anthropic（Claude）通道使用根地址，不要加 /v1；OpenAI（Codex）通道使用 /v1 地址。其余可用模型见 可用模型。

第三步：开始使用

hermes

正在运行的 Hermes 需要重启后才会读取新配置。