Вы ставите Claude Code в терминале — и получаете 403, connection refused или бесконечный OAuth. Claude Code — CLI-агент Anthropic. Запросы идут на те же серверы, что claude.ai, с тем же гео-ограничением. VPN нужен на компьютере, где запущен терминал, не на телефоне в кармане.
Ошибки веб-версии: Claude не работает.
Коротко
- Установка через npm (Node.js 18+).
- Вход через аккаунт Anthropic или API-ключ.
- Системный VPN / туннель — EU или US на всё время сессии.
- Корпоративный прокси без маршрута → connection refused.
- API-ключ — console.anthropic.com.
Шаг 1. Маршрут
- Telegram или email.
- INCY / Happ на ПК: Happ Windows или VPN на роутере.
- Проверка:
curl -sI https://claude.ai | head -1— не пустой отказ.
VPN Android/iPhone не помогут десктопному CLI, если туннель только на телефоне.
Так нельзя: VPN на телефоне, терминал на ноутбуке без туннеля.
Так можно: системный VPN на той же ОС, где claude в терминале.
Пример: разработчик на macOS, Happ с DE-сервером, claude в iTerm — агент отвечает. Выключил VPN — следующая команда падает с region error.
Шаг 2. Установка Claude Code
npm install -g @anthropic-ai/claude-code
Или по документации Anthropic на момент установки.
claude
Первый запуск — OAuth в браузере. Не выключайте VPN до завершения входа. Один сервер на весь OAuth — иначе login loop.
Шаг 3. API-ключ (альтернатива)
- console.anthropic.com с VPN.
- API Keys → создать ключ.
- Экспорт в окружении:
export ANTHROPIC_API_KEY="sk-ant-..."
Биллинг API — отдельно от Claude Pro: API console.
Типичные ошибки
| Ошибка | Решение |
|---|---|
| Region / 403 | VPN на машине с терминалом |
| OAuth loop | один сервер на весь вход |
| Timeout | другой EU/US узел |
| ECONNREFUSED | корпоративный firewall — личный ноутбук |
Подробнее: network error.
IDE
Если используете Claude в VS Code / Cursor — маршрут на той же ОС, что и IDE. Split tunnel, который выводит IDE мимо VPN, ломает и CLI, и плагин.
Модели в CLI
Sonnet и Opus выбираются флагами или в настройках — см. Claude Sonnet и Opus. Лимиты API — по тарифу console, не по Pro-подписке claude.ai.
WSL и удалённый сервер
Claude Code в WSL2 на Windows — VPN должен маршрутизировать WSL, не только хост. Проще: нативный терминал Windows с Happ Desktop или VPN на роутере.
Переменные окружения в CI
GitHub Actions из РФ без прокси — 403. Runner в EU/US или HTTP_PROXY на зарубежный egress. Ключ API — в secrets, не в логах.
Частые вопросы
Claude Pro даёт API?
Нет. Pro — claude.ai. API — отдельный биллинг в console.
VPN на роутере?
Работает, если весь трафик ПК идёт через туннель. LTE на телефоне — отдельный клиент.
Windows без npm?
Установите Node.js LTS с nodejs.org, затем npm-команду выше. «Кряки» Claude Code для Windows — мошенничество, API всё равно требует ключ.
Claude Code vs ChatGPT Codex?
Разные экосистемы — сравнение.
WSL и удалённый сервер
Claude Code в WSL2 на Windows — VPN должен маршрутизировать WSL, не только хост. Проще: нативный терминал Windows с Happ Desktop или VPN на роутере.
Переменные окружения в CI
GitHub Actions из РФ без прокси — 403. Runner в EU/US или HTTP_PROXY на зарубежный egress. Ключ API — в secrets, не в логах.