Claude Code устанавливается одной командой в терминале - без Node.js, без npm, без настройки PATH вручную. В октябре 2025 года Anthropic выпустил нативный установщик, и с тех пор это единственный официально рекомендованный способ. Большинство русскоязычных гайдов до сих пор показывают старый npm-метод, который теперь считается устаревшим.
В этой статье: пошаговая установка Claude Code на Mac, Windows и Linux, первый запуск, авторизация, типичные ошибки и как их чинить. Все команды актуальны на апрель 2026 года.
Что такое Claude Code и зачем его устанавливать
Claude Code - это AI-агент для разработки от Anthropic, который работает прямо в терминале. Не плагин в IDE, а отдельный инструмент, который видит весь проект целиком: читает файлы, запускает команды, пишет и редактирует код, делает коммиты в Git.
Главное отличие от встроенных AI-ассистентов - он не привязан к конкретному редактору. Запустить можно в VS Code, Cursor, PyCharm, Vim или вообще без IDE - прямо в терминале. Для Cursor и Windsurf Claude Code - это не замена, а другой уровень: агент, который управляет проектом целиком, а не просто подсказывает код внутри файла.
Под капотом работает Claude Sonnet 4.6 для обычных задач и Opus 4.7 для сложных архитектурных решений. Контекстное окно - 200 000 токенов, примерно 150 000 слов или небольшой проект целиком.
Для кого это инструмент. Если вы разработчик и хотите ускориться - Claude Code берет на себя рутину: написать тесты, отрефакторить функцию, разобраться в чужом коде, добавить фичу по описанию. Если вы не разработчик, но строите продукты через вайбкодинг - Claude Code работает на уровне всего проекта. Попросить "сделай вход через Google" и он сам найдет нужные файлы, напишет код, поправит конфиги.
Бесплатный план Claude.ai Claude Code не включает. Нужен минимум Claude Pro.
Какой план подписки выбрать
Прежде чем качать установщик, определитесь с планом. От него зависит, какие модели доступны и как часто будут срабатывать лимиты.
| План | Цена | Модели в Claude Code | Лимиты |
|---|---|---|---|
| Claude Pro | $20/мес | Sonnet 4.6, Haiku 4.5 | Умеренные, хватает для нескольких часов работы |
| Claude Max 5x | $100/мес | Sonnet 4.6, Opus 4.7, Haiku 4.5 | В 5 раз выше Pro |
| Claude Max 20x | $200/мес | Все модели | В 20 раз выше Pro |
| API (Console) | По токенам | Все модели | Без фиксированных лимитов, платите за использование |
Claude Pro подходит для старта. Если через пару часов интенсивной работы ощущаете лимиты - смотрите на Max. Для CI/CD и серверов используйте API-ключ через console.anthropic.com.
Максим: "На NanaBanana начинали с Claude Pro по $20. Для разработки и тестирования хватало. Когда начали параллельно вести несколько задач - перешли на Max 5x. Вот тут разница заметна: лимиты не мешают, Opus 4.7 дает заметно лучшие архитектурные решения. Но для первого месяца работы Pro точно достаточно - проверено."
Что нужно до установки
Нативный установщик почти не требует предустановленного ПО.
Операционная система:
- macOS 13 Ventura или новее
- Ubuntu 20.04+, Debian 10+ или другой современный Linux
- Windows 10 версии 1809 или Windows 11
Дополнительно для Windows: нужен Git для Windows (git-scm.com). Claude Code использует Git Bash внутри для выполнения команд. Без него часть функционала агента не работает.
Интернет: обязателен. Запросы идут на серверы Anthropic, GPU на вашей машине не используется.
RAM: от 4 ГБ, рекомендуется 8 ГБ для больших кодовых баз.
Node.js для нативного установщика не нужен совсем. Это главное изменение 2025-2026 года по сравнению со старыми инструкциями - большинство гайдов в поиске до сих пор про npm.
Как установить Claude Code на Mac
На Mac три варианта: нативный установщик через curl, Homebrew и npm. Нативный - приоритетный.
Нативный curl - рекомендуется
Откройте Terminal. Можно найти через Spotlight: Command + Space, напишите "Terminal".
Запустите:
curl -fsSL https://claude.ai/install.sh | bashСкрипт скачает бинарный файл под вашу архитектуру (Apple Silicon или Intel), разместит в ~/.local/bin и настроит PATH. Процесс занимает меньше минуты.
В конце появится сообщение об успешной установке. Там будет команда для добавления Claude Code в .zshrc - скопируйте и запустите её. Это нужно, чтобы claude работал в любой папке после перезапуска терминала.
Затем:
source ~/.zshrc
claude --versionВидите номер версии - готово. Нативный установщик обновляется самостоятельно в фоне при каждом запуске Claude Code.
Homebrew
brew install --cask claude-codeРаботает, но автообновлений нет. При каждом новом релизе нужно вручную:
brew upgrade claude-codenpm - только для пиннинга версии
npm install -g @anthropic-ai/claude-codeТребует Node.js 18+. Метод официально устарел, но продолжает работать. Выбирайте только если есть конкретная причина пиннить версию для CI/CD.
Если после npm-установки команда claude не найдена:
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Как установить Claude Code на Windows
На Windows два подхода: нативная установка через PowerShell и через WSL. WSL дает более стабильную среду и доступ к Linux-инструментарию. Нативная Windows проще, если WSL не нужен.
Нативный установщик через PowerShell
Откройте PowerShell. Строка ввода начинается с PS C:\. Если видите просто C:\ без PS - это CMD, закройте и откройте PowerShell.
irm https://claude.ai/install.ps1 | iexСкачивает и запускает скрипт установки. Права администратора не нужны.
Если появляется ошибка про execution policy:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserЗапустите эту команду, затем снова команду установки.
После установки скачайте Git для Windows с git-scm.com. Принимайте все дефолтные настройки. Закройте и откройте PowerShell заново:
claude --versionЧерез WinGet
winget install Anthropic.ClaudeCodeРаботает на Windows 11. Автообновлений нет, при новых версиях запускайте:
winget upgrade Anthropic.ClaudeCodeЧерез WSL для работы с Linux-проектами
WSL позволяет запустить Ubuntu внутри Windows без виртуальной машины. Claude Code в WSL ведет себя как на настоящем Linux - стабильнее и предсказуемее.
Если WSL не установлен - откройте PowerShell от администратора:
wsl --install -d UbuntuПерезагрузитесь. После перезагрузки откройте Ubuntu из меню Пуск, задайте имя пользователя и пароль.
Внутри Ubuntu-терминала:
curl -fsSL https://claude.ai/install.sh | bash
source ~/.bashrc
claude --versionДиски Windows доступны внутри WSL через /mnt/: диск C - это /mnt/c/, диск D - /mnt/d/.
Важный нюанс: Node.js на основном Windows и Node.js внутри WSL - разные окружения. Если используете npm-метод через WSL, ставьте Node.js именно внутри WSL, а не снаружи.
Как установить Claude Code на Linux и Ubuntu
На Linux работает нативный установщик и официальные репозитории для системных пакетных менеджеров.
Нативный установщик
curl -fsSL https://claude.ai/install.sh | bashБинарник попадает в ~/.local/bin, PATH настраивается для bash и zsh. После установки:
source ~/.bashrc
claude --version
claude doctorclaude doctor - встроенная диагностика. Проверяет авторизацию, PATH, конфиги и MCP-серверы. Хорошая привычка - запускать после каждой установки.
Через apt для Ubuntu и Debian
curl -fsSL https://packages.claude.ai/claude-code/keys/gpg.pub | sudo gpg --dearmor -o /usr/share/keyrings/claude-code.gpg
echo "deb [signed-by=/usr/share/keyrings/claude-code.gpg] https://packages.claude.ai/claude-code stable main" | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-codeАвтообновления через этот метод не работают. Обновления приходят через sudo apt upgrade.
Через dnf для Fedora и RHEL
sudo dnf config-manager --add-repo https://packages.claude.ai/claude-code/rpm/stable/claude-code.repo
sudo dnf install claude-codeAlpine Linux и Docker-контейнеры
Alpine используется в Docker-образах. Там Claude Code устанавливается через apk. Для серверных сценариев без браузера используйте API-ключ вместо OAuth-авторизации.
Сравнение всех методов установки
| Метод | Node.js нужен | Автообновление | Платформа | Когда выбирать |
|---|---|---|---|---|
| curl (нативный) | Нет | Да | Mac, Linux, WSL | Первый выбор для всех |
| PowerShell irm | Нет | Да | Windows | Нативная Windows |
| Homebrew | Нет | Нет | Mac | Уже используете Homebrew |
| WinGet | Нет | Нет | Windows | Предпочитаете WinGet |
| apt/dnf/apk | Нет | Через систему | Linux | Системное управление пакетами |
| npm | Да (18+) | Нет | Все | CI/CD с конкретной версией |
Первый запуск и авторизация
После установки запустите в папке проекта:
cd /путь/к/проекту
claudeПри первом запуске два шага.
Выбор темы - светлая или тёмная. Визуальная настройка, меняется через /theme в любой момент.
Авторизация - откроется браузер с OAuth-страницей Anthropic. Войдите в аккаунт. Claude Code получит токен и сохранит локально. Повторно авторизовываться не нужно.
Для серверов и CI/CD без браузера - API-ключ из console.anthropic.com:
export ANTHROPIC_API_KEY=sk-ant-ваш-ключ
claudeПосле авторизации Claude Code спросит, доверяете ли файлам в текущей папке. Жмите "Trust" - стандартная проверка безопасности при первом открытии проекта.
Первые настройки после запуска
/terminal setupВключает Shift+Enter для многострочного ввода. Без этого Enter сразу отправляет сообщение - неудобно для длинных промптов.
/modelПроверьте активную модель. По умолчанию Sonnet 4.6 - хорошая отправная точка. Opus 4.7 для сложных задач, Haiku 4.5 для быстрых и простых.
/contextПокажет использование токенов (лимит 200K). Если контекст раздулся за длинную сессию - очистите через /clear.
Полезные команды:
| Команда | Что делает |
|---|---|
| /help | Все доступные команды |
| /model | Переключить модель |
| /context | Посмотреть использование токенов |
| /clear | Очистить контекст |
| /terminal setup | Включить Shift+Enter |
| claude doctor | Диагностика системы |
| claude --dangerously-skip-permissions | YOLO-режим без подтверждений |
Режим --dangerously-skip-permissions - агент редактирует файлы и запускает команды без запросов разрешения. Удобно для доверенных проектов, но сознательно: агент может изменить что угодно.
Интеграция с IDE
Claude Code работает в любом терминале. В VS Code есть официальное расширение - вы видите diff изменений кода прямо в редакторе, не в терминале. Расширение называется "Claude Code" в маркетплейсе VS Code. Часто устанавливается автоматически при первом запуске claude в терминале VS Code.
Для PyCharm - расширение есть в JetBrains Marketplace, пока в бете.
Cursor, Windsurf и другие AI-IDE - запускайте Claude Code во встроенном терминале редактора.
Частые ошибки и их решение
claude: command not found после установки
Терминал не перезагружен, PATH не обновился. Закройте и откройте терминал. Или:
source ~/.zshrc # Mac с zsh
source ~/.bashrc # Linux/Mac с bashОшибка Execution Policy на Windows
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserПосле этого повторите команду установки.
npm EACCES: permission denied
Не используйте sudo npm install. Переключитесь на нативный установщик - без Node.js и без проблем с правами.
claude doctor показывает auth error
Токен авторизации слетел. Запустите claude и пройдите авторизацию через браузер заново.
Скачивание зависает или curl не работает
Проверьте соединение. Для российских пользователей в ряде случаев нужен VPN при скачивании с claude.ai. Альтернатива - установить через npm или apt/dnf.
Claude Code не видит Git на Windows
Убедитесь, что Git для Windows установлен. После установки перезапустите терминал. Если не помогло - пропишите путь в .claude/settings.json в проекте:
{
"env": {
"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
}
}Версия Node.js ниже 18 для npm-метода
node -vЕсли ниже 18 - обновите через nvm или просто переключитесь на нативный установщик, который Node.js не требует вообще.
Как настроить CLAUDE.md для лучшей работы агента
Это один из самых недооцененных шагов после установки. Claude Code читает файл CLAUDE.md из корня проекта при каждом запуске - и сразу понимает контекст без лишних объяснений.
Создайте его в корне проекта:
touch CLAUDE.mdЧто писать внутри - зависит от проекта. Минимальная структура:
## Проект
Next.js 14 приложение, App Router, TypeScript. Backend - Supabase.
## Команды
- npm run dev - запуск на порту 3000
- npm run build - продакшн-сборка
- npm test - Jest тесты
- npm run lint - ESLint проверка
## Соглашения
- Серверные компоненты по умолчанию, "use client" только при необходимости
- Работа с БД только через Drizzle в серверных компонентах
- TypeScript strict mode, никаких any-типов
- Коммиты в повелительном наклонении, до 72 символовРазница с CLAUDE.md и без него заметна сразу. Без файла агент каждый раз спрашивает базовые вещи о проекте. С файлом - сразу работает в контексте вашего стека, соглашений и структуры.
Для монорепозиториев CLAUDE.md можно добавлять в каждую поддиректорию. Claude Code читает их иерархически: правила из корня работают везде, из поддиректории - только при работе в ней.
FAQ
Нужен ли Node.js для установки Claude Code в 2026 году?
Нет. Нативный установщик работает без Node.js: curl для Mac/Linux, irm для Windows. Node.js нужен только если специально выбираете npm-метод.
На каких операционных системах работает Claude Code?
macOS 13 Ventura и новее, Ubuntu 20.04+, Debian 10+, Windows 10 (1809) и Windows 11. macOS 12 Monterey и старше не поддерживается.
Как установить Claude Code на Ubuntu 22.04 без прав sudo?
curl -fsSL https://claude.ai/install.sh | bash - нативный установщик ставит в пользовательский ~/.local/bin без прав администратора.
Как обновить Claude Code до последней версии?
Нативный установщик обновляется автоматически в фоне. Homebrew - brew upgrade claude-code. npm - npm update -g @anthropic-ai/claude-code. apt - sudo apt upgrade claude-code.
Работает ли Claude Code на Mac M1/M2/M3?
Да. Нативный установщик определяет архитектуру и скачивает бинарник для ARM (Apple Silicon) или Intel автоматически.
Можно ли использовать Claude Code без подписки?
Нет. Бесплатный Claude.ai Claude Code не включает. Минимум - Pro за $20/мес. Есть пробный период при первой регистрации, но он ограничен.
Как запустить Claude Code на сервере без браузера?
Создайте API-ключ в console.anthropic.com и установите переменную окружения:
export ANTHROPIC_API_KEY=sk-ant-ваш-ключ
claudeГлоссарий
Нативный установщик - способ установки без дополнительных зависимостей. Claude Code скачивает готовый бинарник под вашу ОС и архитектуру.
npm - пакетный менеджер для Node.js. До октября 2025 был основным способом установки Claude Code, теперь устарел.
PATH - системная переменная со списком директорий, где ОС ищет исполняемые файлы. Если claude не найден после установки - PATH не обновился.
WSL (Windows Subsystem for Linux) - встроенная возможность Windows 10/11 запускать Linux без виртуальной машины.
OAuth - протокол авторизации. Claude Code использует его для входа через браузер без ввода пароля напрямую в терминал.
API-ключ - строка вида sk-ant-..., идентифицирует аккаунт при программных запросах. Нужен для CI/CD и серверов.
claude doctor - встроенная диагностика. Проверяет авторизацию, PATH, конфиги и MCP. Запускайте при любых проблемах.
CLAUDE.md - файл в корне проекта с инструкциями для агента. Claude Code читает его при каждом запуске: архитектура, команды запуска, соглашения команды.
MCP (Model Context Protocol) - протокол подключения внешних инструментов. Через MCP Claude Code получает доступ к базам данных, API, браузеру.
Контекстное окно - объем информации, который модель видит за один раз. У Claude Code - 200 000 токенов, примерно небольшой проект целиком.
Что дальше после установки
Установили - хорошо. Следующий шаг: создайте файл CLAUDE.md в корне проекта. Напишите туда, что это за проект, как запускать dev-сервер, как гонять тесты, основные соглашения по коду. Claude Code читает этот файл при каждом старте сессии и сразу понимает контекст без повторных объяснений. Разница заметна уже в первые 10 минут работы.
Подробный обзор Claude Code с разбором возможностей, сравнением с конкурентами и реальными кейсами читайте на странице инструмента.
Все актуальные AI-инструменты для вайбкодинга собраны в каталоге - 70+ инструментов с описаниями, ценами и сравнениями: GitHub Copilot, Aider, Lovable, Bolt и другие.
Если хотите разобраться, как встроить Claude Code в реальный рабочий процесс и строить продукты через вайбкодинг - запишитесь на консультацию к Максиму. Он работает с Claude Code с ранних бета-версий, и ведет несколько AI-продуктов с сотнями тысяч пользователей при нулевых затратах на рекламу.
Обновлено: март 2026