Как установить Claude Code: пошаговая инструкция

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

Ниже — что нужно подготовить заранее, сама команда установки, первый запуск и частые проблемы, из-за которых установка не проходит с первого раза.

Что нужно подготовить перед установкой

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

Также нужен доступ к терминалу — на MacOS и Linux это встроенное приложение, на Windows чаще всего используется отдельная программа терминала, рекомендованная в официальной документации.

Команда установки

Установка выполняется одной командой в терминале:

npm install -g @anthropic-ai/claude-code

Эта команда скачивает и устанавливает инструмент глобально, то есть делает его доступным из любой папки на компьютере, а не только из той, где была выполнена установка. После завершения команды терминал обычно выводит сообщение об успешной установке без дополнительных действий.

Первый запуск

После установки Claude Code запускается внутри конкретной папки проекта, а не как отдельное окно программы:

1. Откройте терминал в папке проекта. На большинстве систем это можно сделать через контекстное меню папки или командой перехода в терминале.
2. Введите команду claude. Это откроет сессию внутри текущей папки.
3. Пройдите авторизацию через браузер. При первом запуске откроется окно для входа в аккаунт — после подтверждения терминал подключится к вашей подписке автоматически.
4. Попробуйте команду /init для начала. Она сканирует папку проекта и готовит черновик файла с базовыми правилами — удобная отправная точка вместо настройки с чистого листа.

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

Таблица: частые проблемы при установке

Установка на разных операционных системах

Общий принцип одинаков для Windows, MacOS и Linux — команда в терминале через менеджер пакетов, — но конкретные детали подготовки окружения отличаются. На MacOS и Linux терминал уже встроен в систему, и обычно достаточно установить среду для управления пакетами, если её ещё нет. На Windows чаще рекомендуется отдельная современная программа терминала, через которую команды работают стабильнее, чем через самый базовый встроенный вариант.

Поскольку конкретные рекомендации по окружению для каждой системы могут обновляться, перед установкой стоит свериться с актуальной официальной документацией, а не ориентироваться только на опыт прошлой установки на другом компьютере.

Что делать, если установка не проходит

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

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

Что проверить сразу после установки

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

Эта проверка важнее, чем просто факт отсутствия ошибки при установке: иногда команда установки завершается без видимых проблем, но первый реальный запуск показывает, что окружение настроено не до конца — например, терминал использует старую версию среды, которая технически запускает команду, но работает нестабильно.

Обновление Claude Code после установки

Инструмент обновляется не автоматически сам по себе, а повторным запуском той же команды установки — она подтягивает актуальную версию, если доступно обновление. Разумная привычка — проверять обновление раз в несколько недель, особенно если вы заметили, что инструмент ведёт себя иначе, чем описано в свежей документации, или не поддерживает функцию, о которой читали в недавнем обзоре.

Обновление не затрагивает настройки конкретных проектов — файл с правилами и история работы в папке проекта остаются на месте после обновления самого инструмента, так же как при переходе между бесплатным и платным уровнем доступа.

Установка на нескольких компьютерах

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

Частая ошибка при установке

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

Вторая частая ошибка — пропускать шаг авторизации или не замечать, что окно браузера для входа не открылось автоматически. Без завершённой авторизации команды в терминале не будут подключены к вашей подписке, даже если сама установка прошла успешно.

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

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

Переустановка не требует повторной авторизации, если сессия в браузере и аккаунт остались прежними — но если возникают сомнения, проще пройти авторизацию заново при первом запуске после переустановки, чем тратить время на диагностику, подключена ли старая сессия корректно.

Где ИИ ошибается

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

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

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

Что дальше

Как настроить Claude Code после установки — в статье настройка Claude Code в 5 шагов. Какие тарифы доступны после авторизации — в статье Claude Code подписка. Что доступно без оплаты на старте — в статье Claude Code бесплатно.

Ярослав Сажнев — преподаватель ИИ в РАНХиГС, внедрение ИИ в компании. Подробнее об авторе