Подключение Claude Code

Claude Code — это AI-ассистент от Anthropic для работы с кодом. Поддерживает только модели Claude, но может работать через кастомный gateway.

Вы можете подключить NormaHub как провайдера и использовать Claude Opus, Sonnet, Fable и другие модели через NormaHub API.

Создайте API-ключ в личном кабинете NormaHub. Скопируйте ключ сразу — повторно он не показывается. Под Claude Code заведите отдельный ключ со своим лимитом: агент генерирует десятки запросов за сессию, и общий ключ без лимита — это открытый бюджет.

Не правьте settings.json ради проверки: задайте две переменные в текущем терминале и запустите claude. Если агент отвечает через NormaHub — база работает, и можно делать постоянную настройку. Важно: адрес без /v1 на конце.

# Linux/macOS — проверка за минуту без правки settings.json
export ANTHROPIC_BASE_URL="https://api.normahub.cc"
export ANTHROPIC_API_KEY="ваш_api_ключ"
claude

# Windows (PowerShell)
$env:ANTHROPIC_BASE_URL = "https://api.normahub.cc"
$env:ANTHROPIC_API_KEY = "ваш_api_ключ"
claude

Конфигурация Claude Code хранится в следующих местах:

• Linux/macOS: ~/.claude/settings.json
• Windows: %USERPROFILE%\.claude\settings.json

Если файл не существует, создайте его вместе с директорией ~/.claude/.

Откройте или создайте файл settings.json и добавьте следующую конфигурацию:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.normahub.cc",
    "ANTHROPIC_AUTH_TOKEN": "ваш_api_ключ",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1",
    "CLAUDE_CODE_DISABLE_1M_CONTEXT": "1"
  },
  "model": "claude-sonnet-5"
}

Замените ваш_api_ключ на реальный ключ из личного кабинета.

Объяснение параметров:

• ANTHROPIC_BASE_URL — адрес NormaHub API (без /v1)
• ANTHROPIC_AUTH_TOKEN — ваш API-ключ
• CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY — включает загрузку моделей из gateway
• CLAUDE_CODE_DISABLE_1M_CONTEXT — отключает синтетические суффиксы [1m] для моделей
• model — модель по умолчанию

Чтобы Claude Code видел доступные модели NormaHub, создайте файл ~/.claude/cache/gateway-models.json:

{
  "data": [
    { "id": "claude-opus-5" },
    { "id": "claude-sonnet-5" },
    { "id": "claude-opus-4-7" }
  ]
}

Добавьте ID моделей из каталога моделей, которые хотите использовать.

После сохранения конфигурации полностью перезапустите Claude Code. Теперь вы можете использовать модели NormaHub.

Claude Code будет использовать модель, указанную в model, или ту, которую вы выберете в интерфейсе.

Запустите Claude Code и отправьте тестовый запрос. Если всё настроено правильно, вы получите ответ от выбранной модели через NormaHub.

Если не хотите настраивать вручную, используйте готовый скрипт установки из GitHub репозитория. Скрипт автоматически загружает список моделей и создаёт конфигурацию.

Claude Code на своём ключе — это pay-as-you-go без подписки: ноль активности — ноль расходов, активная сессия — оплата каждого токена контекста файлов, инструментов и ответов по тарифу модели. Поэтому модель выбирайте под задачу: Sonnet для повседневной работы, Opus для тяжёлых рефакторингов, младшие модели для рутины. Точную цену входа и выхода смотрите в каталоге, а формулу — в гайде по стоимости. Баланс тает быстрее, чем кажется: следите за историей запросов в кабинете после первых сессий.

• 401 Unauthorized — неверный или отозванный API-ключ
• 402 Payment Required — недостаточный баланс
• 403 Forbidden — модель не доступна для вашего ключа
• 429 Too Many Requests — превышен rate limit или spend limit
• 503 Service Unavailable — провайдер модели временно недоступен

При возникновении ошибок проверьте баланс и доступные модели в личном кабинете.