Инструменты

Как установить Claude Code и проверить первый запуск

Для кого

Тому, кто хочет работать с файлами проекта из терминала

Что вы получите

Проверите установку и первую маленькую правку

Время чтения

7 мин

Точка А: сейчас

Команда установлена по ролику, терминал её не находит или открывает чужую папку

Точка Б

Установка проверена, проект открыт осознанно, первая правка видна в diff

Порядок установки Claude Code на macOS, Windows и Linux, проверка команды и безопасный первый запуск в проекте.

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

Сведения об установке и условиях входа проверены 25 октября 2026 года по официальному руководству Anthropic и быстрому старту. Команды и доступ могут измениться, поэтому перед установкой откройте текущую версию этих страниц. Бесплатный план Claude в официальной инструкции не указан как способ доступа к Claude Code: требуется подходящая подписка, Console или поддерживаемый облачный провайдер.

Что проверить до загрузки

Узнайте версию операционной системы и откройте обычный терминал от своего пользователя. Проверьте свободное место, интернет и право установки программ. Не начинайте с sudo: если команда просит права администратора, сначала выясните, какой файл она собирается изменить. Anthropic перечисляет поддерживаемые среды на странице установки; там же есть отдельные шаги для Windows и WSL. На корпоративном компьютере доступ к загрузке и входу может определяться политикой организации.

СредаОфициальный путьПервая проверка
macOSHomebrew или нативная установкаКоманда видна в новом окне терминала
WindowsWinGet или нативный установщикPowerShell находит claude
LinuxНативный установщик и зависимости из документацииВерсия печатается без ошибки
WSLИнструкция для Linux внутри WSLПроект открыт в файловой системе WSL

Для macOS есть вариант через Homebrew. Для Windows официальная документация даёт команду WinGet. Вы можете использовать знакомый менеджер программ. Нативный сценарий с загрузкой скрипта также описан Anthropic; прежде чем исполнять его, прочитайте актуальный текст на странице и правила своей организации.

brew install --cask claude-code
claude --version
claude doctor

На Windows команда установки в PowerShell другая:

winget install Anthropic.ClaudeCode
claude --version
claude doctor

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

Перед входом сохраните три ориентира:

  • запишите способ установки и версию программы;
  • проверьте, какой файл запускает команда claude;
  • откройте терминал в папке нужного проекта.

Что учесть на Windows

На обычной Windows Anthropic рекомендует Git for Windows: с ним Claude Code пользуется Git Bash для команд оболочки. Это рекомендация, а не обязательное условие установки. Без Git for Windows команды выполняются через PowerShell. Если проект находится в WSL, ставьте и запускайте Claude Code внутри WSL; Git for Windows там не нужен. После установки откройте новый терминал, выполните claude --version и проверьте, что команда доступна через PATH.

Как войти и открыть нужную папку

Откройте в терминале папку конкретного проекта, затем запустите claude. При первом старте выполните шаги входа, которые показывает официальный интерфейс. Не вводите пароль или ключ в чужой скрипт. Если уже задана переменная ANTHROPIC_API_KEY, программа может предложить использовать её; проверьте, какой способ оплаты и учёта запросов ожидаете. Наличие файла проекта ещё не означает, что агент должен читать все его данные.

pwd
git status --short
claude

pwd помогает убедиться, что вы не стоите в домашней папке со множеством соседних проектов. git status --short покажет несохранённые изменения до работы агента. Если проект ещё без Git, сделайте копию исходного состояния и уберите из неё секреты. Попросите Claude сначала перечислить файлы, относящиеся к задаче, и план проверки. Устанавливать инструмент ради команды «переделай весь сайт» рискованно: вы не сможете отличить нужные правки от случайных.

Как провести первую проверяемую задачу

Выберите маленькое изменение: исправить текст кнопки или проверку одного поля формы. Назовите текущий результат, ожидаемое поведение и список файлов, которые можно трогать. После ответа прочитайте список изменённых файлов и diff. Запустите имеющуюся проверку проекта, затем откройте изменённую страницу. Успех означает, что вы можете повторить этот цикл без помощи видеоинструкции: задача, правка, просмотр diff, проверка.

РезультатЧто он подтверждаетЧто проверить отдельно
claude --version печатает номерПрограмма доступна терминалуУчётная запись имеет доступ
Удалось войтиСессия запущенаОткрыта правильная папка
Агент исправил файлКод изменилсяОстальные функции работают
Сборка прошлаПроект собираетсяСценарий удобен пользователю

Если запуск не удался

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

Запишите короткую карточку сбоя:

  • скопируйте точное сообщение терминала;
  • укажите команду и операционную систему;
  • проверьте, на каком шаге возникла ошибка;
  • сопоставьте этот шаг с разделом официальной инструкции.

На обучении работе с ИИ мы идём от одной реальной задачи до собственного проверенного результата. Если хотите пройти такой путь вместе, посмотрите формат обучения: там каждый работает со своим проектом и своей проверяемой задачей.

Как оставить компьютер в понятном состоянии после установки

Запишите, каким способом вы поставили программу: Homebrew, WinGet или нативный установщик. От этого зависит порядок обновления и удаления. Если через неделю команда выводит неожиданную версию, найдите путь запускаемого файла, прежде чем устанавливать новую копию. Две версии в разных папках способны создать странные ошибки: одна открывает проект, другая получает обновления, а пользователь видит поведение как будто у одной программы.

Для первого проекта добавьте короткий файл с командами проверки и расположением данных. Секреты в него не пишите. Так следующая сессия не начнётся с догадок о том, как запустить сайт или бот. Даже если после установки вы решите работать через графический интерфейс, сведения о проверке проекта останутся полезны.

Частые вопросы

Можно ли установить без терминала?

Да, Anthropic предлагает приложение и расширения редакторов. Здесь описан именно запуск команды в терминале, потому что так легче проверить папку проекта и увидеть вывод диагностики.

Почему claude --version работает, а вход нет?

Установка и право доступа проверяются отдельно. Сверьте регион, тип учётной записи и сообщение при входе с официальными условиями.

Нужен ли sudo для установки?

Не добавляйте его автоматически. Выберите официальный способ для вашей системы и разберитесь с правами на папку установки, если менеджер программ сообщает об ошибке.

Можно ли начать с существующего рабочего сайта?

Можно после сохранения исходного состояния и выбора небольшой задачи. Сначала перечислите ограничения и проверку, чтобы видеть последствия изменения.

Следующий материал о сравнении Codex и Claude Code поможет выбрать способ работы. Для первого шага здесь достаточно одной проверенной задачи и читаемого diff.