Установка Claude Code CLI: полное руководство для Windows, macOS и Linux

Что такое Claude Code CLI и зачем он нужен

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

Инструмент особенно полезен для тех, кто работает с большими кодовыми базами, хочет автоматизировать повторяющиеся действия или нуждается в ассистенте, который понимает контекст проекта. Claude Code CLI поддерживает интерактивный режим, пакетный запуск с параметрами, а также интеграцию с популярными системами контроля версий и CI/CD. Важно понимать, что для работы требуется платная подписка (Pro, Max, Team, Enterprise или Console) — бесплатный тариф Claude.ai не включает доступ к Claude Code.

Установка CLI доступна на всех основных операционных системах: macOS, Windows, Linux (включая дистрибутивы на базе Debian, Fedora, Alpine). Существует несколько способов установки, каждый из которых имеет свои особенности, преимущества и ограничения. В этой статье мы подробно разберём все варианты, начиная от системных требований и заканчивая устранением типичных ошибок.

Системные требования и предварительные условия

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

• macOS 13.0 и новее
• Windows 10 версии 1809 (сборка 17763) или новее, Windows Server 2019 и новее, Windows 11
• Ubuntu 20.04 и новее
• Debian 10 и новее
• Alpine Linux 3.19 и новее (требуются дополнительные пакеты)

Аппаратные требования включают не менее 4 ГБ оперативной памяти и процессор архитектуры x64 или ARM64. Также необходимо стабильное интернет-соединение для загрузки и аутентификации. В качестве оболочки поддерживаются Bash, Zsh, PowerShell и CMD.

Дополнительно может потребоваться установка ripgrep — утилиты для быстрого поиска по файлам. Обычно она входит в комплект Claude Code, но если поиск не работает, её нужно установить отдельно. Для пользователей Windows рекомендуется установить Git for Windows, чтобы CLI мог использовать Bash-инструменты; в противном случае команды будут выполняться через PowerShell.

Важно: для работы Claude Code требуется учётная запись Anthropic с одной из платных подписок. Также возможна интеграция с облачными провайдерами: Amazon Bedrock, Google Cloud Agent Platform и Microsoft Foundry. Если вы планируете использовать один из этих сервисов, убедитеся, что у вас есть соответствующие учётные данные.

Установка на macOS и Linux через нативный установщик

Наиболее рекомендуемый способ установки Claude Code CLI — использование нативного установщика, который автоматически загружает и настраивает все необходимые компоненты. Этот метод не требует Node.js и поддерживает автоматическое обновление в фоновом режиме.

Для macOS, Linux и WSL выполните в терминале следующую команду:

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

После завершения установки проверьте версию:

claude --version

Если вы хотите установить конкретную версию или переключиться на стабильный канал обновлений, используйте флаги:

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

Установщик размещает бинарный файл в ~/.local/bin/claude, который является символической ссылкой на актуальную версию в ~/.local/share/claude/versions/. Это позволяет автоматически обновляться без вмешательства пользователя. На macOS бинарный файл подписан компанией Anthropic и нотариально заверен Apple, что гарантирует его подлинность.

Если вы предпочитаете использовать Homebrew, выполните:

brew install --cask claude-code

Обратите внимание, что Homebrew предлагает два варианта: claude-code (стабильный канал) и claude-code@latest (последние версии). Установка через Homebrew не обновляется автоматически — для обновления нужно выполнять brew upgrade claude-code или brew upgrade claude-code@latest вручную.

Установка на Windows: нативный установщик и WinGet

Windows поддерживает несколько способов установки Claude Code CLI. Самый простой — использовать нативный установщик через PowerShell или CMD.

Для PowerShell выполните:

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

Для CMD:

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

Важно не перепутать команды: если вы запустите CMD-команду в PowerShell, появится ошибка The token '&&' is not a valid statement separator. Если вы запустите PowerShell-команду в CMD, появится 'irm' is not recognized as an internal or external command. Определить текущую оболочку можно по приглашению: PowerShell показывает PS C:\Users\Имя>, а CMD — просто C:\Users\Имя>.

Альтернативный способ — использование менеджера пакетов WinGet. Выполните команду:

winget install Anthropic.ClaudeCode

Обратите внимание на регистр: идентификатор пакета чувствителен к регистру при использовании флага --exact. Если вы укажете anthropic.claudecode с -e, установка завершится ошибкой. Без флага -e регистр не важен, так как WinGet выполняет поиск без учёта регистра.

После установки через WinGet откройте новый терминал и проверьте:

claude --version

Если команда не найдена, скорее всего, проблема в PATH — об этом мы поговорим в отдельном разделе. Установка через WinGet не обновляется автоматически, поэтому периодически выполняйте winget upgrade Anthropic.ClaudeCode.

Установка через WSL и Linux-менеджеры пакетов

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

Чтобы установить Claude Code в WSL, откройте терминал WSL и выполните команду нативного установщика для Linux:

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

Запуск claude также должен выполняться из терминала WSL, а не из PowerShell. Для WSL не требуется Git for Windows, так как используется Linux-окружение.

Для серверов и управляемых сред удобно использовать системные менеджеры пакетов. Anthropic публикует подписанные репозитории для apt, dnf и apk. Например, для Debian/Ubuntu:

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc -o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

Для Fedora/RHEL используется dnf, для Alpine — apk. В Alpine необходимо дополнительно установить пакеты bash, curl, libgcc, libstdc++, ripgrep и установить переменную окружения USE_BUILTIN_RIPGREP=0. Также может потребоваться добавить community-репозиторий, если пакет ripgrep не найден.

Установка через менеджеры пакетов не обновляется автоматически — обновления выполняются штатными командами (sudo apt upgrade claude-code, sudo dnf upgrade claude-code и т.д.).

Установка через npm и особенности этого способа

Хотя нативные установщики являются предпочтительными, некоторые разработчики предпочитают устанавливать Claude Code через npm. Команда установки:

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

Важно знать несколько нюансов. Начиная с версии 2.1.198, пакет требует Node.js 22 или новее. Если у вас установлена более старая версия Node.js, npm выведет предупреждение EBADENGINE, но установка всё равно завершится, и CLI будет работать. Однако для корректной работы рекомендуется обновить Node.js.

Пакет npm поставляет тот же нативный бинарный файл, что и автономный установщик, через опциональные зависимости для конкретной платформы (например, @anthropic-ai/claude-code-darwin-arm64). Это означает, что во время выполнения Node.js не используется — бинарный файл запускается напрямую. Убедитесь, что ваш менеджер пакетов разрешает установку опциональных зависимостей, иначе бинарный файл может отсутствовать.

Для обновления используйте команду npm install -g @anthropic-ai/claude-code@latest. Не рекомендуется использовать npm update -g, так как она может не перейти на последнюю версию из-за семантического версионирования. Также избегайте запуска sudo npm install -g — это может вызвать проблемы с правами доступа и представляет угрозу безопасности. Если возникают ошибки EACCES, лучше настроить права на каталог npm или использовать менеджер версий Node.js.

Если вы ранее установили Claude Code через npm и хотите перейти на нативный установщик, выполните claude install — это автоматически заменит версию.

Настройка PATH и устранение ошибки «command not found»

Одна из самых частых проблем после установки — ошибка command not found: claude (на macOS/Linux) или 'claude' is not recognized (на Windows). В большинстве случаев это связано с тем, что каталог установки не добавлен в переменную окружения PATH.

Сначала попробуйте открыть новый терминал. Сессия, из которой вы выполняли установку, сохраняет старый PATH и не видит новые каталоги. Если проблема не исчезла, проверьте, находится ли каталог установки в PATH.

На macOS и Linux бинарный файл находится в ~/.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

На Windows бинарный файл находится в %USERPROFILE%\.local\bin\claude.exe. Проверьте PATH в PowerShell:

$env:PATH -split ';' | Select-String '\.local\\bin'

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

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

После этого перезапустите терминал. Если проблема сохраняется, выполните claude doctor — эта команда выводит диагностику установки и подскажет, что не так.

Аутентификация и начало работы

После успешной установки необходимо аутентифицироваться. Claude Code требует учётную запись Pro, Max, Team, Enterprise или Console. Бесплатный план Claude.ai не поддерживается. Также можно использовать сторонних провайдеров API, таких как Amazon Bedrock, Google Cloud Agent Platform или Microsoft Foundry.

Для аутентификации запустите claude в терминале. Откроется браузер с запросом на вход в вашу учётную запись Anthropic. После подтверждения CLI автоматически получит токен доступа. Если у вас установлена переменная окружения ANTHROPIC_API_KEY, CLI один раз запросит разрешение на её использование вместо открытия браузера.

После аутентификации вы можете начать работу. Введите claude в каталоге проекта, чтобы открыть интерактивную сессию. Вы также можете использовать неинтерактивный режим с флагами, например claude -p "напиши тест для этого кода". Для проверки установки и конфигурации выполните claude doctor — эта команда выводит информацию о состоянии установки, ошибках в файлах настроек и предупреждениях.

Если вы используете корпоративную среду, возможно, потребуется настроить прокси или дополнительные параметры сети. Документация Anthropic содержит раздел о сетевой конфигурации, который поможет решить подобные проблемы.

Обновление и управление версиями

Claude Code CLI поддерживает несколько механизмов обновления, которые зависят от способа установки. Нативные установщики (macOS, Linux, Windows) и npm автоматически обновляются в фоновом режиме. При каждом запуске CLI проверяет наличие новой версии и загружает её, а изменения вступают в силу при следующем запуске.

Если вы хотите контролировать процесс обновления, можно настроить канал обновлений. По умолчанию используется канал latest, который получает новые функции сразу после выпуска. Канал stable задерживает обновления примерно на неделю и пропускает версии с серьёзными регрессиями. Настроить канал можно через команду /config в интерактивном режиме или в файле settings.json:

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

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

Установки через Homebrew, WinGet и системные менеджеры пакетов не обновляются автоматически. Для Homebrew используйте brew upgrade claude-code или brew upgrade claude-code@latest. Для WinGet — winget upgrade Anthropic.ClaudeCode. Для apt/dnf/apk — стандартные команды обновления пакетов.

Если вы хотите, чтобы Claude Code сам выполнял обновление для Homebrew или WinGet, установите переменную окружения CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1. В этом случае CLI будет запускать команду обновления в фоновом режиме и предложит перезапуск после успешного обновления. Обратите внимание, что при использовании WinGet обновление может завершиться ошибкой, если Claude Code запущен, так как Windows блокирует исполняемый файл. В этом случае закройте все сессии и повторите попытку.

Удаление Claude Code CLI

Если вам больше не нужен Claude Code CLI, его можно удалить. Способ удаления зависит от того, как вы его устанавливали.

Для нативного установщика на macOS и Linux удалите символическую ссылку и каталог с версиями:

rm ~/.local/bin/claude
rm -rf ~/.local/share/claude

На Windows удалите файлы в %USERPROFILE%\.local\bin\claude.exe и %USERPROFILE%\.local\share\claude. Также можно использовать команду claude uninstall, если она доступна.

Для Homebrew:

brew uninstall --cask claude-code

Для WinGet:

winget uninstall Anthropic.ClaudeCode

Для npm:

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

Для системных менеджеров пакетов используйте стандартные команды удаления, например sudo apt remove claude-code.

После удаления рекомендуется также удалить файлы конфигурации, которые находятся в ~/.claude (на macOS/Linux) или %USERPROFILE%\.claude (на Windows). Это удалит настройки, историю и кэш. Если вы использовали сторонние провайдеры API, убедитесь, что вы отозвали доступ в соответствующих сервисах.

Вопросы и ответы