На Windows Claude Code ставится одной командой 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 либо ключ codexkey. Подробнее ниже.
Почему именно 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: ключ codexkey (без аккаунта Anthropic и без VPN)
Этот путь для тех, у кого нет аккаунта Anthropic или кто работает из России. codexkey это шлюз к Claude на том же протоколе Messages API. Вы получаете ключ формата sk_cdx_…, направляете Claude Code на адрес codexkey, и дальше всё работает как обычно: MCP-серверы, хуки, всё на месте. Без VPN и без регистрации в Anthropic. Оплата по токенам от $0.33 за 1M токенов, принимаются СБП, российские карты, МТС и крипта.
Как направить Claude Code на codexkey
Claude Code читает две переменные окружения: базовый URL и учётные данные. В ANTHROPIC_BASE_URL укажите адрес codexkey, а ключ передайте через ANTHROPIC_API_KEY (для той же цели Claude Code принимает и ANTHROPIC_AUTH_TOKEN). Точные имена переменных перед стартом лучше сверить с руководством по Claude Code.
Сначала получите ключ codexkey
- Зарегистрируйтесь на странице регистрации: нужна только почта.
- Пополните баланс через СБП, российскую или зарубежную карту, МТС или крипту. Минимума нет.
- Дашборд → API Keys → создайте ключ. Скопируйте значение
sk_cdx_….
PowerShell: проверить на одну сессию
Быстрая проверка только в текущем окне:
$env:ANTHROPIC_BASE_URL = "https://api.codexkey.ru"
$env:ANTHROPIC_API_KEY = "sk_cdx_YOUR_KEY"
claude
Значения исчезнут, как только окно закроется. Для проверки это годится, для повседневной работы нет.
PowerShell: сделать постоянным
Чтобы значения пережили перезагрузку, запишите их в пользовательское окружение:
setx ANTHROPIC_BASE_URL "https://api.codexkey.ru"
setx ANTHROPIC_API_KEY "sk_cdx_YOUR_KEY"
setx сохраняет переменные, но текущее окно не обновляет. Закройте PowerShell, откройте новое окно и запустите claude.
WSL2 / Ubuntu
Добавьте экспорты в ~/.bashrc (или ~/.zshrc):
export ANTHROPIC_BASE_URL="https://api.codexkey.ru"
export ANTHROPIC_API_KEY="sk_cdx_YOUR_KEY"
Перечитайте профиль командой source ~/.bashrc. Запустите claude в любом репозитории, и агент пойдёт через codexkey.
Как проверить, что Claude Code работает?
Быстрые проверки по порядку:
claude --versionпоказывает номер сборки: бинарник установлен и находится вPATH.- Запустите
claudeвнутри репозитория и задайте простой вопрос: «покажи файлы в этом проекте». Корректный ответ означает, что с авторизацией и сетью всё в порядке. - Попросите внести крошечную правку, например «добавь комментарий в начало README.md», и убедитесь, что файл изменился.
Если шаг 2 завершается ошибкой авторизации, значит, ключ или базовый URL не применились. Переходите к разбору ошибок.
Настройка MCP-серверов на Windows
MCP-серверы (Model Context Protocol) расширяют Claude Code инструментами: доступом к файловой системе, веб-запросами, коннекторами к БД и другим. Они работают одинаково и с аккаунтом Anthropic, и с codexkey: для 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. В ключе лишний пробел, или в окружении осталось старое значение. Создайте новый ключ в дашборде codexkey, задайте переменную заново и откройте новый терминал.
getaddrinfo ENOTFOUND api.anthropic.com. ANTHROPIC_BASE_URL не применился. Выполните echo $env:ANTHROPIC_BASE_URL (PowerShell) или echo $ANTHROPIC_BASE_URL (WSL): должно вывести https://api.codexkey.ru. Пусто? Значит, переменную задали через setx, но новое окно не открыли.
429 rate_limit_exceeded. Прочитайте текст ошибки и правила провайдера. Если есть Retry-After, учитывайте его и снижайте частоту запросов в клиенте. API ключей личного кабинета не позволяет задавать дневной лимит ключа.
Обновление и удаление 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? Да, через codexkey. Шлюз выдаёт собственные ключи sk_cdx_…, регистрация в Anthropic не нужна. VPN тоже не требуется, доступ есть из России.
Какую версию Node.js ставить? Текущий LTS: минимум 18, рекомендуется 20 или 22. На более старых версиях Claude Code может падать при запуске.
Как скачать Claude Code: есть ли установщик .exe? Поддерживаемый способ установки на Windows это npm: npm install -g @anthropic-ai/claude-code. Отдельный установщик скачивать не нужно, всё делает npm.
Будут ли работать MCP-серверы и хуки на Windows? Да. Они работают и нативно, и в WSL2 и ведут себя одинаково при входе через Anthropic или через codexkey. В нативной Windows следите за форматом путей.
Вопросы? Пишите команде в Telegram https://t.me/codex_key или через страницу контактов.