Установка Claude Code: Windows, Mac, Linux

3 минуты чтения · 35 просмотров

Алексей Воронов AI-инструменты · Koderra

Тестирует и описывает современные инструменты для разработчиков. Специализация — AI-ассистенты, автоматизация и CLI-инструменты.

17 апреля 2026

Warmly lit home office with dual screens for coding and programming. Perfect modern workspace for tech enthusiasts. — Claude Code · Установка

Claude Code — CLI-инструмент. Работает в терминале на macOS, Linux и Windows (через WSL или нативный инсталлятор). Ниже — пошаговая инструкция для каждой платформы.

Требования

Аккаунт Anthropic — нужна подписка Pro ($20/мес), Max или API-ключ
Node.js 18+ — только для npm-способа установки
ОС: macOS 10.15+, Ubuntu 20.04+ / Debian 10+, Windows 10+ (WSL) или Windows native
RAM: 4 ГБ минимум, 8 ГБ рекомендуется
GPU не нужен — всё считается на серверах Anthropic

macOS

Выберите любой из трёх способов:

Вариант 1 — Нативный инсталлятор (рекомендуется)

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

Вариант 2 — Homebrew

brew install --cask claude-code
claude --version

Вариант 3 — npm

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

Linux (Ubuntu / Debian)

Вариант 1 — Нативный инсталлятор

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

Вариант 2 — npm (Node.js 18+)

# Если Node.js ещё не установлен:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22 && nvm use 22

# Настройка директории для глобальных пакетов
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# Установка Claude Code
npm install -g @anthropic-ai/claude-code
claude --version

Windows

Вариант 1 — Нативный PowerShell (проще всего)

# Откройте PowerShell и выполните:
irm https://claude.ai/install.ps1 | iex
claude --version

Вариант 2 — WSL (Windows Subsystem for Linux)

# Шаг 1: Установите WSL (в PowerShell от администратора)
wsl --install

# Шаг 2: После перезагрузки откройте терминал WSL
# Шаг 3: Установите Claude Code командой Linux:
curl -fsSL https://claude.ai/install.sh | bash

⚠️ Windows + WSL: Node.js должен быть установлен внутри WSL, а не на Windows. Распространённая ошибка — установить Node.js на Windows и пытаться использовать его из WSL.

Авторизация

После установки запустите claude — откроется браузер для входа в аккаунт Anthropic. Если браузер не открывается (удалённый сервер, WSL):

# Авторизация через API-ключ
export ANTHROPIC_API_KEY=sk-ant-ваш-ключ
claude --version

Получить API-ключ можно в Anthropic Console.

Проверка установки

claude --version
# Вывод: claude 1.x.x

claude doctor
# Диагностирует конфигурацию и предлагает исправления

Обновление

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

# Homebrew
brew upgrade claude-code

# Нативный инсталлятор — обновляется автоматически

Частые проблемы

Ошибка	Решение
`command not found: claude`	Добавьте npm bin в PATH: `echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc`
`EACCES permission error`	Никогда не используйте `sudo npm`. Настройте глобальную директорию npm через nvm.
Node.js version too old	`nvm install 22 && nvm use 22`
Аутентификация не работает	Используйте `export ANTHROPIC_API_KEY=...` вместо браузерного входа
Полный сброс	`npm uninstall -g @anthropic-ai/claude-code && rm -rf ~/.claude && npm install -g @anthropic-ai/claude-code`

← Claude Code — главная · → Как пользоваться Claude Code

Первые шаги после установки

Сразу после установки — не начинайте работать без базовой настройки. Вот что опытные пользователи делают в первую очередь:

# 1. Перейдите в папку проекта
cd /path/to/your/project

# 2. Создайте CLAUDE.md (ключевой шаг!)
claude
> # Проект: MyApp, стек: PHP 8.3 + MariaDB, тесты: PHPUnit
> # Коммиты только на английском, PSR-12 style

# 3. Сразу настройте .claudeignore
cat > .claudeignore << EOF
node_modules/
vendor/
.git/
dist/
build/
*.log
coverage/
EOF

Первые 2–3 минуты настройки экономят часы работы позже.

nvm — рекомендуемый способ для npm-установки

Если вы устанавливаете Claude Code через npm, используйте nvm вместо системного Node.js. Это предотвращает большинство проблем с правами и версиями:

# Установка nvm (один раз)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc   # или source ~/.zshrc

# Установка свежего Node.js
nvm install 22
nvm use 22
nvm alias default 22

# Теперь устанавливайте без sudo
npm install -g @anthropic-ai/claude-code

Золотое правило: никогда не запускайте sudo npm install. Если npm требует sudo — значит, нужно исправить конфигурацию (nvm решает это автоматически), а не давать root-права.

Автообновление Claude Code

Claude Code обновляется часто — почти еженедельно. Способы следить за обновлениями:

# Проверить текущую версию
claude --version

# Обновить (npm)
npm update -g @anthropic-ai/claude-code

# Если вы хотите автообновление при каждом запуске
# добавьте в ~/.bashrc или ~/.zshrc:
alias claude="npm update -g @anthropic-ai/claude-code -q && claude"

Нативный инсталлятор (curl | bash) обновляется автоматически при каждом запуске — ничего делать не нужно.

Проверка успешной установки

claude doctor
# Пример успешного вывода:
# ✓ Claude Code v1.x.x installed
# ✓ API key configured
# ✓ Node.js v22.x.x
# ✓ Git available
# ✓ No MCP server errors

Если claude doctor показывает ошибки — исправляйте каждую по очереди. Обычно хватает первых двух пунктов из таблицы выше.