Claude Code + NormaHub
Claude Code на своём API-ключе
Агентское кодирование на моделях Claude без подписки и VPN: укажите endpoint NormaHub, выберите модель из каталога и платите только за токены каждой сессии.
Для кого: разработчики, использующие Claude Code из России без зарубежной карты
Создать API keyБыстрый старт
От ключа до первого ответа
- 01
Создайте отдельный API-ключ под Claude Code и задайте ему лимит расходов.
- 02
Пропишите ANTHROPIC_BASE_URL без /v1 и ключ в окружении или settings.json.
- 03
Перезапустите Claude Code и отправьте тестовый запрос через NormaHub.
Рабочий шаблон
Скопируйте основу и замените модель
Используйте только идентификатор из актуального каталога. Ключ храните в переменной окружения.
# Linux/macOS — проверка за минуту без правки settings.json
export ANTHROPIC_BASE_URL="https://api.normahub.cc"
export ANTHROPIC_API_KEY="NORMAHUB_API_KEY"
claudeДетали решения
Как это устроено
Зачем Claude Code связка с NormaHub
Claude Code работает только с моделями Claude, но умеет ходить через кастомный gateway — этим и пользуется связка: агент получает Opus для тяжёлых рефакторингов, Sonnet для повседневной работы и младшие модели для рутины без подписки Anthropic и региональных ограничений. Оплата — с рублёвого баланса за потраченные токены, модели переключаются параметром. Ключ под агента заводите отдельным со своим лимитом: за одну сессию Claude Code генерирует десятки запросов, и общий ключ без тормоза — это открытый бюджет.
Сколько стоит сессия
Каждая сессия тарифицируется по факту: промпт, контекст прикреплённых файлов, вызовы инструментов и сгенерированный ответ складываются во входные и выходные токены по ставкам выбранной модели. Отсюда экономика агента — младшая модель для рутины, флагман только для сложных задач и короткие сессии вместо одного бесконечного диалога. Точные цены входа и выхода смотрите в каталоге моделей, формулу расчёта — в гайде по стоимости токенов, а реальный расход первых сессий сверяйте с историей запросов в личном кабинете: баланс тает быстрее, чем кажется.
Нюансы и лимиты
Адрес указывается без суффикса /v1 — путь API Claude Code добавляет сам, с лишним суффиксом аутентификация не пройдёт. Ошибка «This account requires login» означает, что агент не увидел переменные окружения: проверьте, что адрес и ключ заданы в том же терминале, откуда запускаете claude, и перезапустите процесс. Список моделей фиксируется файлом gateway-models.json с ID из каталога; подписка Claude для стороннего endpoint не нужна.
Оплата и контроль расходов
Запросы оплачиваются с предварительно пополненного баланса по актуальным ставкам выбранной модели. Минимум и комиссия показываются перед оплатой в кабинете; лимит расходов задаётся для API-ключа.
Ограничения доступности
Возможности зависят от модели и внешнего маршрута. При недоступности provider запрос может завершиться ошибкой; проверяйте каталог, статус и документацию перед production.
Частые вопросы
Какой base URL указывать для Claude Code?
ANTHROPIC_BASE_URL=https://api.normahub.cc — строго без /v1 на конце. Путь API агент добавляет сам; с суффиксом /v1 аутентификация не пройдёт.
Ошибка «This account requires login» — что делать?
Claude Code не увидел переменные окружения и пытается войти через Anthropic напрямую. Проверьте, что ANTHROPIC_BASE_URL и ключ заданы в том же терминале, откуда запускаете claude, затем перезапустите процесс.
Как считается стоимость сессии?
По факту токенов: каждый запрос агента — промпт, контекст файлов, инструменты, ответ — тарифицируется по ставкам выбранной модели. Ноль активности — ноль расходов, подписка не нужна.
Нужен ли VPN для Claude Code из России?
Нет. Запросы идут на инфраструктуру NormaHub напрямую, оплата — с рублёвого баланса. VPN не нужен ни терминалу, ни биллингу.