# Настройка Hermes Agent в VS Code с единым API‑ключом RouterAI для работы с Claude, GPT

В этом руководстве мы соберем сетап для вайб-кодинга (Vibe Coding) на базе VS Code. В качестве основного инструмента мы используем автономного Hermes Agent, а модели подключаем через шлюз[RouterAI](/ "RouterAI").

## 1. Почему Hermes Agent и RouterAI дополняют друг друга в вайб кодинге

Термин «Vibe Coding», который популяризировал Андрей Карпатый, меняет подход к программированию. Вы становитесь менеджером, описываете задачи на естественном языке и управляете процессом, а код пишет ИИ.

Hermes Agent даёт для этого подходящую основу:

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

* **ACP-интеграция.** Работает через стандартный Agent Client Protocol (ACP) – это значит, что он нативно встраивается в VS Code, Zed и JetBrains IDE.

* **Богатый инструментарий**. Hermes способен на чтение и редактирование файлов, терминал, поиск, браузер, написание кода.

* **Память и навыки**. Hermes запоминает ваши предпочтения, а также может загружать навыки (Skills) для сложных рабочих процессов.

Однако без качественной LLM агент бесполезен. Здесь возникают две проблемы:

* По умолчанию Hermes просит вводить API-ключ отдельно для каждого провайдера.

* А оплата доступа к OpenAI, Anthropic или Google напрямую из России отдельный квест.

> Решение: использовать Hermes Agent как среду выполнения, а модели подключать через агрегатор[RouterAI](/ "RouterAI"). Такой подход открывает доступ к топовым моделям (Claude Sonnet, GPT, DeepSeek и другим) через единый ключ доступа, с удобной оплатой в рублях и без VPN.

## 2. Что представляет собой Hermes Agent?

Hermes оснащен инструментами веб-поиска, выполнения терминальных команд, редактирования файлов, памяти, делегирования задач и многими другими.

* **Постоянная память**\
  Агент помнит ваши предпочтения, проекты, окружение и изученную информацию через MEMORY.md и USER.md. Но есть лимит до 2200 символов.

* **Контекстные файлы**\
  Hermes автоматически загружает контекстные файлы проекта, которые формируют его поведение в вашем проекте. Приоритет: `.hermes.md`, `AGENTS.md`, `CLAUDE.md`, `.cursorrules`

* **Навыки (Skills)**\
  В арсенале Hermes есть готовые навыки для кодинга, маркетинга, дизайна, MLOps и других задач.

* **Контрольные точки (Checkpoints)**\
  Перед внесением изменений в файлы Hermes может создавать снимок рабочей директории и откатываться назад, если что-то пошло не так.

* **Делегирование саб-агентов**\
  Инструмент `delegate_task` порождает дочерних агентов с изолированным контекстом и ограниченными наборами инструментов.

* **Планировщик задач (Cron)**\
  Можно планировать задачи на естественном языке или с помощью cron‑выражений. Задачи могут использовать навыки и доставлять результаты на разные платформы и выполняться в изолированных сессиях.

* **Интеграция с VS Code через ACP**\
  Hermes запускается как ACP-сервер через команду Hermes acp. Расширение ACP Client в VS Code подключается к этому серверу и отображает инструменты в вашем редакторе.

## 3. RouterAI с единым ключом доступа без VPN и проблем с оплатой

Чтобы Hermes Agent превратился из удобного интерфейса в функционального ассистента, ему необходим доступ к API модели.Для этого будем использовать RouterAI.

**Что дает RouterAI:**

* OpenAI-совместимый API. Миграция обычно сводится к замене `base_url` и ключа.

* Регулярное обновление каталога моделей.

* Оплата российскими картами, СБП и по счёту для юрлиц.

* Pay-as-you-go. Списание только за фактически потраченные токены.

**Быстрый старт:**

* Зарегистрируйтесь на[routerai.ru](http://routerai.ru/ "routerai.ru").

* Пополните баланс (от 100 р.).

* В личном кабинете перейдите в раздел «Ключи API» и сгенерируйте новый ключ.

* Скопируйте его, он понадобится для настройки.

Актуальный список моделей и их идентификаторов всегда смотрите на [странице](http://routerai.ru/models "странице"). Каталог обновляется, и named-версии моделей меняются быстрее, чем статьи о них.

## 4. Настройка Hermes Agent + RouterAI 

### 4.1 Что нужно для старта

* Аккаунт RouterAI с API-ключом

* Python 3.12+ нужен, если планируете ручную установку через pipx (раздел 4.2.2). При автоматической установке (4.2.1) скрипт подтягивает Python и остальные зависимости сам.

### 4.2 Установка Hermes Agent 

#### 4.2.1. Автоматическая установка (рекомендуется)

Рекомендуемспособ с официальным установочным скриптом. Он автоматически загрузит все зависимости (Python, Node.js, ripgrep, ffmpeg и др.) и проведёт через интерактивную настройку.

1. Откройте терминал и выполните команду:

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

2. Скрипт предложит выбрать режим настройки. Выберите **Full setup** (используйте стрелки ↑↓, затем Enter). Только этот режим позволяет подключить внешние API-провайдеры, включая RouterAI. Quick Setup привязан к внутренним моделям Nous и не даст возможности подключить RouterAI.

![1.00](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/ba3af108277d998d13d8c9388ac3b30d.png)

3. После выбора Full setup появится список провайдеров. Так как RouterAI в списке отсутствует, выберите **Custom endpoint (enter URL manually)** (прокрутите список вниз) и нажмите Enter.
4. Введите **URL эндпоинта RouterAI**:\
   <https://routerai.ru/api/v1>
5. Введите **ваш**  **API-ключ RouterAI** (скопируйте из личного кабинета). Ключ не отображается, но вводится корректно.

![1.00](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/55657d360d6e1edcf0e8d55e4d87cb55.png)

6. Установщик проверит эндпоинт и покажет число доступных моделей (например, Verified endpoint … (488 model(s) visible)). На вопрос о режиме совместимости оставьте **Auto-detect**, просто нажмите **Enter**.
7. Затем выберите модель по умолчанию. Введите идентификатор модели, например:\
   anthropic/claude-sonnet-5.5 (или любую другую из списка [RouterAI](http://routerai.ru/models "RouterAI")). Нажмите **Enter**.

> Важно: Hermes Agent требует контекстное окно от 64 000 токенов — модели с меньшим контекстом установщик не примет.

8. При запросе контекстного окна оставьте поле пустым (Context length in token) нажмите **Enter.**  Hermes сам определит оптимальный размер.

9. Отобразится имя провайдера: **Display name \[[Routerai.ru](http://routerai.ru/ "Routerai.ru")].** Можно оставить предложенное Routerai.ru или изменить на своё, затем **Enter**.

10. Установщик предложит выбрать уровень рассуждений (Select reasoning effort). Оставьте текущее значение (medium): выберите **Skip (keep current)** (последний пункт) и нажмите **Enter**.

11. Далее установщик спросит, где выполнять команды терминала. Оставьте **Keep current (local) (или Local),** нажмите **Enter**.

![1.00](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/671ff8d3500b4cdb70e1804b52a321aa.png)

12. Появится меню настройки мессенджеров (Telegram, Slack и др.), через которые можно будет написать агенту. Ничего не выбирайте, просто нажмите **Enter** (подтвердить пустой выбор) – эти платформы для работы через VS Code не нужны. Их всегда можно будет настроить позже, если захотите.
13. Затем покажут список инструментов (Web Search, Browser, Terminal, File Ops и т.д.). Большинство уже включены. Просто нажмите **Enter**, оставив всё как есть.

![1.00](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/40510e4c502256daeac9b05c4655d323.png)

14. Затем установщик настроит инструменты автоматически. Браузерная автоматизация (чтобы Hermes мог открывать страницы, кликать, скроллить, выполнять JavaScript и т.д.) использует встроенный **Browser Use**: выбирать движок не нужно, API-ключи не требуются. Для Computer Use установщик сам подготовит драйвер cua-driver, это займёт некоторое время. 

![1.00](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/ce5cf78735686aebccd7fafc2e77750e.png)

15. На вопрос о провайдере для генерации изображений выберите **Skip — keep defaults / configure later** (в самом низу) и нажмите **Enter**.

![1.00](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/a5367def56d7727ae829ade7b7b2fa54.png)

16. Аналогично для синтеза речи (TTS-провайдер) выберите **Skip — keep defaults / configure later** и **Enter**.

![1.00](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/6c0a80bb6dcd6c60b6d58cd157356e71.png)

17. Выбор поискового провайдера. Также выберите Skip — keep defaults / configure later и **Enter**. Эта функция не обязательна для базовой работы, её можно подключить позже

Установка завершена.

Проверьте версию:

`hermes --version`

Должно отобразиться v0.22.2 или выше (версия на 20.10.2026).

#### 4.2.2. Ручная установка

Если автоматический скрипт не подходит, установите зависимости вручную.

**Установка Homebrew**   (нужен для установки Python, pipx, git из командной строки):

`/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`

`eval "$(/opt/homebrew/bin/brew shellenv zsh)"`

**Установка pipx** для скачивания Python-приложений в изолированное окружение

`brew install pipx`

`pipx ensurepath`

**Установка Hermes Agent с поддержкой ACP**

`pipx install 'hermes-agent[acp]'`

`hermes --version`

**Проверка**: должно показать v0.22.2+

### 4.3 Интеграция Hermes Agent с RouterAI

Если использовали автоматическую установку URL и ключ RouterAI уже прописаны на шаге 4.2.1, дополнительно ничего делать не нужно, переходите к разделу 4.4.

Проверить, что всё сохранилось корректно, можно так:

`cat ~/.hermes/config.yaml`

В секции с настройками провайдеров должен быть блок с **base\_url**: *<https://routerai.ru/api/v1>* и вашим ключом. Точное имя секции (providers или custom\_providers) может отличаться между версиями Hermes, ориентируйтесь на актуальную [документацию](https://hermes-agent.nousresearch.com/docs "документацию"), если содержимое файла выглядит иначе.

**Если вы использовали ручную установку, создайте конфигурационный файл сами:**

`mkdir -p ~/.hermes`

`cat > ~/.hermes/config.yaml << 'EOF'`

`model:`

`  default: anthropic/claude-sonnet-5.5`

`  provider: custom`

`  base_url: https://routerai.ru/api/v1`

`custom_providers:`

`  - name: Routerai.ru`

`    base_url: https://routerai.ru/api/v1`

`    key_env: ROUTERAI_API_KEY`

`    model: anthropic/claude-sonnet-5.5`

`EOF`

Сам ключ храните не в config.yaml, а в файле `~/.hermes/.env`:

`echo 'ROUTERAI_API_KEY=ваш_ключ_из_RouterAI' >> ~/.hermes/.env`

Замените `ваш_ключ_из_RouterAI` на свой API‑ключ и сверьте id модели с текущим каталогом на [RouterAi](http://routerai.ru/models "RouterAi"), так как они периодически меняются.

\*\*Выбор модели после настройки: \*\*

`hermes model`

![1.00](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/0d95b0d84bdc44afdaeec31152e3a4d4.png)

### 4.4 Тестирование Hermes Agent в терминале 

**Вызовите в терминале интерактивный чат:**

`hermes chat`

**И далее в чате проверьте работу Hermes Agent:**

`Напиши функцию на Python, которая выводит 'Hello, RouterAI!’`

![1.00](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/b87a851eb8a1b2b73121a3f07ece56aa.png)

## 5. Интеграция с VS Code: настраиваем ACP-интеграцию

### 5.1 Установка расширения ACP

В VS Code перейдите в раздел Extensions (Cmd+Shift+X) и установите расширение:

* ACP Client (издатель formulahendry, Jun Han) – это универсальный клиент для любых ACP-агентов, который работает надёжно и позволяет подключать несколько агентов одновременно.

![1.00](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/c90661207c5b8c5cc91efe7ad425de47.png)

### 5.2 Настройка ACP Client 

Откройте пользовательские настройки VS Code (Cmd+Shift+P → Preferences: Open User Settings (JSON)) и добавьте блок:

![1.00](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/002dad09cca34989fd14a0672872bbe0.jpg)

`{`

`  "acp.agents": {`

`    "Hermes + RouterAI": {`

`      "command": "/Users/ваше_имя/.local/bin/hermes",`

`      "args": ["acp"],`

`      "env": {`

`        "PATH": "/Users/ваше_имя/.local/bin:/usr/local/bin:/usr/bin:/bin"`

`      }`

`    }`

`  }`

`}`

Замените `/Users/ваше_имя `на ваше имя пользователя.

> Важно: полный путь к hermes можно получить командой:\
> `which hermes`
>
> Скопируйте его и вставьте в поле «command».

## 6. Запуск и подключение Hermes Agent в VS Code

### 6.1 Автоматический запуск Hermes Agent 

Откройте панель расширения ACP Client (иконка в Activity Bar), выберите «Hermes + RouterAI» и нажмите Connect.

![1.00](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/3e27afdc505ca6b7b440d709064d3a8b.png)

### 6.2 Ручной запуск Hermes Agent + RouterAI

Если автоматический запуск не работает, откройте отдельный терминал и выполните:

`hermes acp`

Дождитесь пока закончится процесс. Затем в VS Code:

* Откройте панель ACP Client.

* Выберите «Hermes + RouterAI».

* Нажмите Connect.

Если всё хорошо, вы увидите приветствие и поле для ввода сообщений.

### 6.3 Проверка в VS Code

В панели ACP Client напишите любой запрос для проверки. Например:

`Напиши функцию на Python, которая вычисляет факториал числа.`

![1.00](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/fde1ad4396a100e922dad28702aaddc6.png)

## 7.  Контекстные файлы и управление сессиями

### 7.1 Контекст проекта AGENTS.md

Создайте папку проекта и файл правил:

`mkdir ~/routerai-demo && cd ~/routerai-demo`

`cat > AGENTS.md << 'EOF'`

`Проектные правила`

`- Язык кода: Python 3.12`

`- Все комментарии на русском`

`- Никогда не используй хардкодные строки – только константы`

`- После изменений запускай: python -m pytest tests/`

`EOF`

![1.00](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/32662823b015236b4a2ba48257adaf71.png)

Запустите Hermes из этой папки:

`hermes`

Hermes автоматически прочитает AGENTS.md и будет следовать правилам в течение сессии. 

[![4a79ef7a8ca6844fbd988798dabdfd3e](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/5529357502229e43a2120cb7c655b689.png)](%D0%A2%D0%B5%D1%80%D0%BC%D0%B8%D0%BD%D0%B0%D0%BB%20%D1%81%20%D0%B7%D0%B0%D0%BF%D1%83%D1%89%D0%B5%D0%BD%D0%BD%D1%8B%D0%BC%20Hermes%20Agent%20%D0%B2%20%D0%BF%D0%B0%D0%BF%D0%BA%D0%B5%20%D0%BF%D1%80%D0%BE%D0%B5%D0%BA%D1%82%D0%B0%20routerai-demo.)

### 7.2 Какие файлы контекста поддерживает Hermes

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

<table markdown="0">
<colgroup>
<col width="296">
<col width="296">
</colgroup>
<tbody>
<tr>
<td>
<p dir="ltr">Файл</p>
</td>
<td>
<p dir="ltr">Назначение</p>
</td>
</tr>
<tr>
<td>
<p dir="ltr">`AGENTS.md`</p>
</td>
<td>
<p dir="ltr">Основные правила проекта</p>
</td>
</tr>
<tr>
<td>
<p dir="ltr">`.hermes.md`</p>
</td>
<td>
<p dir="ltr">Специфичные настройки Hermes</p>
</td>
</tr>
<tr>
<td>
<p dir="ltr">`CLAUDE.md`</p>
</td>
<td>
<p dir="ltr">Совместимость с Claude агентами</p>
</td>
</tr>
<tr>
<td>
<p dir="ltr">`.cursorrules`</p>
</td>
<td>
<p dir="ltr">Совместимость с Cursor IDE</p>
</td>
</tr>
</tbody>
</table>

 

![1.00](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/b35f9ae78cef6947bca8d29b8a81302f.png)

### 7.3 Быстрая подгрузка файлов через @ 

В чате Hermes вы можете использовать `@` для быстрой вставки содержимого файлов. Например, `@src/utils.py` заставит агента прочитать указанный файл и добавить его в контекст текущего запроса. Поведение зависит от версии Hermes и расширения ACP Client, поэтому при странностях сверяйтесь с [документацией](https://hermes-agent.nousresearch.com/docs/user-guide/features/context-references "документацией") к своей версии. 

### 7.4 Расширяем возможности Hermes готовыми навыками (Skills)

Навыки (Skills) – это процедурная память Hermes Agent, которая включает в себя пошаговые руководства, проверенные рабочие процессы и экспертные знания, которые агент загружает по требованию.  Каждый навык представляет собой документ SKILL.md, который учит Hermes выполнять конкретные задачи. Навыки следуют стандарту agentskills.io и являются предпочтительным способом расширения возможностей агента. Они проще в создании, чем инструменты (tools), не требуют изменения кода агента и могут быть опубликованы для сообщества

Список загруженных навыков можно посмотреть прямо в Hermes чате (hermes chat). Вывод показывает компактный список с названиями и описаниями.

В чате Hermes:

`/skills `

**Или из терминала:**

`hermes skills list`

![1.00](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/16efc237e55539e42471f0fd7d0d585a.png)

Есть возможность поиска по ключевому слову:

**В чате:**

`/skills search docker`

**Из терминала:**

`hermes skills search blockchain`

![1.00](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/25a2adc6a84ebf6045389fb5811d9f6d.png)

**Пример установки навыка для работы в Hermes Agent**

1. Найдите подходящий GitHub-навык

В терминале выполните поиск:

`/skills search github`

2. Установите нужный навык

Когда найдёте подходящий, скопируйте его идентификатор и установите командой.

`/skills install agent-github-pr-manager`

3. Проверьте, что навык установлен

`/skills list`

![1.00](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/88425730786e45b6e7a1eca8516a1500.png)

### 7.5 Управление сессиями без потери контекста

Сессии позволяют сохранять историю диалога и состояние агента. Это полезно, если вы:

* прервали работу и хотите продолжить ровно с того же места,

* ведете несколько параллельных задач (например, рефакторинг и написание тестов) и не хотите смешивать контексты,

* хотите вернуться к старой задаче через несколько дней.

Hermes предоставляет два способа управления сессиями:

1. Слэш-команды, которые вводятся прямо в чате (hermes chat);

2. Терминальные команды, которые выполняются в оболочке (zsh/bash) и обычно начинаются с hermes.

Полный перечень слэш-команд доступен в [Slash Commands Reference](https://hermes-agent.nousresearch.com/docs/reference/slash-commands "Slash Commands Reference"), а все терминальные флаги и команды sessions – в [CLI Commands Reference](https://hermes-agent.nousresearch.com/docs/reference/cli-commands "CLI Commands Reference"). Также общее руководство по сессиям можно найти в [Sessions Guide](https://hermes-agent.nousresearch.com/docs/user-guide/sessions "Sessions Guide").

> Синтаксис может меняться в новых версиях. Рекомендуем всегда сверяться с актуальной документацией или вызывать hermes sessions --help для получения подсказки прямо в терминале.

## 8. На что обратить внимание при работе с Hermes + RouterAI

При работе в связке Hermes Agent + RouterAI стоит учитывать несколько моментов, которые напрямую влияют на продуктивность и стоимость разработки.

**Модель имеет значение.**

Если агент начинает «галлюцинировать», терять нить рассуждения или выдавать нерабочий код, первым делом проверьте выбранную модель. Для сложных задач используйте флагманские модели (Claude Sonnet 5.5, GPT-5.5). Бюджетные варианты хороши для объяснения концепций или генерации документации, но в реализации сложной логики могут ошибаться.

**Гигиена контекста и контроль расходов.**

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

Советы по экономии:

* Регулярно начинайте новый чат командой /new после завершения этапа задачи.

* Разбивайте большие задачи на короткие сессии.

* Следите за индикатором использования контекста в интерфейсе Hermes.

**Автоодобрение изменений.**

В настройках Hermes или через команду /yolo (режим «You Only Live Once») можно включить автоматическое одобрение опасных операций. Но будьте осторожны, так как в этом режиме агент выполняет действия без запроса подтверждения, включая редактирование файлов и выполнение терминальных команд. Рекомендуется оставить запрос на подтверждение для всех критических действий, чтобы вы всегда могли просмотреть дифф и утвердить изменения.

## 9. Заключение

Мы собрали сетап для вайб-кодинга:

* Hermes Agent дает автономность, инструментарий, память, навыки и контрольные точки для агентной разработки.

* RouterAI обеспечивает интеллект (Claude, GPT, DeepSeek) без проблем с доступом из РФ.

* VS Code выступает в роли удобного интерфейса для комфортной разработки.

Удачного вайб-кодинга! 🚀