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

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

Claude Code работает на следующих платформах и конфигурациях:
  • Операционная система:
    • macOS 13.0+
    • Windows 10 1809+ или Windows Server 2019+
    • Ubuntu 20.04+
    • Debian 10+
    • Alpine Linux 3.19+
  • Оборудование: 4 ГБ+ ОЗУ, процессор x64 или ARM64
  • Сеть: требуется подключение в Интернет. См. конфигурация сети.
  • Shell: Bash, Zsh, PowerShell или CMD. Встроенные установки Windows требуют Git for Windows. Установки WSL не требуют.
  • Местоположение: поддерживаемые Anthropic страны

​
Дополнительные зависимости

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

Предпочитаете графический интерфейс? Приложение Desktop позволяет использовать Claude Code без терминала. Загрузите его для macOS или Windows.Новичок в терминале? См. руководство по терминалу для пошаговых инструкций.
To install Claude Code, use one of the following methods: You can also install with apt, dnf, or apk on Debian, Fedora, RHEL, and Alpine. После завершения установки откройте терминал в проекте, над которым вы хотите работать, и запустите Claude Code: 
claude
Если вы столкнулись с какими-либо проблемами во время установки, см. руководство по устранению неполадок.

​
Настройка в Windows

Вы можете запустить Claude Code изначально в Windows или внутри WSL. Выберите в зависимости от того, где находятся ваши проекты и какие функции вам нужны:
ОпцияТребуетSandboxingКогда использовать
Native WindowsGit for WindowsНе поддерживаетсяВстроенные проекты и инструменты Windows
WSL 2WSL 2 включенПоддерживаетсяЦепочки инструментов Linux или изолированное выполнение команд
WSL 1WSL 1 включенНе поддерживаетсяЕсли WSL 2 недоступен
Вариант 1: Native Windows с Git Bash Установите Git for Windows, затем выполните команду установки из PowerShell или CMD. Вам не нужно запускать от имени администратора. Независимо от того, устанавливаете ли вы из PowerShell или CMD, это влияет только на то, какую команду установки вы выполняете. Ваша подсказка показывает PS C:\Users\YourName> в PowerShell и C:\Users\YourName> без PS в CMD. Если вы новичок в терминале, руководство по терминалу проходит через каждый шаг. После установки запустите claude из PowerShell, CMD или Git Bash. Claude Code использует Git Bash внутри для выполнения команд независимо от того, откуда вы его запустили. Если Claude Code не может найти вашу установку Git Bash, установите путь в файле settings.json: 
{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}
Claude Code также может запускать PowerShell изначально в Windows. Инструмент PowerShell развертывается постепенно; установите CLAUDE_CODE_USE_POWERSHELL_TOOL=1 для включения или 0 для отключения. См. инструмент PowerShell для настройки и ограничений. Вариант 2: WSL Откройте ваше распределение WSL и выполните установщик Linux из инструкций установки выше. Вы устанавливаете и запускаете claude внутри терминала WSL, а не из PowerShell или CMD.

​
Alpine Linux и дистрибутивы на основе musl

Встроенный установщик на Alpine и других дистрибутивах на основе musl/uClibc требует libgcc, libstdc++ и ripgrep. Установите их с помощью менеджера пакетов вашего дистрибутива, затем установите USE_BUILTIN_RIPGREP=0. Этот пример устанавливает необходимые пакеты на Alpine: 
apk add libgcc libstdc++ ripgrep
Затем установите USE_BUILTIN_RIPGREP на 0 в файле settings.json: 
{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}

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

После установки убедитесь, что Claude Code работает: 
claude --version
Для более подробной проверки установки и конфигурации выполните claude doctor: 
claude doctor

​
Аутентификация

Claude Code требует учетную запись Pro, Max, Team, Enterprise или Console. Бесплатный план Claude.ai не включает доступ к Claude Code. Вы также можете использовать Claude Code с поставщиком API третьей стороны, таким как Amazon Bedrock, Google Vertex AI или Microsoft Foundry. После установки войдите, выполнив claude и следуя подсказкам браузера. См. Аутентификация для всех типов учетных записей и параметров настройки команды.

​
Обновление Claude Code

Встроенные установки автоматически обновляются в фоновом режиме. Вы можете настроить канал выпуска для управления тем, получаете ли вы обновления немедленно или по отложенному стабильному расписанию, или отключить автоматические обновления полностью. Установки Homebrew, WinGet и менеджер пакетов Linux требуют ручного обновления.

​
Автоматические обновления

Claude Code проверяет наличие обновлений при запуске и периодически во время работы. Обновления загружаются и устанавливаются в фоновом режиме, а затем вступают в силу при следующем запуске Claude Code.
Установки Homebrew, WinGet, apt, dnf и apk не обновляются автоматически. Для Homebrew выполните brew upgrade claude-code или brew upgrade claude-code@latest, в зависимости от того, какой cask вы установили. Для WinGet выполните winget upgrade Anthropic.ClaudeCode. Для менеджеров пакетов Linux см. команды обновления в разделе Install with Linux package managers.Известная проблема: Claude Code может уведомить вас об обновлениях до того, как новая версия будет доступна в этих менеджерах пакетов. Если обновление не удается, подождите и повторите попытку позже.Homebrew сохраняет старые версии на диске после обновлений. Периодически выполняйте brew cleanup для освобождения дискового пространства.

​
Настройка канала выпуска

Управляйте каналом выпуска, который Claude Code использует для автоматических обновлений и claude update, с помощью параметра autoUpdatesChannel:
  • "latest", по умолчанию: получайте новые функции сразу же после их выпуска
  • "stable": используйте версию, которая обычно имеет возраст около одной недели, пропуская выпуски с серьезными регрессиями
Настройте это через /config → Auto-update channel, или добавьте в файл settings.json: 
{
  "autoUpdatesChannel": "stable"
}
Для развертываний в масштабах предприятия вы можете обеспечить согласованный канал выпуска во всей организации, используя управляемые параметры. Установки Homebrew выбирают канал по имени cask вместо этого параметра: claude-code отслеживает стабильный и claude-code@latest отслеживает последний.

​
Закрепление минимальной версии

Параметр minimumVersion устанавливает нижний предел. Фоновые автоматические обновления и claude update отказываются устанавливать любую версию ниже этого значения, поэтому переход на канал "stable" не понижает вас, если вы уже находитесь на более новой сборке "latest". Переключение с "latest" на "stable" через /config предлагает вам либо остаться на текущей версии, либо разрешить понижение. Выбор остаться устанавливает minimumVersion на эту версию. Переключение обратно на "latest" очищает его. Добавьте его в файл settings.json для явного закрепления нижнего предела: 
{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}
В управляемых параметрах это обеспечивает минимум на уровне организации, который параметры пользователя и проекта не могут переопределить.

​
Отключение автоматических обновлений

Установите DISABLE_AUTOUPDATER на "1" в ключе env файла settings.json: 
{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}
DISABLE_AUTOUPDATER только останавливает фоновую проверку; claude update и claude install по-прежнему работают. Чтобы заблокировать все пути обновления, включая ручные обновления, установите DISABLE_UPDATES вместо этого. Используйте это, когда вы распространяете Claude Code через свои собственные каналы и вам нужно, чтобы пользователи оставались на версии, которую вы предоставляете.

​
Ручное обновление

Чтобы применить обновление немедленно без ожидания следующей проверки в фоновом режиме, выполните: 
claude update

​
Расширенные параметры установки

Эти параметры предназначены для закрепления версии, менеджеров пакетов Linux, npm и проверки целостности двоичного файла.

​
Установка определенной версии

Встроенный установщик принимает либо конкретный номер версии, либо канал выпуска (latest или stable). Канал, который вы выбираете во время установки, становится вашим значением по умолчанию для автоматических обновлений. См. настройка канала выпуска для получения дополнительной информации. Для установки последней версии (по умолчанию): 
curl -fsSL https://claude.ai/install.sh | bash
Для установки стабильной версии: 
curl -fsSL https://claude.ai/install.sh | bash -s stable
Для установки определенного номера версии: 
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

​
Установка с менеджерами пакетов Linux

Claude Code публикует подписанные репозитории apt, dnf и apk. Замените stable на latest для канала rolling. Установки менеджеров пакетов не обновляются автоматически через Claude Code; обновления поступают через ваш обычный рабочий процесс обновления системы. Все репозитории подписаны с помощью ключа подписи выпуска Claude Code. Перед доверием к ключу проверьте его, как описано в каждой вкладке.
Для Debian и Ubuntu. Чтобы использовать канал rolling, измените оба вхождения stable в строке deb: путь URL и имя suite.
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
Проверьте отпечаток ключа GPG перед доверием к нему: gpg --show-keys /etc/apt/keyrings/claude-code.asc должен сообщить 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE.Для обновления позже выполните sudo apt update && sudo apt upgrade claude-code.

​
Установка с npm

Вы также можете установить Claude Code как глобальный пакет npm. Пакет требует Node.js 18 или позже. 
npm install -g @anthropic-ai/claude-code
Пакет npm устанавливает тот же встроенный двоичный файл, что и автономный установщик. npm получает двоичный файл через дополнительную зависимость для каждой платформы, такую как @anthropic-ai/claude-code-darwin-arm64, и шаг postinstall связывает его на место. Установленный двоичный файл claude сам по себе не вызывает Node. Поддерживаемые платформы установки npm: darwin-arm64, darwin-x64, linux-x64, linux-arm64, linux-x64-musl, linux-arm64-musl, win32-x64 и win32-arm64. Ваш менеджер пакетов должен разрешать дополнительные зависимости. См. устранение неполадок, если двоичный файл отсутствует после установки.
НЕ используйте sudo npm install -g, так как это может привести к проблемам с разрешениями и рискам безопасности. Если вы столкнулись с ошибками разрешений, см. устранение неполадок ошибок разрешений.

​
Целостность двоичного файла и подпись кода

Каждый выпуск публикует manifest.json, содержащий контрольные суммы SHA256 для каждого двоичного файла платформы. Манифест подписан ключом GPG Anthropic, поэтому проверка подписи на манифесте транзитивно проверяет каждый двоичный файл, который он указывает.

​
Проверка подписи манифеста

Шаги 1-3 требуют оболочки POSIX с gpg и curl. В Windows выполните их в Git Bash или WSL. Шаг 4 включает опцию PowerShell.
1

Загрузка и импорт открытого ключа

Ключ подписи выпуска опубликован по фиксированному URL.
curl -fsSL https://downloads.claude.ai/keys/claude-code.asc | gpg --import
Отобразите отпечаток импортированного ключа.
gpg --fingerprint security@anthropic.com
Подтвердите, что вывод включает этот отпечаток:
31DD DE24 DDFA B679 F42D  7BD2 BAA9 29FF 1A7E CACE
2

Загрузка манифеста и подписи

Установите VERSION на выпуск, который вы хотите проверить.
REPO=https://downloads.claude.ai/claude-code-releases
VERSION=2.1.89
curl -fsSLO "$REPO/$VERSION/manifest.json"
curl -fsSLO "$REPO/$VERSION/manifest.json.sig"
3

Проверка подписи

Проверьте отделенную подпись против манифеста.
gpg --verify manifest.json.sig manifest.json
Действительный результат сообщает Good signature from "Anthropic Claude Code Release Signing <security@anthropic.com>".gpg также выводит WARNING: This key is not certified with a trusted signature! для любого вновь импортированного ключа. Это ожидается. Строка Good signature подтверждает, что криптографическая проверка прошла. Сравнение отпечатков на шаге 1 подтверждает, что сам ключ является подлинным.
4

Проверка двоичного файла против манифеста

Сравните контрольную сумму SHA256 вашего загруженного двоичного файла со значением, указанным в platforms.<platform>.checksum в manifest.json.
sha256sum claude
Подписи манифеста доступны для выпусков начиная с 2.1.89. Более ранние выпуски публикуют контрольные суммы в manifest.json без отделенной подписи.

​
Подписи кода платформы

В дополнение к подписанному манифесту отдельные двоичные файлы несут подписи кода, специфичные для платформы, где это поддерживается.
  • macOS: подписано “Anthropic PBC” и заверено Apple. Проверьте с помощью codesign --verify --verbose ./claude.
  • Windows: подписано “Anthropic, PBC”. Проверьте с помощью Get-AuthenticodeSignature .\claude.exe.
  • Linux: двоичные файлы не подписаны индивидуально кодом. Если вы загружаете непосредственно из корзины claude-code-releases или используете встроенный установщик, проверьте целостность с помощью подписи манифеста выше. Если вы устанавливаете с помощью apt, dnf или apk, ваш менеджер пакетов автоматически проверяет подписи, используя ключ подписи репозитория.

​
Удаление Claude Code

Чтобы удалить Claude Code, следуйте инструкциям для вашего метода установки.

​
Встроенная установка

Удалите двоичный файл Claude Code и файлы версии: 
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

​
Установка Homebrew

Удалите cask Homebrew, который вы установили. Если вы установили стабильный cask: 
brew uninstall --cask claude-code
Если вы установили последний cask: 
brew uninstall --cask claude-code@latest

​
Установка WinGet

Удалите пакет WinGet: 
winget uninstall Anthropic.ClaudeCode

​
apt / dnf / apk

Удалите пакет и конфигурацию репозитория: 
sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc

​
npm

Удалите глобальный пакет npm: 
npm uninstall -g @anthropic-ai/claude-code

​
Удаление файлов конфигурации

Удаление файлов конфигурации удалит все ваши параметры, разрешенные инструменты, конфигурации MCP server и историю сеансов.
Расширение VS Code, плагин JetBrains и приложение Desktop также записывают в ~/.claude/. Если какое-либо из них все еще установлено, каталог будет пересоздан при следующем запуске. Чтобы полностью удалить Claude Code, удалите расширение VS Code, плагин JetBrains и приложение Desktop перед удалением этих файлов. Чтобы удалить параметры Claude Code и кэшированные данные: 
# Удаление пользовательских параметров и состояния
rm -rf ~/.claude
rm ~/.claude.json

# Удаление параметров для конкретного проекта (выполните из каталога вашего проекта)
rm -rf .claude
rm -f .mcp.json