Пошаговая установка Claude Code на Windows и Linux: native installer, claude doctor, OAuth Pro, PATH, работа из России и первый промпт в репозитории без мифа про бесплатный CLI.
Десять гайдов по claude code противоречат друг другу: npm, WSL, «бесплатно из коробки». На Windows 11 вы ставите Node, получаете claude, но PATH ломается; native installer проходит, а терминал без перезапуска снова пишет «not recognized»; при логине — «App unavailable in region». Ниже один путь: native install, claude doctor, OAuth Pro/Console и первый промпт в репозитории — без мифа про free CLI.
TL;DR / Быстрый инсайт: В 2026 году Anthropic рекомендует native installer — Node.js не нужен. Windows: irm https://claude.ai/install.ps1 | iex, бинарь ложится в %USERPROFILE%.localbin. Проверка: claude —version и claude doctor. Claude Code входит в Pro/Max/Team/Console, free Claude.ai CLI не дает. Россия не в списке supported countries — блокировка региона часто маскируется под «битый установщик».
Запрос «как установить claude code» в Яндекс Вордстат дает около 1 098 показов в месяц по России; хвост «на windows» — 397, «в россии» — 252. Claude Code — агент в терминале: читает файлы проекта, запускает shell-команды, правит код по вашему запросу. CLI (Command Line Interface) — программа, которой вы управляете текстом, а не кнопками. На июнь 2026 актуальна ветка v2.1.x; native-сборки обновляются в фоне.
Выберите сценарий: Claude Code в терминале или Cursor с MCP
Типичная ошибка — путать два инструмента одного вендора. Claude Code живет в терминале: вы cd в папку репозитория, пишете claude, агент сам исследует проект и предлагает правки. Cursor — IDE (редактор кода) с чатом и MCP-серверами внутри окна. На практике связка такая: Claude Code для глубокого рефакторинга в git-репо, Cursor — для быстрых правок и визуального diff. MCP (Model Context Protocol) — «розетки» для внешних сервисов; в Claude Code их подключают после базового CLI, не смешивая с установкой.
Критерий Claude Code (CLI) Cursor + MCP Где работает Терминал, SSH, WSL2 Окно редактора Подписка Pro/Max/Team/Console API Отдельный тариф Cursor + API Sandbox на Windows Только через WSL2 Зависит от tools в MCP Когда выбирать Автономный агент в репозитории Визуальный код + каталог MCP
Делайте: начните с одного репозитория и одного терминала. Не делайте: ставить npm-гайд 2025 года как default — Node больше не обязателен для официального пути.
Проверьте предусловия: подписка, RAM и статус региона
Claude Code не входит в бесплатный план Claude.ai. Нужен Pro (от $17/мес при годовой оплате или $20 помесячно), Max, Team, Enterprise либо Console с API key. RAM от 4 GB, Windows 10 1809+, Ubuntu 20.04+, macOS 13+, интернет обязателен. Для России критично заранее сверить список supported countries: РФ там нет — при установке или OAuth может прийти «App unavailable in region». Это не сломанный скрипт, а ограничение аккаунта и сети.
Делайте: подготовьте платный аккаунт и документируйте путь к бинарю до первой команды. Не делайте: тратить вечер на переустановку CLI, если блокирует регион — сначала страна аккаунта и доступ к claude.com.
Установите native installer: PowerShell, bash или WinGet
Официальный канон на 2026-06-17 — native one-liner. Самая частая ошибка после успешной установки на Windows — не битый install.ps1, а PATH без перезапуска терминала.
Схема установки:
Выбор ОС → native install → перезапуск терминала → claude —version → claude doctor → cd в проект → claude → OAuth → первый промпт
- Windows PowerShell: откройте PS (приглашение PS C:), выполните irm https://claude.ai/install.ps1 | iex. В CMD используйте install.cmd, не смешивайте синтаксис && с PowerShell.
- Linux, macOS, WSL2: curl -fsSL https://claude.ai/install.sh | bash.
- Альтернатива Windows: winget install Anthropic.ClaudeCode — без автообновления по умолчанию.
- Перезапустите терминал полностью — закройте вкладку, не только clear.
- Проверьте версию: claude —version — ожидайте 2.1.x на июнь 2026.
- Диагностика: claude doctor; при сетевых сбоях — curl -sI https://downloads.claude.ai/claude-code-releases/latest.
Бинарь Windows: %USERPROFILE%.localbinclaude.exe. Если claude not recognized — добавьте эту папку в User PATH и снова откройте терминал. В PowerShell: Test-Path $env:USERPROFILE.localbinclaude.exe должен вернуть True.
Настройте авторизацию: Pro, OAuth и PATH в России
После установки cd в папку проекта и введите claude. Откроется браузер для OAuth — войдите в аккаунт с Pro/Max/Console. Ошибка 403 или «App unavailable in region» при российском IP означает: сверьте supported countries, проверьте страну биллинга аккаунта, при необходимости Console API или корпоративный Bedrock-путь для команд. Free Claude.ai в браузере CLI не открывает — не ждите «бесплатно из коробки».
На Windows без Git Bash часть shell-команд агента ведет себя иначе. Делайте: поставьте Git for Windows или задайте CLAUDE_CODE_GIT_BASH_PATH на git-bash.exe. Не делайте: копировать npm install -g @anthropic-ai/claude-code как единственный путь — это advanced option с ручным pin версии.
Запустите первый сеанс: промпт, разрешения и CLAUDE.md
В реальном проекте начните с нейтрального вопроса из quickstart: what does this project do? Агент прочитает структуру репо и объяснит назначение. При правке файлов CLI спросит approve — это нормально: автономные агенты на сложных задачах без человека в открытых оценках укладываются менее чем в 2,5% случаев, контроль остается за вами.
Создайте в корне CLAUDE.md — краткие правила для агента: стек, стиль коммитов, что трогать нельзя. Команда /help покажет служебные режимы. Делайте: один осмысленный запрос и одну мелкую правку с подтверждением. Не делайте: давать агенту продакшен-токены в промпте — храните секреты в env.
Подключите MCP и связку с Cursor или n8n
MCP настраивают после рабочего CLI — по документации MCP. Хвост «claude code mcp servers» в Вордстат — около 718 показов: подключайте один сервер под задачу (файлы, браузер, docs). Для IDE-потока см. подключение MCP в Cursor; для фоновых сценариев — автоматизация n8n с ИИ-агентами и Make + MCP. Claude Code правит код в git, n8n/Make публикуют и шлют уведомления 24/7.
Если хотите собрать полный стек автоматизации без ручного кода, в курсе Make.com и вайбкодинга на kv-ai.ru разбирают связку агентов, MCP и no-code — это логичный следующий шаг после рабочего терминала.
Пройдите чеклист troubleshooting перед продакшеном
- command not found — перезапуск терминала, PATH к .localbin, Test-Path claude.exe.
- syntax error в установщике — PS vs CMD: irm | iex только в PowerShell.
- region / OAuth 403 — supported countries, аккаунт Pro/Console, не переустановка CLI.
- устаревшая версия — native auto-update; WinGet обновляйте вручную.
- токены — не коммитьте API keys; ротируйте при утечке.
Критерий «готово»: claude —version и claude doctor без ошибок; OAuth прошел; агент ответил на what does this project do?; вы записали путь к бинарю и план обновлений (native vs WinGet). Тогда установка закрыта, MCP и параллельная работа с Cursor — на второй день, как в типичном сценарии после первого вечера с PATH и регионом.
Материал проверен: эксперт Елена Ковалева (Главный эксперт по SEO/GEO).
Достоверность данных: все статистические показатели и ключевые фразы верифицированы по данным Яндекс Вордстат на июнь 2026 года.
Частые вопросы
Как установить claude code на windows?
Откройте PowerShell, выполните irm https://claude.ai/install.ps1 | iex, закройте и снова откройте терминал. Проверьте claude —version. Если не находится — добавьте %USERPROFILE%.localbin в PATH. Альтернатива: winget install Anthropic.ClaudeCode.
Как установить claude code в россии?
Установщик скачивается глобально, но Россия не в списке Anthropic supported countries. Нужен платный аккаунт Pro/Max/Console и соответствие региона аккаунта официальным требованиям. При «App unavailable in region» не переустанавливайте CLI — проверьте страну и тип подписки.
Можно ли использовать claude code бесплатно?
Нет для официального CLI: free-план Claude.ai не включает Claude Code. Минимум — Pro около $20/мес или Console API с оплатой по токенам. Гайды про «7 способов бесплатно» обычно про другие инструменты, не про этот CLI.
Нужен ли Node.js для claude code?
Для native installer 2026 — нет. npm install -g @anthropic-ai/claude-code остался продвинутым вариантом, если вы осознанно фиксируете версию через Node 18+.
Что такое claude doctor?
Встроенная диагностика окружения: сеть, путь к бинарю, зависимости. Запускайте после установки и при любой странной ошибке до смены аккаунта или переустановки.
Как подключить claude code mcp?
Сначала добейтесь рабочего claude login в проекте. Затем добавьте MCP server по официальной документации — один сервер на задачу. Для MCP внутри IDE используйте Cursor отдельно.
Как установить claude code в cursor?
Это разные продукты: Claude Code — отдельный CLI в терминале, Cursor — редактор со своим Agent. Можно работать параллельно: CLI в репозитории, Cursor для визуальных правок и MCP-каталога.