Hermes Agent 安装教程（macOS）

推荐用一键脚本

下面的手动步骤一键脚本都会自动完成（安装 + 同时配置 Claude 和 GPT）：

curl -fsSL https://docs.aizhan.space/sh/hermes.sh | bash

详见 Hermes Agent 一键配置安装。

1. 安装 Hermes Agent

打开「终端」，执行 Hermes 官方安装命令：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

官方安装器会自己准备 Python 和依赖，不需要 pip，也不需要系统自带 Python；安装过程需要访问 GitHub。安装完成后命令位于 ~/.local/bin，请重新打开终端，然后验证：

hermes --version

2. 配置 Hermes（接入AI驿站）

配置文件是 Hermes 主目录下的 config.yaml，主目录为 ~/.hermes（设置了 HERMES_HOME 环境变量时以它为准）。

mkdir -p ~/.hermes
open -e ~/.hermes/config.yaml   # 或用你习惯的编辑器

写入下面的内容（已有配置的话，只需添加或替换对应的段落）：

model:
  default: "claude-opus-5-5"
  provider: "aizhan-claude"

providers:
  aizhan-claude:
    name: "AI驿站 Claude"
    base_url: "https://api.aizhan.space"
    api_mode: anthropic_messages
    api_key: "你的 Claude 分组 Key"
    default_model: "claude-opus-5-5"
    models:
      "claude-opus-5-5":
        context_length: 1000000
  aizhan-gpt:
    name: "AI驿站 GPT"
    base_url: "https://api.aizhan.space/v1"
    api_mode: codex_responses
    api_key: "你的 GPT 分组 Key"
    default_model: "gpt-6.1-sol"
    models:
      "gpt-6.1-sol":
        context_length: 1050000

agent:
  reasoning_effort: "medium"

• 把两处 Key 换成你在 api.aizhan.space 创建的真实 Key（Claude 和 GPT 是不同的令牌分组）。只用一家的话，删掉另一家的条目，并让 model 指向你保留的那一家。
• Claude 地址不带 /v1，GPT 地址必须带 /v1。
• 字段一律用小写加下划线（如 base_url、api_key），驼峰写法 Hermes 不认。

3. 启动并验证

hermes -z "Reply with exactly: OK"
hermes -z "Reply with exactly: OK" --provider aizhan-gpt -m gpt-6.1-sol

两条都回复 OK 就说明配置成功。之后直接运行 hermes 进入交互，在会话中用 /model 切换模型、/reasoning 调整推理强度。

常见问题

1. 提示找不到 hermes 命令

安装器已把 ~/.local/bin 加入 PATH，但要重新打开终端才会生效。

2. Claude 报错 "Requests from the ... framework are not supported"

你的 Claude Key 所在令牌分组只允许 Claude 官方客户端。请在允许第三方工具的分组下重新创建 Key。

3. API 调用失败 / 401

• 检查 Key 是否完整、是否属于对应的分组（Claude Key 配给 aizhan-claude，GPT Key 配给 aizhan-gpt）
• 检查 base_url：Claude 不带 /v1，GPT 带 /v1
• hermes doctor 里的「Anthropic API」检查的是 Anthropic 官方地址，与本配置无关，显示 ✗ 可以忽略