接入 Hermes Agent

将 Hermes Agent 连接到 TokenCode，通过 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 中安装和使用。

推荐方式：使用 TokenCode CLI 配置

安装 Hermes Agent 后，推荐先运行 TokenCode CLI 的交互式菜单向导：

bash
npm install -g @tokencode/tokencode
tokencode

在菜单中选择 Hermes Agent，按提示输入 TokenCode API Key 和默认模型即可。CLI 会自动写入 Hermes 配置。

如果你已经熟悉参数，也可以一键写入：

bash
npx @tokencode/tokencode hm -k sk-your-api-key -m claude-sonnet-4-6

CLI 会写入 Hermes 所需的 provider、Base URL、默认模型和 API Key 配置。

手动配置

如果你不想使用 TokenCode CLI，也可以手动配置。

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

bash
hermes config set model.provider custom
hermes config set model.base_url https://tokencode.dev
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://tokencode.dev
  api_mode: anthropic_messages
  api_key: sk-your-api-key

验证配置

执行：

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

临时切换模型：

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

常见问题

配置后仍连接到 OpenRouter

请重新设置：

bash
hermes config set model.provider custom

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

Base URL 怎么填

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

模型调用失败

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