MegaBrain University · гайд
Как подключить Hermes Agent к Claude, GPT-6 и Gemini по одному API-ключу
Обновлено · 10 мин настройка
Коротко
Чтобы подключить Hermes Agent к MegaBrain, запустите hermes model, выберите Custom endpoint и введите базовый URL https://themegabrain.ru/api/gateway/v1, ваш API-ключ MegaBrain и ID модели, например anthropic/claude-sonnet-5.5. После этого все диалоги, вызовы инструментов, задачи cron и переписка в Telegram идут через эту модель, а на GPT-6, Gemini, Kimi или GLM можно переключиться одной строкой.
| Base URL (OpenAI-совместимый) | https://themegabrain.ru/api/gateway/v1 |
|---|---|
| Base URL для Claude Code и Anthropic SDK | https://themegabrain.ru/api/anthropic |
| Ключ | Authorization: Bearer <ключ> — страница «API-ключ» в кабинете |
| Модель по умолчанию | anthropic/claude-sonnet-5.5 |
| Бесплатная модель для проверки | mb-auto/free |
Что такое Hermes Agent
Hermes Agent — открытый ИИ-агент от Nous Research. Он работает на вашем компьютере или сервере, пользуется инструментами (терминал, файлы, браузер, веб-поиск), сохраняет удачные решения как навыки, помнит контекст между сессиями и общается через терминал или мессенджеры: Telegram, Discord, Slack, WhatsApp, Signal и почту.
Своей модели у Hermes нет: ему нужен провайдер, и подходит любой OpenAI-совместимый API. MegaBrain — такой API: один ключ и один баланс организации для Claude, GPT, Gemini, Grok и открытых моделей. Сложные задачи можно отдать сильной модели, рутину — недорогой, и не заводить аккаунты у каждой лаборатории.
Настройка по шагам
Шаг 1. Получите API-ключ MegaBrain
themegabrain.ru работает для компаний и их сотрудников, по приглашениям. Компания оставляет заявку, мы заводим организацию, а сотрудники получают приглашение на почту с паролем. Сотрудник входит и создаёт ключ на странице «API-ключ». Один ключ открывает все текстовые модели, а также модели изображений и видео.
Баланс организации пополняется безналичным переводом по счёту в рублях: без VPN и зарубежной карты. Подписки нет, каждый запрос оплачивается по цене модели, а расход виден по каждому сотруднику.
Сохраните ключ в переменной окружения, чтобы он не попал в конфиг, которым вы делитесь с коллегами:
# ~/.zshrc или ~/.bashrc export MEGABRAIN_API_KEY="ваш-ключ-megabrain"curl https://themegabrain.ru/api/gateway/v1/chat/completions \ -H "Authorization: Bearer $MEGABRAIN_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "anthropic/claude-sonnet-5.5", "messages": [{"role": "user", "content": "Ответь: OK"}]}'Проверьте ключ до настройки агента. Ответ в JSON с полем
choicesзначит, что ключ, баланс и модель работают:Шаг 2. Установите Hermes Agent
На macOS, Linux или WSL2:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash source ~/.zshrc # или ~/.bashrcНа Windows (PowerShell):
iex (irm https://hermes-agent.nousresearch.com/install.ps1).Шаг 3. Направьте Hermes на MegaBrain
Запустите
hermes modelи выберите Custom endpoint (self-hosted / VLLM / etc.). Введите базовый URL, вставьте ключ и укажите ID модели:Base URL: https://themegabrain.ru/api/gateway/v1 API key: ваш-ключ-megabrain Model: anthropic/claude-sonnet-5.5Мастер записывает настройки в
~/.hermes/config.yaml. Файл можно править и вручную:model: provider: custom base_url: https://themegabrain.ru/api/gateway/v1 api_key: ваш-ключ-megabrain default: anthropic/claude-sonnet-5.5Переменная
OPENAI_BASE_URLне задаёт свой эндпоинт в Hermes — источник настроек толькоconfig.yaml. Не передавайте этот файл другим: в нём лежит ключ.Шаг 4. Запустите сессию и проверьте
Запустите
hermesи дайте задачу, для которой нужен инструмент, например «Покажи файлы в этой папке и кратко опиши, что в каждом». Если Hermes выполнил команду и ответил, вызов инструментов работает. Сменить модель прямо в сессии:/model custom:openai/gpt-6.1-sol.Шаг 5. Подключите Telegram и запустите агента круглосуточно
Выполните
hermes gateway setup, чтобы подключить Telegram (или Discord, Slack, WhatsApp, Signal, почту), затемhermes gateway start. Чтобы агент работал после закрытия терминала (это нужно для задач cron), установите его как службу:hermes gateway install.
Какую модель выбрать
Hermes нужна модель с поддержкой вызова инструментов (tool calling) и контекстом от 64 тыс. токенов. Все модели из таблицы подходят. Начните с Claude Sonnet 5.5, а когда регулярные задачи cron отлажены, переведите их на Gemini Flash или DeepSeek Flash.
| ID модели | Когда брать |
|---|---|
anthropic/claude-sonnet-5.5 | Модель по умолчанию для агента: надёжно вызывает инструменты, держит длинные задачи, контекст 1 млн токенов. |
anthropic/claude-opus-5.5 | Сложные многошаговые задачи, ревью кода, аналитика, где ошибка дороже токенов. |
openai/gpt-6.1-sol | Флагман OpenAI: альтернатива Claude для кода и рассуждений. |
google/gemini-3.8-flash | Быстро и недорого: длинные документы, таблицы, разбор входящих. |
moonshotai/kimi-k3.1-pro | Сильная открытая модель для агентов и кода. |
z-ai/glm-5.3 | Открытая модель для кода и инструментов, хорошее соотношение цены и качества. |
deepseek/deepseek-v4.1-flash | Массовые рутинные задачи: классификация, черновики, саммари. |
mb-auto/free | Бесплатно, для проверки настройки. Контекст 128 тыс., слабее в вызове инструментов; не отправляйте конфиденциальные данные. |
Все модели с ценами и размером контекста — в каталоге. Каждая модель вызывается одним и тем же ключом.
Что можно делать
Мессенджер вместо терминала
Один процесс Hermes отвечает в Telegram, Discord, Slack, WhatsApp, Signal и почте, так что сотрудники пользуются агентом без командной строки.
Задачи по расписанию
Задачи cron создаются обычной фразой («каждый понедельник в 9:00 по Москве присылай мне…») или командой hermes cron create "every 2h" "…", а результат приходит в чат.
Навыки, которые он пишет сам
После задачи Hermes может сохранить порядок действий как навык (формат agentskills.io) и использовать его снова. Список навыков — команда /skills.
MCP-серверы
Добавьте MCP-серверы в раздел mcp_servers: файла config.yaml или командой hermes mcp install <name>, чтобы дать агенту доступ к базе данных, документации или CRM, если у неё есть MCP-сервер.
Сценарии для бизнеса
Утренняя сводка для руководителя в Telegram
Задача cron читает вчерашние цифры (выгрузку из 1С в CSV, таблицу или базу через MCP), сравнивает с прошлой неделей и каждое утро присылает в чат руководителей три главных пункта.
Задача для агента:
Каждый будний день в 8:00 по Москве читай sales.csv в ~/reports (выгрузка из 1С), сравни вчерашний день с тем же днём прошлой недели и пришли мне в Telegram: выручку, число заказов, топ-3 товара и всё, что изменилось больше чем на 20%. Не длиннее 10 строк.Разбор почты поддержки
Подключите ящик поддержки. Hermes помечает каждое новое письмо (ошибка, оплата и документы, новый клиент, спам), готовит черновик ответа по вашему FAQ, а срочные письма пересылает в рабочий чат в Telegram. Здесь хватит недорогой быстрой модели.
Фото для карточек Ozon и Wildberries
Тот же ключ работает с API изображений и видео MegaBrain. Попросите Hermes вызвать https://themegabrain.ru/api/gateway/v1/queue/nano-banana-pro через curl и сохранить результат, а затем оформить это как навык: отдел маркетплейсов пишет в чат «сделай 4 варианта главного фото для этого товара».
Задача для агента:
Через медиа-API MegaBrain (документация: https://themegabrain.ru/docs/media, ключ в $MEGABRAIN_API_KEY) сгенерируй в Nano Banana Pro главное фото для карточки Wildberries в формате 3:4: наша синяя керамическая кружка на светлом дубовом столе, светлый фон, без надписей. Сохрани в ~/marketing и оформи шаги как навык product-shot.Мониторинг цен конкурентов
Каждую ночь Hermes обходит список страниц конкурентов, отмечает изменения цен и ассортимента и ведёт журнал, а по понедельникам в 10:00 по Москве присылает сводку.
Если не работает
401 Unauthorized
Ключ не указан или скопирован с ошибкой, либо агент не прочитал переменную окружения (перезапустите агент после export). Проверьте ключ командой curl из шага 1.
402 Payment Required
Закончился баланс организации. Администратор пополняет его по счёту на странице «Баланс»; пока платёж идёт, проверять настройку можно на mb-auto/free.
Model not found
ID модели должен точно совпадать с каталогом, вместе с префиксом лаборатории: anthropic/claude-sonnet-5.5, а не claude-sonnet-5.5. Базовый URL должен заканчиваться на /v1.
Hermes печатает вызовы инструментов текстом, а не выполняет их
Модель не поддерживает вызов инструментов. Выберите модель из таблицы выше; anthropic/claude-sonnet-5.5 — надёжный вариант по умолчанию.
Задачи cron не запускаются
Задачи выполняются, только пока работает шлюз. Установите его как службу командой hermes gateway install.
Частые вопросы
Можно ли подключить Hermes Agent к Claude?
Да. В hermes model выберите Custom endpoint, укажите базовый URL https://themegabrain.ru/api/gateway/v1 и модель anthropic/claude-sonnet-5.5, anthropic/claude-opus-5.5 или anthropic/claude-fable-5.2. Аккаунт Anthropic не нужен.
Hermes Agent и модели Hermes — это одно и то же?
Нет. Hermes Agent — программа-агент от Nous Research, а Hermes 3/4 — языковые модели той же лаборатории. Агент работает с любой моделью, которая умеет вызывать инструменты, в том числе с Claude, GPT и Gemini.
Сколько это стоит?
Вы платите за токены по цене модели с баланса организации в рублях. Подписки и платы за места нет, поэтому агент, который простаивает, ничего не стоит. Цены в рублях за миллион токенов — в каталоге; mb-auto/free бесплатна.
Нужны ли отдельные аккаунты Anthropic, OpenAI или Google?
Нет. Один ключ MegaBrain открывает Claude, GPT, Gemini, Grok, Kimi, GLM, DeepSeek, Qwen и MiniMax. Модель меняется сменой ID, а не провайдера или ключа, а оплата идёт с одного рублёвого баланса организации.
Это работает из России без VPN?
Да. Агент обращается к https://themegabrain.ru/api/gateway/v1, VPN для запросов к моделям не нужен, зарубежная карта тоже: баланс организации пополняется по счёту в рублях.
Можно ли попробовать бесплатно?
Да: укажите модель mb-auto/free. Она направляет каждый запрос на доступную бесплатную модель (контекст 128 тыс.). Для проверки настройки этого хватит, но с длинными задачами на инструментах она справляется хуже, а её провайдеры могут сохранять запросы — не отправляйте туда конфиденциальные данные и персональные данные клиентов.
MegaBrain · один API для всех моделей
Claude, GPT, Gemini, Kimi, GLM и DeepSeek в любом агенте — один ключ и один баланс.
Без VPN и иностранной карты: компании пополняют баланс по счёту в рублях, сотрудники получают свои API-ключи, расход виден по каждому.