К содержимому
Блог

Как установить Claude Code: официальные способы и проверка

Как установить 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 задаются отдельным шагом.

Какой способ выбрать

СпособКак обновляетсяКогда подходит
Нативный установщикв фоне, самвыбор по умолчанию для ноутбука
Homebrewbrew upgrade claude-code вручнуювы и так ставите всё через brew
WinGetwinget upgrade Anthropic.ClaudeCode вручнуюто же на Windows
npmnpm 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

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

Внутри WSL команду запускают в терминале дистрибутива, а не в PowerShell.

Windows

В PowerShell:

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

В CMD другая команда:

batch
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, он стоит по умолчанию.

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

Новая модель иногда требует версию новее, чем отдаёт stable. Тогда на время переключитесь на latest.

Пакетные менеджеры

bash
brew install --cask claude-code
powershell
winget install Anthropic.ClaudeCode
bash
npm install -g @anthropic-ai/claude-code

У Homebrew два cask: claude-code следует стабильному каналу и отстаёт примерно на неделю, claude-code@latest получает релизы сразу. Перед npm install -g не добавляйте sudo: Anthropic прямо предупреждает, что это ведёт к проблемам с правами.

Как проверить, что стоит оригинал

Первая проверка занимает секунду. Откройте новое окно терминала и выполните:

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

bash
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 на ту же дату.

Создать аккаунт и ключ

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.