Перейти к основному содержанию
Дата обновления: 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.

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

curl -fsSL https://raw.githubusercontent.com/xujfcn/crazyrouter-hermes/main/setup.sh | bash
Скрипт попросит ввести 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 unauthorizedAPI Key неверный, истек или был замененсоздайте новый Crazyrouter token и обновите ~/.hermes/.env
403 или model not allowedtoken не разрешает выбранную модельразрешите модель в настройках Crazyrouter token
Hermes все еще использует старого провайдераHermes не перечитал конфиг или был изменен не тот файлперезапустите Hermes и проверьте ~/.hermes/.env и ~/.hermes/config.yaml
Таймаут соединениялокальная сеть не может подключиться к Crazyrouterпроверьте proxy, firewall и DNS

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

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