Повторное использование подписок на инструменты программирования в качестве бэкендов Hermes (Copilot / Codex / Claude Max)

Как применить

Hermes предоставляет готовые идентификаторы провайдеров для трех основных бэкендов инструментов программирования, каждый из которых соответствует методу аутентификации вашей подписки.

Провайдер openai-codex осуществляет аутентификацию через устройственный код (открывается URL, вводится код) без необходимости установки CLI Codex; учетные данные сохраняются в ~/.hermes/auth.json и могут быть импортированы из ~/.codex/auth.json. При ошибке обновления (HTTP 4xx / invalid_grant) он помечает токен обновления как недействительный, и вам нужно войти заново через hermes auth add codex-oauth.

Ограничения по типу токенов реальны: прямой API Copilot отклоняет классические токены PAT ghp_*, поэтому используйте детализированный PAT или токен OAuth/приложения вместо попыток разобраться с ошибкой 401 при использовании классического PAT.

В случае Copilot одноразовое восстановление после ошибки 401 (повторное получение токена, пересоздание клиента, повторная попытка) означает, что временная проблема с аутентификацией не прервёт вашу сессию; постоянная ошибка 401 указывает на то, что токен действительно недействителен, и вам нужно снова выполнить команду gh auth login.

Аутентификация через OAuth для Claude Max возможна только при наличии плана с дополнительными кредитами на использование; если аутентификация через hermes model OAuth завершается неудачей, а вы используете обычный тариф Max, переключитесь на использование ключа API.

Режим ACP Copilot (copilot-acp, который запускает локальный подпроцесс Copilot CLI, работающий по протоколу ACP) отличается от Copilot с прямым API (copilot, HTTP-клиент): прямой API проще в использовании, а режим ACP полезен, когда нужно использовать собственную обработку сессий и аутентификации CLI.

Переключение моделей во время сессии с помощью /model copilot:gpt-5.4 и /model anthropic:claude-sonnet-4-6 позволяет тратить дешёвые токены на рутинные задачи и сохранять квоту подписочных моделей для сложных случаев.

Настройка GitHub Copilot (прямой способ): самый простой вариант — разрешить Hermes повторно использовать ваш gh auth token, выполнив gh auth login один раз, если вы ещё не вошли в систему, затем указать провайдера как copilot в файле ~/.hermes/config.yaml.

# easiest: let Hermes reuse your gh login
gh auth login            # once, if not already

# ~/.hermes/config.yaml
model:
  provider: "copilot"
  default: "gpt-5.4"

Настройка OpenAI Codex (авторизация через device-code): выполните hermes model и выберите OpenAI Codex, чтобы начать процесс авторизации через браузер, или импортируйте существующие учётные данные Codex, скопировав их из ~/.codex/auth.json в ~/.hermes/auth.json.

hermes model              # → "OpenAI Codex" → device-code flow in browser
# or import an existing Codex login:
#   credentials copied from ~/.codex/auth.json into ~/.hermes/auth.json

Если токен обновления Codex позже перестанет работать, повторно авторизуйтесь с помощью hermes auth add codex-oauth.

hermes auth add codex-oauth

Настройка Anthropic / Claude Max: выполните hermes model и выберите Anthropic для OAuth-авторизации (требуется подписка Claude Max с дополнительными кредитами на использование), или экспортируйте переменную ANTHROPIC_API_KEY, чтобы использовать API-ключ вместо этого, затем укажите провайдера как anthropic в файле ~/.hermes/config.yaml.

hermes model              # → "Anthropic" → OAuth (needs Claude Max + extra-usage credits)
# or API key:
#   export ANTHROPIC_API_KEY=sk-ant-...

# ~/.hermes/config.yaml
model:
  provider: "anthropic"
  default: "claude-sonnet-4-6"