Как установить Claude Code на Windows 10/11: Node.js, npm, нативно или через WSL2, авторизация по ключу Claudexia без аккаунта Anthropic, разбор ошибок.

Claude Code ставится на Windows одной командой npm: npm install -g @anthropic-ai/claude-code, дальше запускаете claude. Вся установка занимает около 15 минут, единственное реальное требование — Node.js 18 или новее. Это короткая версия. Всё остальное в гайде — про места, где обычно спотыкаются: запускать нативно или внутри WSL2, как авторизоваться без аккаунта Anthropic и как чинить ошибки PATH и политики выполнения, которые вылезают на свежей Windows.

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

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

Три вещи:

Windows 10 или 11. Более старые версии (7/8) не поддерживаются, CLI обычно не запускается.
Node.js 18 или новее (LTS). Claude Code — это пакет npm, без Node и npm никак.
Способ авторизации — аккаунт или подписка Anthropic, API-ключ Anthropic либо ключ Claudexia. Подробнее ниже.

Почему именно Node 18? CLI использует современные возможности рантайма, которых в старых сборках Node нет. Свежий LTS снимает целый класс жалоб в духе «падает при запуске».

Установка Node.js на Windows

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

node --version
npm --version

node --version должен показать v18.x.x или выше (v20 или v22 LTS тоже подходят). Если node не распознан — закройте все окна терминала и откройте новое: изменения PATH не применяются к уже открытым оболочкам.

Любите менеджеры версий? Для нативной Windows обычно берут nvm-windows. Внутри WSL2 — стандартный nvm.

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

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

	Нативно (PowerShell / Terminal)	WSL2 (Ubuntu)
Сложность настройки	Минимальная — Node и Claude Code	Лишний шаг: включить WSL, поставить Ubuntu
Git и инструменты	Windows-версия Git, иногда странности с путями	Нативный Linux Git, bash, привычные Unix-утилиты
Пути к файлам	`C:\Users\you\...`, обратные слэши	`/home/you/...`, прямые слэши
Хуки и скрипты	Часть shell-скриптов рассчитана на bash	bash везде, меньше сюрпризов
Скорость на больших репо	Норм для большинства проектов	Быстро — держите код в Linux-ФС
Кому подходит	Быстрый старт, Windows-стек	Node/Python/Go, кто привык к Linux

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

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

В PowerShell от администратора:

wsl --install

Команда включает WSL, ставит WSL2 и по умолчанию подтягивает Ubuntu. Перезагрузитесь по запросу, запустите «Ubuntu» из меню «Пуск» и задайте Linux-логин и пароль. Внутри Ubuntu поставьте Node через nvm или пакетный менеджер и переходите к установке через npm — команда одинаковая. Проверьте node --version уже внутри Ubuntu: версия Node на Windows и в WSL2 — это две разные установки, и важно, чтобы LTS стоял именно там, где вы запускаете claude.

Как установить Claude Code через npm?

Команда одна и та же и в нативном PowerShell, и в WSL2:

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

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

claude --version

Должна показаться строка версии. Если при установке выскочила ошибка прав — не лезьте за sudo в глобальную папку npm, это создаёт больше проблем, чем решает. Чистое исправление — в разделе про ошибки ниже.

Не ставить npm install -g на самой Windows? Некоторые запускают всё только внутри WSL2 и нативный npm не трогают. Это нормально — выберите одно окружение и держитесь его, иначе получите два бинарника claude.

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

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

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

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

Вариант A — аккаунт или подписка Anthropic

Есть подписка Claude Pro/Max или аккаунт Console — выберите вход по логину. Claude Code откроет браузер, вы войдёте, токен сохранится. Просто — если вы можете создать и удержать аккаунт Anthropic. У многих за пределами США это не выходит: при регистрации одновременно проверяются IP, номер телефона и страна карты.

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

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

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

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

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

Claude Code читает две переменные окружения: базовый URL и учётные данные. Задайте ANTHROPIC_BASE_URL на адрес Claudexia, а ключ передайте через ANTHROPIC_API_KEY (Claude Code также принимает ANTHROPIC_AUTH_TOKEN для той же цели). Точные имена переменных лучше сверить с гайдом по Claude Code перед стартом.

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

Зарегистрируйтесь на claudexia.tech — только почта.
Пополните баланс через СБП, российскую или зарубежную карту, МТС или крипту. Минимума нет.
Дашборд → API Keys → создайте ключ. Скопируйте значение sk_cdx_….

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

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

$env:ANTHROPIC_BASE_URL = "https://api.claudexia.tech"
$env:ANTHROPIC_API_KEY  = "sk_cdx_YOUR_KEY"
claude

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

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

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

setx ANTHROPIC_BASE_URL "https://api.claudexia.tech"
setx ANTHROPIC_API_KEY  "sk_cdx_YOUR_KEY"

setx сохраняет переменные, но не обновляет текущее окно. Закройте PowerShell, откройте новое окно и запустите claude.

WSL2 / Ubuntu

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

export ANTHROPIC_BASE_URL="https://api.claudexia.tech"
export ANTHROPIC_API_KEY="sk_cdx_YOUR_KEY"

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

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

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

claude --version показывает номер сборки — бинарник установлен и в PATH.
Внутри репозитория запустите claude и спросите что-нибудь простое: «покажи файлы в этом проекте». Корректный ответ значит, что и авторизация, и сеть в порядке.
Попросите внести крошечную правку — «добавь комментарий в начало README.md» — и проверьте, что файл изменился.

Если шаг 2 падает с ошибкой авторизации — ключ или базовый 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

На нативной Windows следите за форматом пути — обратные слэши и пробелы в именах папок требуют аккуратности. Внутри WSL2 используйте Linux-пути (/home/you/projects). Список серверов — командой claude mcp list. Подробный разбор есть в нашем гайде по MCP-серверам.

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

claude не распознан / node не распознан. Папка установки не в PATH, либо терминал был открыт раньше установки. Сначала откройте новое окно PowerShell. Всё ещё падает? Проверьте $env:PATH (PowerShell) и убедитесь, что глобальная bin-папка npm там есть — найти её можно через npm config get prefix.

npm ERR! EACCES / отказ прав при глобальной установке. Не запускайте sudo на глобальной папке. На нативной Windows это редкость; если случилось — переустановите Node официальным установщиком (он выставляет права корректно). В WSL2 перенаправьте глобальный префикс npm в домашнюю папку:

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Затем переустановите: npm install -g @anthropic-ai/claude-code.

running scripts is disabled on this system (политика выполнения). PowerShell по умолчанию блокирует скрипты. Разрешите подписанные локальные скрипты для своего пользователя:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Настройка ограничена вашей учёткой и считается стандартной и безопасной.

401 Unauthorized / invalid_api_key. В ключе лишний пробел или в окружении осталось старое значение. Создайте новый ключ в дашборде Claudexia, переустановите переменную и откройте новый терминал.

getaddrinfo ENOTFOUND api.anthropic.com. ANTHROPIC_BASE_URL не применился. Выполните echo $env:ANTHROPIC_BASE_URL (PowerShell) или echo $ANTHROPIC_BASE_URL (WSL) — должно вывести https://api.claudexia.tech. Пусто? Значит задали через setx, но не открыли новое окно.

429 rate_limit_exceeded. Сработал дневной лимит по ключу или кончился баланс. Пополните счёт или поднимите лимит в дашборде.

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

Обновить до свежей версии:

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

После проверьте claude --version. Полностью удалить:

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

Это удаляет бинарник. Переменные окружения остаются — очистите их в PowerShell командой setx ANTHROPIC_API_KEY "" (затем откройте новое окно) или уберите строки export из ~/.bashrc в WSL.

Что дальше

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

Готовы подключить? Получите ключ и следуйте гайду по Claude Code — агент начнёт править ваш репозиторий, пока кофе не остыл.

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

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

Работает ли Claude Code без аккаунта Anthropic? Да — через Claudexia. Шлюз выдаёт собственные ключи sk_cdx_…, так что регистрация в Anthropic не нужна. VPN не требуется, доступ есть из России.

Какую версию Node.js ставить? Текущий LTS — минимум 18, рекомендуется 20 или 22. Что-то старее рискует падать при запуске.

Как скачать Claude Code — есть установщик .exe? Поддерживаемый путь установки на Windows — через npm: npm install -g @anthropic-ai/claude-code. Отдельного установщика скачивать не нужно, всё делает npm.

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

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

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