Hermes Agent — открытый автономный ИИ-агент от Nous Research, который запускается на компьютере или сервере и выполняет задачи по указаниям. Агент работает с файлами, выполняет код в терминале, ищет информацию в интернете, автоматизирует процессы и подключается к мессенджерам (Telegram, Discord, Slack и другим).

Установка и базовая настройка описаны в официальной документации. Здесь — только подключение к ProxyAPI.

Конфигурация Hermes хранится в двух файлах:

  • ~/.hermes/config.yaml — основные настройки: модели, сервисы, инструменты
  • ~/.hermes/.env — ключи и секреты

В конец файла ~/.hermes/.env добавляется строка:

PROXYAPI_KEY=<КЛЮЧ>

Ключ выпускается в консоли. Как выпустить — в статье API-ключи.

Файл ~/.hermes/config.yaml открывается командой hermes config edit.

В конец файла добавляется блок custom_providers с двумя записями:

custom_providers:
  - name: proxyapi
    base_url: https://api.proxyapi.ru/v1
    key_env: PROXYAPI_KEY
    api_mode: chat_completions
  - name: proxyapi-claude
    base_url: https://api.proxyapi.ru
    key_env: PROXYAPI_KEY
    api_mode: anthropic_messages
  • proxyapi — OpenAI-совместимый формат, через него доступны все модели каталога.
  • proxyapi-claude — формат Anthropic, для моделей Claude. В этом формате Hermes сам включает кэширование: повторяющийся контекст читается из кэша и оплачивается по 10% от обычной цены ввода. Через proxyapi запросы к Claude тоже проходят, но без кэша, и весь контекст на каждом шаге оплачивается по полной цене.

В секции model задаётся сервис и модель по умолчанию:

model:
  provider: "custom:proxyapi-claude"
  default: "anthropic/claude-sonnet-4-6"

После сохранения запускается hermes — агент работает с моделью Claude Sonnet 4.6 через ProxyAPI по умолчанию.

hermes --provider custom:proxyapi --model openai/gpt-5.6-sol
hermes --provider custom:proxyapi --model google/gemini-2.5-pro
hermes --provider custom:proxyapi --model moonshotai/kimi-k2.5
hermes --provider custom:proxyapi-claude --model anthropic/claude-opus-4-6

/model custom:proxyapi-claude:anthropic/claude-sonnet-4-6
/model custom:proxyapi:openai/gpt-5.6-sol
/model custom:proxyapi:google/gemini-2.5-flash
/model custom:proxyapi:deepseek/deepseek-v3.2

hermes --provider custom:proxyapi-claude --model anthropic/claude-haiku-4-5 -z "Объясни, что такое Docker"

Финальный вид изменённых секций ~/.hermes/config.yaml. Остальные настройки файла не трогаются:

model:
  provider: "custom:proxyapi-claude"
  default: "anthropic/claude-sonnet-4-6"

custom_providers:
  - name: proxyapi
    base_url: https://api.proxyapi.ru/v1
    key_env: PROXYAPI_KEY
    api_mode: chat_completions
  - name: proxyapi-claude
    base_url: https://api.proxyapi.ru
    key_env: PROXYAPI_KEY
    api_mode: anthropic_messages

И ~/.hermes/.env:

PROXYAPI_KEY=<КЛЮЧ>

В PROXYAPI_KEY подставляется ключ из консоли.

Частые вопросы

Какие модели доступны в Hermes Agent?

Любые из каталога: openai/gpt-5.6-sol, anthropic/claude-sonnet-4-6, google/gemini-2.5-pro, deepseek/deepseek-v3.2 и остальные. Идентификатор пишется полностью, вместе с вендором.

Почему Hermes отвечает ошибкой 401?

В ~/.hermes/.env нет переменной PROXYAPI_KEY или в ней не ключ ProxyAPI. Ключ выпускается в консоли и работает только с адресом ProxyAPI, не с адресом конечного сервиса.

Нужен ли VPN для работы Hermes с ProxyAPI?

Нет. Запросы идут на api.proxyapi.ru, доступ из России открыт без VPN.

Последняя редакция: 13 ноября 2026 г.