Hermes Agent — открытый автономный ИИ-агент от Nous Research, который запускается на компьютере или сервере и выполняет задачи по указаниям. Агент работает с файлами, выполняет код в терминале, ищет информацию в интернете, автоматизирует процессы и подключается к мессенджерам (Telegram, Discord, Slack и другим).
Установка и базовая настройка описаны в официальной документации. Здесь — только подключение к ProxyAPI.
Конфигурация Hermes хранится в двух файлах:
~/.hermes/config.yaml— основные настройки: модели, сервисы, инструменты~/.hermes/.env— ключи и секреты
В конец файла ~/.hermes/.env добавляется строка:
PROXYAPI_KEY=<КЛЮЧ>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_messagescustom_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"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-6hermes --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/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 --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_messagesmodel: 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=<КЛЮЧ>
В 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 г.