Claude Code через AI Gateway — настройка окружения

Claude Code — агент для разработки в терминале: понимает контекст проекта, редактирует файлы, запускает команды и тесты, делает коммиты. Работает по протоколу Anthropic API — AI Gateway поддерживает совместимый маршрут /v1/messages, поэтому подключение сводится к нескольким переменным окружения.

Установка

npm install -g @anthropic-ai/claude-code

Подключение к AI Gateway

1. 1
   Создайте API-ключ

   В кабинете AI Gateway создайте ключ — формат sk-aigate-…. Отдельный ключ на проект упрощает контроль расхода.

2. 2
   Задайте переменные окружения

   Добавьте в ~/.bashrc / ~/.zshrc (или в окружение CI):

   bashbashКопировать

   export ANTHROPIC_BASE_URL="https://ai-gatewey.ru"export ANTHROPIC_AUTH_TOKEN="sk-aigate-ваш_ключ"# модель по умолчанию — любой Claude из каталога AI Gatewayexport ANTHROPIC_MODEL="anthropic/claude-sonnet-5.5"# алиасы opus/sonnet/haiku и фоновые задачи (заголовки сессий и прочая служебка)# иначе уйдут в канонические идентификаторы Anthropic, которых в каталоге нетexport ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-5.5"export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-5.5"export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-latest"

3. 3
   Или настройте на уровне проекта

   Чтобы не трогать глобальное окружение, положите настройки в .claude/settings.json внутри репозитория:

   jsonjsonКопировать

   {"env": {"ANTHROPIC_BASE_URL": "https://ai-gatewey.ru","ANTHROPIC_AUTH_TOKEN": "sk-aigate-ваш_ключ","ANTHROPIC_MODEL": "anthropic/claude-sonnet-5.5","ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-opus-5.5","ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-5.5","ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-latest"}}

4. 4
   Запустите и проверьте

   Выполните claude в каталоге проекта и отправьте первый запрос. Команда /status внутри сессии покажет активную модель и адрес API.

Модели для Claude Code

Claude Code рассчитан на модели Claude: Sonnet — баланс цены и качества для повседневной работы, Opus — сложные задачи и большие рефакторинги, Haiku — быстрые дешёвые операции:

Частые вопросы