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

Что нужно для установки Claude Code

Claude Code — ИИ-агент Anthropic для работы с кодом. Он читает файлы проекта, правит их и запускает команды в терминале. Требования к компьютеру по документации:

• macOS 13.0 или новее;
• Windows 10 версии 1809 и новее или Windows Server 2019;
• Ubuntu 20.04, Debian 10, Alpine Linux 3.19 и новее;
• 4 ГБ оперативной памяти, процессор x64 или ARM64;
• оболочка Bash, Zsh, PowerShell или CMD и подключение к интернету.

Node.js для основного способа установки не нужен: установщик скачивает готовую программу. Node.js 22 или новее понадобится только тем, кто ставит Claude Code через npm.

Второе условие — аккаунт. Claude Code работает с тарифами Pro, Max, Team, Enterprise и с аккаунтом Claude Console, где оплата идет по API. Бесплатный тариф claude.ai доступа к Claude Code не дает. Как оплатить подписку или API из России, я разобрал отдельно в статье Claude Code в России, здесь повторять не буду. Сколько запросов дает каждый тариф, есть в разборе лимитов Claude.

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

В Терминале достаточно одной команды.

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

Пока идет загрузка, установщик ничего не пишет на экран. Программа ляжет в ~/.local/bin/claude. Когда команда закончит работу, откройте новое окно терминала, чтобы оболочка увидела новый путь.

Второй способ для Mac — Homebrew: brew install --cask claude-code. У Homebrew два варианта пакета. claude-code идет по стабильному каналу, он отстает от свежих версий примерно на неделю и пропускает выпуски с серьезными ошибками. claude-code@latest получает каждую версию в день выхода. Разница с установщиком в обновлениях: версия из Homebrew сама не обновляется, ее поднимают командой brew upgrade claude-code.

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

На Windows команда зависит от оболочки. В PowerShell строка приглашения начинается с PS C:\, в CMD буквы PS нет.

• в PowerShell irm https://claude.ai/install.ps1 | iex;
• в CMD curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd;
• через WinGet winget install Anthropic.ClaudeCode.

Права администратора не нужны. Если вы перепутали оболочку, Windows скажет об этом сама. Ошибка 'irm' is not recognized значит, что команду для PowerShell вставили в CMD, а The token '&&' is not a valid statement separator означает обратное.

Документация советует поставить Git for Windows. С ним Claude Code выполняет команды через Git Bash, без него переключается на PowerShell. Работать можно в обоих случаях, но инструменты Bash и Monitor требуют Git Bash.

Windows или WSL: что выбрать

Claude Code запускается прямо в Windows или внутри WSL, подсистемы Linux. Для проектов под Windows (.NET, PowerShell, 1С) подойдет обычная установка. Если проект собирается Linux-инструментами или нужна песочница для команд агента, ставьте в WSL 2: по документации песочница работает только там, в обычной Windows и WSL 1 ее нет. Внутри WSL используется команда для Linux, запускать ее нужно в терминале WSL, а не в PowerShell.

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

Для Ubuntu, Debian, Fedora и других дистрибутивов подходит та же команда, что и для Mac.

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

Для тех, кому удобнее системные пакеты, Anthropic держит подписанные репозитории для apt, dnf и apk. У каждого два канала, stable и latest. При такой установке Claude Code обновляется вместе с системой через sudo apt upgrade или аналог. Ключ репозитория и порядок подключения описаны в разделе Advanced setup документации, там же указан отпечаток ключа для проверки.

На Alpine перед установкой нужны пакеты: apk add bash curl libgcc libstdc++ ripgrep. После этого в настройках Claude Code задают переменную USE_BUILTIN_RIPGREP=0, чтобы поиск по файлам шел через системный ripgrep.

Установка через npm: когда она нужна

Команда npm install -g @anthropic-ai/claude-code ставит ту же программу, что и установщик. Нужен Node.js 22 или новее. Этот путь удобен, если на машине все ставится через npm, например в контейнере или CI. Пакет поддерживает 8 платформ: macOS на Apple Silicon и Intel, Linux x64 и ARM64 в вариантах glibc и musl, Windows x64 и ARM64.

Два правила из документации. Установка через sudo npm install -g запрещена: она ломает права на папку с пакетами. Обновляйте командой npm install -g @anthropic-ai/claude-code@latest, потому что npm update -g может оставить старую версию.

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

Агент запускается из папки проекта двумя командами.

cd ~/projects/my-app

claude

При первом запуске Claude Code откроет браузер для входа. Войдите тем аккаунтом, на котором оформлена подписка Pro или Max, либо аккаунтом Claude Console. Для Console при первом входе автоматически создается рабочее пространство Claude Code, где видно расход денег.

Вход сохраняется, повторять его не придется. Сменить аккаунт можно командой /login внутри сессии. Если в системе задана переменная ANTHROPIC_API_KEY и вы разрешите ее использовать, Claude Code пропустит вход через браузер и будет списывать деньги с ключа.

Как проверить, что Claude Code установлен

Откройте новое окно терминала и выполните claude --version. Рабочая установка печатает номер версии и приписку в скобках, например 2.1.312 (Claude Code). Версия 2.1.312 вышла 27 октября 2026 года, она последняя на дату статьи по журналу изменений Anthropic.

Подробную проверку делает claude doctor. Команда ничего не меняет и показывает состояние установки, ошибки в файлах настроек и результат последнего автообновления.

Как пользоваться Claude Code: первые запросы

Claude Code понимает обычный язык, в том числе русский. Начните с трех вопросов о проекте, агент сам прочитает нужные файлы:

• «что делает этот проект?»
• «где точка входа в приложение?»
• «объясни структуру папок».

Затем дайте небольшую задачу: «добавь проверку пустого поля в форму регистрации». Агент найдет файл и покажет изменение. В ручном режиме он спрашивает разрешение на каждую правку, и вы отвечаете Yes или No. Режим разрешений переключается клавишами Shift+Tab в любой момент.

Первой командой в новом проекте я бы запустил /init. Она создает файл CLAUDE.md с описанием проекта: как собирать, где тесты, какие правила кода. Claude Code читает этот файл в начале каждой сессии, поэтому объяснять проект заново не придется.

Команды Claude Code, которые нужны в первый день

Команды в терминале, до запуска сессии:

• claude открывает интерактивную сессию;
• claude "почини сборку" открывает сессию сразу с задачей;
• claude -p "объясни эту функцию" отвечает один раз и завершает работу, удобно для скриптов;
• claude -c продолжает последний разговор в текущей папке;
• claude -r открывает список прошлых разговоров.

Команды внутри сессии начинаются с косой черты:

• /help показывает все команды;
• /clear очищает историю разговора;
• /compact сжимает разговор в сводку и освобождает контекст;
• /model меняет модель;
• /usage показывает расход и лимиты тарифа;
• /permissions настраивает, что агенту разрешено без вопроса;
• /mcp управляет MCP-серверами;
• /plugin ставит и отключает плагины;
• /exit или дважды Ctrl+D завершают работу.

Claude Code в VS Code: как подключить расширение

Расширение работает в VS Code 1.94 и новее. Его ставят из панели расширений (Ctrl+Shift+X на Windows и Linux, Cmd+Shift+X на Mac): поиск по названию Claude Code от Anthropic и кнопка Install. То же расширение ставится в Cursor и в другие редакторы на основе VS Code.

После установки в правом верхнем углу редактора появится значок Claude Code. Он виден, когда открыт файл. По нажатию откроется панель агента, вход в аккаунт проходит в браузере, а задачу пишут прямо в панели. Расширение показывает предложенные правки рядом с исходным кодом, и их можно принять или отклонить по одной. Выделенный фрагмент агент видит сам, а Alt+K (Option+K на Mac) вставляет ссылку на строки файла в запрос.

Расширение несет свою копию Claude Code только для панели чата и не добавляет команду claude в систему. Чтобы запускать агента во встроенном терминале VS Code, поставьте его отдельно командой для вашей системы из разделов выше.

Claude Code Desktop: установка без терминала

Если терминал непривычен, есть приложение Claude для компьютера с вкладкой Code. Оно выходит для macOS (одна сборка для Intel и Apple Silicon), Windows в двух сборках, x64 и ARM64, для Linux есть бета-версия через apt или пакет .deb для Ubuntu и Debian. Ссылки на загрузку стоят на странице документации Desktop quickstart.

После установки нужно войти в аккаунт и открыть вкладку Code, затем выбрать локальную среду и папку проекта кнопкой «Open folder». Node.js и отдельный Claude Code для этой вкладки не нужны. Вкладка доступна только на платных тарифах: на бесплатном приложение предложит оформить подписку.

Что может пойти не так при установке

Ниже частые ошибки из раздела Troubleshoot installation документации Anthropic.

• command not found: claude или 'claude' is not recognized. Программа установлена, но ее папки нет в PATH. На Mac с оболочкой Zsh выполните echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc, затем source ~/.zshrc. На Linux с Bash замените файл на ~/.bashrc. На Windows добавьте в пользовательский PATH папку %USERPROFILE%\.local\bin и откройте новое окно PowerShell.
• syntax error near unexpected token '<' или curl: (22) ... error: 403. Вместо скрипта установки пришла веб-страница или отказ. Если в тексте ошибки есть «App unavailable in region», Claude Code недоступен в вашей стране. Если страна поддерживается, причина обычно в прокси или корпоративном файрволе.
• API Error: 403 Request not allowed после входа. Проверьте в настройках claude.ai, что подписка активна. Для аккаунта Console нужна роль Claude Code или Developer.
• Cask 'claude-code' is unavailable в Homebrew. Обновите сам Homebrew командой brew update и повторите установку.
• Терминал внутри VS Code не видит claude, хотя в обычном окне все работает. Редактор запомнил старый PATH, перезапустите его целиком.

Россия не входит в список стран, где Anthropic предоставляет сервис. Доступ из неподдерживаемой страны нарушает правила Anthropic и грозит блокировкой аккаунта. Законные варианты доступа описаны в статье Claude Code в России.

Права агента: что проверить после установки

Claude Code выполняет команды с правами вашего пользователя. Он может удалить файлы, поставить пакеты, сделать коммит. В карточке Claude Code в каталоге у него высокий уровень доступа, и на первых порах я бы держал ручной режим, где каждая правка и команда ждет подтверждения.

Три настройки на первый день:

1. Запускайте агента из папки проекта. В ручном режиме он спрашивает разрешение, прежде чем читать или менять файлы за ее пределами.
2. Откройте /permissions и запретите команды, которые не должны выполняться без вас, например публикацию пакетов или работу с базой на сервере.
3. Работайте в репозитории Git, тогда любую правку агента можно откатить.

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

Версия из установщика обновляется сама в фоне, новая версия включается при следующем запуске. Обновить сразу можно командой claude update. Пакеты из Homebrew, WinGet и системных репозиториев обновляются вручную их менеджерами.

Удаление зависит от способа установки. Для версии из установщика на Mac и Linux достаточно двух команд: rm -f ~/.local/bin/claude и rm -rf ~/.local/share/claude. Для Homebrew нужна команда brew uninstall --cask claude-code, для WinGet winget uninstall Anthropic.ClaudeCode, для npm npm uninstall -g @anthropic-ai/claude-code. Настройки и история лежат в ~/.claude и ~/.claude.json, их удаляют отдельно, если они больше не нужны.

Что поставить в Claude Code после установки

Голый Claude Code уже пишет и правит код. Скиллы, MCP-серверы и плагины добавляют ему порядок работы и доступ к сервисам. С чего я бы начал:

• правила для Claude Code по мотивам Карпаты — скилл из четырех принципов в одном CLAUDE.md против частых ошибок агента: допущений, переусложнения и лишних правок.
• Context7 — MCP-сервер со свежей документацией библиотек, чтобы агент не писал код по устаревшим API.
• Playwright MCP — управление браузером для проверки вашего сайта.
• Superpowers — плагин с процессом разработки: уточнение задачи, план, тесты, ревью.
• ccusage — утилита, которая считает расход токенов по журналам Claude Code.

Как ставить скиллы, я показал в статье как поставить скилл в Claude Code, а проверенный набор собран в подборке лучших скиллов для Claude Code. Любую запись каталога можно установить командой вида npx skillfoxx add mcp/playwright-mcp: до установки она покажет уровень доступа и файл, который изменит. Если не знаете, что выбрать, опишите проект в подборе с Foxx AI, он предложит инструменты из каталога.