Claude Code через AI Gateway — настройка окружения
Терминальный кодинг-агент Anthropic: правит файлы, гоняет тесты, работает с git
Claude Code — агент для разработки в терминале: понимает контекст проекта, редактирует файлы, запускает команды и тесты, делает коммиты. Работает по протоколу Anthropic API — AI Gateway поддерживает совместимый маршрут /v1/messages, поэтому подключение сводится к двум переменным окружения.
Установка
npm install -g @anthropic-ai/claude-codeПодключение к AI Gateway
- Создайте API-ключ
В кабинете AI Gateway создайте ключ — формат
sk-aigate-…. Отдельный ключ на проект упрощает контроль расхода. - Задайте переменные окружения
Добавьте в
~/.bashrc/~/.zshrc(или в окружение CI):export ANTHROPIC_BASE_URL="https://ai-gatewey.ru" export ANTHROPIC_AUTH_TOKEN="sk-aigate-ваш_ключ" # модель по умолчанию — любой Claude из каталога AI Gateway export ANTHROPIC_MODEL="anthropic/claude-sonnet-5" - Или настройте на уровне проекта
Чтобы не трогать глобальное окружение, положите настройки в
.claude/settings.jsonвнутри репозитория:{ "env": { "ANTHROPIC_BASE_URL": "https://ai-gatewey.ru", "ANTHROPIC_AUTH_TOKEN": "sk-aigate-ваш_ключ", "ANTHROPIC_MODEL": "anthropic/claude-sonnet-5" } } - Запустите и проверьте
Выполните
claudeв каталоге проекта и отправьте первый запрос. Команда/statusвнутри сессии покажет активную модель и адрес API.
ANTHROPIC_API_KEY не должна быть установлена одновременно с ANTHROPIC_AUTH_TOKEN — иначе Claude Code попытается авторизоваться напрямую в Anthropic и получит ошибку. Проверьте: echo $ANTHROPIC_API_KEY должно быть пустым.Модели для Claude Code
Claude Code рассчитан на модели Claude: Sonnet — баланс цены и качества для повседневной работы, Opus — сложные задачи и большие рефакторинги, Haiku — быстрые дешёвые операции:
| Модель | Ввод, ₽/1М | Вывод, ₽/1М | Контекст |
|---|---|---|---|
| Anthropic: Claude Sonnet 5 | 314 | 1 568 | 1M |
| Anthropic: Claude Opus 4.8 | 784 | 3 919 | 1M |
| Anthropic Claude Haiku Latest | 157 | 784 | 200K |
Частые вопросы
Можно ли переключать модель внутри сессии?
Да, командой /model — укажите код модели каталога AI Gateway, например anthropic/claude-opus-4.8 для сложной задачи и обратно на Sonnet для рутины.
Claude Code пишет об ошибке авторизации — что проверить?
Три вещи: ключ действителен (кабинет → Ключи), ANTHROPIC_BASE_URL указан без /v1 на конце, и в окружении не осталось ANTHROPIC_API_KEY от прямой подписки Anthropic.
Как контролировать расход агента?
Агентные сессии прожорливы: задайте ключу месячную квоту и лимит RPM в кабинете — при превышении запросы остановятся, а не спишут лишнее.
Claude в терминале — с оплатой в рублях
Начать бесплатно