Настройка Hermes Agent

Дата обновления: 2026-06-06

С помощью crazyrouter-hermes можно переключить Hermes Agent на Crazyrouter как провайдера моделей. После настройки Hermes использует https://api.crazyrouter.com/v1 как OpenAI-совместимый endpoint и вызывает Claude, GPT, DeepSeek, Gemini, Qwen и 627+ других моделей через один API Key Crazyrouter.

Кому подходит

пользователям Hermes Agent, которые хотят использовать Crazyrouter как провайдера моделей
локальным agent-сценариям, где модели и квоты должны управляться через Crazyrouter
тем, кто хочет одной командой настроить OPENAI_API_KEY, OPENAI_BASE_URL и модель по умолчанию

Требования

Пункт	Описание
Hermes Agent	Установите Hermes локально и убедитесь, что он запускается
Аккаунт Crazyrouter	Создайте аккаунт на crazyrouter.com
Crazyrouter API Key	Рекомендуется создать отдельный `sk-...` token для Hermes
Доступ к моделям	Разрешите в token модели, которые планируете использовать

Hermes подключается к Crazyrouter через OpenAI-совместимые настройки. Base URL должен быть https://api.crazyrouter.com/v1.

Настройка одной командой

Linux / macOS / WSL2
Windows PowerShell
Windows CMD

curl -fsSL https://raw.githubusercontent.com/xujfcn/crazyrouter-hermes/main/setup.sh | bash

irm https://raw.githubusercontent.com/xujfcn/crazyrouter-hermes/main/setup.ps1 | iex

curl -o setup.bat https://raw.githubusercontent.com/xujfcn/crazyrouter-hermes/main/setup.bat
setup.bat

Скрипт попросит ввести Crazyrouter API Key, выбрать модель по умолчанию и при необходимости проверить соединение.

Скрипт записывает локальную конфигурацию Hermes. Если у вас уже есть свои настройки, сначала сделайте резервную копию ~/.hermes/.env и ~/.hermes/config.yaml.

Ручная настройка

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

Переменные окружения

Отредактируйте ~/.hermes/.env:

OPENAI_API_KEY=sk-your-crazyrouter-key
OPENAI_BASE_URL=https://api.crazyrouter.com/v1

Модель по умолчанию

Отредактируйте ~/.hermes/config.yaml:

model:
  provider: "custom"
  default: "claude-opus-4-8"
  base_url: "https://api.crazyrouter.com/v1"

Замените default на любую модель, разрешенную в вашем Crazyrouter token.

Переключение моделей

После настройки переключайте модели внутри Hermes с помощью /model:

/model claude-opus-4-8
/model gpt-5.5
/model claude-sonnet-4.6
/model gemini-3.1-pro
/model deepseek-v4-pro
/model qwen-max
/model gpt-4o

Если при переключении появляется model not allowed или 403, обычно выбранная модель не разрешена в текущем Crazyrouter token.

Чеклист проверки

OPENAI_API_KEY в ~/.hermes/.env является действительным Crazyrouter token
OPENAI_BASE_URL равен https://api.crazyrouter.com/v1
provider в ~/.hermes/config.yaml равен custom
модель по умолчанию разрешена в Crazyrouter token
Hermes отвечает на тестовое сообщение
/model gpt-5.5 или другая разрешенная модель переключается успешно

Частые проблемы

Симптом	Вероятная причина	Решение
`401 unauthorized`	API Key неверный, истек или был заменен	создайте новый Crazyrouter token и обновите `~/.hermes/.env`
`403` или `model not allowed`	token не разрешает выбранную модель	разрешите модель в настройках Crazyrouter token
Hermes все еще использует старого провайдера	Hermes не перечитал конфиг или был изменен не тот файл	перезапустите Hermes и проверьте `~/.hermes/.env` и `~/.hermes/config.yaml`
Таймаут соединения	локальная сеть не может подключиться к Crazyrouter	проверьте proxy, firewall и DNS

Открыть репозиторий crazyrouter-hermes

Посмотрите скрипты настройки, пример ручной конфигурации и актуальные заметки.

Начало работы

Возможности

Официальные цены моделей

Настройка Hermes Agent

Кому подходит

Требования

Настройка одной командой

Ручная настройка

Переменные окружения

Модель по умолчанию

Переключение моделей

Чеклист проверки

Частые проблемы

Открыть репозиторий crazyrouter-hermes

​Кому подходит

​Требования

​Настройка одной командой

​Ручная настройка

​Переменные окружения

​Модель по умолчанию

​Переключение моделей

​Чеклист проверки

​Частые проблемы

Открыть репозиторий crazyrouter-hermes

Кому подходит

Требования

Настройка одной командой

Ручная настройка

Переменные окружения

Модель по умолчанию

Переключение моделей

Чеклист проверки

Частые проблемы