NezhaGateNezhaGate

NezhaGate отдаёт тот же Messages API, что и Anthropic, поэтому вызов инструментов, размышления и кэш промптов в Claude Code работают без изменений. Задайте две переменные окружения — и можно начинать.

Перед началом

  • API-ключ NezhaGate (создайте его на странице API Keys в консоли).
  • Установленный Claude Code. Если его ещё нет, выполните команду (нужен Node.js 18 или новее):
Terminal
npm install -g @anthropic-ai/claude-code

Шаг 1: задайте переменные окружения

Задайте их в терминале, где будете запускать claude. ANTHROPIC_AUTH_TOKEN — ваш ключ NezhaGate; ANTHROPIC_MODEL — модель по умолчанию.

bash / zsh
export ANTHROPIC_BASE_URL=https://nezhagate.com/anthropic
export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-sonnet-5
claude

Так переменные действуют только в текущем терминале; в новом их нужно задать заново. Чтобы они сохранились, используйте settings.json из следующего шага.

Шаг 2 (рекомендуется): сохраните в settings.json

Запишите те же настройки в пользовательский файл настроек Claude Code — тогда они будут работать в любом терминале. Файл: ~/.claude/settings.json на macOS / Linux и %USERPROFILE%\.claude\settings.json в Windows; если файла нет, создайте его.

settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://nezhagate.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"
  }
}

Шаг 3: запустите и проверьте

Запустите claude в папке проекта и введите /status, чтобы увидеть текущие настройки: base URL должен быть https://nezhagate.com/anthropic.

Выбор модели

Claude Code работает только с моделями Claude (эндпоинт /anthropic принимает только их). Доступны сейчас:

ID моделиВходВыходЧтение кэша
claude-sonnet-4-6$1.50$7.50$0.15
claude-opus-5$4.00$20.00$0.40
claude-fable-5$8.00$40.00$0.80
claude-sonnet-5$1.00$5.00$0.10

Цены в долларах США за миллион токенов.

Чтобы переключиться во время сессии, введите /model и ID модели, например /model claude-opus-5. Какие модели стоят за пунктами Opus и Sonnet в меню /model, задают ANTHROPIC_DEFAULT_OPUS_MODEL и ANTHROPIC_DEFAULT_SONNET_MODEL.

Модель для фоновых задач

Небольшие фоновые задачи (например, название для диалога) Claude Code поручает маленькой модели и по умолчанию запрашивает Claude Haiku. В NezhaGate Haiku нет, поэтому укажите в ANTHROPIC_DEFAULT_HAIKU_MODEL одну из моделей из таблицы выше — иначе эти фоновые запросы будут получать 404.

Оплата и кэш

Оплата за токены, по тем же ценам, что и на эндпоинтах /v1. Попадания в кэш промптов оплачиваются по цене «Чтение кэша» из таблицы — намного дешевле входа. Claude Code в каждом ходе отправляет один и тот же системный промпт и контекст проекта, поэтому обычно попадает в кэш на каждом ходе.

Частые ошибки

401 или «Invalid API key»

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

404 «model: …»

Запрошенной модели нет в списке NezhaGate; чаще всего это Haiku, которую по умолчанию запрашивают фоновые задачи. Задайте ANTHROPIC_MODEL и ANTHROPIC_DEFAULT_HAIKU_MODEL, как описано выше.

402: недостаточно средств

На балансе аккаунта не хватает средств, или ключ достиг заданного вами бюджета. Пополните баланс в консоли или увеличьте лимит ключа.

Похоже, настройки не применились

Задавайте переменные окружения до запуска claude и в том же терминале; после правки settings.json перезапустите Claude Code. Текущий base URL показывает /status.

429 или «overloaded»

Все линии этой модели сейчас заняты. Повторите через несколько секунд — ничего не спишется.

Другие интеграции