Как установить Claude Code на Mac, Windows и Linux: CLI или .dmg

Claude Code — ИИ-агент Anthropic для программирования: он читает код проекта, правит файлы, запускает команды и работает с git. Установить его можно двумя путями, и это разные вещи. Терминальная версия (CLI, команда claude) ставится одной командой в Терминале. Приложение Claude для Mac скачивается как обычная программа в виде .dmg, и Claude Code в нём открывается на вкладке Code. По состоянию на 21 октября 2026 года для терминальной версии Anthropic рекомендует нативный установщик: ему не нужен Node.js, и он сам обновляется в фоне. Ниже — команды для Mac, Windows и Linux, проверка установки, вход в аккаунт и решения ошибок, из-за которых команда claude не находится.

Команды установки Claude Code: коротко для каждой платформы

• macOS, Linux, WSL: curl -fsSL https://claude.ai/install.sh | bash
• Windows PowerShell: irm https://claude.ai/install.ps1 | iex
• Windows CMD: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
• Mac через Homebrew: brew install --cask claude-code
• Приложение с окном вместо терминала: Claude для Mac (.dmg) или Windows, вкладка Code — подробности в следующем разделе.
• Требования: macOS 13.0+, Windows 10 1809+, Ubuntu 20.04+ или Debian 10+, от 4 ГБ оперативной памяти. Нужен план Pro ($20 в месяц) или выше: бесплатный план Claude не включает Claude Code.
• После установки: откройте новое окно терминала, выполните claude --version, затем claude в папке проекта и войдите через браузер.

Если нужны только команды, скопируйте свою и переходите к разделу Аутентификация и первый запуск. Ниже разобрано, чем методы отличаются, что учесть на Windows и какой план выбрать.

Скачать Claude на Mac: приложение .dmg или Claude Code в терминале

Если вам нужна программа с окном, которую можно открыть из Dock, скачивайте приложение Claude: это файл .dmg, одна универсальная сборка для Mac на Intel и Apple Silicon. Claude Code в нём уже встроен и открывается на вкладке Code. Если же нужна команда claude в Терминале, во встроенном терминале VS Code или на сервере, ставьте терминальную версию командой из раздела про macOS и Linux. У терминальной версии нет отдельного .dmg: она ставится командой, через Homebrew или npm.

Как поставить приложение на Mac или MacBook:

1. Скачайте .dmg со страницы загрузки Claude или по ссылке из руководства по приложению Claude Code Desktop в документации Anthropic.
2. Откройте файл, установите приложение и запустите Claude из папки «Программы».
3. Войдите в аккаунт Anthropic и нажмите вкладку Code вверху по центру. Если приложение предлагает перейти на платный план, значит, его нет на аккаунте: вкладке Code нужна подписка Pro, Max, Team или Enterprise.
4. Выберите локальную папку проекта (Open folder…) и опишите задачу.

Для вкладки Code не нужно ставить ни Node.js, ни терминальную версию. Обратное тоже верно: приложение не добавляет команду claude в Терминал, её ставят отдельно. Кроме Code в приложении есть вкладка Chat (обычный чат, как на claude.ai) и Cowork (агент, который выполняет задачи в фоне).

На Windows приложение скачивается как установщик для x64, для ARM64 есть отдельный установщик. На Linux приложение пока в бета-версии и ставится через apt или .deb на Ubuntu и Debian.

Что нужно перед установкой Claude Code

Схема частично устарела: npm поддерживается и требует Node.js 22+ (а не 18+), а команда Homebrew — brew install --cask claude-code. Актуальные данные — в тексте ниже.

Перед установкой проверьте две вещи: ваша система подходит под минимальные требования, и у вас есть подходящий аккаунт Anthropic. Сама установка на старой системе или без платного плана может пройти, но запуск или вход затем не сработают.

Системные требования

На Mac версию системы видно в меню Apple → «Об этом Mac». На macOS старше 13.0 установка обрывается ошибкой вроде dyld: Symbol not found или dyld: cannot load. Homebrew скачивает тот же бинарный файл, поэтому здесь не поможет — нужно обновить macOS. Стандартного приложения «Терминал» достаточно, iTerm2 и другие терминалы тоже подойдут.

На Windows нужна сборка 1809 или новее, то есть Windows 10 начиная с обновления октября 2018 года и Windows 11. Права администратора для установки не нужны. Git for Windows ставить не обязательно: с ним Claude Code выполняет команды через Git Bash, без него — через PowerShell. 32-битная Windows не поддерживается.

На Linux документация называет минимальные версии Ubuntu, Debian и Alpine. Для Fedora, RHEL и Arch минимальных версий в ней нет, но для Fedora и RHEL есть репозиторий dnf. На Alpine и других дистрибутивах с musl сначала понадобятся пакеты bash, curl, libgcc, libstdc++ и ripgrep, а в настройках — USE_BUILTIN_RIPGREP=0. Установщик сам определяет архитектуру (x64 или ARM64). Внутри WSL на Windows работает та же команда, что и на Linux.

Последний пункт — регион. Claude Code требует, чтобы вы находились в стране из списка поддерживаемых стран Anthropic. Россия в этот список не входит (по состоянию на 21 октября 2026 года): даже если установка пройдёт, войти в аккаунт из неподдерживаемой страны не получится. Что это значит для подписки, разобрано в статье Claude Pro: есть ли бесплатный пробный период и что с Россией.

Выбор правильного аккаунта

Claude Code недоступен на бесплатном плане Claude.ai. Для входа нужен аккаунт Pro, Max, Team, Enterprise или Anthropic Console. Цены ниже указаны по странице тарифов Claude на 21 октября 2026 года, в долларах США и без налогов.

Если вы пробуете Claude Code впервые, разумно начать с Pro за $20 в месяц и перейти на Max, когда лимиты начнут мешать. В план Max также входят API-кредиты на Claude Platform — от $100 до $200 в месяц. Team удобен для команды: общая оплата и управление местами, а премиум-место даёт в 5 раз больше использования, чем стандартное. Console подходит, если вы запускаете Claude Code в CI/CD или пользуетесь им эпизодически и хотите платить только за потреблённые токены. Подробнее о выборе между Pro и Max — в статье Claude Pro vs Max: цены, лимиты Claude Code и окупаемость Max.

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

На macOS и Linux работает один и тот же скрипт. Нативный установщик скачивает готовый бинарный файл под вашу систему и архитектуру: Node.js, nvm и прочие зависимости не нужны, а обновления приходят сами в фоне.

Нативный установщик (рекомендуемый)

Откройте Терминал. На Mac это приложение «Терминал»: нажмите Cmd + Пробел и введите «Терминал» или найдите его в папке «Программы» → «Утилиты». Выполните одну команду:

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

Пока файл скачивается, команда ничего не выводит — это нормально, дождитесь завершения. Установщик кладёт программу в ~/.local/bin/claude (это ссылка на версию в ~/.local/share/claude/versions/), а настройки и история хранятся в ~/.claude/.

Сам установщик PATH не меняет. Если папки ~/.local/bin в PATH нет, в конце он выведет блок Setup notes: с сообщением Native installation exists but ~/.local/bin is not in your PATH. и командой для исправления. Выполните её или воспользуйтесь разделом «command not found: claude». После установки откройте новое окно терминала: уже открытое окно помнит старый PATH.

Главное преимущество нативной установки — фоновые обновления: Claude Code сам проверяет новые версии и ставит их. Если обновление нужно прямо сейчас, выполните claude update. Результат последней попытки обновления показывает claude doctor.

Если не хотите передавать скрипт сразу в bash, скачайте его, просмотрите и запустите вручную:

curl -fsSL https://claude.ai/install.sh -o install-claude.sh
less install-claude.sh  # review the script
bash install-claude.sh

Скачивайте Claude Code только из официальных источников: скрипты с claude.ai, документация на code.claude.com, репозиторий anthropics/claude-code на GitHub и официальные пакеты claude-code в Homebrew, Anthropic.ClaudeCode в WinGet и @anthropic-ai/claude-code в npm. Установщики из рекламы и с похожих доменов могут быть поддельными.

На Linux, кроме скрипта, можно подключить официальный репозиторий для apt (Debian, Ubuntu), dnf (Fedora, RHEL) или apk (Alpine) — инструкции есть в разделе о расширенной установке в документации Claude Code. Такие установки, как и Homebrew, по умолчанию сами не обновляются.

Альтернатива через Homebrew

Если вы ставите инструменты через Homebrew, Claude Code доступен как cask:

brew install --cask claude-code

Есть два варианта cask. claude-code следует стабильному каналу: он обычно отстаёт от последней версии примерно на неделю и пропускает выпуски с серьёзными регрессиями. claude-code@latest получает новые версии сразу:

brew install --cask claude-code@latest

Установки через Homebrew сами не обновляются. Обновляйте командой того cask, который поставили:

brew upgrade claude-code

Если хотите, чтобы Claude Code сам запускал это обновление, задайте переменную CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1. Если Homebrew отвечает Error: Cask 'claude-code' is unavailable: No Cask with this name exists, у вас устарел локальный индекс: выполните brew update и повторите установку.

Homebrew размещает ссылку на claude в /opt/homebrew/bin/ на Mac с Apple Silicon или в /usr/local/bin/ на Mac с Intel. Если позже решите перейти на нативный установщик, сначала удалите версию из Homebrew командой brew uninstall --cask claude-code, чтобы в системе не осталось двух копий.

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

Каким бы способом вы ни ставили Claude Code, проверьте результат в новом окне терминала:

which -a claude
claude --version

which -a claude показывает все найденные копии claude: если строк больше одной, у вас несколько установок, и запускается первая из списка — лишние лучше удалить. claude --version должна вывести номер версии вида 2.1.xxx (Claude Code). Если вместо этого появляется «command not found», переходите к разделу устранения проблем.

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

Установка Claude Code на Windows

На Windows есть одно дополнительное решение: запускать Claude Code прямо в Windows или внутри WSL (подсистемы Windows для Linux). Выбирайте по тому, где лежат ваши проекты и какие инструменты вы используете.

Если вы пишете под Windows — .NET, скрипты PowerShell, нативные инструменты Windows, — ставьте Claude Code нативно через PowerShell или CMD. Никаких обязательных зависимостей у этого варианта нет. Если вы разрабатываете под Linux — серверы на Node.js, бэкенды на Python, контейнеры Docker, — WSL 2 даёт полноценный Linux, где Claude Code работает так же, как на macOS и Linux. Ещё одно отличие: изолированное выполнение команд (sandboxing) поддерживается в WSL 2, но не в нативной Windows. Если сомневаетесь, начните с нативной установки: WSL можно добавить позже.

Нативный установщик PowerShell (рекомендуется для большинства пользователей)

Откройте PowerShell — запускать его от имени администратора не нужно. Узнать, где вы находитесь, можно по приглашению: в PowerShell строка начинается с PS C:\Users\ВашеИмя>, в CMD — с C:\Users\ВашеИмя> без PS. Выполните:

irm https://claude.ai/install.ps1 | iex

Команда скачивает и ставит нативный бинарный файл в %USERPROFILE%\.local\bin\claude.exe. После установки откройте новое окно PowerShell и проверьте claude --version. Как и на macOS, такая установка обновляется в фоне.

Git for Windows не обязателен. С ним Claude Code использует Git Bash для выполнения команд, без него — PowerShell. Если работаете со скриптами на Bash, Git for Windows стоит поставить с git-scm.com, отметив в установщике «Add to PATH».

Две ошибки выдают неверную оболочку. 'irm' is not recognized as an internal or external command означает, что вы в CMD, а не в PowerShell. The token '&&' is not a valid statement separator — что вы в PowerShell, а запускаете команду для CMD.

Альтернатива через WinGet

Если вы пользуетесь WinGet (менеджер пакетов, встроенный в Windows 11 и новые сборки Windows 10), Claude Code доступен в официальном репозитории:

winget install Anthropic.ClaudeCode

Установки через WinGet сами не обновляются: периодически выполняйте winget upgrade Anthropic.ClaudeCode или задайте CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1, чтобы Claude Code запускал обновление сам. WinGet удобен, если ваша организация управляет программами через Windows Package Manager.

Установщик Windows CMD

Для командной строки CMD есть отдельная команда:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Она ставит ту же нативную версию, что и установщик PowerShell. Выбор между PowerShell и CMD влияет только на то, какую команду установки вы запускаете.

Путь WSL (для Linux-ориентированных разработчиков)

Если вам нужна полноценная Linux-среда в Windows, сначала установите WSL, а затем внутри него — Claude Code той же командой, что и на Linux:

# Step 1: Install WSL (in PowerShell as admin)
wsl --install

# Step 2: Reboot your computer when prompted

# Step 3: Open your WSL terminal (Ubuntu by default)
# Step 4: Install Claude Code using the Linux method
curl -fsSL https://claude.ai/install.sh | bash

Права администратора здесь нужны только для wsl --install, то есть для установки самой WSL. Устанавливайте и запускайте claude внутри терминала WSL, а не из PowerShell или CMD. Git for Windows для WSL не нужен.

Если внутри WSL вы ставите Claude Code через npm, Node.js тоже должен быть установлен внутри WSL: Node.js из Windows оттуда не виден. Нативный установщик этой проблемы не имеет, потому что Node.js ему не нужен.

Держите проекты в файловой системе WSL (например, ~/projects/), а не на диске Windows (/mnt/c/Users/...): операции с файлами через границу WSL и Windows заметно медленнее, а Claude Code читает файлы постоянно.

npm-установка Claude Code: когда переходить на нативный установщик

Установка через npm поддерживается и описана в документации как дополнительный вариант:

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

Пакету нужен Node.js 22 или новее. На более старом Node.js npm выведет предупреждение EBADENGINE, но установка завершится и claude будет работать: пакет скачивает тот же нативный бинарный файл, что и основной установщик, и сам Node.js во время работы не использует. До июля 2026 года минимальной версией был Node.js 18, поэтому в старых инструкциях указано именно 18.

В январе 2026 года (версия 2.1.15) Claude Code показывал пользователям npm уведомление об устаревании, отсюда в старых руководствах фраза «npm устарел». В текущей документации npm описан как обычный дополнительный вариант, и уведомления больше нет.

Обновлять npm-установку нужно командой npm install -g @anthropic-ai/claude-code@latest. npm update -g использовать не стоит: она учитывает диапазон версий из первой установки и может не дойти до свежего выпуска. Никогда не запускайте sudo npm install -g — это ведёт к проблемам с правами и рискам безопасности.

Переходить на нативный установщик не обязательно, но это имеет смысл, если:

• глобальная папка npm недоступна для записи: тогда npm-установка не может обновиться сама, и claude doctor сообщает Can't auto-update: npm global folder isn't writable;
• which -a claude показывает несколько копий, и вы не уверены, какая из них запускается;
• вы хотите убрать Claude Code из цепочки зависимостей Node.js, nvm или asdf.

Самый короткий путь — команда claude install: она переводит npm-установку на нативную без sudo. Можно сделать то же вручную:

# Step 1: Check your current installation method
which -a claude
# If it returns a path inside node_modules or .npm-global, you're on npm

# Step 2: Uninstall the npm version
npm uninstall -g @anthropic-ai/claude-code

# Step 3: Verify it's gone
which claude  # Should return "not found"

# Step 4: Install the native version
curl -fsSL https://claude.ai/install.sh | bash  # macOS/Linux
# OR
irm https://claude.ai/install.ps1 | iex  # Windows PowerShell

# Step 5: Open a new terminal and verify
claude --version

Настройки и история в ~/.claude/ при этом остаются на месте: удаление пакета npm их не трогает.

Аутентификация и первый запуск

После установки перейдите в папку проекта и запустите Claude Code:

cd /path/to/your/project
claude

При первом запуске Claude Code открывает браузер со страницей входа Anthropic. Войдите с аккаунтом Pro, Max, Team, Enterprise или Console и подтвердите доступ. Если браузер не открылся сам, нажмите c: ссылка для входа скопируется в буфер обмена, и её можно вставить в браузер вручную. Это же помогает в узком окне или по SSH, когда ссылка переносится на несколько строк.

Для управления входом есть команды claude auth login и claude auth logout, а внутри сессии — /login и /logout. Отдельной команды claude logout нет.

Методы аутентификации

Claude Code поддерживает три способа входа.

Вход через браузер подходит большинству. Если у вас Pro или Max, это самый простой путь: оплата идёт через подписку, а лимиты соответствуют вашему плану.

API-ключ нужен там, где нет браузера: CI/CD, контейнеры Docker, удалённые серверы. Задайте переменную окружения ANTHROPIC_API_KEY перед запуском:

export ANTHROPIC_API_KEY=sk-ant-...
claude

Claude Code спросит, использовать ли этот ключ. Если вы согласитесь, он пропустит вход через браузер, а оплата пойдёт со счёта Anthropic Console за потреблённые токены. Как настроить ключи, settings.json и модели, разобрано в статье Настройка Claude Code API: ключи, settings.json, модели и шлюзы.

Облачные провайдеры — Amazon Bedrock, Google Cloud Agent Platform (Vertex AI) и Microsoft Foundry — подключаются через переменные окружения:

# Amazon Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1

# Google Cloud Agent Platform (Vertex AI)
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project-id

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

Инициализация проекта с помощью CLAUDE.md

После входа полезно создать файл CLAUDE.md в корне проекта. В нём Claude получает постоянный контекст о проекте: команды сборки, соглашения по коду, архитектурные решения, порядок тестирования — всё, чего не видно из самого кода. Без него каждая сессия начинается с нуля.

Стартовый CLAUDE.md можно сгенерировать автоматически:

# Inside a Claude Code session, run:
/init

Команда анализирует проект и создаёт CLAUDE.md с найденными системами сборки, фреймворками тестирования и паттернами кода. Хороший CLAUDE.md лаконичен: для каждой строки спросите себя, ошибётся ли Claude, если её убрать, и если нет — удаляйте. В монорепозиториях можно добавить отдельные CLAUDE.md в подпапки: правила из корня действуют везде, а правила из подпапки — только при работе в ней.

Пример CLAUDE.md для типичного проекта на Next.js:

# CLAUDE.md

## Commands
- `npm run dev` - Start dev server on port 3000
- `npm run build` - Production build
- `npm test` - Run Jest tests
- `npm run lint` - ESLint check

## Architecture
- Next.js 15 with App Router
- PostgreSQL with Drizzle ORM
- Authentication via Clerk
- All API routes in src/app/api/

## Conventions
- Server components by default; use "use client" only when needed
- TypeScript strict mode; no any types
- Commit messages: imperative mood, < 72 chars

Главный принцип: CLAUDE.md сообщает то, чего Claude не поймёт, просто прочитав код. Команды сборки, соглашения об именах и архитектурные решения ценнее всего: без явной подсказки именно здесь Claude чаще всего ошибается.

Устранение типичных проблем при установке

Большинство проблем при установке сводится к PATH, к не той оболочке на Windows или к сети. Начните с диагностики:

claude doctor

Команда не запускает сессию: она выводит состояние установки, ошибки в файлах настроек и предупреждения с подсказками, как их исправить. Если claude вообще не запускается, начните с раздела ниже. Полный список ошибок с решениями есть на странице устранения проблем с установкой в документации Claude Code.

«command not found: claude»

Это самая частая ошибка после установки: программа установлена, но её папки нет в PATH, или терминал был открыт до установки. На macOS она выглядит как zsh: command not found: claude, на Linux — bash: claude: command not found.

Сначала откройте новое окно терминала. Если не помогло, проверьте, на месте ли программа:

ls -la ~/.local/bin/claude

Если файл есть, проверьте, есть ли его папка в PATH:

echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

Пустой вывод означает, что папки в PATH нет. Добавьте её в настройки своей оболочки. Для Zsh, которая стоит в macOS по умолчанию:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Для Bash на Linux:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Если на Mac вы пользуетесь Bash, добавьте строку в ~/.bash_profile: Терминал macOS запускает Bash так, что ~/.bashrc не читается. Если и после этого команда не находится, проверьте три вещи: окно терминала открыто после изменения (терминал внутри редактора берёт PATH из редактора, поэтому редактор тоже нужно перезапустить); строка действительно сохранилась (grep -n '.local/bin' ~/.zshrc); вы правили файл именно своей оболочки (echo $0 показывает, какая у вас оболочка).

Если ls отвечает No such file or directory, нативной установки нет. Если вы ставили Claude Code через Homebrew или npm, ищите копию командой which -a claude; если не ставили никак — вернитесь к установке.

«"claude" не является внутренней или внешней командой» в Windows

В русской Windows эта ошибка в CMD звучит как "claude" не является внутренней или внешней командой, исполняемой программой или пакетным файлом., а в PowerShell — Имя "claude" не распознано как имя командлета, функции, файла сценария или выполняемой программы. Причина та же, что на Mac: папки %USERPROFILE%\.local\bin нет в PATH или окно открыто до установки.

Закройте все окна PowerShell и откройте новое. Если ошибка осталась, проверьте в PowerShell, на месте ли программа:

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

Если ответ True, добавьте папку в пользовательскую переменную PATH:

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Затем откройте новое окно терминала и снова выполните claude --version. В CMD то же самое делается через «Переменные среды» в настройках системы: добавьте %USERPROFILE%\.local\bin в пользовательскую переменную PATH. Если терминал открыт внутри VS Code или другого редактора, перезапустите сам редактор. Какие копии claude видит система, показывает where.exe claude.

Ещё три случая с похожими симптомами:

• ошибка появилась сразу после обновления Claude Code — пропал claude.exe, и его можно восстановить из резервной копии по инструкции на странице устранения проблем в документации;
• команда claude открывает приложение Claude вместо терминальной версии — старая версия приложения Claude регистрировала свой Claude.exe с приоритетом в PATH, достаточно обновить приложение;
• расширение VS Code пишет Could not locate the Claude CLI on PATH — PATH задан только в профиле PowerShell, а расширение его не читает; задайте PATH как переменную среды пользователя и перезапустите VS Code. Как проверить, с каким аккаунтом работает расширение, — в статье Как проверить аккаунт Claude Code в VS Code: /status, логин и API-маршрут.

Ошибки EACCES (только для метода npm)

Если при установке через npm появляются ошибки EACCES, не используйте sudo npm install -g: файлы, созданные от root, ломают права для всех последующих глобальных установок npm. Самое простое решение — claude install, которая переведёт вас на нативную установку без sudo. Если хотите остаться на npm, перенесите глобальную папку npm в домашнюю директорию:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @anthropic-ai/claude-code

На Mac с Zsh вместо ~/.bashrc используйте ~/.zshrc.

Ошибки аутентификации

Если вход через браузер не проходит:

1. Сбросьте вход: /logout внутри сессии (или claude auth logout в терминале), закройте Claude Code и снова запустите claude.
2. Если браузер не открывается, нажмите c и вставьте скопированную ссылку вручную.
3. Проверьте, что на аккаунте платный план: Pro, Max, Team или Enterprise.
4. Сообщение App unavailable in region означает, что Claude Code недоступен в вашей стране.
5. В корпоративной сети с прокси задайте переменную HTTPS_PROXY.

Если вход часто слетает, проверьте точность системных часов: от них зависит проверка токена. Для CI, где браузера нет, используйте API-ключ, как описано выше.

Проблемы, специфичные для Windows

Ошибка running scripts is disabled on this system относится к npm-установке: политика выполнения PowerShell блокирует скрипты-запускатели npm.ps1 и claude.ps1. На установщик irm https://claude.ai/install.ps1 | iex она не влияет. Решения: разрешить локальные скрипты для своего пользователя, вызывать npm.cmd и claude.cmd вместо .ps1 или перейти на установщик PowerShell.

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

Сообщение Claude Code on Windows requires either Git for Windows (for bash) or PowerShell означает, что Claude Code не нашёл ни одной оболочки. Обычно помогает вернуть в PATH папку C:\Windows\System32\WindowsPowerShell\v1.0\ или поставить PowerShell 7. Ошибка Claude Code does not support 32-bit Windows появляется, если открыть пункт «Windows PowerShell (x86)»: откройте обычный Windows PowerShell.

Если в WSL медленно работают файловые операции, перенесите проект с диска Windows (/mnt/c/...) в файловую систему WSL (~/projects/).

Сетевые проблемы и прокси

Установщик скачивает файлы с downloads.claude.ai. Проверить доступ к нему можно так:

curl -sI https://downloads.claude.ai/claude-code-releases/latest

Первая строка с кодом 200 означает, что сервер доступен. Код 403 обычно значит, что адрес блокирует прокси или сетевой фильтр, либо что Claude Code недоступен в вашем регионе. Нет ответа или Could not resolve host — соединение блокирует сеть. В PowerShell вызывайте curl.exe с тем же адресом: обычный curl там — псевдоним другой команды.

За корпоративным прокси задайте его адрес перед установкой:

export HTTPS_PROXY=http://proxy.yourcompany.com:8080
export HTTP_PROXY=http://proxy.yourcompany.com:8080
curl -fsSL https://claude.ai/install.sh | bash

Если вход не проходит за прокси, те же переменные обычно помогают и там. Если доступ закрыт файрволом, попросите ИТ-отдел открыть домены downloads.claude.ai, claude.ai и api.anthropic.com.

Ошибки обновления: «Auto-update failed» и «Release verification failed»

Красная строка Auto-update failed · Run claude doctor внизу сессии не мешает работать дальше. Чтобы завершить обновление или увидеть причину, выполните claude update в терминале. Сообщение Release verification failed for Claude Code ... The update was not installed. означает, что новая версия не прошла проверку и не установилась, а старая продолжает работать. Если причина в сообщении начинается с sidecar_fetch_, просто повторите команду. Об успешном обновлении claude update сообщает строкой Successfully updated from ....

Медленная работа после установки

Если Claude Code запустился, но отвечает медленно, частая причина — переполненный контекст. Команда /compact внутри сессии сжимает историю диалога и освобождает место.

Файл .claudeignore Claude Code не поддерживает: если он есть в проекте, он ничего не делает. Чтобы запретить Claude читать отдельные файлы и папки, добавьте правила Read в раздел permissions.deny файла настроек, например .claude/settings.json:

{
  "permissions": {
    "deny": ["Read(./.env)", "Read(./secrets/**)"]
  }
}

Какой план Claude Code вам подходит?

План определяет лимиты использования: чем дольше Claude Code работает у вас за день, тем выше нужен уровень. Цены — по странице тарифов Claude на 21 октября 2026 года, в долларах США без налогов.

Claude Pro за $20 в месяц ($17 в месяц при оплате за год) — отправная точка для большинства разработчиков. С него разумно начать, если вы обращаетесь к Claude Code несколько раз в день: ревью кода, исправление багов, небольшие задачи. Если лимиты начнут прерывать работу, план можно повысить позже.

Claude Max 5x за $100 в месяц имеет смысл, когда вы регулярно упираетесь в лимиты Pro: он даёт в 5 раз больше использования. Claude Max 20x за $200 в месяц — в 20 раз больше, чем Pro, для тех, кто держит Claude Code открытым весь день или ведёт несколько проектов параллельно. Оба варианта Max также включают API-кредиты на Claude Platform — от $100 до $200 в месяц.

Anthropic Console (оплата по API) подходит для эпизодического использования и CI/CD: вместо подписки вы пополняете баланс и платите за потреблённые токены по ценам API выбранной модели. Итоговая сумма зависит от модели и объёма работы, поэтому следите за расходами в консоли.

Team — для команд: стандартное место стоит $25 в месяц ($20 при оплате за год), премиум-место с 5-кратным объёмом использования — $125 в месяц ($100 при оплате за год). Сравнение Pro и Max с расчётом окупаемости — в статье Claude Pro vs Max: цены, лимиты Claude Code и окупаемость Max. Что делать, если лимит уже исчерпан, разобрано в статье Claude Code Rate Limit Reached: что делать и как продолжить.

Сравнение методов установки

Ниже все способы установить терминальную версию Claude Code на одной таблице:

Для большинства лучший выбор — нативный установщик: зависимостей нет, обновления приходят сами. Homebrew и WinGet удобны, если вы и так управляете программами через менеджер пакетов и готовы обновлять вручную. npm — рабочий вариант, если Node.js 22+ у вас уже стоит и вам привычнее этот инструмент. Конкретную версию или канал (stable или latest) можно зафиксировать и в нативном установщике, так что npm для этого не обязателен. Приложение Claude с вкладкой Code в таблицу не входит: это отдельный продукт, который ставится как обычная программа (см. раздел о Mac).

Частые вопросы об установке Claude Code

Требуется ли Claude Code Node.js? Нет, если вы ставите его нативным установщиком, через Homebrew, WinGet или приложение Claude. Node.js 22+ нужен только для установки через npm; на более старом Node.js npm выведет предупреждение EBADENGINE, но установка завершится.

Можно ли использовать Claude Code на Apple Silicon? Да. Нативный установщик сам определяет архитектуру и ставит версию для ARM64 на Mac с M-процессорами или для x64 на Mac с Intel. Приложение Claude для Mac — одна универсальная сборка для обоих типов.

Есть ли у Claude Code файл .dmg для Mac? Файл .dmg есть у приложения Claude, и Claude Code в нём работает на вкладке Code. Терминальная версия ставится не из .dmg, а командой curl -fsSL https://claude.ai/install.sh | bash или через brew install --cask claude-code.

Как полностью удалить Claude Code? Команды claude uninstall нет, удаление зависит от способа установки. Нативная версия на macOS и 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/ остаётся, пока вы не удалите её сами; расширение VS Code, плагин JetBrains и приложение Claude тоже пишут в неё, поэтому удаляйте их раньше. Команды для Windows и другие варианты — в статье Как установить Claude Code: полное руководство для всех платформ (2026).

Можно ли использовать Claude Code без подписки? Бесплатный план Claude его не включает. Без подписки остаётся аккаунт Anthropic Console с API-ключом: вы платите только за потреблённые токены. Ещё один вариант — облачные провайдеры Amazon Bedrock, Google Cloud Agent Platform и Microsoft Foundry по их собственным тарифам.

Можно ли пользоваться Claude Code без установки? Да, есть облачный вариант в браузере. Чем он отличается от локальной работы, разобрано в статье Есть ли у Claude Code веб-версия: чем отличаются облачный Web, Remote Control и локальная работа.

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

Существует ли десктопное приложение Claude Code? Да: это приложение Claude для macOS, Windows и Linux (бета), где Claude Code открывается на вкладке Code. Приложение и терминальная версия ставятся независимо: установка одного не добавляет другое.

Можно ли установить Claude Code в России? Даже если установка пройдёт, войти не получится: Claude Code требует, чтобы вы находились в стране из списка поддерживаемых Anthropic, а России в нём нет. Подробнее — в статье Claude Pro: есть ли бесплатный пробный период и что с Россией.

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

Итог простой: на Mac и Linux терминальная версия ставится командой curl или через Homebrew, на Windows — через PowerShell, CMD или WinGet, а тем, кому не нужен терминал, подойдёт приложение Claude с вкладкой Code. Node.js нужен только для установки через npm.

Дальше полезно сделать три вещи. Во-первых, выполните /init внутри Claude Code, чтобы создать CLAUDE.md для проекта: постоянный контекст заметно улучшает ответы. Во-вторых, наберите /help и посмотрите встроенные слэш-команды: там есть быстрые сценарии для ревью кода, коммитов и тестов. В-третьих, подключите серверы MCP (Model Context Protocol), чтобы Claude Code получил прямой доступ к вашим инструментам и источникам данных.

Если вы сравниваете Claude Code с другими инструментами, в статье OpenClaw vs Claude Code: что выбрать и как использовать вместе разобраны сильные стороны и сценарии каждого. Если упираетесь в лимиты, практические шаги собраны в статье Claude Code Rate Limit Reached: что делать и как продолжить. Если вы также пользуетесь OpenClaw, настройка его API описана в статье OpenClaw: полное руководство по API, настройке и оптимизации.