canonical_url: https://yycode.net/docs/ru/hermes-quickstart lang: ru updated_at: 2026-07-04T13:33:48.616Z source_html: https://yycode.net/docs/ru/hermes-quickstart # yycode × Hermes: руководство быстрого старта ## Сценарий использования Эта статья решает только одну задачу: подключить Anthropic-совместимый интерфейс yycode к Hermes и выполнить минимальную проверку работоспособности. Если сейчас вы используете Hermes, а не OpenClaw, Cherry Studio или другой клиент, эта статья описывает соответствующий способ подключения. --- ## 1. Подготовка Перед началом проверьте: - Вы уже создали API Key в [консоли yycode](https://yycode.net/console/token) - Вы знаете фактическое имя модели, которую Hermes должен вызывать - Вы можете редактировать конфигурационный файл Hermes `config.yaml` - В этот раз вы подключаете Anthropic-совместимую конечную точку yycode, а не OpenAI-совместимую --- ## 2. Поддерживаемые модели В этой статье в первую очередь описано подключение Anthropic-совместимых моделей yycode. Частые имена моделей: | Имя модели | |---| | `claude-opus-4-6` | | `claude-sonnet-4-6` | | `claude-haiku-4-5-20251001` | Если вы не уверены, какие модели сейчас фактически доступны вашему аккаунту, ориентируйтесь на консоль или уже имеющиеся успешные вызовы. --- ## 3. Рекомендуемый путь: подключение через `custom_providers` Hermes При подключении Hermes к yycode основная идея такая: 1. Объявить provider yycode в `custom_providers` 2. В блоке `model` направить модель по умолчанию на этот provider 3. Отключить `smart_model_routing`, чтобы Hermes автоматически не переключался на другую модель ### Шаг 1: определите пользовательский provider ```yaml custom_providers: - name: custom-yycode-net-aws base_url: https://yycode.net api_key: api_mode: anthropic_messages models: - claude-opus-4-6 ``` Здесь важнее всего два пункта: - `base_url` укажите как `https://yycode.net` - `api_mode` обязательно должен быть `anthropic_messages` ### Шаг 2: направьте модель по умолчанию на этот provider ```yaml model: default: claude-opus-4-6 provider: custom-yycode-net-aws base_url: https://yycode.net api_key: api_mode: anthropic_messages ``` `provider` здесь должен соответствовать `name` из `custom_providers` выше, иначе Hermes не пойдет через определенный вами Dragon Code provider. ### Шаг 3: отключите Smart Model Routing ```yaml smart_model_routing: enabled: false ``` Если не отключить, Hermes может из-за короткого сообщения автоматически перейти на более дешевую модель, и вы увидите, что настроили `claude-opus-4-6`, но фактически запускается другая модель. --- ## 4. Минимальная рабочая конфигурация для прямого использования Ниже приведен объединенный минимальный пример. Замените `` на свой Dragon Code API Key: ```yaml model: default: claude-opus-4-6 provider: custom-yycode-net-aws base_url: https://yycode.net api_key: api_mode: anthropic_messages custom_providers: - name: custom-yycode-net-aws base_url: https://yycode.net api_key: api_mode: anthropic_messages models: - claude-opus-4-6 smart_model_routing: enabled: false fallback_providers: - provider: minimax-cn model: MiniMax-M2.7 ``` Если хотите переключиться на другую Anthropic-совместимую модель, достаточно одновременно изменить имя модели в `model.default` и `custom_providers[].models`. --- ## 5. Критерии успеха Если выполнены пункты ниже, значит Hermes и Dragon Code в целом уже соединены: - `base_url` указан как `https://yycode.net` - `api_mode` указан как `anthropic_messages` - `model.provider` указывает на имя provider, определенное в `custom_providers` - `smart_model_routing.enabled` отключен - После отправки сообщения Hermes реально получает ответ модели --- ## 6. Частые вопросы ### Почему нельзя подключать как OpenAI-совместимый интерфейс? В этом подключении Hermes к yycode следует использовать нативный формат сообщений Anthropic, то есть `/v1/messages`. Известные выводы: - `/v1/messages` работает - `/v1/chat/completions` не подходит как основной путь для этой конфигурации Hermes Поэтому `api_mode` обязательно должен быть `anthropic_messages`; не настраивайте по OpenAI-совместимому режиму. ### Почему я выбрал `claude-opus-4-6`, но фактически запускается другая модель? Сначала проверьте, отключен ли `smart_model_routing.enabled`. Если в Hermes включена умная маршрутизация, короткие сообщения могут автоматически переводиться на дешевую модель, из-за чего выбор в интерфейсе и реальная модель запроса не совпадают. ### Можно ли использовать `api_key_env`? По текущей записи конфигурации, в Hermes v0.10.0 `api_key_env` в блоках `model` и `custom_providers` работает нестабильно: переменная окружения может не раскрыться корректно, и в итоге вернется 401. Если вы уже подтвердили, что проблема именно в этом, сначала вернитесь к прямому указанию `api_key`, запустите цепочку, а затем решайте, продолжать ли разбор варианта с переменной окружения. ### Почему возвращается 401? Обычно сначала проверяют: - Действителен ли API Key - Заполнен ли `api_key` в нужных местах `model` и `custom_providers` - Действительно ли Hermes загрузил измененный конфигурационный файл ### Почему возвращается 503 или service unavailable? Если текущая конфигурация идет по OpenAI-совместимому пути, сначала вернитесь и проверьте, не задан ли в Hermes неправильный `api_mode`. Рекомендуемый путь в этой статье — Anthropic-совместимое подключение; не рекомендуется смешивать его с OpenAI-совместимым вариантом. --- ## 7. Пример проверки API Если хотите сначала обойти Hermes и напрямую проверить доступность конечной точки Dragon Code, можно вызвать нативную конечную точку Anthropic: ```bash curl -X POST "https://yycode.net/v1/messages" \ -H "Content-Type: application/json" \ -H "x-api-key: " \ -H "anthropic-version: 2023-06-01" \ -d '{"model":"claude-opus-4-6","max_tokens":50,"messages":[{"role":"user","content":"hi"}]}' ``` Если этот запрос нормально возвращает ответ, затем проверять конфигурацию Hermes будет проще. --- ## 8. Следующий шаг - Хотите подключить другие клиенты: смотрите `OpenClaw Быстрый старт`, `Cherry Studio Быстрый старт` - Еще не создали Key: вернитесь в [консоль yycode](https://yycode.net/console/token) и сначала создайте API Key - Хотите унифицировать конфигурацию инструментов разработки: продолжайте читать другие документы быстрого подключения на сайте