Одна подписка Claude Pro, все инструменты: `hermes proxy` с Aider, Cline и Codex CLI

v0.14.0 выкатил однострочную команду, которая молча поглотила целый класс вопросов про интеграцию, которые комьюнити задавало месяцами. Запускаешь hermes proxy — и у тебя локальный http://localhost:port-эндпоинт, который говорит на OpenAI-API, а под капотом — тот OAuth-провайдер, в котором ты залогинен через Hermes: Claude Pro, ChatGPT Pro или SuperGrok.

Практическое следствие: инструменты, которые умеют говорить только на OpenAI-API, — Aider, Cline, Codex CLI, Continue и длинный хвост редакторских плагинов — теперь могут разговаривать с Claude Pro, ChatGPT Pro и SuperGrok через твою действующую подписку, и тебе ни разу не приходится генерировать API-ключ.

И вот что здесь главное: большинство этих инструментов требует отдельных биллинговых отношений с каждым провайдером. Aider с Claude → аккаунт в Anthropic console с привязанной платёжкой. Cline с GPT-5 → биллинговый аккаунт в OpenAI. Codex CLI → то же самое. hermes proxy сворачивает всё это в один localhost-эндпоинт, который аутентифицируется через OAuth-сессию, которая у тебя уже есть.

Дальше — точный воркфлоу.

0. Что должно быть готово

• •Hermes Agent v0.14.0 или новее установлен и настроен (hermes --version для проверки)
• •Хотя бы одна OAuth-подписка связана через hermes model — Claude Pro, ChatGPT Pro или SuperGrok

Если ты ни разу не логинился ни в одного OAuth-провайдера, при первом запуске hermes model тебя проведут через OAuth-флоу под каждого. Выбирай ту подписку, за которую ты реально платишь.

1. Поднять proxy

hermes proxy

По умолчанию он биндится на свободный порт в localhost. URL печатается в стартап-логе — скопируй. Чтобы зафиксировать порт:

hermes proxy --port 11500

Гоняй его как долгоживущий процесс — пока downstream-инструменты к нему ходят, он должен жить. systemd, launchd, tmux или просто отдельная вкладка терминала — всё подойдёт.

2. Натравить downstream-инструмент на proxy

Aider

export OPENAI_API_BASE=http://localhost:11500/v1
export OPENAI_API_KEY=hermes-proxy  # любая непустая строка
aider --model claude-sonnet-4-6

Флаг --model у Aider'а ссылается на имя модели в том виде, в котором proxy резолвит его из твоего Hermes-провайдер-конфига. Если ты залогинен через Claude Pro — твоя дефолтная Claude-модель доступна; то же самое для ChatGPT Pro и SuperGrok.

Cline (VS Code)

В настройках Cline выбери провайдером OpenAI Compatible. Заполни:

• •Base URL: http://localhost:11500/v1
• •API Key: hermes-proxy (любое непустое значение)
• •Model ID: имя модели из твоего Hermes-конфига (например, claude-sonnet-4-6, gpt-5.1)

Сохрани. Теперь Cline маршрутизирует запросы через Hermes; auth твоей подписки разрулит остальное.

Codex CLI

Codex CLI обычно ждёт OPENAI_API_BASE и OPENAI_API_KEY. Форма та же, что у Aider'а:

export OPENAI_API_BASE=http://localhost:11500/v1
export OPENAI_API_KEY=hermes-proxy
codex --model gpt-5-codex

Если ты залогинен в ChatGPT Pro через Hermes, модель gpt-5-codex вылезает через proxy, и Codex CLI получает полный доступ — а ты ни разу не заводил биллинговые отношения с OpenAI.

Continue (JetBrains / VS Code)

Отредактируй конфиг Continue (~/.continue/config.json или через UI):

{
  "models": [{
    "title": "Claude via Hermes",
    "provider": "openai",
    "model": "claude-sonnet-4-6",
    "apiBase": "http://localhost:11500/v1",
    "apiKey": "hermes-proxy"
  }]
}

Та же схема. "provider" остаётся openai, потому что с точки зрения Continue он бьёт по OpenAI-эндпоинту.

3. Проверить, что всё работает

Быстрый curl-тест:

curl http://localhost:11500/v1/models -H "Authorization: Bearer hermes-proxy"

Должен вернуться список моделей, которые твой Hermes-провайдер-конфиг выкладывает наружу. Если получаешь 401 или пустой список — proxy запущен, но Hermes не видит живой OAuth-сессии. Перезапусти hermes model и возьми того провайдера, по которому у тебя есть действующая подписка.

4. Если что-то пошло не так

• •«Connection refused» — proxy не запущен. Запускай.
• •«401 unauthorized» — модель, которую ты запросил, не покрыта твоей привязанной подпиской. Запусти hermes model и посмотри, какие провайдеры активны.
• •«Model not found» — имя модели в downstream-инструменте не совпадает с тем, что выставляет твой Hermes-провайдер. Бери имена из hermes model list.
• •Подрезали по rate-limit'у — ты упёрся в лимиты самой подписки (у Claude Pro — около 50 сообщений за 5 часов на Sonnet; у ChatGPT Pro своя квота; у SuperGrok тоже своя). Proxy не накручивает свой rate limiter — он пробрасывает ту квоту, которую тебе даёт провайдер.

Почему это важно

OpenAI-API — это лингва-франка экосистемы AI-инструментов. Почти каждый редакторский плагин и кодовый ассистент поддерживает OpenAI в первую очередь, а «OpenAI-совместимые эндпоинты» — во вторую. Закавыка в том, что «совместимый эндпоинт» почти всегда означает «нужен API-ключ, а значит — биллинговый аккаунт, а значит — твоя подписка за $20/месяц превращается в pay-as-you-go-аккаунт у кого-то на dashboard'е».

hermes proxy схлопывает эту проблему. Твоя OAuth-подписка остаётся там, где живёт. Proxy на localhost'е говорит на OpenAI. Aider, Cline, Codex CLI, Continue — они не знают, что разговаривают с Claude или с Grok. Они видят просто OpenAI-эндпоинт, который работает.

Одна подписка, все инструменты, никаких API-ключей. Весь питч — в одной строке.

Дальше

• •Release notes v0.14.0 — анонс hermes proxy
• •Документация Hermes Agent
• •Hermes Agent на GitHub