Расширенная настройка
Системные требования, установка для конкретной платформы, управление версиями и удаление Claude Code.
На этой странице рассматриваются системные требования, детали установки для конкретной платформы, обновления и удаление. Для пошагового руководства по вашему первому сеансу см. краткое руководство. Если вы никогда раньше не использовали терминал, см. руководство по терминалу.
Системные требования
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; Claude Code переходит на PowerShell при отсутствии Git Bash. Установки WSL не требуют Git for Windows.
- Местоположение: поддерживаемые Anthropic страны
Дополнительные зависимости
- ripgrep: обычно включен в Claude Code. Если поиск не работает, см. устранение неполадок поиска.
Установка Claude Code
To install Claude Code, use one of the following methods:
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
If you see The token '&&' is not a valid statement separator, you're in PowerShell, not CMD. If you see 'irm' is not recognized as an internal or external command, you're in CMD, not PowerShell. Your prompt shows PS C:\ when you're in PowerShell and C:\ without the PS when you're in CMD.
Git for Windows is recommended on native Windows so Claude Code can use the Bash tool. If Git for Windows is not installed, Claude Code uses PowerShell as the shell tool instead. WSL setups do not need Git for Windows.
brew install --cask claude-code
Homebrew offers two casks. claude-code tracks the stable release channel, which is typically about a week behind and skips releases with major regressions. claude-code@latest tracks the latest channel and receives new versions as soon as they ship.
winget install Anthropic.ClaudeCode
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 Windows | Git for Windows рекомендуется; PowerShell используется при отсутствии | Не поддерживается | Встроенные проекты и инструменты Windows |
| WSL 2 | WSL 2 включен | Поддерживается | Цепочки инструментов Linux или изолированное выполнение команд |
| WSL 1 | WSL 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. Когда установлен Git Bash, Claude Code использует его внутри для выполнения команд независимо от того, откуда вы его запустили. Если Claude Code не может найти вашу установку Git Bash, установите путь в файле settings.json:
{
"env": {
"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
}
}
Claude Code также может запускать PowerShell изначально в Windows. Когда установлен Git Bash, инструмент 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
Если это не сработает с ошибкой command not found или другой ошибкой, см. Troubleshoot installation and login.
Для более подробной проверки установки и конфигурации выполните 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.
Настройка канала выпуска
Управляйте каналом выпуска, который 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
irm https://claude.ai/install.ps1 | iex
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Для установки стабильной версии:
curl -fsSL https://claude.ai/install.sh | bash -s stable
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd stable && del install.cmd
Для установки определенного номера версии:
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 2.1.89 && del install.cmd
Установка с менеджерами пакетов 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.
Для Fedora и RHEL:
sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code
dnf загружает ключ при первой установке и предлагает вам подтвердить отпечаток. Проверьте, что он совпадает с 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE перед принятием.
Для обновления позже выполните sudo dnf upgrade claude-code.
Для Alpine Linux:
wget -O /etc/apk/keys/claude-code.rsa.pub \
https://downloads.claude.ai/keys/claude-code.rsa.pub
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add claude-code
Проверьте загруженный ключ с помощью sha256sum /etc/apk/keys/claude-code.rsa.pub, который должен сообщить 395759c1f7449ef4cdef305a42e820f3c766d6090d142634ebdb049f113168b6.
Для обновления позже выполните apk update && apk 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. Ваш менеджер пакетов должен разрешать дополнительные зависимости. См. устранение неполадок, если двоичный файл отсутствует после установки.
Для обновления установки npm выполните npm install -g @anthropic-ai/claude-code@latest. Избегайте npm update -g, который соблюдает диапазон semver из исходной установки и может не переместить вас на самый новый выпуск.
Целостность двоичного файла и подпись кода
Каждый выпуск публикует manifest.json, содержащий контрольные суммы SHA256 для каждого двоичного файла платформы. Манифест подписан ключом GPG Anthropic, поэтому проверка подписи на манифесте транзитивно проверяет каждый двоичный файл, который он указывает.
Проверка подписи манифеста
Шаги 1-3 требуют оболочки POSIX с gpg и curl. В Windows выполните их в Git Bash или WSL. Шаг 4 включает опцию PowerShell.
Загрузка и импорт открытого ключа
Ключ подписи выпуска опубликован по фиксированному 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
Загрузка манифеста и подписи
Установите 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"
Проверка подписи
Проверьте отделенную подпись против манифеста.
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 подтверждает, что сам ключ является подлинным.
Проверка двоичного файла против манифеста
Сравните контрольную сумму SHA256 вашего загруженного двоичного файла со значением, указанным в platforms.<platform>.checksum в manifest.json.
sha256sum claude
shasum -a 256 claude
(Get-FileHash claude.exe -Algorithm SHA256).Hash.ToLower()
Подписи кода платформы
В дополнение к подписанному манифесту отдельные двоичные файлы несут подписи кода, специфичные для платформы, где это поддерживается.
- 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 все еще работает после этого, у вас, вероятно, есть вторая установка или оставшийся псевдоним оболочки из старого установщика. См. Проверка конфликтующих установок, чтобы найти и удалить его.
Встроенная установка
Удалите двоичный файл Claude Code и файлы версии:
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
Установка 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
sudo dnf remove claude-code
sudo rm /etc/yum.repos.d/claude-code.repo
apk del claude-code
sed -i '\|downloads.claude.ai/claude-code/apk|d' /etc/apk/repositories
rm /etc/apk/keys/claude-code.rsa.pub
npm
Удалите глобальный пакет npm:
npm uninstall -g @anthropic-ai/claude-code
Удаление файлов конфигурации
Расширение 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
# Удаление пользовательских параметров и состояния
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force
# Удаление параметров для конкретного проекта (выполните из каталога вашего проекта)
Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Force