Как установить Claude Code и начать работу за 5 минут

Claude Code — это coding agent от Anthropic, который работает в терминале, читает файлы проекта, предлагает изменения и запускает команды. Чтобы начать, установите актуальную CLI-версию, откройте небольшой тестовый проект, войдите в аккаунт и дайте агенту сначала задачу на чтение. Для первого изменения оставьте ручное подтверждение и обязательно проверьте git diff.

Коротко

• Текущий рекомендуемый способ установки — Native Install, а не старый глобальный пакет npm.
• Запуск из папки проекта: claude.
• Для первого сеанса оставьте режим Manual (default) или начните с Plan mode.
• Сначала попросите Claude объяснить проект и ничего не менять.
• Первую правку ограничьте одним файлом, затем проверьте git diff.
• Для выхода нажмите Ctrl+D; Ctrl+C останавливает текущую операцию.

Что такое Claude Code

Claude Code — не обычный чат в окне браузера. Агент получает доступ к рабочей папке и может читать кодовую базу, редактировать файлы, выполнять команды и взаимодействовать с инструментами разработки. Он доступен в терминале, IDE, desktop-приложении и браузере.

В этой инструкции используется Terminal CLI. Это самый прямой способ понять рабочий цикл: открыть проект, сформулировать задачу, просмотреть запрошенное действие, разрешить его и проверить результат.

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

Подготовьте:

• терминал: Terminal или iTerm на macOS, shell на Linux, PowerShell/CMD либо WSL на Windows;
• небольшой проект, который не жалко изменить;
• желательно Git и чистый git status;
• аккаунт Claude Pro, Max, Team или Enterprise, аккаунт Anthropic Console либо поддерживаемый внешний провайдер.

Официальная документация указывает, что Claude Desktop, Terminal CLI и VS Code поддерживают сторонних провайдеров. Если вы подключаете Claude Code из России через BetterToken, используйте отдельную русскую инструкцию по API Key и Anthropic-compatible Base URL. Для Claude Desktop доступна отдельная инструкция по подключению к BetterToken API. Установка приложения или CLI и настройка провайдера — разные шаги: сначала установите нужный клиент, затем добавьте параметры доступа.

Как установить Claude Code

Anthropic рекомендует Native Install. Команды ниже взяты из актуального Claude Code Quickstart.

macOS, Linux и WSL

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

Windows CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Native Install обновляется в фоне. На обычной Windows Anthropic рекомендует установить Git for Windows, чтобы Claude Code мог использовать Bash. В WSL он не нужен.

Если команда установки вернула 403, ошибку curl или сообщение про неожиданный символ <, откройте официальный раздел Troubleshoot installation. Не переходите на случайную команду из старой статьи: способы установки меняются.

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

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

cd /path/to/test-project
git status
claude

При первом запуске Claude Code предложит авторизоваться в браузере. Если позже понадобится сменить аккаунт или повторить вход, используйте /login внутри сеанса.

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

Первое безопасное задание за 5 минут

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

Шаг 1. Попросите только прочитать проект

Введите:

Кратко объясни, что делает этот проект, где находится точка входа и как его запустить. Ничего не меняй и не выполняй сетевые команды.

Так вы проверите три вещи: Claude видит правильную папку, понимает структуру и соблюдает прямое ограничение «ничего не менять».

Шаг 2. Ограничьте первую правку одним файлом

Для проекта с README можно использовать такой prompt:

Добавь в README.md короткий раздел «Как запустить локально». Меняй только README.md. Не устанавливай зависимости, не обращайся к сети и ничего не коммить. Перед изменением кратко опиши, что добавишь.

В режиме Manual Claude может читать файлы без запроса, но перед редактированием попросит подтверждение. Проверьте имя файла и смысл изменения. Для первого сеанса не включайте «Accept all».

Шаг 3. Проверьте результат вне чата

После правки выполните:

git diff -- README.md

Проверьте:

• изменён только README.md;
• не появились ключи, пароли или внутренние пути;
• текст соответствует запросу;
• нет случайного изменения зависимостей или конфигурации.

Если результат неверный, не просите «переделать всё». Укажите конкретную проблему и ещё раз назовите файл, который можно менять.

Шаг 4. Завершите сеанс

Ctrl+D закрывает Claude Code. Если агент выполняет действие, Ctrl+C сначала прерывает его. Когда ничего не выполняется, первое нажатие Ctrl+C очищает ввод, второе закрывает сеанс.

Какие разрешения выбрать новичку

Актуальные режимы описаны в официальной странице Choose a permission mode.

Для первого знакомства достаточно Manual. Если проект чужой или задача затрагивает несколько файлов, запустите Claude Code так:

claude --permission-mode plan

Не используйте --dangerously-skip-permissions на рабочем компьютере. Официальная документация прямо предупреждает, что этот режим не защищает от prompt injection и непреднамеренных действий.

Частые ошибки новичков

claude: command not found

Полностью закройте и снова откройте терминал, затем повторите claude. Если команда всё ещё не найдена, используйте официальный troubleshooting для своей ОС и проверьте, завершилась ли установка.

PowerShell сообщает, что && недопустим

Вы запустили команду для CMD в PowerShell. Используйте PowerShell-вариант с irm. Обратная ситуация тоже возможна: если CMD не знает irm, используйте команду для CMD.

Claude открыл не тот проект

Остановитесь и проверьте рабочую директорию. Закройте сеанс, выполните cd в правильную папку и снова запустите claude. Не пытайтесь исправить ошибку длинным prompt внутри неправильного каталога.

Claude собирается изменить слишком много файлов

Не подтверждайте действие. Перейдите в Plan mode или перепишите задачу: назовите один разрешённый файл, запретите установку зависимостей, сеть и commit, добавьте критерий готовности.

Авторизация не открылась или нужен другой аккаунт

Запустите /login внутри Claude Code и следуйте официальному браузерному потоку. Не вставляйте API Key в обычный prompt и не сохраняйте его в репозитории.

Что делать дальше

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

1. попросить Claude объяснить один модуль;
2. исправить небольшую документированную ошибку;
3. попросить написать или обновить один тест;
4. проверить git diff и запустить тесты;
5. только потом переходить к задаче на несколько файлов.

Так вы постепенно учитесь управлять областью изменений, разрешениями и проверкой результата. Эти навыки важнее списка «магических» prompt.

FAQ

Нужен ли Node.js для установки Claude Code?

Для команд Native Install из этой инструкции отдельный шаг с npm не используется. Если вы выбираете другой способ установки, проверяйте его требования в актуальной официальной документации.

Можно ли начать без Git?

Да, но Git сильно снижает цену ошибки: git diff показывает изменения, а откат возвращает исходное состояние. Для первого опыта лучше взять небольшой Git-репозиторий без незакоммиченных правок.

Действительно ли всё занимает пять минут?

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

Безопасен ли Claude Code в режиме Manual?

Manual даёт больше контроля, но не гарантирует отсутствие ошибок. Проверяйте рабочую папку, каждое запрошенное действие и итоговый diff. Для незнакомого кода сначала используйте Plan mode.

Источники

• Claude Code Overview
• Claude Code Quickstart
• Permission modes
• Interactive mode and shortcuts

Короткий правильный старт выглядит так: актуальная установка, правильная папка, Manual mode, запрос на чтение, одна небольшая правка и проверка git diff. Этого достаточно, чтобы понять механику Claude Code и не отдавать агенту больше контроля, чем нужно.