Hermes Agent. Сложенное бумажное послание, похожее на крыло, движется через небольшую арку шлюза к аккуратному рабочему пространству с кодом — метафора маршрутизации агентов.

Hermes Agent с Claude через шлюз: настройка пользовательского провайдера, контроль расходов и исправления

Hermes Agent хранит секреты в ~/.hermes/.env а всё остальное — в ~/.hermes/config.yaml. Надёжный способ запустить его с Claude через шлюз — использовать именованного пользовательского провайдера, работающего в формате Anthropic Messages. Более простой вариант, provider: anthropic с другим базовым URL выглядит правильным, но отправляет запросы в Anthropic для любого хоста, который он не распознаёт.

Установка

Linux / macOS / WSL2

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

hermes setup запускает полный мастер настройки; hermes model настраивает только провайдера и модель; hermes doctor проверяет существующую установку.

Добавьте шлюз как пользовательского провайдера

~/.hermes/.env

AIPRIME_API_KEY=your_gateway_key

~/.hermes/config.yaml

providers:
  aiprime:
    api: https://aiprimetech.io/v1
    key_env: AIPRIME_API_KEY
    transport: anthropic_messages
    catalog_provider: anthropic

model:
  provider: custom:aiprime
  default: claude-sonnet-5

Ключ	Почему
`transport: anthropic_messages`	Используйте формат Messages от Anthropic. Без него Hermes переходит на формат OpenAI Chat Completions
`key_env`	Имя переменной в `.env` которая хранит ключ
`catalog_provider: anthropic`	Модели Claude на шлюзе наследуют метаданные Anthropic о контексте и обработке изображений
`provider: custom:aiprime`	выбирает именованного провайдера; `/model custom:aiprime:<model>` переключает внутри чата

Мастер настройки делает то же самое: hermes model, затем **Пользовательская конечная точка**, затем режим API **Anthropic Messages**. Если вместо этого вы выбираете Chat Completions, оставьте /v1 в URL.

Почему provider: anthropic с базовым URL не работает

Настройка provider: anthropic и base_url: https://aiprimetech.io выглядит правильной, но не действует: в текущем исходном коде Hermes переопределение базового URL для встроенного провайдера Anthropic принимается только для хостов Anthropic, Claude и Azure, поэтому запросы по-прежнему отправляются в Anthropic. Используйте именованного пользовательского провайдера, описанного выше.

ANTHROPIC_BASE_URL в документации указано как способ переопределить базовый URL Anthropic, но из-за открытой ошибки Hermes селектор моделей его игнорирует. Пользовательский провайдер позволяет избежать обеих проблем.

Что влияет на расход токенов и какие настройки его ограничивают

Hermes выполняет работу за пределами видимого вам диалога, и вся она оплачивается через один и тот же ключ, если вы не направите её в другое место.

Источник расхода	Настройка
Subagents (delegation)	`delegation.max_concurrent_children` (по умолчанию 10), `delegation.max_iterations` (по умолчанию 250), `delegation.max_spawn_depth` (по умолчанию 1); более дешёвая `delegation.model`
Фоновый анализ памяти и навыков после каждого хода диалога	`auxiliary.background_review.enabled: false`, либо меньшее `max_input_tokens`
Вспомогательные задачи (сжатие, заголовки, обработка изображений)	`auxiliary.<task>.provider` и `.model` чтобы направлять их к более дешёвой модели
Задачи по расписанию	`cron.model` для всех задач; `hermes cron pause <id>` или `hermes pause`
Шлюз обмена сообщениями (Telegram, Discord и другие)	Списки разрешённых пользователей, такие как `TELEGRAM_ALLOWED_USERS`; избегайте `GATEWAY_ALLOW_ALL_USERS=true`

~/.hermes/config.yaml (дополнения)

delegation:
  max_concurrent_children: 3
  model: claude-haiku-4-5
auxiliary:
  background_review:
    enabled: false
cron:
  model: claude-haiku-4-5

hermes prompt-size показывает фиксированные расходы, которые несёт каждый вызов; /usage и /compress помогают в длительной сессии.

Hermes может войти в аккаунт Claude, но в его документации указано, что этот вариант работает только на тарифе Max с купленными кредитами на дополнительное использование, а подписчики Pro не могут им воспользоваться. С API-ключом шлюза нет ограниченного периода использования по подписке; плата списывается с вашего баланса за каждый токен.

Модели

Идентификатор модели	Для каких задач
`claude-sonnet-5`	Основной выбор для программирования и работы с агентами: быстрая, мощная, со средней стоимостью.
`claude-opus-5-5`	Более сложные рассуждения, масштабный рефакторинг, длительная работа агентов.
`claude-fable-5-1`	Самая мощная и дорогая; используйте её для наиболее сложных задач.
`claude-haiku-4-5`	Недорогая и быстрая: заголовки, краткие изложения, классификация, небольшие шаги.

Hermes требуется контекстное окно как минимум на 64K токенов; все модели в таблице соответствуют этому требованию.

Устранение неполадок

Что вы видите	Причина	Решение
HTTP 400 при первом запуске	Имя модели не совпадает с идентификатором модели на шлюзе	Используйте идентификатор из таблицы выше
Запросы отправляются в Anthropic или завершаются ошибкой аутентификации Anthropic	`provider: anthropic` со сторонним базовым URL	Используйте именованного пользовательского провайдера
Бессмысленные или пустые ответы	Неверный транспорт для URL	`transport: anthropic_messages` для Claude
Превышена длина контекста	Сессия превышает настроенное контекстное окно	Задайте `model.context_length`; `/compress`
403 `Your request was blocked`	Межсетевой экран перед конечной точкой отклоняет клиент	Добавьте `extra_headers` с User-Agent, как у браузера
После обновления отсутствуют настройки	Схема конфигурации изменилась	`hermes config check`, затем `hermes config migrate`
Бот не отвечает в Telegram или Discord	Шлюз не запущен или отправитель не разрешён	`hermes gateway status`; проверьте `~/.hermes/logs/gateway.log`

Сравниваете фреймворки для агентов? См. руководство по настройке OpenClaw.

Часто задаваемые вопросы

Как использовать Hermes Agent с пользовательской конечной точкой Claude?

Добавьте именованного провайдера в ~/.hermes/config.yaml: укажите URL шлюза в api, переменную из ~/.hermes/.env в key_env и transport: anthropic_messages, затем задайте model.provider: custom:<name>.

Почему Hermes игнорирует мой base_url для Anthropic?

При provider: anthropic Hermes принимает переопределение базового URL только для хостов Anthropic, Claude и Azure, поэтому сторонний URL игнорируется. Вместо этого используйте именованного пользовательского провайдера.

Как сократить расход токенов в Hermes Agent?

Ограничьте число субагентов в настройках делегирования, направьте вспомогательные задачи и задания cron на более дешёвую модель, отключите фоновую проверку и проверьте hermes prompt-size.

Можно ли использовать подписку Claude Pro в Hermes Agent?

Согласно документации Hermes, нет: вход через Claude работает только с подпиской Max и кредитами для дополнительного использования. API-ключ позволяет полностью обойти ограничения подписки.

Начните использовать Claude за несколько минут

Получите ключ API — учётная запись Anthropic и запись в лист ожидания не нужны.

Получить ключ API

AI Prime Tech — независимый API-шлюз. Он не связан с Anthropic, не одобрен этой компанией и не является её реселлером. Claude и названия связанных моделей — товарные знаки их соответствующих владельцев.