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

Node.js для Claude Code: какая версия нужна и как обойтись без него

Для установки через npm требуется Node.js 18 или новее — node -v для проверки; nvm (nvm install --lts) для исправления. Устаревшая версия Node — самая частая причина, по которой Claude Code не запускается после установки. Если Node не входит в ваш набор инструментов, обойдитесь без него: нативный установщик ниже поставляет автономный исполняемый файл с автоматическим обновлением.

Вариант 1 — npm (любая ОС с Node.js 18 или новее)

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

Если npm install -g завершается с ошибкой EACCES на macOS или Linux, не используйте sudo — вместо этого исправьте префикс npm: npm config set prefix ~/.npm-global и добавьте ~/.npm-global/bin в PATH. В Windows запускайте установку из обычного терминала без прав администратора.

Вариант 2 — нативный установщик для Mac, Linux и Windows (без Node.js)

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

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

# Windows CMD (the one-liner people search for)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Установка Claude Code на Linux и Ubuntu

На Ubuntu, Debian, Fedora или любом другом дистрибутиве нативный установщик (curl -fsSL https://claude.ai/install.sh | bash) помещает автоматически обновляемый исполняемый файл в домашний каталог и не требует ни прав root, ни Node.js. Если вы предпочитаете npm, сначала установите Node 18 или новее из NodeSource либо через nvm — версия Node из apt в Ubuntu обычно слишком старая — затем npm install -g @anthropic-ai/claude-code. На сервере, доступном только через терминал, или в контейнере лучше использовать нативный исполняемый файл; добавьте две переменные шлюза в ~/.bashrc , и через SSH всё будет работать так же, как локально.

Нативная сборка обновляется автоматически и позволяет избежать конфликтов версий Node. Это лучший выбор для компьютеров, где Node ещё не входит в набор используемых инструментов.

Вариант 3 — настольное приложение или расширение IDE

Настольное приложение Claude включает Claude Code, а расширения для VS Code и JetBrains устанавливают CLI при первом использовании. Возможности и ограничения каждого интерфейса описаны в руководстве по веб-версии, настольному приложению и IDE.

Примечания для Windows

Claude Code работает нативно в Windows 10/11 (PowerShell или Git Bash) и внутри WSL. WSL удобнее для проектов, рассчитанных на оболочку Unix. Если claude не найден после установки через npm в Windows, откройте новый терминал, чтобы PATH был прочитан заново, либо проверьте npm config get prefix и добавьте соответствующую папку bin .

Запуск Claude Code без входа в аккаунт: аутентификация с API-ключом

Выполните claude и выберите /login , чтобы войти с подпиской Claude Pro/Max, — или полностью пропустите вход. Если задана переменная ANTHROPIC_API_KEY (или ANTHROPIC_AUTH_TOKEN), Claude Code не показывает экран входа и работает локально с эндпоинтом, указанным в ANTHROPIC_BASE_URL; так же он запускается на компьютерах, где невозможно открыть браузер. Для этого шлюза используйте вариант с ключом:

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key   # or ANTHROPIC_AUTH_TOKEN
claude

Добавьте эти две строки в ~/.zshrc, ~/.bashrc или в свой профиль PowerShell, чтобы они применялись в каждом новом терминале. В Claude Code команда /status показывает, какой эндпоинт и ключ используются.

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

claude update                      # native / self-update
npm update -g @anthropic-ai/claude-code   # npm install
npm uninstall -g @anthropic-ai/claude-code

Если установка прошла успешно, но Claude Code не запускается

• command not found → PATH: откройте новую оболочку или добавьте каталог глобальных исполняемых файлов npm.
• Node version ошибки → требуется Node.js 18 или новее; node -v для проверки либо перейдите на нативный установщик.
• Зависает при первом запуске → корпоративный прокси; задайте HTTPS_PROXY или базовый URL шлюза, если ваша сеть блокирует api.anthropic.com.
• 401 / недействительный ключ → если ANTHROPIC_BASE_URL указывает сюда, нужно использовать ключ шлюза; ключ из консоли Anthropic будет отклонён.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Часто задаваемые вопросы

AI Prime Tech — независимый API-шлюз, который не связан с Anthropic, не одобрен и не спонсируется этой компанией. «Claude» и «Claude Code» — товарные знаки Anthropic. Описанные здесь возможности Claude Code соответствуют публичной документации Anthropic на момент написания и часто меняются; цены и списки моделей на этой странице берутся из текущих настроек шлюза.