Hermes Agent 一键配置安装教程

一条命令安装 Hermes Agent，并同时接入AI驿站的 Claude 和 GPT。默认模型 claude-opus-5-5，推理强度中档（medium）。

1. 运行一键配置命令

macOS / LinuxWindows PowerShell

bash

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

powershell

irm https://sh.api.aizhan.space/hermes.ps1 | iex

菜单：1 安装 Hermes Agent、2 配置AI驿站 (Claude + GPT)、3 一键全部安装（第一次用选这个）。

2. 安装方式

脚本调用 Hermes 官方安装器（macOS / Linux 为 install.sh --skip-setup，Windows 为 install.ps1）。官方安装器会自己准备 Python 和依赖，不需要 pip，也不需要系统自带 Python。安装器需要访问 GitHub，网络不通时请先解决网络问题。

macOS / Linux：命令装在 ~/.local/bin/hermes，装完重新打开终端
Windows：命令装在 %LOCALAPPDATA%\hermes\bin，装完重新打开 PowerShell

关于两把 Key

Claude 和 GPT 在官网是不同的令牌分组。脚本会先让你选择要配置的模型家族（1 Claude + GPT（回车默认）/ 2 仅 Claude / 3 仅 GPT），然后依次输入：

Claude 分组 API Key
GPT 分组 API Key（直接回车 = 与 Claude Key 相同）

每把 Key 都会先用 /v1/models 验证，并拉取这个分组下可用的模型列表一起写进配置。

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

说明你的 Claude Key 所在令牌分组只允许 Claude 官方客户端使用。请到 api.aizhan.space 在允许第三方工具的分组下新建令牌，然后重新运行脚本选「2) 配置」。

3. 脚本会写哪些文件

只写 Hermes 主目录下的 config.yaml：设置了 HERMES_HOME 时用它，否则 Windows 为 %LOCALAPPDATA%\hermes，macOS / Linux 为 ~/.hermes。

yaml

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

providers:
  aizhan-claude:
    name: "AI驿站 Claude"
    base_url: "https://api.aizhan.space"        # Anthropic 格式，不带 /v1
    api_mode: anthropic_messages
    api_key: "sk-你的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"     # OpenAI 格式，带 /v1
    api_mode: codex_responses
    api_key: "sk-你的GPT Key"
    default_model: "gpt-6.1-sol"
    models:
      "gpt-6.1-sol":
        context_length: 1050000

agent:
  reasoning_effort: "medium"

只替换 aizhan-claude / aizhan-gpt 两个条目和默认模型、推理强度，其他配置和注释都保留；改动前备份为 config.yaml.bak.时间戳。
这是 Hermes 当前版本的 providers: 写法。旧版文档里的写法 Hermes 已不再读取，请以本页为准。

4. 验证与使用

bash

# 默认模型 (Claude)
hermes -z "Reply with exactly: OK"
# GPT
hermes -z "Reply with exactly: OK" --provider aizhan-gpt -m gpt-6.1-sol

启动交互：hermes
会话中切换：/model gpt-6.1-sol --provider aizhan-gpt（加 --global 设为默认）
交互式选默认模型：hermes model
改推理强度：会话中 /reasoning high，或 hermes config set agent.reasoning_effort high
hermes doctor 里的「Anthropic API」检查的是 Anthropic 官方地址，和AI驿站配置无关，显示 ✗ 可以忽略。

5. 回滚

把 config.yaml.bak.时间戳 复制回 config.yaml。注意 Hermes 下次启动时会把这些备份移到 <主目录>/backups/config/，文件不会丢，去那里找即可。

Hermes Agent 一键配置安装教程 ​

1. 运行一键配置命令 ​

2. 安装方式 ​

关于两把 Key ​

3. 脚本会写哪些文件 ​

4. 验证与使用 ​