Подключить Hermes Agent к Zukko — Anthropic или OpenAI

Hermes Agent подключается к Zukko через обычный API-ключ — без подписок Claude или ChatGPT. Главное — выбрать в мастере правильный пункт и не перепутать base URL: для Anthropic он без /v1, для OpenAI — с /v1. Ниже — оба варианта по шагам, готовые конфиги и разбор типичных ошибок.

Что такое Hermes Agent

Hermes Agent↗ — автономный AI-агент от Nous Research. Он работает в терминале, есть десктоп-приложение и подключение к мессенджерам; агент умеет запоминать контекст между сессиями и создавать навыки по ходу работы. Модель для него выбирается отдельно: Hermes поддерживает множество провайдеров, включая Anthropic и OpenAI по API-ключу.

С Zukko один ключ fetch_... даёт Hermes доступ к Claude, GPT и GLM. Шлюз принимает оба формата запросов, поэтому любую модель каталога можно звать и через Anthropic-вариант, и через OpenAI-вариант.

Если Hermes ещё не установлен, на Linux, macOS и WSL2 это делается одной командой:

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

Для Windows и десктоп-приложения смотрите инструкцию по установке на сайте Hermes.

Шаг 1. Запустите мастер настройки

Если чат Hermes открыт, выйдите из него (Ctrl+C или /quit) и выполните в терминале:

hermes model

hermes model — полный мастер настройки провайдера: он добавляет провайдеров, принимает ключи и сохраняет конфиг. В списке выберите один из двух пунктов:

• Anthropic — Claude models via API key or Claude Code
• OpenAI — Codex CLI or direct OpenAI API

Оба работают через Zukko, разница только в формате запросов.

Вариант 1: Anthropic

В мастере:

Мастер сохранит ключ в ~/.hermes/.env, вручную туда писать ничего не нужно. Затем укажите адрес Zukko в ~/.hermes/config.yaml:

model:
  provider: anthropic
  default: claude-sonnet-5
  base_url: https://api.zukko.pro

base_url — без /v1: Anthropic SDK внутри Hermes добавит путь сам.

Запустите Hermes:

hermes

Внутри чата модель меняется командой /model.

Вариант 2: OpenAI

В мастере:

Ключ и адрес хранятся в ~/.hermes/.env:

OPENAI_API_KEY=fetch_...
OPENAI_BASE_URL=https://api.zukko.pro/v1

Или задайте адрес в ~/.hermes/config.yaml:

model:
  provider: openai-api
  default: claude-sonnet-5
  base_url: https://api.zukko.pro/v1

Здесь base_url — с /v1. По документации Hermes, переменная OPENAI_BASE_URL учитывается только для провайдера openai-api.

В этом варианте можно указать любую модель Zukko: claude-sonnet-5, claude-opus-5-5, gpt-5.6-sol, gpt-5.6-luna, glm-5.3, glm-5.3-flash.

Какой вариант выбрать

Если работаете в основном с Claude — Anthropic-вариант естественнее. Если хотите переключаться между Claude, GPT и GLM в одном провайдере — удобнее OpenAI-вариант. Подробнее о форматах — в разделе Anthropic или OpenAI↗.

Сколько это стоит

Цены Zukko за 1M токенов (вход/выход): claude-sonnet-5, claude-opus-5-5 и gpt-5.6-sol — $0,30/$0,30; gpt-5.6-luna и glm-5.3 — $0,10/$0,10; glm-5.3-flash — $0,04/$0,04. Агент с каждым шагом отправляет в модель большой контекст (инструкции, память, историю), поэтому основная часть расхода — входные токены. В Zukko кэшированные токены оплачиваются по обычной входной цене, а у вендоров чтение из кэша стоит около 10% входной цены, так что для длинных агентных сессий реальная разница с официальным прайсом меньше, чем при прямом сравнении цен. Поставьте на ключ дневной лимит, чтобы агент не потратил больше запланированного.

Проверка подключения

1. Получите ключ на странице API-ключей↗.
2. Пройдите мастер hermes model по одному из вариантов выше.
3. Запустите hermes и задайте любой вопрос.
4. Откройте раздел «Использование» в кабинете — запрос должен появиться там.

Если не работает

401 unauthorized

Ключ опечатан, отозван или скопирован с пробелами. Проверьте его на странице ключей↗.

402

Закончился баланс. Пополните↗ и повторите.

404 в Anthropic-варианте

В base_url не должно быть /v1. Правильно: https://api.zukko.pro, неправильно: https://api.zukko.pro/v1.

OpenAI-вариант ходит не туда или отдаёт 404

Проверьте, что:

1. Провайдер — openai-api.
2. Base URL — с /v1: https://api.zukko.pro/v1.
3. В OPENAI_API_KEY записан ключ fetch_....

Мастер предлагает Codex CLI или Claude Code OAuth

Эти пункты рассчитаны на официальные подписки и для Zukko не подходят. Выбирайте:

• для Anthropic — API key;
• для OpenAI — direct OpenAI API.

Частые вопросы

Что выбрать: Anthropic или OpenAI?

Это выбор формата запросов, а не модели: через любой из них доступен весь каталог Zukko. Какая модель лучше справляется с вашими задачами, проверьте сами — дайте Hermes одну и ту же задачу на claude-sonnet-5 и gpt-5.6-sol и сравните результат и расход в кабинете.

Как переключаться между провайдерами?

Настройте оба варианта через hermes model. По документации Hermes, команда /model внутри чата переключает только между уже настроенными провайдерами и моделями, а добавлять новых провайдеров нужно через hermes model в терминале.

Есть ли у Hermes графический интерфейс?

По документации Hermes, кроме терминала есть десктоп-приложение и работа через мессенджеры (Telegram, Discord и другие). Подключение к модели настраивается так же.

Работает ли Hermes с GLM?

Да, через OpenAI-вариант: укажите glm-5.3 или glm-5.3-flash как модель. Учтите, что контекст у GLM — 128K токенов против 1M у Claude и GPT. Актуальный список моделей — GET https://api.zukko.pro/v1/models или страница «Модели»↗ в кабинете.

Краткая шпаргалка по настройке есть в документации Zukko по Hermes↗.