接入 Hermes Agent

将 Hermes Agent 连接到 Puyun AI，通过 Anthropic Messages 协议使用编程模型。

安装 Hermes Agent

在 macOS 或 Linux 终端执行：

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

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

bash
source ~/.bashrc
# 如果使用 zsh：
source ~/.zshrc

验证安装：

bash
hermes --version

Windows 用户建议在 WSL2 中安装和使用。

手动配置

Hermes Agent 默认可能使用 OpenRouter。接入 Puyun AI 时，需要把 provider 改为 custom，并指定 Anthropic Messages 模式：

bash
hermes config set model.provider custom
hermes config set model.base_url https://ai.tracup.com
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key sk-your-api-key
hermes config set model.default claude-sonnet-4-6

这些配置会写入 ~/.hermes/config.yaml。你也可以直接编辑该文件：

yaml
model:
  default: claude-sonnet-4-6
  provider: custom
  base_url: https://ai.tracup.com
  api_mode: anthropic_messages
  api_key: sk-your-api-key

验证配置

执行：

bash
hermes chat -q "你好，请用一句话确认连接成功"

临时切换模型：

bash
hermes chat -m gpt-4o -q "解释一下这个项目的结构"

常见问题

配置后仍连接到 OpenRouter

请重新设置：

bash
hermes config set model.provider custom

并检查 ~/.hermes/config.yaml 中是否仍有旧的 provider 配置。

Base URL 怎么填

Hermes Agent 使用 anthropic_messages 模式时，Base URL 填写 https://ai.tracup.com，不要添加 /v1。

模型调用失败

请先用 claude-sonnet-4-6 或模型列表中的 Claude 原生模型验证连接。如果 Claude 模型可用，其他模型失败，通常是目标模型能力或协议转换兼容性问题。