Hermes Agent 是一款终端 AI 编程工具。接入云信大模型 API 平台（简称 AIHub）时，可通过自定义模型配置，将模型 provider 指向 AIHub 的 Anthropic Messages 或 OpenAI-compatible 入口。

安装 Hermes Agent

macOS/Linux 使用安装脚本进行安装，脚本会自动安装 Hermes Agent 及所需运行依赖：

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

安装完成后，重新加载终端环境：

bashsource ~/.bashrc
# 如果使用 zsh，则执行：
source ~/.zshrc

确认命令可用：

bashhermes --version

Windows 用户：若工具要求 Linux 运行环境，建议先安装 WSL2，并在 WSL2 中执行上述安装命令。

配置接入凭证

若 Hermes Agent 支持命令行配置，可按以下语义写入配置：

bashhermes config set model.provider custom
hermes config set model.base_url "$AIHUB_BASE_URL/v1"
hermes config set model.api_key "$AIHUB_TOKEN"
hermes config set model.default "$AIHUB_MODEL"

• 如需使用 Anthropic Messages 协议，请将协议模式配置为工具当前版本对应的 Anthropic Messages 选项。
• 如需使用 OpenAI-compatible 协议，请将协议模式配置为工具当前版本对应的 OpenAI 兼容选项。

配置项说明：

配置项	说明
model.provider	custom 或自定义 provider 名称
model.base_url	$AIHUB_BASE_URL/v1
model.api_key	$AIHUB_TOKEN，即 AIHub API 密钥/访问令牌
model.default	AIHub 模型名称
api_mode/协议模式	Anthropic Messages 或 OpenAI-compatible，按工具支持项选择

验证配置

1. 验证目标协议入口。

   bashcurl "$AIHUB_BASE_URL/v1/models" \
     -H "Authorization: Bearer $AIHUB_TOKEN"
   

2. 运行 Hermes Agent 发起最小对话。

   bashhermes chat -q "只回复 OK"
   

如果控制台请求日志中出现 AIHub 标准推理请求，说明配置已生效。

常见问题

现象	排查方向
配置后仍连接默认 provider	检查 Hermes Agent 当前配置文件是否被其他 profile 覆盖。
401/unauthorized	model.api_key 未正确填写当前环境的 AIHUB_TOKEN。
404	Base URL 与协议模式不匹配（例如 Anthropic 模式却指向 Chat Completions endpoint）。
模型不可用	调用 /v1/models 查询当前令牌可见的模型列表，并切换为返回的 data[].id。