Посадка

Посадка — это установка инструмента и понимание, что именно появилось у вас на диске. Половина «загадочных» проблем новичка объясняется тем, что он не знает, где живёт конфигурация и какой бинарь на самом деле запускается.

Что ставится

Claude Code — один нативный исполняемый файл, а не пакет Node. Даже установка через npm тянет платформенный бинарь через опциональную зависимость и линкует его; сам claude при работе Node не вызывает. Поэтому «переустановить Node» как способ починки почти никогда не помогает.

Требования: macOS 13+, Windows 10 1809+ или Server 2019+, Ubuntu 20.04+, Debian 10+, Alpine 3.19+; 4 ГБ ОЗУ, x64 или ARM64; оболочка Bash, Zsh, PowerShell или CMD. Поиск по репозиторию делает ripgrep — он идёт в комплекте, и отдельно ставить его нужно только на musl-дистрибутивах (USE_BUILTIN_RIPGREP=0).

Способы установки

Каналы релизов два. latest отдаёт версию сразу, stable — примерно недельной давности, минуя релизы с крупными регрессиями. Для нативной установки канал выбирается при установке (bash -s stable) и дальше настройкой autoUpdatesChannel. У Homebrew канал зашит в имя каски: claude-code — stable, claude-code@latest — latest.

Где что лежит

• бинарь и версии: ~/.local/bin/claude — символическая ссылка в ~/.local/share/claude/versions/;
• личная конфигурация: каталог ~/.claude/ (скиллы, агенты, правила, настройки) и файл ~/.claude.json;
• проектная: .claude/ в корне репозитория плюс .mcp.json.

Что именно из этих файлов попадает в разговор и в каком порядке — разобрано в Скрижаль проекта.

Windows: три разных мира

Git for Windows формально опционален, но именно он даёт инструмент Bash: без него команды оболочки идут через инструмент PowerShell. Если Git Bash не находится, путь задаётся переменной CLAUDE_CODE_GIT_BASH_PATH в блоке env файла настроек. Песочница на нативном Windows не поддерживается вовсе — она построена на Seatbelt (macOS) и bubblewrap (Linux и WSL 2). Что это меняет для прав — в Круг дозволенного.

Проверка и обновление

claude --version печатает номер и слово (Claude Code). claude doctor — диагностика без запуска сессии: здоровье установки, ошибки в файлах настроек, результат последней попытки обновления. claude update применяет обновление немедленно.

DISABLE_AUTOUPDATER=1 в блоке env останавливает только фоновую проверку — claude update продолжит работать; чтобы закрыть и его, нужен DISABLE_UPDATES. Настройка minimumVersion задаёт нижнюю границу: переход на канал stable после этого не откатит вас назад.

Версия — не косметика. Больше половины фактов об инструменте верны начиная с конкретного номера, и в документации это помечено прямо на странице механизма шаблоном Requires Claude Code v2.1. Как встроить сверку версии в привычку — Как читать журнал изменений.

Удаление

Нативная установка снимается двумя командами: удалить ~/.local/bin/claude и каталог ~/.local/share/claude. Конфигурация живёт отдельно — ~/.claude и ~/.claude.json; их удаление сотрёт настройки, MCP-серверы и историю сессий, поэтому это отдельное осознанное действие, а не часть деинсталляции.