Нужен ли Node.js для Claude Code?

Только для установки через npm: пакет официально требует Node.js 22 или новее. Нативный установщик, Homebrew и WinGet ставят готовый бинарник, и Node.js для них не нужен. Во время работы сам Claude Code Node.js не использует.

Можно ли установить Claude Code в России без VPN?

Да. Установка через npm идёт из реестра npm и работает из России. Для работы агенту нужен доступ к модели: вместо входа в аккаунт Anthropic задаются переменные ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN с адресом Anthropic-совместимого шлюза и вашим токеном.

Что выбрать на Windows: нативный режим или WSL?

Если проект на Windows и вы работаете в PowerShell, достаточно нативного режима — желательно с Git for Windows. Если проект и инструменты живут в Linux, ставьте Claude Code внутри WSL и задавайте переменные в ~/.bashrc дистрибутива. Песочница для команд поддерживается только в WSL 2.

Как обновить Claude Code?

Нативная установка обновляется сама, вручную — командой claude update. Установку через npm обновляйте командой npm install -g @anthropic-ai/claude-code@latest, а не npm update -g. Homebrew — brew upgrade claude-code, WinGet — winget upgrade Anthropic.ClaudeCode.

Как полностью удалить Claude Code?

Удалите бинарник способом, которым ставили: npm uninstall -g @anthropic-ai/claude-code, winget uninstall Anthropic.ClaudeCode или удаление ~/.local/bin/claude и ~/.local/share/claude. Затем, если нужно, удалите настройки ~/.claude и ~/.claude.json и переменные ANTHROPIC_* из профиля оболочки.

Как установить Claude Code на Windows, macOS и Linux в России

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

Установите Node.js 22 или новее и выполните в PowerShell npm install -g @anthropic-ai/claude-code. Проверьте установку командой claude --version. Альтернатива — нативный установщик irm https://claude.ai/install.ps1 | iex, но из России он может вернуть ошибку региона. Права администратора не нужны.

Коротко: как установить Claude Code за пять минут

Claude Code — это CLI-агент Anthropic: он запускается в терминале командой claude, читает проект, правит файлы и выполняет команды. Сам инструмент бесплатный, платить нужно только за доступ к модели — подпиской или через API.

Самый надёжный способ установки из России — через npm: пакет @anthropic-ai/claude-code скачивается из реестра npm, а не с серверов Anthropic, которые для российских IP могут отвечать ошибкой «App unavailable in region». Нативный установщик тоже рабочий вариант, но только если его скрипт у вас открывается.

Дальше Claude Code нужно подключить к модели. В России для этого задают две переменные окружения — адрес Anthropic-совместимого шлюза и токен — и запускают claude в папке проекта. Весь путь выглядит так:

# 1. Установка (Windows, macOS, Linux)
npm install -g @anthropic-ai/claude-code

# 2. Подключение к модели (macOS / Linux / WSL / Git Bash)
export ANTHROPIC_BASE_URL="https://claude-gateway.ru/api"
export ANTHROPIC_AUTH_TOKEN="ваш_токен_из_кабинета"

# 3. Запуск в папке проекта
cd ~/projects/my-app
claude

Подробнее: Claude Code в России: подключение без VPN

Что нужно перед установкой: система и Node.js

Официальные системные требования Anthropic: macOS 13 и новее, Windows 10 (1809+) или Windows Server 2019+, Ubuntu 20.04+, Debian 10+, Alpine 3.19+. Процессор x64 или ARM64, не меньше 4 ГБ оперативной памяти и оболочка Bash, Zsh, PowerShell или CMD. 32-битная Windows не поддерживается.

Node.js нужен только для установки через npm. Начиная с версии 2.1.198 пакет официально требует Node.js 22 или новее. На более старой версии npm покажет предупреждение EBADENGINE, но установка, как правило, завершится: пакет ставит нативный бинарник, который во время работы Node.js не использует. Чтобы не ловить странные ошибки, лучше сразу поставить актуальную LTS-версию Node.js.

Для нативного установщика Node.js не нужен вовсе — скрипт сам скачивает готовый бинарник. Проверить, что у вас уже есть, можно двумя командами:

Windows: Node.js ставится установщиком с nodejs.org или через winget install OpenJS.NodeJS.LTS.
macOS: установщик с nodejs.org или brew install node.
Linux и VPS: пакет из репозитория NodeSource или менеджер версий nvm — системный nodejs в старых дистрибутивах часто слишком старый.

node --version   # нужна v22 или новее для npm-установки
npm --version

Установка через npm: универсальный способ для России

Команда одинаковая для всех систем. npm подтягивает платформенный пакет (например, @anthropic-ai/claude-code-win32-x64 или -linux-x64) и связывает бинарник claude. Менеджер пакетов должен разрешать optional-зависимости — если вы их отключали, бинарник не установится.

Не запускайте установку через sudo npm install -g: это прямо не рекомендует Anthropic, потому что так появляются проблемы с правами и автообновлением. Если npm ругается на EACCES в Linux или macOS, перенастройте глобальную папку npm на домашний каталог или используйте nvm — тогда sudo не понадобится.

Если после установки claude «не найден», значит, папка глобальных пакетов npm не в PATH — см. раздел про Windows ниже.
Команда claude doctor ничего не меняет, а только показывает состояние установки, ошибки в файлах настроек и подсказки по исправлению.

# установка
npm install -g @anthropic-ai/claude-code

# проверка
claude --version     # выведет что-то вроде 2.1.xxx (Claude Code)
claude doctor        # диагностика установки и настроек

Нативный установщик, Homebrew и WinGet

Официально Anthropic рекомендует нативный установщик: он ставит бинарник в ~/.local/bin (на Windows — в %USERPROFILE%\.local\bin) и обновляет его в фоне. Но скрипт и сами бинарники скачиваются с доменов Anthropic, и из России они могут вернуть HTML-страницу вместо скрипта, ошибку 403 или «syntax error near unexpected token '<'». Это не поломка компьютера, а региональное ограничение — в таком случае просто используйте npm.

Homebrew-cask и пакет WinGet скачивают тот же бинарник, поэтому могут упереться в то же ограничение. Кроме того, эти способы не обновляются автоматически — обновлять их придётся вручную.

Ошибка «The token '&&' is not a valid statement separator» — вы вставили CMD-команду в PowerShell.
Ошибка «'irm' is not recognized» — наоборот, PowerShell-команда в CMD. В PowerShell строка начинается с PS C:\.

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

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

# Homebrew (macOS)
brew install --cask claude-code

# WinGet (Windows)
winget install Anthropic.ClaudeCode

Claude Code на Windows: PowerShell, Git Bash, WSL и PATH

На Windows у Claude Code два режима. Нативный: ставите из PowerShell или CMD, права администратора не нужны. Если установлен Git for Windows, агент выполняет команды через Git Bash, если нет — через PowerShell. Git for Windows ставить не обязательно, но с ним агент увереннее работает с bash-скриптами и git.

Режим WSL: Claude Code ставится и запускается внутри дистрибутива Linux, как на обычной Linux-машине. Этот вариант удобнее, если проект и тулчейн живут в Linux, а WSL 2 дополнительно поддерживает песочницу для команд. Важно: переменные окружения Windows внутрь WSL сами не попадают — их нужно задавать в ~/.bashrc уже в WSL.

Самая частая проблема на Windows — «claude : The term 'claude' is not recognized». Она значит, что папки с бинарником нет в PATH. Для npm-установки это обычно %APPDATA%\npm, для нативной — %USERPROFILE%\.local\bin. Проверьте и добавьте нужную папку в пользовательский PATH, затем откройте новое окно терминала:

Если Claude Code не находит Git Bash, укажите путь в настройках: переменная CLAUDE_CODE_GIT_BASH_PATH со значением C:\Program Files\Git\bin\bash.exe в блоке env файла settings.json.
Если установлено приложение Claude Desktop, оно может перехватывать команду claude — проверьте, какой именно claude.exe находится первым в PATH.

# где npm хранит глобальные пакеты
npm config get prefix

# есть ли папка нативной установки в PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# добавить папку нативной установки в PATH пользователя
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

macOS, Linux и установка Claude Code на VPS

На macOS и Linux установка через npm не отличается от Windows. Если после нативной установки команда не находится, добавьте ~/.local/bin в PATH: на macOS по умолчанию оболочка Zsh, поэтому строка идёт в ~/.zshrc, на Linux — в ~/.bashrc.

На VPS (Ubuntu, Debian) Claude Code работает так же, как на рабочей машине: вы подключаетесь по SSH и запускаете claude в папке проекта. Браузерный логин на сервере не нужен — при работе через токен в переменных окружения окно входа не появляется. Учтите требование к памяти: на серверах меньше 4 ГБ RAM установка может быть убита системой, помогает swap-файл. Чтобы сессия не обрывалась при разрыве SSH, запускайте агента внутри tmux или screen.

# Ubuntu / Debian VPS: Node.js 22 через nvm и Claude Code
# (nvm ставится по инструкции из репозитория github.com/nvm-sh/nvm)
nvm install 22
npm install -g @anthropic-ai/claude-code

# если claude не находится после нативной установки
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# работа в устойчивой сессии
tmux new -s claude
cd /srv/my-app && claude

Как запустить Claude Code в России: переменные окружения

После установки Claude Code при первом запуске предлагает войти в аккаунт Anthropic. Из России это упирается в две стены: регион не поддерживается, а подписку и API-баланс нельзя оплатить российской картой. Поэтому вместо логина агенту дают готовый доступ через переменные окружения: ANTHROPIC_BASE_URL задаёт адрес API, ANTHROPIC_AUTH_TOKEN — токен, который уходит в заголовке Authorization: Bearer. Когда токен задан, окно входа не появляется.

Для нашего шлюза это адрес https://claude-gateway.ru/api и токен из личного кабинета, который выпускается после оплаты тарифа в рублях. Адрес указывается без /v1 на конце — Claude Code сам добавляет /v1/messages. Шлюз — независимый сервис, не аффилированный с Anthropic; он проксирует запросы в формате Anthropic API, поэтому сам Claude Code остаётся официальным и немодифицированным.

Переменные, заданные командой export или $env:, живут до закрытия окна терминала. Для первого запуска это удобно, а постоянную настройку разберём в следующем разделе.

# macOS / Linux / WSL / Git Bash
export ANTHROPIC_BASE_URL="https://claude-gateway.ru/api"
export ANTHROPIC_AUTH_TOKEN="ваш_токен_из_кабинета"
claude

# Windows PowerShell
$env:ANTHROPIC_BASE_URL = "https://claude-gateway.ru/api"
$env:ANTHROPIC_AUTH_TOKEN = "ваш_токен_из_кабинета"
claude

# Windows CMD
set ANTHROPIC_BASE_URL=https://claude-gateway.ru/api
set ANTHROPIC_AUTH_TOKEN=ваш_токен_из_кабинета
claude

Подробнее: Документация шлюза: переменные и endpoint · API-ключ, прокси и base URL в Claude Code: все варианты

Как сохранить настройки навсегда: профиль оболочки, setx и settings.json

Есть три способа, и они не взаимоисключающие. Первый — профиль оболочки: строки export добавляются в ~/.zshrc (macOS) или ~/.bashrc (Linux, WSL, Git Bash). Второй — переменные пользователя Windows через setx: они появятся во всех новых окнах PowerShell и CMD, текущее окно нужно перезапустить.

Третий, самый надёжный — блок env в файле настроек Claude Code ~/.claude/settings.json (на Windows %USERPROFILE%\.claude\settings.json). Claude Code читает его сам, поэтому настройки работают независимо от того, из какого терминала или IDE он запущен, в том числе для фоновых агентов. Если одна и та же переменная задана и в оболочке, и в settings.json, приоритет у файла настроек.

Не кладите токен в .claude/settings.json внутри проекта — этот файл коммитится в репозиторий и становится виден всем. Для настроек одного проекта есть .claude/settings.local.json — его тоже стоит добавить в .gitignore.

# macOS (zsh)
echo 'export ANTHROPIC_BASE_URL="https://claude-gateway.ru/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="ваш_токен"' >> ~/.zshrc
source ~/.zshrc

# Windows (PowerShell или CMD), затем откройте новое окно
setx ANTHROPIC_BASE_URL "https://claude-gateway.ru/api"
setx ANTHROPIC_AUTH_TOKEN "ваш_токен"

# ~/.claude/settings.json — работает на любой ОС
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://claude-gateway.ru/api",
    "ANTHROPIC_AUTH_TOKEN": "ваш_токен"
  }
}

Первый запуск и проверка подключения

Перейдите в папку проекта и выполните claude. При первом запуске агент попросит выбрать тему оформления и подтвердить, что вы доверяете этой папке, — после этого откроется интерактивная сессия. Напишите любую просьбу обычным текстом, например «опиши структуру проекта». Если пришёл ответ, подключение работает.

Внутри сессии команда /status показывает, куда реально уходят запросы: строка Anthropic base URL должна содержать адрес шлюза, а источником авторизации — быть ANTHROPIC_AUTH_TOKEN. Если там старый логин, выполните /logout. Модель переключается командой /model — для повседневной работы обычно хватает claude-sonnet-5, а claude-opus-5-5 стоит включать на сложных задачах.

Если что-то не работает, проверьте шлюз напрямую запросом из терминала — так станет понятно, в чём проблема: в сети и токене или в настройках Claude Code.

Команды, CLAUDE.md и приёмы ежедневной работы — в отдельном гайде для начинающих.
Разбор ошибок 401, 403, 404, «App unavailable in region» и других — в статье про ошибки и блокировки.

curl -sS https://claude-gateway.ru/api/v1/messages \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-haiku-4-5", "max_tokens": 16, "messages": [{"role": "user", "content": "ping"}]}'

# ответ с "id":"msg_... — токен и адрес в порядке
# 401 — неверный токен; 404 — ошибка в адресе (например, лишний /v1)

Подробнее: Как пользоваться Claude Code: команды и CLAUDE.md · Ошибки Claude Code и как их исправить · Какую модель выбрать в Claude Code

Как обновить и как удалить Claude Code

Способ обновления зависит от способа установки. Нативная установка обновляется в фоне сама, а вручную — командой claude update. Для npm Anthropic рекомендует переустановку с тегом latest, а не npm update -g: последняя команда учитывает старый диапазон версий и может не поднять вас до свежего релиза. Homebrew и WinGet обновляются только своими командами. Если фоновое обновление из России не проходит, используйте npm — реестр npm доступен.

Удаление тоже зависит от способа установки. После удаления самого бинарника останутся настройки, история сессий и конфигурации MCP в ~/.claude и ~/.claude.json — удаляйте их, только если хотите начать с чистого листа. Расширение VS Code, плагин JetBrains и Desktop-приложение тоже пишут в ~/.claude, поэтому при полном удалении сначала уберите их. И не забудьте удалить переменные ANTHROPIC_* из профиля оболочки или переменных Windows.

# обновление
claude update                                    # нативная установка
npm install -g @anthropic-ai/claude-code@latest  # npm
brew upgrade claude-code                         # Homebrew
winget upgrade Anthropic.ClaudeCode              # WinGet

# удаление
npm uninstall -g @anthropic-ai/claude-code       # npm
rm -f ~/.local/bin/claude && rm -rf ~/.local/share/claude   # нативная, macOS/Linux/WSL
winget uninstall Anthropic.ClaudeCode            # WinGet

# полная очистка настроек (macOS/Linux)
rm -rf ~/.claude
rm ~/.claude.json

Подробнее: Тарифы на доступ к модели в рублях