Source: https://aiprimetech.io/ru/learn/run-hermes-agent-with-claude-api/ [Главная](/ru/) / [Обучение](/ru/learn/) / Hermes Agent с Claude через шлюз: настройка пользовательского провайдера, контроль расходов и устранение проблем # 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: переключает внутри чата Мастер настройки делает то же самое: 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..provider и .model чтобы направлять их к более дешёвой модели | Задачи по расписанию | cron.model для всех задач; hermes cron pause или 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 помогают в длительной сессии. ## Вход через Claude Pro или Max вместо ключа 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](/ru/learn/run-openclaw-with-claude-api/). ## Часто задаваемые вопросы Как использовать Hermes Agent с пользовательской конечной точкой Claude? Добавьте именованного провайдера в ~/.hermes/config.yaml: укажите URL шлюза в api, переменную из ~/.hermes/.env в key_env и transport: anthropic_messages, затем задайте model.provider: custom:. Почему 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](/register) AI Prime Tech — независимый API-шлюз. Он не связан с Anthropic, не одобрен этой компанией и не является её реселлером. Claude и названия связанных моделей — товарные знаки их соответствующих владельцев. ## Другие руководства по Claude API [Как получить ключ Claude API](/ru/learn/how-to-get-a-claude-api-key/)[Как устроены цены Claude API](/ru/learn/claude-api-pricing-explained/)[Самый дешевый способ использования API Claude](/ru/learn/cheapest-way-to-use-claude-api/)[Безлимитный Cursor с API Claude](/learn/use-claude-api-with-cursor/)[Безлимитный доступ к Claude Code](/ru/learn/use-claude-api-with-claude-code/)[Шлюз API Claude и прямой доступ к Anthropic: сравнение](/ru/learn/claude-api-vs-anthropic-direct/)[Используйте Claude с OpenAI SDK: совместимая с OpenAI конечная точка, потоковая передача, инструменты и ограничения](/ru/learn/openai-compatible-claude-api/)[Объяснение моделей Claude: сравнение Claude Opus, Sonnet, Haiku и Fable — все модели Claude API, названия моделей Anthropic и цены (2026)](/ru/learn/claude-api-models-compared/)[Оплата API Claude криптовалютой](/ru/learn/claude-api-with-crypto-payment/)[Доступ к API Claude без листа ожидания](/ru/learn/claude-api-without-waitlist/)[Как сократить расход токенов Claude](/ru/learn/how-to-reduce-claude-token-usage/)[Безлимитный Cline с API Claude](/ru/learn/use-claude-api-with-cline/)[Безлимитный Roo Code с API Claude](/ru/learn/use-claude-api-with-roo-code/)[Безлимитный Claude в IDE JetBrains](/ru/learn/use-claude-api-with-jetbrains/)[Aider с Claude через шлюз: ANTHROPIC_API_BASE, файлы конфигурации, режим архитектора и исправления](/ru/learn/use-claude-api-with-aider/)[Безлимитный Claude в VS Code](/ru/learn/use-claude-api-with-vscode/)[Конфигурация OpenCode для Claude: настройка opencode.json, модели и распространённые ошибки](/ru/learn/use-claude-api-with-opencode/)[Запуск OpenClaw с Claude без ограничений](/ru/learn/run-openclaw-with-claude-api/)[Что означает API, совместимый с Anthropic](/ru/learn/anthropic-compatible-api/)[Ключ API Claude Code — ANTHROPIC_API_KEY: как получить, настроить и когда вместо него использовать claude setup-token](/ru/learn/claude-code-api-key-setup/)[Расходы на API Claude Code — цены и способы их снизить](/ru/learn/claude-code-api-costs/)[Объяснение ошибок API Claude: ошибка сервера 500, перегрузка 529, лимит запросов 429, некорректный запрос 400 — и исправление каждой из них](/ru/learn/claude-api-errors-troubleshooting/)[Как купить кредиты Claude API — и почему кредиты Claude лучше любого предложения «купить аккаунт Claude»](/ru/learn/buy-claude-api-credits/)[Бесплатный API Claude: существует ли бесплатный ключ API Claude и что действительно бесплатно в 2026?](/ru/learn/claude-api-free-trial/)[API Claude или подписка Claude Pro/Max — что выбрать](/ru/learn/claude-api-vs-subscription/)[Codex CLI с пользовательским провайдером: config.toml, модели GPT и Claude, расширение для IDE и исправления](/ru/learn/use-claude-api-with-codex/)[Подключение Claude к n8n](/ru/learn/use-claude-api-with-n8n/)[Маршрутизация LiteLLM к Claude](/ru/learn/use-claude-api-with-litellm/)[Использование Claude в Kilo Code](/ru/learn/use-claude-api-with-kilo-code/)[GitHub Copilot Chat с Claude через шлюз: настройка Custom Endpoint, режим агента и исправления](/ru/learn/use-claude-api-with-github-copilot/)[Подключите Zed к Claude через шлюз](/ru/learn/use-claude-api-with-zed/)[Подключите Cherry Studio к Claude](/ru/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic в LangChain: импорт, base_url, потоковая передача, инструменты и ошибки](/ru/learn/use-claude-api-with-langchain/)[Anthropic Python SDK: установка, настройка base_url, потоковая передача и обработка ошибок](/ru/learn/anthropic-python-sdk/)[Claude с Vercel AI SDK: baseURL в createAnthropic, потоковая передача и устранение проблем](/ru/learn/use-claude-api-with-vercel-ai-sdk/)[Используйте Factory Droid с Claude](/ru/learn/use-claude-api-with-factory-droid/)[Как устроен API Claude Code](/ru/learn/claude-code-api/)[Интеграция API Claude в ваше приложение](/ru/learn/claude-api-integration/)[Как пользоваться Claude без ограничений — и почему «взломанного Claude Code» не существует](/ru/learn/get-unlimited-claude-usage/)