Как установить Claude Code: официальные способы и проверка
Claude Code ставится пятью способами: нативным установщиком, через Homebrew, WinGet, npm и подписанные репозитории apt, dnf и apk. Для большинства лучше нативный, потому что он обновляется сам. После установки запустите claude --version и claude doctor, потом подключите Relay: для этого нужны адрес, ключ и модель.
Коротко
Нативный установщик ставится одной командой на macOS, Linux, WSL и Windows и единственный обновляется в фоне.
Homebrew, WinGet, npm и пакеты Linux обновляются вручную.
claude --versionиclaude doctorпроверяют установку. Ключ и адрес Relay задаются отдельным шагом.
Какой способ выбрать
| Способ | Как обновляется | Когда подходит |
|---|---|---|
| Нативный установщик | в фоне, сам | выбор по умолчанию для ноутбука |
| Homebrew | brew upgrade claude-code вручную | вы и так ставите всё через brew |
| WinGet | winget upgrade Anthropic.ClaudeCode вручную | то же на Windows |
| npm | npm install -g @anthropic-ai/claude-code@latest вручную, нужен Node.js 22 или новее | npm уже часть вашего процесса |
| apt, dnf, apk | командой пакетного менеджера | серверы, образы, CI |
Я начинал бы с нативного установщика и уходил бы с него только по понятной причине: на сервере нужен пакет с подписью репозитория, в команде принято ставить всё через brew или WinGet. Причина «так привычнее» плохая, потому что за обновлениями придётся следить самому. Для обновления через npm не используйте npm update -g: по документации Anthropic он может не дойти до последнего релиза.
Что нужно заранее
По системным требованиям Anthropic на 14 октября 2026 поддерживаются macOS 13 и новее, Windows 10 версии 1809 и новее (или Windows Server 2019), Ubuntu 20.04, Debian 10 и Alpine 3.19 или новее, не меньше 4 ГБ памяти и процессор x64 или ARM64. На Alpine нет bash и curl: поставьте их вместе с libgcc, libstdc++ и ripgrep, иначе установочная команда упадёт с ошибкой not found. После этого задайте USE_BUILTIN_RIPGREP=0 в блоке env файла settings.json, чтобы Claude Code использовал установленный ripgrep. Права администратора на Windows не нужны.
Команды установки
Все команды ниже сверены со страницей Advanced setup в документации Anthropic на 14 октября 2026.
macOS, Linux и WSL
curl -fsSL https://claude.ai/install.sh | bashВнутри WSL команду запускают в терминале дистрибутива, а не в PowerShell.
Windows
В PowerShell:
irm https://claude.ai/install.ps1 | iexВ CMD другая команда:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdОболочку подскажет приглашение: PS C:\ значит PowerShell, просто C:\ значит CMD. Ошибка The token '&&' is not a valid statement separator говорит, что вы в PowerShell с командой для CMD. Ошибка 'irm' is not recognized говорит об обратном. Windows-специфику (Git for Windows, WSL, MCP) разбирает отдельная статья про Claude Code на Windows.
Канал и версия
Нативный установщик принимает канал или номер версии. Для команды я бы закрепил stable: у всех одинаковое поведение, а релизы с серьёзными регрессиями пропускаются. Для одиночной работы подойдёт latest, он стоит по умолчанию.
curl -fsSL https://claude.ai/install.sh | bash -s stable
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89Новая модель иногда требует версию новее, чем отдаёт stable. Тогда на время переключитесь на latest.
Пакетные менеджеры
brew install --cask claude-codewinget install Anthropic.ClaudeCodenpm install -g @anthropic-ai/claude-codeУ Homebrew два cask: claude-code следует стабильному каналу и отстаёт примерно на неделю, claude-code@latest получает релизы сразу. Перед npm install -g не добавляйте sudo: Anthropic прямо предупреждает, что это ведёт к проблемам с правами.
Как проверить, что стоит оригинал
Первая проверка занимает секунду. Откройте новое окно терминала и выполните:
claude --version
claude doctorПервая команда печатает номер версии вида 2.1.211 (Claude Code). Вторая выводит диагностику без запуска сессии: состояние установки, ошибки в файлах настроек и подсказки по исправлению.
Оригинал определяется источником. Официальными считаются только каналы, перечисленные выше. Установщик с «обходом подписки», архив с форума или «ускоренная сборка» к ним не относятся, и обходить там нечего: сама установка открыта. Двоичные файлы на macOS подписаны организацией Anthropic PBC и нотаризованы Apple, проверяется командой codesign --verify --verbose ./claude. На Windows подпись смотрит Get-AuthenticodeSignature .\claude.exe. Репозитории apt и dnf подписаны ключом релизов с отпечатком 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE.
Для рабочего ноутбука этого хватает. Полная проверка подписанного манифеста с контрольными суммами нужна серверам, где важна цепочка доверия, и описана на той же странице Anthropic.
Подключение к Relay после установки
Установленный claude при первом запуске ждёт вход в аккаунт Anthropic. Если в окружении заданы адрес и ключ шлюза, Claude Code использует их вместо входа. Нужны три вещи: ANTHROPIC_BASE_URL=https://relay-llm.ru без /v1, ключ в ANTHROPIC_AUTH_TOKEN и идентификаторы моделей. Ключ выпускается по инструкции как получить API-ключ Claude.
С моделями есть ловушка. Для фоновых задач Claude Code берёт модель из ANTHROPIC_DEFAULT_HAIKU_MODEL, а в каталоге Relay на 14 октября 2026 моделей Haiku нет. Задайте вместо неё любую Claude-модель из каталога, например эту:
Полный набор переменных и вариант для settings.json собраны в статье про подключение Claude Code к Relay и на странице интеграции. Проверка занимает минуту: запустите claude, выполните /status и найдите строку Anthropic base URL с адресом Relay. Затем отправьте claude -p "ping" и убедитесь, что запрос появился в журнале запросов.
Если claude не находится
После установки команда может быть «not found», когда папка с программой не входит в PATH. Нативный установщик кладёт файл в ~/.local/bin/claude на macOS и Linux и в %USERPROFILE%\.local\bin\claude.exe на Windows. Сначала закройте терминал и откройте новый: уже запущенное окно не видит свежий PATH. Не помогло, добавьте папку вручную (пример для zsh):
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrcДля Bash на Linux файл ~/.bashrc, для Bash на macOS ~/.bash_profile. Разбор остальных симптомов лежит в диагностике подключения.
Обновление и удаление
Нативная установка обновляется сама, а немедленное обновление запускает claude update. Для Homebrew, WinGet и пакетов Linux используйте команды из таблицы выше. Удаление зависит от способа: для нативной установки это rm -f ~/.local/bin/claude и rm -rf ~/.local/share/claude, для Homebrew brew uninstall --cask claude-code, для npm npm uninstall -g @anthropic-ai/claude-code. Настройки в ~/.claude остаются на месте, пока вы не удалите их сами.
Нужен ли Node.js для Claude Code?
Нативному установщику Node.js не нужен. Он требуется только для установки через npm, и версия должна быть 22 или новее. На старой версии npm выводит предупреждение, но установка завершается.
Чем отличаются каналы stable и latest?
Канал stable отстаёт примерно на неделю и пропускает релизы с серьёзными регрессиями, latest получает версии сразу. По умолчанию нативная установка следует latest, а Homebrew выбирает канал по имени cask.
Почему установщик вернул HTML или ошибку 403?
Адрес установки отдал веб-страницу вместо скрипта. В документации Anthropic среди причин названы сеть, прокси и фильтры, временный сбой и ограничение по стране. Страница об ошибках установки сопоставляет каждое сообщение с исправлением и предлагает другие установщики.
Источники
Команды, системные требования и проверка подписи сверены со страницей Advanced setup на 14 октября 2026. Порядок подключения к шлюзу описан на странице Connect Claude Code to an LLM gateway на ту же дату.