Чем это отличается от обычной регистрации в Claude AI#
Если аккаунт claude.ai уже есть — часть пути пройдена: Claude Code использует тот же логин, тот же гео-блок обходится тем же способом (VPN/прокси, телефон и почта поддерживаемой страны, при необходимости — верификация личности). Весь этот разбор уже есть в статье Claude AI в России, здесь его не повторяю.
Но у Claude Code есть два отличия, которые аккаунт для обычного чата не покрывает:
1. Free-тариф не работает. В официальной документации это сказано прямо: Claude Code требует Pro, Max, Team, Enterprise или Console- аккаунт — «the free Claude.ai plan does not include Claude Code access». Тарифы и способы оплаты — в статье как оплатить Claude из России, включая отдельный способ для CLI: прокси к API без VPN. 2. Вход происходит не в браузере, а из терминала, и это меняет правило про VPN — ниже отдельным разделом.
Что такое терминал и где его открыть#
Claude Code ставится и запускается не кликом по иконке, а командами в терминале — текстовом окне, куда команды печатаются, а не нажимаются мышкой. Пугаться не стоит: весь путь ниже — это скопировать одну строчку, вставить и нажать Enter.
| Система | Как открыть |
|---|---|
| macOS | Command+Space, набрать «Терминал», Enter |
| Windows | Win+X, выбрать «Терминал» или «Windows PowerShell» |
| Linux | Ctrl+Alt+T в большинстве дистрибутивов |
Вставить скопированную команду в терминал горячими клавишами обычно нельзя — Command+V или Ctrl+V не работают. На macOS и в PowerShell вставка идёт правым щелчком мыши или Cmd+V всё же работает в новых версиях Terminal.app; если не сработало — через меню терминала «Правка → Вставить».
Как установить#
Системные требования: macOS 13+, Windows 10 версии 1809+ или Windows Server 2019+, Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+, от 4 ГБ оперативной памяти и подключение к интернету. Отдельно ставить Node.js или Git для этого способа не нужно — нативный установщик их не требует.
- Открыть терминал (таблица выше)
- Скопировать и вставить команду для своей ОС: на macOS, Linux и в WSL это
curl -fsSL https://claude.ai/install.sh | bash, в Windows PowerShell —irm https://claude.ai/install.ps1 | iex - Нажать Enter и дождаться, пока установка допишет строку в конце — обычно 1–2 минуты
- Закрыть терминал и открыть заново — это подтягивает обновлённый PATH, без этого шага следующая команда может не найтись
- Набрать
claude --versionи нажать Enter — рабочая установка печатает номер версии вида2.1.211 (Claude Code)
Если своя ОС не macOS/Linux/Windows или нужен способ без сетевого скрипта — есть альтернативы: Homebrew (brew install --cask claude-code), WinGet (winget install Anthropic.ClaudeCode), npm (npm install -g @anthropic-ai/claude-code, но здесь уже нужен Node.js 22 или новее). Нативный установщик из шагов выше обновляется в фоне сам, эти три — только руками. Подробный разбор Windows и WSL — граблей там больше, чем в одной команде — будет отдельной статьёй, ссылку добавлю, когда она выйдет.
Первый запуск: пошагово#
- В той же папке, где будет проект, набрать
claudeи нажать Enter - Автоматически откроется браузер со страницей входа Anthropic: залогиниться тем же способом, что и на claude.ai (аккаунт, VPN и регион — как в статье про доступ к Claude AI)
- После входа браузер покажет «можно закрыть эту вкладку» — вернуться в терминал
- В терминале появится приглашение Claude Code — можно печатать задачу на русском языке
Если браузерный вход неудобен — например, работа идёт на сервере без графического окружения, — есть обходной путь: задать переменную окружения ANTHROPIC_API_KEY с ключом из Claude Console. Тогда Claude Code браузер не открывает вообще, а один раз спрашивает подтверждение, что использовать этот ключ.
Для CI и скриптов, где интерактивный вход недоступен, есть третий вариант — команда claude setup-token разово открывает тот же браузерный вход и печатает в терминал OAuth-токен на год. Токен нужно сохранить самому — Claude Code его нигде не хранит — и передать дальше переменной CLAUDE_CODE_OAUTH_TOKEN. Работает только с подпиской Pro/Max/Team/Enterprise, для Console-аккаунта не годится.
Если что-то не заработало#
Две ошибки на старте встречаются чаще остальных.
command not found: claude (или «claude не является внутренней или внешней командой» в Windows) — установка прошла, но система не знает, где искать программу. Решение: закрыть терминал и открыть заново, обычно этого хватает. Если не помогло, на macOS добавить путь вручную:
1echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc2source ~/.zshrc
На Linux с Bash — те же две строки, но файл ~/.bashrc вместо ~/.zshrc.
App unavailable in region — это не сбой установки, а тот самый гео-блок: запрос дошёл до Anthropic с IP страны не из списка поддерживаемых. Решение не техническое, а из статьи про доступ к Claude AI — проверить, что VPN включён и на уровне всей системы, не только в браузере (ниже отдельно, почему это разные вещи для Claude Code).
Почему браузерного VPN недостаточно#
Это главная ловушка, которая касается именно Claude Code и не относится к обычному чату в браузере. Расширение VPN в Chrome или Firefox шифрует трафик только самого браузера. Claude Code — это процесс в терминале, он идёт в интернет напрямую и браузерное расширение не видит вообще, поэтому светит настоящим российским IP даже при включённом браузерном VPN.
Разбор пяти типичных причин бана аккаунтов Claude Code из России есть в статье как оплатить Claude из России — первая в списке ровно об этом. Практический вывод: нужен VPN-клиент или прокси на уровне всей системы, а не расширение браузера — тогда и вход через браузер, и сам терминал идут через один и тот же IP.
Где хранится вход и когда его обновлять#
После успешного входа Claude Code сохраняет учётные данные локально: на macOS — в зашифрованном Keychain, на Linux — в файле ~/.claude/.credentials.json с правами 0600 (доступ только владельцу), на Windows — в %USERPROFILE%\.claude\.credentials.json. Входить заново на каждый запуск не нужно.
Вход не бессрочный. За три дня до истечения Claude Code печатает предупреждение: «Your login expires in 3 days · run /login to renew» — это не блокирует работу, просто напоминание. После фактического истечения запросы начинают падать с ошибкой Login expired · Please run /login, и терминал просит войти заново той же командой /login. Команда /logout разлогинивает вручную и сбрасывает состояние первого запуска — следующий claude снова пройдёт весь путь входа и настройки.
Что дальше#
Установка и вход — это пять минут при рабочем VPN. Если раньше не пользовались Claude Code вообще, логичный следующий шаг — обзор моделей Opus, Sonnet и Haiku: какую включать по умолчанию, чтобы не платить за то, что не нужно для задачи.
Частые вопросы#
Работает ли Claude Code на бесплатном тарифе?
Нужен ли отдельный аккаунт для Claude Code, если уже есть claude.ai?
claude браузер откроется сам и попросит войти обычным способом, а дальше вход сохранится локально и повторного ввода не потребует.Почему Claude Code просит войти заново, хотя я недавно логинился?
Login expired, пока не пройти команду /login снова и не подтвердить вход заново через браузер.Обязательно ли использовать браузер для входа?
ANTHROPIC_API_KEY с ключом из Claude Console, Claude Code браузер не открывает — просит один раз подтвердить использование ключа и запоминает выбор. Подходит для серверов без графического окружения и для CI, где интерактивный браузерный вход недоступен физически.- Anthropic — системные требования и команды установки Claude Code, проверено 10.08.2026
- Anthropic — типы входа, хранение учётных данных, claude setup-token, проверено 10.08.2026
- Anthropic — список стран с доступом к claude.ai и API, Россия отсутствует
- Anthropic — разбор ошибок установки и входа, проверено 10.08.2026
Больше цифр и разборов — в Telegram-канале
Черновики, промежуточные результаты и то, что не дошло до блога