$ sudo teach IT

Установка Claude Code — это не одна команда, а короткая цепочка решений: каким способом ставить, как обновляться, чем авторизоваться. Ошибка на любом шаге даёт один и тот же неприятный результат: команда claude не находится, или находится, но отказывается работать. И в обоих случаях причина обычно не в самом инструменте.

Чаще всего люди спотыкаются на трёх вещах. Ставят через sudo npm install -g и получают проблемы с правами. Устанавливают расширение для редактора и удивляются, что claude не работает в терминале. Держат в переменных окружения старый API-ключ и не понимают, почему вход по подписке не предлагается.

После этого урока у вас будет рабочая установка Claude Code, привязанная к вашей учётной записи, и понимание, как её обновлять и диагностировать, если что-то пойдёт не так.

Что уже умеем / что добавим

На прошлом уроке вы разобрались с доступом: выбрали платный план или учётную запись Console и убедились, что система соответствует требованиям. Теперь превратим этот доступ в работающий инструмент — поставим Claude Code, выполним вход и проверим, что всё на месте.

Что вы узнаете в рамках статьи

  • Какие есть способы установки и чем они отличаются
  • Как проверить, что установка прошла успешно, и что делать, если нет
  • Как выполнить вход по учётной записи и чем это отличается от входа по API-ключу
  • Как устроены автообновления и как выбрать канал обновлений
  • Как полностью удалить Claude Code, если понадобится переустановка

Ключевые термины

  • Нативный установщик — скрипт, который скачивает готовый бинарный файл Claude Code и настраивает его. Рекомендуемый способ установки.
  • Канал обновлений — поток версий, на который вы подписаны: latest (все релизы сразу) или stable (версии примерно недельной давности).
  • claude doctor — диагностическая команда, которая выводит состояние установки и настроек, не запуская сессию.
  • Вход по учётной записи — авторизация через браузер под вашим аккаунтом Claude.ai или Console.
  • ANTHROPIC_API_KEY — переменная окружения с API-ключом. Если она задана, Claude Code предложит подтвердить этот ключ вместо открытия браузера.

Выбираем способ установки

Основной и рекомендуемый способ — нативный установщик. Он скачивает бинарный файл под вашу платформу и умеет обновляться сам.

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

Есть и альтернативы. Через Homebrew: brew install --cask claude-code. Через WinGet: winget install Anthropic.ClaudeCode. Через npm: npm install -g @anthropic-ai/claude-code (потребуется Node.js 22 или новее).

Разница между ними — не в возможностях, а в обновлениях. Нативная установка обновляется в фоне автоматически. Homebrew, WinGet и системные пакетные менеджеры — нет, их нужно обновлять вручную. Пакет npm, к слову, ставит тот же самый бинарный файл: Node.js используется только для установки, а не для работы.

Важное предупреждение: не используйте sudo npm install -g. Это приводит к проблемам с правами доступа и создаёт риски безопасности.

После установки перейдите в каталог проекта и запустите:

claude

Откроется интерактивная сессия в терминале — это и есть Claude Code.

Проверяем, что установка прошла успешно

Прежде чем что-то настраивать, убедитесь, что инструмент вообще виден системе:

claude --version

Рабочая установка выведет номер версии, например 2.1.211 (Claude Code). Если вместо этого вы видите command not found, значит бинарный файл не попал в PATH — это самая частая проблема установки.

Для более подробной картины есть отдельная команда:

claude doctor

Она печатает диагностику установки и настроек: состояние инсталляции, ошибки в файлах настроек, предупреждения с предложенными исправлениями. Сессию при этом не запускает. Заведите привычку: любая непонятная проблема с Claude Code — сначала claude doctor, потом всё остальное.

Выполняем вход

Отдельной команды установки для входа не нужно. Запустите claude и следуйте подсказкам в браузере — откроется страница авторизации, вы войдёте под своей учётной записью, и Claude Code свяжется с ней.

Claude Code требует учётную запись Pro, Max, Team, Enterprise или Console. Бесплатный план Claude.ai доступа не даёт — об этом мы говорили на прошлом уроке.

Если в вашем окружении задана переменная ANTHROPIC_API_KEY, поведение будет другим: браузер не откроется, вместо этого Claude Code один раз попросит подтвердить использование этого ключа. Это удобно для автоматизации, но неожиданно, если вы забыли про старую переменную в конфигурации оболочки. Проверить легко:

echo $ANTHROPIC_API_KEY

Пустой вывод — переменной нет, вход пойдёт через браузер. Если вывелся ключ, а вы хотели войти по подписке, уберите переменную из ~/.zshrc или ~/.bashrc и перезапустите терминал.

Обновления и каналы

Нативная установка проверяет обновления при запуске и периодически во время работы. Новая версия скачивается в фоне и применяется при следующем старте. Результат последней попытки обновления показывает всё тот же claude doctor.

Чтобы обновиться немедленно, не дожидаясь фоновой проверки:

claude update

Если версия уже последняя, команда сообщит Claude Code is up to date (<version>).

Каналом обновлений управляет настройка autoUpdatesChannel. Значение latest (по умолчанию) даёт новые возможности сразу, stable — версии примерно недельной давности, из которых исключены релизы с серьёзными регрессиями. Настраивается через /config → Auto-update channel или прямо в файле настроек:

{
  "autoUpdatesChannel": "stable"
}

Если автообновления вам мешают — например, вы работаете в среде с фиксированными версиями, — их можно выключить:

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

При этом claude update продолжит работать: переменная отключает только фоновую проверку.

Удаление и переустановка

Иногда проще снести всё и поставить заново — особенно если в системе оказалось несколько установок разными способами. Для нативной установки:

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 всё ещё запускается, значит в системе есть вторая установка другим способом: найдите и уберите её.

Отдельно отметим: файлы конфигурации (~/.claude и ~/.claude.json) при удалении бинарника остаются. Это удобно — переустановка не потребует настраивать всё заново. Удалять их стоит только тогда, когда вы действительно хотите начать с чистого листа.

Частые ошибки

  • Установка через sudo npm install -g. Даёт проблемы с правами доступа к глобальному каталогу npm и создаёт риски безопасности. Используйте нативный установщик или обычный npm install -g без sudo.
  • Ожидание, что расширение для редактора добавит claude в терминал. Расширение содержит собственную копию инструмента только для своей панели. Чтобы команда claude работала в терминале, нужна отдельная установка.
  • Забытая переменная ANTHROPIC_API_KEY в конфигурации оболочки. Вход по учётной записи не предложится, Claude Code будет использовать старый ключ. Проверьте переменную, если авторизация ведёт себя не так, как вы ожидали.
  • Несколько установок разными способами одновременно. Обновляется одна, а запускается другая — версии расходятся, поведение становится непредсказуемым. Оставьте один способ установки.

Наиболее частые вопросы

  • Нужен ли Node.js для работы Claude Code? — Нет. Даже пакет npm ставит нативный бинарный файл, который не использует Node.js при запуске. Node.js нужен только для самой установки через npm.
  • После установки команда claude не находится. Что делать? — Скорее всего, каталог с бинарником не попал в PATH. Запустите claude doctor из работающей установки или проверьте PATH вручную.
  • Обязательно ли обновляться вручную? — При нативной установке нет, обновления идут в фоне. При установке через Homebrew, WinGet или системный пакетный менеджер — да, они не обновляются автоматически.
  • Можно ли поставить конкретную версию? — Да, нативный установщик принимает номер версии: curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89.
  • Что делать, если после переустановки пропали настройки? — Значит, вместе с бинарником удалили ~/.claude. Сам по себе удалённый бинарник настройки не трогает.

Итоги

Отличная работа — у вас на машине рабочий Claude Code, привязанный к вашей учётной записи. Вы понимаете, чем нативная установка отличается от установки через пакетные менеджеры, умеете проверять состояние через claude --version и claude doctor, знаете, как переключить канал обновлений и что делать при переустановке.

Это тот фундамент, который дальше просто работает и не отвлекает. На следующем уроке мы займёмся окружением: настроим терминал так, чтобы многострочные запросы и уведомления вели себя предсказуемо, и подключим Claude Code к редактору. После него работать станет заметно комфортнее.

На следующий урок