Установка Claude Code на Windows: пошаговый гайд 2026

Claude Code ставится на Windows одной командой в PowerShell: irm https://claude.ai/install.ps1 | iex, дальше запускаете claude. Права администратора и Node.js для этого не нужны. Вся установка вместе с авторизацией занимает около 15 минут. Это короткая версия. Всё остальное в гайде про места, где обычно спотыкаются: запускать нативно или внутри WSL2, как авторизоваться без аккаунта Anthropic и как чинить ошибки PATH и политики выполнения, которые вылезают на свежей Windows.

Claude Code это консольный кодинг-агент от Anthropic. Он читает репозиторий, правит файлы, гоняет тесты и открывает pull request прямо из терминала. На Windows он работает нативно, так что WSL строго не обязателен, но опыт через WSL2 у многих заметно ровнее, и мы разберём оба варианта.

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

Для старта хватит трёх вещей:

• Windows 10 версии 1809 или новее, Windows 11 либо Windows Server 2019+. Windows 7 и 8 не поддерживаются. Ещё нужны 4 ГБ RAM и процессор x64 или ARM64.
• Доступ к серверам Anthropic. Скрипт и бинарник скачиваются оттуда, а страна должна входить в список поддерживаемых у Anthropic. Что делать, если установка упирается в 403, написано в разделе об установке ниже.
• Способ авторизации: платный аккаунт Anthropic, API-ключ Anthropic либо ключ Claudexia. Подробнее ниже.

Node.js для нативной установки не нужен. Он понадобится, только если вы ставите через npm или запускаете MCP-серверы через npx.

Нативно в PowerShell или через WSL2: что выбрать?

Работают оба. Вот честный размен.

Коротко: если вы и так живёте в PowerShell, а проект под Windows, ставьте нативно. Если ваш инструментарий ждёт Unix-окружения (а это почти любая работа с Node, Python, Go) или нужна песочница, WSL2 сэкономит нервы. Одно важное правило для WSL2: держите код в Linux-файловой системе (/home/you/projects), а не под /mnt/c/.... Кросс-ФС доступ медленный и сбивает с толку наблюдатели за файлами.

Настройка WSL2 (если идёте этим путём)

В PowerShell от администратора (нужна Windows 10 версии 2004 или новее, либо Windows 11):

wsl --install

Команда включает WSL и по умолчанию ставит Ubuntu на WSL 2. Перезагрузитесь по запросу, запустите «Ubuntu» из меню «Пуск» и задайте Linux-логин и пароль. Дальше выполните внутри Ubuntu установщик для Linux:

curl -fsSL https://claude.ai/install.sh | bash

Ставить и запускать claude нужно внутри терминала Ubuntu, а не из PowerShell или CMD. Установка на Windows и установка внутри Ubuntu живут отдельно: бинарник в ~/.local/bin внутри Ubuntu и бинарник в %USERPROFILE%\.local\bin на Windows это две разные копии.

Как установить Claude Code на Windows?

PowerShell

irm https://claude.ai/install.ps1 | iex

Пока скрипт качает файл, он ничего не печатает. Когда вернётся приглашение, откройте новое окно терминала и проверьте:

claude --version

Должна показаться строка вида 2.1.211 (Claude Code). Бинарник лежит в %USERPROFILE%\.local\bin\claude.exe, дальше установка обновляется сама в фоне. Для расширенной проверки есть claude doctor: он ничего не меняет, а печатает диагностику установки и настроек с подсказками по исправлению.

CMD

Если вы в классическом CMD (приглашение C:\Users\you> без PS), команда другая:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Команды для разных оболочек не взаимозаменяемы. Ошибка The token '&&' is not a valid statement separator значит, что вы в PowerShell и вставили строку для CMD. Ошибка 'irm' is not recognized значит обратное.

WinGet

winget install Anthropic.ClaudeCode

WinGet сам Claude Code не обновляет: время от времени выполняйте winget upgrade Anthropic.ClaudeCode.

npm, если нужен именно он

Пакет @anthropic-ai/claude-code ставит тот же нативный бинарник, а Node.js во время работы claude не вызывает. С версии 2.1.198 в пакете указан Node.js 22 или новее, на более старом npm печатает предупреждение EBADENGINE, но установка проходит и claude запускается. Проще сразу взять свежий LTS.

Скачайте установщик LTS с nodejs.org, запустите и оставьте настройки по умолчанию. Он сам добавит Node и npm в PATH. Откройте новое окно PowerShell и проверьте:

node --version
npm --version

node --version должен показать v22.x.x или выше. Если node не распознан, закройте все окна терминала и откройте новое: изменения PATH не применяются к уже открытым оболочкам. Любите менеджеры версий? Для нативной Windows обычно берут nvm-windows, внутри WSL2 стандартный nvm. Затем:

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

Флаг -g ставит пакет глобально, чтобы команда claude была доступна везде. sudo не используйте: Claude Code обновляет себя без него, и установка, которая требует sudo, сама обновляться не сможет.

Поставили Claude Code и нативно, и через npm, или и на Windows, и в WSL? Получите два бинарника claude, и запустится тот, что раньше в PATH. Найти все копии на Windows можно командой where.exe claude: она ищет в текущей папке и по Windows PATH, а Linux-копию внутри WSL не увидит. В WSL проверяйте отдельно: type -a claude покажет все копии на PATH дистрибутива. Выберите одну установку и держитесь её.

Если установка не идёт

Скрипт лежит на claude.ai, а бинарник качается с downloads.claude.ai. Проверьте, отвечает ли сервер:

curl.exe -sI https://downloads.claude.ai/claude-code-releases/latest

Нужен именно curl.exe: в PowerShell curl это псевдоним Invoke-WebRequest, и флаги -sI он отвергает. Первая строка HTTP/1.1 200 OK значит, что сервер достижим. 403 обычно значит прокси или сетевой фильтр, либо что Claude Code недоступен в вашем регионе. Во втором случае в ответе встречается текст App unavailable in region. За корпоративным прокси задайте HTTPS_PROXY и HTTP_PROXY до запуска установщика. Мы не проверяли установку из каждой страны, разбор по пунктам лежит в статье Скачать Claude Code.

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

Перейдите в папку проекта и запустите агента:

cd C:\Users\you\projects\my-app   # PowerShell
# или, в WSL2:
cd ~/projects/my-app
claude

При первом запуске Claude Code спросит, как авторизоваться. Вариантов три.

Вариант A: аккаунт Anthropic

Нужен платный план Claude (Pro, Max, Ultra, Team или Enterprise) либо аккаунт Console: бесплатный план claude.ai Claude Code не включает. Выберите вход по логину, Claude Code откроет браузер, вы войдёте, токен сохранится. Просто, если вы можете создать и удержать аккаунт Anthropic. У многих за пределами США это не получается: карту отклоняют, а проверки телефона и биллинга могут блокировать регистрацию.

Вариант B: API-ключ Anthropic

Есть ключ sk-ant-… из Anthropic Console? Задайте его в переменной ANTHROPIC_API_KEY. При первом запуске Claude Code спросит, использовать ли ключ, и после вашего согласия пропустит вход через браузер. Списания идут через ваш аккаунт Anthropic.

Вариант C: ключ Claudexia (без аккаунта Anthropic)

Это путь для тех, у кого нет аккаунта Anthropic или не проходит оплата. Claudexia принимает запросы по тому же протоколу Messages API. Вы получаете ключ в формате sk_cdx_…, направляете Claude Code на адрес Claudexia, и дальше всё работает так же: MCP-серверы, хуки, всё на месте. Регистрироваться в Anthropic не нужно, VPN для запросов к API тоже. Оплата по токенам, цена каждой модели указана на странице моделей, принимаются СБП, российские карты, МТС и крипта.

Важно: Claudexia продаёт доступ к API, а не подписки Claude Pro и Max. Шлюз не отменяет правила Anthropic о том, из каких стран можно пользоваться Claude Code, и эти условия вам придётся прочитать самим.

Как направить Claude Code на Claudexia

Адрес API и учётные данные Claude Code берёт из переменных окружения. Нужны пять: ANTHROPIC_BASE_URL (адрес без /v1), ANTHROPIC_AUTH_TOKEN (ключ) и три ANTHROPIC_DEFAULT_*_MODEL для алиасов opus, sonnet и haiku. Без последних Claude Code запрашивает собственные модели по умолчанию и отвечает «There's an issue with the selected model». Каноничный список переменных и моделей лежит в гайде по Claude Code.

Сначала получите ключ Claudexia

1. Зарегистрируйтесь на claudexia.tech, хватит логина и пароля или входа через Google, GitHub, Telegram.
2. Пополните баланс через СБП, российскую или зарубежную карту, МТС или крипту. Минимальное пополнение 1 доллар.
3. Дашборд → API Keys → создайте ключ. Скопируйте значение sk_cdx_….

PowerShell: проверить на одну сессию

Быстрый тест только в текущем окне:

$env:ANTHROPIC_BASE_URL = "https://api.claudexia.tech"
$env:ANTHROPIC_AUTH_TOKEN = "sk_cdx_YOUR_KEY"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5-5[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-sonnet-5"
claude

Эти значения исчезнут при закрытии окна. Годится для проверки, не для повседневной работы.

PowerShell: сделать постоянным

Чтобы значения сохранялись после перезагрузки, запишите их в пользовательское окружение:

setx ANTHROPIC_BASE_URL "https://api.claudexia.tech"
setx ANTHROPIC_AUTH_TOKEN "sk_cdx_YOUR_KEY"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "claude-opus-5-5[1m]"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "claude-sonnet-5[1m]"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "claude-sonnet-5"

setx сохраняет переменные, но не обновляет текущее окно. Закройте PowerShell, откройте новое окно и запустите claude. Суффикс [1m] понимает только Claude Code. У claude-sonnet-5 и claude-opus-5-5 окно 1M встроено, и для них суффикс ничего не меняет: он стоит в примерах на случай версии Claude Code, которая этих ID не знает и по умолчанию считает окно 200K (при старте она об этом предупреждает, тогда выполните claude update). Нужен суффикс тем моделям, которые Claude Code открывает на 1M только через него: claude-opus-4-6[1m] и claude-sonnet-4-6[1m]. К claude-haiku-4.5 его не добавляйте: у неё окно 200K. Те же переменные можно положить в блок env файла %USERPROFILE%\.claude\settings.json, пример есть в гайде по настройке Claude Code.

WSL2 / Ubuntu

Добавьте экспорты в ~/.bashrc (или ~/.zshrc):

export ANTHROPIC_BASE_URL="https://api.claudexia.tech"
export ANTHROPIC_AUTH_TOKEN="sk_cdx_YOUR_KEY"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5[1m]"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5[1m]"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-sonnet-5"

Перечитайте профиль: source ~/.bashrc. Запустите claude в любом репозитории, и агент пойдёт через Claudexia.

Как проверить, что Claude Code работает?

Быстрые проверки по порядку:

1. claude --version показывает номер сборки: бинарник установлен и находится в PATH.
2. Запустите claude и введите /status. Строка Anthropic base URL должна показывать https://api.claudexia.tech, а строка Auth token называть переменную ANTHROPIC_AUTH_TOKEN. Если строки с адресом нет, переменная не дошла до сессии. Одного ANTHROPIC_BASE_URL без ключа мало: сохранённый вход claude.ai останется главным.
3. Внутри репозитория спросите что-нибудь простое: «покажи файлы в этом проекте». Корректный ответ значит, что и авторизация, и сеть в порядке.
4. Попросите внести крошечную правку, «добавь комментарий в начало README.md», и проверьте, что файл изменился.

Если шаг 3 падает с ошибкой авторизации, ключ или базовый URL не применились. Переходите к разбору ошибок.

Настройка MCP-серверов на Windows

MCP-серверы (Model Context Protocol) расширяют Claude Code инструментами: доступ к файловой системе, веб-запросы, коннекторы к БД и прочее. Они работают одинаково и через аккаунт Anthropic, и через Claudexia: шлюз прозрачен для MCP.

Добавить сервер через CLI:

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem C:\Users\you\projects

npx идёт в комплекте с Node.js, так что для такого сервера Node понадобится, даже если сам Claude Code вы поставили нативно. На нативной Windows следите за форматом пути: обратные слэши и пробелы в именах папок требуют аккуратности. Внутри WSL2 используйте Linux-пути (/home/you/projects). Список серверов выводит claude mcp list. Подробный разбор есть в нашем гайде по MCP-серверам.

Частые ошибки на Windows и как их чинить

claude не распознан. Установка прошла, но папка %USERPROFILE%\.local\bin не в PATH: установщик сам PATH не меняет, а только пишет подсказку в конце вывода. Сначала откройте новое окно PowerShell. Терминал внутри редактора берёт PATH у редактора, так что закройте и откройте сам редактор. Всё ещё падает? Проверьте, что бинарник на месте:

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

True значит, что файл есть и папку надо добавить в пользовательский PATH:

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Перезапустите терминал и снова выполните claude --version. Если по команде claude вместо Claude Code открывается приложение Claude Desktop, обновите Desktop: старые версии кладут свой Claude.exe в WindowsApps, и он идёт в PATH раньше.

node или npm не распознан. Это касается только npm-способа и MCP-серверов на npx. Поставьте Node.js LTS с nodejs.org и откройте новое окно терминала.

running scripts is disabled on this system (политика выполнения). Ошибка приходит при npm-установке: PowerShell блокирует .ps1-оболочки, которые npm создаёт для команд npm и claude. Установщик irm ... | iex под это правило не подпадает. Есть три выхода. Разрешить локально созданные скрипты для своей учётной записи:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Либо вызывать npm.cmd и claude.cmd, на них политика не действует. Либо поставить Claude Code установщиком для PowerShell вместо npm.

После npm-установки claude не запускается или печатает Error: claude native binary not installed. На Windows PowerShell и CMD чаще пишут, что не могут выполнить файл, а само сообщение видно на macOS, Linux и в WSL. Причина обычно в npm 12: он по умолчанию не запускает установочный шаг пакета, и бинарник не ложится на место. Проверьте npm --version: если версия начинается с 12, проще всего перейти на нативный установщик и удалить npm-пакет командой npm uninstall -g @anthropic-ai/claude-code.

EACCES или отказ прав при установке через npm. Не запускайте sudo на глобальной папке npm. Документация Anthropic советует перейти на нативный установщик: он пишет только в папки вашего профиля.

WSL: cannot execute binary file: Exec format error. Вы на WSL 1. Переведите дистрибутив на WSL 2 из PowerShell, подставив имя из wsl -l -v:

wsl --set-version <DistroName> 2

WSL: exec: node: not found при запуске claude после установки через npm. WSL подхватил Windows-версию Node. which node покажет путь, начинающийся с /mnt/c/. Поставьте Linux-Node через nvm или пакетный менеджер дистрибутива.

Claude Code does not support 32-bit Windows. Вы открыли пункт Windows PowerShell (x86) в меню «Пуск». Откройте Windows PowerShell без (x86) и повторите установку.

401 Unauthorized / invalid_api_key. В ключе лишний пробел или в окружении осталось старое значение. В наших гайдах ключ лежит в ANTHROPIC_AUTH_TOKEN, он уходит заголовком Authorization: Bearer. Шлюз принимает и x-api-key, поэтому ключ sk_cdx_… в ANTHROPIC_API_KEY сам по себе 401 не вызывает. Если заданы обе переменные, по документации Claude Code побеждает ANTHROPIC_AUTH_TOKEN, а ANTHROPIC_API_KEY в интерактивной сессии ещё и ждёт разового подтверждения, так что оставьте одну. Какой ключ сейчас активен, покажет /status. Создайте новый ключ в дашборде Claudexia, переустановите переменную и откройте новый терминал.

Unable to connect to API или (ENOTFOUND). Claude Code не достучался до адреса API. Выполните echo $env:ANTHROPIC_BASE_URL (PowerShell) или echo $ANTHROPIC_BASE_URL (WSL): должно вывести https://api.claudexia.tech. Пусто? Тогда Claude Code идёт на api.anthropic.com: вы задали переменную через setx, но не открыли новое окно. Если адрес есть, а в тексте ошибки Connection refused, проверьте, не остался ли в профиле или в settings.json старый адрес локального шлюза, который уже не запущен.

429 Too Many Requests. У 429 несколько причин. Слишком частые запросы (rate_limited) или слишком много одновременных по ключу (org_queue_full): снизьте частоту и дождитесь завершения текущих. Сервис загружен (queue_full, queue_timeout): повторите через несколько секунд. Баланс почти пуст (low_balance): запросы идут по одному, пополните баланс. Claude Code работает с форматом Anthropic, где код не приходит, только статус и тип ошибки, поэтому при 429 сначала загляните в дашборд и проверьте баланс. При наличии учитывайте Retry-After. API ключей личного кабинета не позволяет задавать дневной лимит ключа.

Обновление и удаление Claude Code

Нативная установка обновляется сама: Claude Code проверяет обновления при запуске и периодически, ставит их в фоне, а новая версия включается при следующем запуске. Чтобы обновиться сразу:

claude update

claude doctor покажет результат последней попытки автообновления. Установка через WinGet сама не обновляется: winget upgrade Anthropic.ClaudeCode. Для npm используйте npm install -g @anthropic-ai/claude-code@latest, а не npm update -g: он держится диапазона версии с первой установки и может не дойти до свежего релиза.

Удалить нативную установку:

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Для остальных способов: winget uninstall Anthropic.ClaudeCode или npm uninstall -g @anthropic-ai/claude-code. В WSL удалите бинарник командами rm -f ~/.local/bin/claude и rm -rf ~/.local/share/claude.

Настройки, разрешённые инструменты, конфигурации MCP и история сессий лежат в %USERPROFILE%\.claude и %USERPROFILE%\.claude.json. Они остаются после удаления программы: стирайте их, только если готовы потерять всё это. Переменные окружения тоже остаются. Убрать их из пользовательского окружения Windows можно так:

foreach ($n in 'ANTHROPIC_BASE_URL','ANTHROPIC_AUTH_TOKEN','ANTHROPIC_DEFAULT_OPUS_MODEL','ANTHROPIC_DEFAULT_SONNET_MODEL','ANTHROPIC_DEFAULT_HAIKU_MODEL') {
  [Environment]::SetEnvironmentVariable($n, $null, 'User')
}

Затем откройте новое окно. В WSL уберите строки export из ~/.bashrc.

Что дальше

• Только начинаете? Загляните в наш гайд по настройке Claude Code.
• Работаете из России или без аккаунта Anthropic? Инструкция по доступу из России глубже разбирает оплату и доступ.
• Установка падает или нужен список способов? Читайте Скачать Claude Code.
• Выбираете инструмент? Читайте Claude Code против Cursor.
• Подключаете шлюз? В гайде по Claude Code лежит каноничная конфигурация, а быстрый старт выдаст ключ за пару минут.

Частые вопросы

Нужен ли WSL, чтобы запустить Claude Code на Windows? Нет. Он работает нативно в PowerShell, CMD или Windows Terminal. WSL2 опционален: он удобнее для Unix-инструментария и нужен, если вам нужна песочница (sandboxing), которой нативная Windows не поддерживает.

Работает ли Claude Code без аккаунта Anthropic? Да, через Claudexia. Шлюз выдаёт собственные ключи sk_cdx_…, так что регистрация в Anthropic не нужна, а для запросов к API не нужен и VPN. Саму установку Claude Code качают с серверов Anthropic: если они недоступны из вашей сети, смотрите раздел «Если установка не идёт».

Какую версию Node.js ставить? Для нативной установки никакую. Для npm-способа нужен Node.js 22 или новее, подробности в разделе про npm выше.

Как скачать Claude Code, есть ли установщик .exe? Среди официальных способов для Windows Anthropic называет PowerShell, CMD и WinGet, и ни один из них не двойной клик по .exe. Файлы со сторонних сайтов скачивать не нужно. Отдельно есть приложение Claude для Windows (claude.com/download), которое позволяет работать с Claude Code без терминала, но это другая программа, см. Скачать Claude Desktop и подключить MCP.

Будут ли работать MCP-серверы и хуки на Windows? Да. Они работают и нативно, и в WSL2, и ведут себя одинаково при авторизации через Anthropic или Claudexia. На нативной Windows следите за форматом путей.

Вопросы? Пишите команде в Telegram или на support@claudexia.tech.