Как установить Claude Code на Windows 11 в 2026: полный гайд

Claude Code — это терминальный AI-агент от Anthropic, который пишет код по запросу на естественном языке. До конца 2025 года на Windows инструмент работал только через Windows Subsystem for Linux (WSL) — встроенную в Windows подсистему Linux. С 2026 года появилась нативная установка через стандартный пакетный менеджер Node.js, и теперь Claude Code запускается на Windows 11 без дополнительных слоёв.

В этой статье — пошаговая установка для Windows 11. Расскажем про оба способа (нативный и через WSL), разберём типичные ошибки и покажем, что делать после установки. По результатам анализа поисковых запросов, в начале 2026 года около 3 400 человек в месяц ищут информацию по установке Claude Code на Windows — это популярный запрос.

Что нужно перед установкой Claude Code на Windows

Прежде чем запускать установку, проверьте, что у вас есть всё необходимое.

Минимальные требования

• Операционная система: Windows 11 любой редакции или Windows 10 версии 2004 (сборка 19041) и новее
• Оперативная память: минимум 4 ГБ, рекомендуется 8 ГБ для комфортной работы
• Свободное место на диске: 500 МБ для самого Claude Code, плюс место под рабочие проекты
• Интернет-соединение: обязательно — агент работает через серверы Anthropic
• Подписка Claude Pro или выше — на бесплатном тарифе агент недоступен

Что должно быть установлено заранее

Перед самой установкой Claude Code понадобится подготовить системные инструменты:

Если что-то отсутствует — устанавливайте перед основной процедурой. Иначе появятся ошибки на следующих шагах.

Какой способ установки выбрать

С 2026 года Windows поддерживает два пути:

1. Нативная установка — Claude Code работает напрямую в PowerShell без дополнительных слоёв. Подходит большинству пользователей
2. Через Windows Subsystem for Linux (WSL) — установка внутри подсистемы Linux. Полезна разработчикам, которые уже работают с WSL, или при возникновении специфических проблем с нативной установкой

Если вы начинающий пользователь и не работаете с WSL — выбирайте нативный способ. Он проще и быстрее.

Нативная установка Claude Code на Windows 11

Самый простой и быстрый путь. Подходит для большинства пользователей.

Шаг 1. Установите Node.js

Откройте сайт nodejs.org в браузере. На главной странице будут две кнопки скачивания: версия LTS (рекомендованная стабильная) и Current (свежая, но менее стабильная). Выбирайте LTS.

После скачивания запустите установочный файл MSI. В мастере установки соглашайтесь со всеми параметрами по умолчанию. Установка занимает 1-2 минуты.

После завершения откройте PowerShell (нажмите Win+X, выберите «Windows PowerShell» или «Терминал») и проверьте версию:

node --version

Должно вывестись что-то вроде v22.10.0. Если выводится «команда не найдена» — закройте все окна PowerShell и откройте снова. Если и после этого не работает — перезагрузите компьютер.

Шаг 2. Установите Git

Скачайте Git с сайта git-scm.com/download/win. Запустите установщик. На странице выбора редактора по умолчанию выберите «Use Visual Studio Code as Git’s default editor» (или ваш текущий редактор). Остальные настройки оставьте по умолчанию.

Проверьте установку:

git --version

Должно вывести версию Git, например git version 2.45.0.windows.1.

Шаг 3. Установите Claude Code через npm

Откройте PowerShell от имени администратора (правый клик по значку PowerShell → «Запуск от имени администратора»). Выполните команду:

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

Флаг -g означает глобальную установку — Claude Code будет доступен из любой папки. Установка занимает 30-60 секунд.

Шаг 4. Проверьте установку

После завершения обязательно закройте текущее окно PowerShell и откройте новое. Без перезапуска переменная окружения PATH не обновится, и команда claude будет недоступна.

В новом окне PowerShell проверьте:

claude --version

Должна вывестись текущая версия Claude Code. Если получили эту строку — установка прошла успешно.

Дополнительно можно запустить диагностику:

claude doctor

Эта команда покажет тип установки, версию, расположение конфигурации и подсветит возможные проблемы.

Шаг 5. Первый запуск и авторизация

Перейдите в любую папку с проектом (или создайте новую):

mkdir мой-первый-проект
cd мой-первый-проект
claude

При первом запуске Claude Code откроет браузер с просьбой войти в аккаунт Anthropic. Если у вас уже активная подписка Claude Pro — войдите. Если нет — оформите подписку перед использованием (об этом ниже).

После авторизации вернитесь в PowerShell. Агент готов к работе. Можно вводить первую задачу:

Создай файл README.md с описанием проекта.

Установка через Windows Subsystem for Linux

Альтернативный способ установки. Подходит, если у вас уже настроен WSL для других задач, или если нативная установка не работает по каким-то причинам.

Когда выбирать WSL

• Вы уже разработчик и работаете с Linux-инструментами через WSL
• Нативная установка показывает ошибки, которые не получается исправить
• Хотите изолировать AI-агента от основной системы

Шаг 1. Включите WSL

Откройте PowerShell от имени администратора и выполните:

wsl --install

Команда установит WSL версии 2 и дистрибутив Ubuntu по умолчанию. После завершения перезагрузите компьютер.

После перезагрузки откроется консоль Ubuntu, попросит создать имя пользователя и пароль для Linux. Запомните пароль — он понадобится для административных команд.

Шаг 2. Обновите систему Ubuntu

В консоли Ubuntu выполните:

sudo apt update
sudo apt upgrade -y

После ввода пароля система обновит список пакетов и установит свежие версии. Занимает 2-5 минут.

Шаг 3. Установите Node.js внутри WSL

Это критически важно: Node.js нужно устанавливать именно внутри WSL, а не на Windows. Если у вас уже стоит Node.js на Windows — Claude Code не сможет его использовать из WSL.

Самый надёжный способ — через скрипт NodeSource:

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs

Проверьте установку:

node --version
npm --version

Шаг 4. Установите Claude Code

В консоли Ubuntu:

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

После завершения проверьте:

claude --version

Шаг 5. Проверьте путь установки

Запустите команду which claude — должно вывестись что-то вроде /usr/bin/claude или /home/имя-пользователя/.nvm/versions/.... Если в пути есть /mnt/c/ — значит используется Windows-версия Node.js, это нужно исправить (см. раздел «Типичные ошибки» ниже).

Шаг 6. Используйте Claude Code из VS Code

Установите Visual Studio Code на Windows. В нём установите расширение «Remote — WSL» (или «WSL» в новой версии).

После установки откройте VS Code, нажмите F1, введите «WSL: Connect to WSL» и выберите ваш дистрибутив Ubuntu. Через несколько секунд VS Code подключится к WSL. Открывайте папку проекта внутри WSL и работайте с Claude Code в встроенном терминале.

Подписка Claude Pro: как оформить из России

Без активной подписки Claude Pro (минимум 20 долларов в месяц) Claude Code не работает. Anthropic не принимает российские карты — оплата идёт через обходные пути.

В 2026 году для России доступны четыре способа:

Подробный разбор каждого способа — в нашей статье про оплату зарубежных сервисов.

Кратко: самый простой способ — открыть payment.mts.ru или приложение Ozon Банка, найти Claude в каталоге, оплатить рублями через систему быстрых платежей, получить реквизиты виртуальной карты на электронную почту, ввести их на странице claude.ai/upgrade.

Типичные ошибки при установке и их решения

Разберём проблемы, которые встречаются чаще всего.

Ошибка: «команда не найдена» после установки

Причина: переменная окружения PATH не обновилась после установки.

Решение: закройте все открытые окна PowerShell или Command Prompt. Откройте новое окно — переменные обновятся. Если после трёх попыток не работает — перезагрузите компьютер.

Ошибка: «cannot execute binary file: Exec format error»

Причина: вы используете WSL версии 1 вместо WSL версии 2.

Решение: конвертируйте дистрибутив в WSL2. В PowerShell от администратора:

wsl --set-version Ubuntu 2

Если в системе ещё нет WSL2, сначала обновите ядро: скачайте с сайта Microsoft пакет обновления и установите. Затем повторите команду конвертации.

Ошибка: «Cannot find module» при запуске

Причина: Claude Code установлен в Windows, а вы пытаетесь запустить его из WSL (или наоборот).

Решение: запустите which claude. Если путь начинается с /mnt/c/ — это Windows-версия в среде WSL, не работает. Удалите её и установите Node.js плюс Claude Code заново именно внутри WSL.

Ошибка: «npm: command not found»

Причина: Node.js установлен криво или не до конца.

Решение: скачайте последнюю версию Node.js с nodejs.org, удалите старую через «Параметры» → «Приложения» → «Установленные приложения» → найдите Node.js → «Удалить». Установите свежую версию. Не забудьте перезапустить PowerShell.

Ошибка: установка работает, но запросы зависают

Причина: проблемы с соединением до серверов Anthropic.

Решение: проверьте интернет. Если соединение стабильное, но Claude Code висит — попробуйте запустить агент на зарубежном виртуальном сервере. Это решает проблему стабильности окончательно.

Ошибка: «EACCES: permission denied»

Причина: недостаточно прав для глобальной установки.

Решение: на Windows запустите PowerShell от имени администратора. На WSL/Linux используйте sudo перед командой npm.

Команда claude doctor для диагностики

Если что-то идёт не так — используйте встроенную диагностику. Команда выводит:

• Установленную версию Claude Code
• Тип установки (нативная или через WSL)
• Расположение конфигурационных файлов
• Версию Node.js
• Проблемы с PATH

claude doctor

Этот инструмент часто подсказывает причину сбоев и пути решения.

Что делать после установки: первые шаги

Установили, авторизовались, проверили работу. Что дальше?

Создайте файл правил проекта CLAUDE.md

В корне любого нового проекта создайте файл CLAUDE.md. В нём опишите контекст:

• Какой технологический стек используется
• Команды для запуска и тестирования
• Ваши правила оформления кода
• Чего не следует делать

Этот файл Claude Code будет читать при каждом запуске в этом проекте. Без него агент работает «вслепую» — с файлом гораздо точнее.

Попробуйте режим планирования

Перед сложной задачей нажмите Shift+Tab — Claude Code переключится в режим планирования. Сначала составит план действий, вы его проверите, и только потом он начнёт выполнение. Для задач на несколько файлов — обязательно используйте этот режим.

Изучите слеш-команды

В Claude Code есть встроенные команды, начинающиеся со слеша:

Подключите внешние инструменты через MCP

После освоения базовых сценариев расширьте возможности агента через MCP-серверы. Подключите GitHub, базы данных, браузер — и Claude Code сможет работать с этими системами напрямую.

Создайте свои навыки (Skills)

Если есть задачи, которые вы выполняете регулярно — оформите их в виде Skills. Один раз настроили — Claude Code будет следовать вашим правилам автоматически.

Решение типичных проблем со скоростью работы

Claude Code установился, авторизация прошла, базовые команды работают — но запросы выполняются медленно или периодически зависают. Разберём, что можно сделать.

Проверьте скорость соединения с серверами Anthropic

Откройте PowerShell и проверьте задержку до серверов:

ping api.anthropic.com

Нормальный показатель — 100-200 миллисекунд. Если выше 300 — соединение нестабильное, агент будет работать медленно.

Перейдите на работу через зарубежный сервер

Если стабильность критична, оптимальное решение — арендовать виртуальный сервер за рубежом и работать через него. Стоимость — около 400 ₽ в месяц. Скорость работы вырастает в 3-5 раз, разрывы пропадают.

Подробная инструкция как настроить этот сценарий — в нашей статье про использование Claude Code в России.

Используйте VS Code с расширением Remote

Visual Studio Code умеет работать с удалёнными серверами через расширение «Remote — SSH». Установили один раз — потом подключаетесь к серверу одной командой и работаете как с локальной папкой. Все файлы, терминал, отладка — на удалённом сервере, но интерфейс на вашем компьютере.

Очистите контекст агента

При долгой работе агент накапливает контекст беседы, что замедляет ответы. Команда /clear сбрасывает текущий контекст. Команда /compact сжимает историю до самого важного. Используйте их каждые 30-60 минут работы.

Сравнение с другими AI-инструментами на Windows

Claude Code — не единственный AI-инструмент для разработчиков. Краткое сравнение трёх популярных вариантов для Windows.

Подробный разбор всех инструментов — в нашей сводной статье.

Чеклист: установка Claude Code на Windows

1. Проверьте версию Windows — нужна Windows 11 или Windows 10 версии 2004+
2. Скачайте и установите Node.js LTS с сайта nodejs.org
3. Установите Git для Windows с сайта git-scm.com
4. Откройте PowerShell от имени администратора — правый клик по значку PowerShell
5. Выполните установку Claude Code командой npm install -g @anthropic-ai/claude-code
6. Закройте окно PowerShell и откройте новое — обновится переменная PATH
7. Проверьте установку командой claude --version
8. Запустите диагностику через claude doctor для проверки конфигурации
9. Оформите подписку Claude Pro — через МТС Оплату или Озон Банк
10. Авторизуйтесь при первом запуске claude в любой папке
11. Создайте файл CLAUDE.md в корне проекта с правилами
12. Поставьте первую задачу — простую, чтобы освоить интерфейс