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

> Claude Code для терминала ставится одной командой на Mac, Windows и Linux, приложение Claude (.dmg) — отдельно. Нужен план от $20 в месяц, Free не подходит.

- URL: https://blog.laozhang.ai/ru/posts/how-to-install-claude-code
- Published: 2026-03-16
- Updated: 2026-10-21
- Author: LaoZhang AI Team (https://blog.laozhang.ai/ru/about)
- Topic: Claude Code
- Tags: Claude Code, Руководство по установке, Инструменты ИИ для кодирования, Инструменты разработчика

---
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 — подробности в [следующем разделе](#скачать-claude-на-mac-приложение-dmg-или-claude-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](#установка-claude-code-на-macos-и-linux). У терминальной версии нет отдельного `.dmg`: она ставится командой, через Homebrew или npm.

| Что вам нужно | Что ставить | Откуда |
|---|---|---|
| Работать с кодом в окне, без терминала | Приложение Claude, вкладка Code | `.dmg` со [страницы загрузки Claude](https://claude.com/download) |
| Команда `claude` в Терминале, VS Code, JetBrains или по SSH | Claude Code CLI | `curl -fsSL https://claude.ai/install.sh \| bash` или `brew install --cask claude-code` |
| И то и другое | Оба продукта | Ставятся независимо, порядок не важен |

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

1. Скачайте `.dmg` со [страницы загрузки Claude](https://claude.com/download) или по ссылке из [руководства по приложению Claude Code Desktop в документации Anthropic](https://code.claude.com/docs/ru/desktop-quickstart).
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

![Сравнение шести методов установки Claude Code: нативный CLI, Homebrew, WinGet, npm, CMD и WSL](https://blog.laozhang.ai/posts/ru/how-to-install-claude-code/img/install-methods.webp)

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

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

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

| Параметр | Минимум |
|---|---|
| macOS | 13.0 (Ventura) или новее, Apple Silicon или Intel |
| Windows | Windows 10 1809+ или Windows Server 2019+ |
| Linux | Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+ |
| Оперативная память | от 4 ГБ |
| Процессор | x64 или ARM64 |
| Оболочка | Bash, Zsh, PowerShell или CMD |
| Сеть и регион | подключение к интернету, страна из списка поддерживаемых 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](https://www.anthropic.com/supported-countries). Россия в этот список не входит (по состоянию на 21 октября 2026 года): даже если установка пройдёт, войти в аккаунт из неподдерживаемой страны не получится. Что это значит для подписки, разобрано в статье [Claude Pro: есть ли бесплатный пробный период и что с Россией](https://blog.laozhang.ai/ru/posts/claude-pro-free-trial).

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

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

| Аккаунт | Цена | Claude Code |
|---|---|---|
| Free | $0 | Нет |
| Pro | $20 в месяц, $17 в месяц при оплате за год | Да |
| Max 5x | $100 в месяц | Да, в 5 раз больше лимитов, чем у Pro |
| Max 20x | $200 в месяц | Да, в 20 раз больше лимитов, чем у Pro |
| Team | $25 за стандартное место в месяц ($20 при оплате за год), $125 за премиум-место ($100 при оплате за год) | Да |
| Enterprise | $20 за место в месяц при оплате за год плюс использование по ценам API, от 20 мест | Да |
| Anthropic Console | Оплата за токены по API | Да, через API-ключ |

Если вы пробуете 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](https://blog.laozhang.ai/ru/posts/claude-code-pro-vs-max).

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

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

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

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

```bash
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»](#command-not-found-claude). После установки откройте новое окно терминала: уже открытое окно помнит старый PATH.

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

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

```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](https://code.claude.com/docs/ru/setup). Такие установки, как и Homebrew, по умолчанию сами не обновляются.

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

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

```bash
brew install --cask claude-code
```

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

```bash
brew install --cask claude-code@latest
```

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

```bash
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, проверьте результат в новом окне терминала:

```bash
which -a claude
claude --version
```

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

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

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

![Дерево решений для установки Claude Code на Windows: нативный PowerShell, WinGet и WSL](https://blog.laozhang.ai/posts/ru/how-to-install-claude-code/img/windows-decision.webp)

На 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`. Выполните:

```powershell
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](https://git-scm.com/downloads/win), отметив в установщике «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 доступен в официальном репозитории:

```powershell
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 есть отдельная команда:

```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:

```powershell
# 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 поддерживается и описана в документации как дополнительный вариант:

```bash
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`. Можно сделать то же вручную:

```bash
# 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:

```bash
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` перед запуском:

```bash
export ANTHROPIC_API_KEY=sk-ant-...
claude
```

Claude Code спросит, использовать ли этот ключ. Если вы согласитесь, он пропустит вход через браузер, а оплата пойдёт со счёта Anthropic Console за потреблённые токены. Как настроить ключи, `settings.json` и модели, разобрано в статье [Настройка Claude Code API: ключи, settings.json, модели и шлюзы](https://blog.laozhang.ai/ru/posts/claude-code-api-configuration).

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

```bash
# 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` можно сгенерировать автоматически:

```bash
# Inside a Claude Code session, run:
/init
```

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

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

```markdown
# 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 или к сети. Начните с диагностики:

```bash
claude doctor
```

Команда не запускает сессию: она выводит состояние установки, ошибки в файлах настроек и предупреждения с подсказками, как их исправить. Если `claude` вообще не запускается, начните с раздела ниже. Полный список ошибок с решениями есть на [странице устранения проблем с установкой в документации Claude Code](https://code.claude.com/docs/ru/troubleshoot-install).

### «command not found: claude»

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

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

```bash
ls -la ~/.local/bin/claude
```

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

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

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

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

Для Bash на Linux:

```bash
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, на месте ли программа:

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

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

```powershell
$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-маршрут](https://blog.laozhang.ai/ru/posts/check-claude-code-vscode-account).

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

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

```bash
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.

```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`. Проверить доступ к нему можно так:

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

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

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

```bash
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`:

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

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

План определяет лимиты использования: чем дольше Claude Code работает у вас за день, тем выше нужен уровень. Цены — по [странице тарифов Claude](https://claude.com/pricing) на 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](https://blog.laozhang.ai/ru/posts/claude-code-pro-vs-max). Что делать, если лимит уже исчерпан, разобрано в статье [Claude Code Rate Limit Reached: что делать и как продолжить](https://blog.laozhang.ai/ru/posts/claude-code-rate-limit-reached).

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

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

| Метод | Платформа | Команда | Автообновление | Зависимости | Для кого |
|-------|----------|---------|---------------|-------------|---------|
| Нативный установщик | macOS, Linux, WSL | `curl -fsSL https://claude.ai/install.sh \| bash` | Да | Нет | Большинство |
| Нативный PowerShell или CMD | Windows | `irm https://claude.ai/install.ps1 \| iex` | Да | Нет (Git for Windows по желанию) | Пользователи Windows |
| Homebrew | macOS, Linux | `brew install --cask claude-code` | Нет, `brew upgrade` | Homebrew | Пользователи Homebrew |
| WinGet | Windows | `winget install Anthropic.ClaudeCode` | Нет, `winget upgrade` | WinGet | Управление пакетами Windows |
| apt, dnf, apk | Linux | Официальный репозиторий, см. документацию | Нет | Пакетный менеджер | Серверы и централизованное управление |
| npm | macOS, Linux, Windows | `npm install -g @anthropic-ai/claude-code` | Да, если глобальная папка npm доступна для записи | Node.js 22+ | Тем, кому удобнее npm |
| WSL | Windows | Установщик Linux внутри WSL | Да | WSL 2 (или WSL 1) | Разработка под Linux |

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

## Частые вопросы об установке 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)](https://blog.laozhang.ai/ru/posts/claude-code-install).

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

**Можно ли пользоваться Claude Code без установки?** Да, есть облачный вариант в браузере. Чем он отличается от локальной работы, разобрано в статье [Есть ли у Claude Code веб-версия: чем отличаются облачный Web, Remote Control и локальная работа](https://blog.laozhang.ai/ru/posts/claude-code-web-interface).

**Работает ли 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: есть ли бесплатный пробный период и что с Россией](https://blog.laozhang.ai/ru/posts/claude-pro-free-trial).

## Что делать после установки 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: что выбрать и как использовать вместе](https://blog.laozhang.ai/ru/posts/openclaw-vs-claude-code) разобраны сильные стороны и сценарии каждого. Если упираетесь в лимиты, практические шаги собраны в статье [Claude Code Rate Limit Reached: что делать и как продолжить](https://blog.laozhang.ai/ru/posts/claude-code-rate-limit-reached). Если вы также пользуетесь OpenClaw, настройка его API описана в статье [OpenClaw: полное руководство по API, настройке и оптимизации](https://blog.laozhang.ai/ru/posts/openclaw-api-guide).

## Источники

Внешние страницы, на которые ссылается это руководство, в порядке упоминания. Последнее обновление: 2026-10-21.

- [страницы загрузки Claude](https://claude.com/download) (claude.com)
- [руководства по приложению Claude Code Desktop в документации Anthropic](https://code.claude.com/docs/ru/desktop-quickstart) (code.claude.com)
- [списка поддерживаемых стран Anthropic](https://www.anthropic.com/supported-countries) (anthropic.com)
- [странице тарифов Claude](https://claude.com/pricing) (claude.com)
- [разделе о расширенной установке в документации Claude Code](https://code.claude.com/docs/ru/setup) (code.claude.com)
- [git-scm.com](https://git-scm.com/downloads/win) (git-scm.com)
- [странице устранения проблем с установкой в документации Claude Code](https://code.claude.com/docs/ru/troubleshoot-install) (code.claude.com)