Hermes Agent配置第三方API中转站教程

具体配置步骤

步骤一：配置凭证 (.env)

打开或创建 ~/.hermes/.env 文件：

Bash

nano ~/.hermes/.env

在文件中添加你的第三方中转站提供的 API Key（通常是 sk- 开头的字符串）：

Code snippet

# 建议定义一个专属的变量名，避免与官方的 ANTHROPIC_API_KEY 冲突
CUSTOM_CLAUDE_KEY="your_third_party_proxy_api_key_here"

保存并退出（Nano 编辑器下按 Ctrl + O 回车保存，Ctrl + X 退出）。

步骤二：配置中转商与模型 (config.yaml)

打开 ~/.hermes/config.yaml 文件：

Bash

nano ~/.hermes/config.yaml

在文件中添加 custom_providers（自定义提供商）板块。

⚠️ 避坑关键点： 很多国内或第三方中转站的完整基础路径通常是 [https://api.xxxx.com/v1](https://api.xxxx.com/v1)。在 Hermes 中，建议在 base_url 后直接带上 /v1，这样可以防止 Hermes 的探测机制在找不到标准接口时自作聪明地对你的 URL 进行错误改写。

请参考以下格式进行追加或修改：

YAML

custom_providers:
  - name: my-claude-proxy
    # 填入中转站的 Base URL，注意结尾带上 /v1
    base_url: "https://your-proxy-domain.com/v1" 
    # 引用我们在 .env 中定义的密钥
    api_key: "${CUSTOM_CLAUDE_KEY}"
    # 声明此中转站使用的是 Anthropic 的 Messages 协议规范
    api_mode: "anthropic_messages"
    # 指定该中转商默认映射的具体模型名称
    model: "claude-3-5-sonnet-20241022" 

# 如果你想让 Hermes 默认就启动这个模型，可以在顶层指定：
model:
  default: "claude-3-5-sonnet-20241022"
  provider: "my-claude-proxy"

4. 启动与验证

配置完成后，直接在终端中初始化或运行 Hermes：

Bash

hermes chat

进入对话后，你可以通过以下命令验证当前模型及中转路由是否生效：

1. 输入 /model（或者在部分版本中直接回车输入命令），检查当前处于激活状态的 provider 是否为你配置的 my-claude-proxy。
2. 发送一句简单的测试：你好，请问你是谁？ 如果中转站配置正确，你将收到由 Claude 3.5 Sonnet 响应的丝滑回复。

💡 进阶提示： 如果你的中转站同时支持 OpenAI 格式的调用（比如把 Claude 映射成了类似 GPT 的调用路径），你也可以将 api_mode 改为 openai，并将 base_url 调整为对应的 OpenAI 路由格式。不过对于代码和 Agent 任务，原生 anthropic_messages 协议的解析性能和工具调用（Tool Calling）表现通常更稳定。