Установка Claude Code кажется тривиальной, но за ней стоит несколько решений, влияющих на воспроизводимость и обновления. Официально поддерживаются актуальные macOS, Windows и основные дистрибутивы Linux, x64 или ARM64 с минимумом памяти, один из распространённых shell и доступ в интернет из поддерживаемой страны. Требования стоит знать заранее: часть проблем первого запуска - не баги, а неподдерживаемое окружение.

Рекомендуемый способ - native installation через официальный установочный скрипт: на macOS, Linux и WSL его подтягивают curl'ом, на Windows - через PowerShell или CMD. Сразу после установки делают две проверки: claude --version отвечает на вопрос "что запускается", а claude doctor проверяет саму установку, валидность настроек и известные проблемы. Терминальный doctor - это read-only диагностика; внутрисессионный /doctor - это уже bundled skill, который может предложить исправления.

Есть и пакетные способы - Homebrew cask и WinGet, - у которых своя логика обновлений. Ключевое различие: native installation обновляется в фоне сама, а Homebrew, WinGet, apt, dnf и apk по умолчанию требуют обновления через свой пакетный менеджер. Для Homebrew и WinGet Claude Code способен сам запускать обновление пакета, но только если это явно разрешено переменной CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE. По умолчанию контроль остаётся за менеджером.

Канал обновлений задаётся осознанно. В native installation ключ autoUpdatesChannel принимает latest - новые версии сразу - или stable, где обычно есть примерно недельная задержка и пропуск релизов с крупными регрессиями. Рядом стоит minimumVersion - пол для обновлений: ни фоновое авто-обновление, ни claude update не поставят версию ниже него, поэтому переход на stable не откатит вас назад. Его легко спутать с requiredMinimumVersion, а это другое: тот ключ живёт только в managed settings, обновления не ограничивает и просто не даёт Claude Code запуститься на версии ниже указанной. Для по-настоящему воспроизводимого CI полагаются не на канал, а на установку явной версии или заранее подготовленный образ.

Полезно один раз увидеть и команды установки, и настройку канала рядом. Ниже - native-скрипт, проверка версии и doctor, а также фрагмент settings с каналом и минимальной версией. К этой карте возвращаются при заведении нового окружения или при переходе между latest и stable: она показывает, где именно принимается решение о том, какая версия у вас исполняется.