Установка Claude Code: полная инструкция для Windows, Mac, Linux, VS Code и VPS

Claude Code — инструмент от Anthropic, который выполняет задачи автономно: редактирует файлы, запускает команды, работает с проектами. В этой статье — пошаговая установка на любую систему и запуск на VPS для работы 24/7.

Требования

• macOS, Linux или Windows (WSL) — для CLI-версии
• Windows или Mac — для десктопного приложения
• Node.js 18+ — для установки через npm
• Подписка Claude Pro (от $20/мес) или API-ключ Anthropic

Шаг 1: Оформите подписку Claude

Claude Code работает с платными подписками:

• Claude Pro — $20/мес, подходит для старта
• Claude Max — от $100/мес, расширенные лимиты

Как оформить:

1. Перейдите на claude.ai
2. Создайте аккаунт или войдите
3. Профиль → Subscription → выберите план
4. Оплатите зарубежной или виртуальной картой

Шаг 2: Установка

Выберите способ под вашу систему:

Способ 1: Приложение Claude (самый простой)

1. Перейдите на claude.ai/download
2. Скачайте версию для вашей системы (Mac или Windows)
3. Установите как обычную программу
4. Откройте приложение, войдите в аккаунт
5. Перейдите на вкладку Code — Claude Code уже встроен

Способ 2: VS Code (рекомендуем для работы с проектами)

1. Скачайте и установите VS Code
2. Откройте VS Code
3. Extensions: Cmd+Shift+X на Mac, Ctrl+Shift+X на Windows
4. Найдите «Claude Code» от Anthropic
5. Нажмите Install
6. Кликните на иконку Claude в боковой панели
7. Sign In → браузер → войдите в аккаунт Claude

Способ 3: Терминал CLI (Mac / Linux / Windows WSL)

Установка через npm:

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

Проверка:

claude --version

Если command not found — перезапустите терминал.

Установка Node.js если не установлен:

Шаг 3: Авторизация

Вариант А: Через подписку (рекомендуется)

1. Запустите в терминале: claude
2. Откроется браузер с запросом авторизации
3. Нажмите Authorize
4. Вернитесь в терминал — готово ✅

Вариант Б: Через API-ключ

1. Зарегистрируйтесь на console.anthropic.com
2. API Keys → создайте ключ
3. Установите переменную окружения:

Mac / Linux:

export ANTHROPIC_API_KEY="sk-ant-..."
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc

Windows (PowerShell):

$env:ANTHROPIC_API_KEY="sk-ant-..."
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY","sk-ant-...","User")

Шаг 4: Проверка работы

claude

Привет, кто ты?

Если Claude ответил — всё работает ✅

Установка на VPS-сервер (работа 24/7)

Шаг 1: Покупка VPS

Рекомендуем Beget. Минимальная конфигурация: 2 CPU, 2 ГБ RAM — от 22 ₽/день.

Выбор локации — важно: выбирайте Латвию или любой европейский датацентр, не Россию. Claude API недоступен с российских IP.

ОС: Ubuntu 24.04 LTS — все команды ниже написаны под неё.

Шаг 2: Подключение по SSH

Mac / Linux / Windows PowerShell:

ssh root@ВАШ_IP_АДРЕС

При первом подключении введите yes на вопрос про fingerprint, затем пароль (символы не отображаются — это нормально).

Шаг 3: Обновление системы

apt update && apt upgrade -y

Шаг 4: Установка Node.js 22

curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
apt install -y nodejs

node -v  # v22.x.x
npm -v   # 10.x.x

Шаг 5: Установка Claude Code

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

Жёлтые строки npm warn deprecated — нормально, ни на что не влияют. Дождитесь added XXX packages.

claude --version

Шаг 6: Авторизация на VPS

Через API-ключ (рекомендуется для VPS):

export ANTHROPIC_API_KEY="sk-ant-..."
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.bashrc

Через подписку Pro/Max: установите Claude Code на своём компьютере, получите токен командой claude setup-token, затем авторизуйтесь на VPS через claude auth login.

Шаг 7: Проверка

claude "Кто ты? Ответь одним предложением."

Шаг 8: Автозапуск через systemd

nano /etc/systemd/system/claude-agent.service

Вставьте (замените путь и API-ключ):

[Unit]
Description=Claude Code Agent
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/root/my-project
ExecStart=/usr/bin/claude "выполни задачи из tasks.md"
Restart=on-failure
Environment=ANTHROPIC_API_KEY=sk-ant-...

[Install]
WantedBy=multi-user.target

Сохраните: Ctrl+O → Enter → Ctrl+X. Запустите:

systemctl daemon-reload && systemctl enable claude-agent && systemctl start claude-agent
systemctl status claude-agent  # Должно быть: active (running)

Шаг 9: Базовая защита сервера

# Файрвол
apt install -y ufw && ufw allow 22/tcp && ufw enable

# Защита от брутфорса
apt install -y fail2ban && systemctl enable fail2ban

# Автообновления безопасности
apt install -y unattended-upgrades && dpkg-reconfigure -plow unattended-upgrades

Полезные команды

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

«command not found» после установки
Перезапустите терминал. Проверьте: npm list -g @anthropic-ai/claude-code. Если пусто — переустановите.

«authentication error»
Повторная авторизация: claude auth login

Медленные ответы
Зависит от модели: Sonnet быстрее, Opus умнее. Для большинства задач хватает claude-sonnet-4-6.

Не устанавливается пакет npm
Проверьте node --version — нужна версия 18+. Обновите с nodejs.org.

Windows: нет WSL
В PowerShell от администратора: wsl --install, перезагрузите, установите Node.js внутри WSL.

На VPS: не подключается к API
Убедитесь что сервер в Европе — не в России. Проверьте ключ: echo $ANTHROPIC_API_KEY.