Первый запуск: Прохождение первого примера
📚 Навигация по серии: В предыдущей статье 06 · Coding Plan: Подписка или оплата по мере использования мы разобрались с финансовой стороной вопроса. В этой статье мы перейдем к практике — от открытия терминала до успешного завершения первой задачи, чтобы вы совершили свой первый «успешный забег».
Друзья, всё предыдущее было подготовкой — установка, авторизация, выбор тарифа завершены.
Инструмент перед вами, но, вероятно, вы чувствуете легкую неуверенность: Так как же им пользоваться? Я открыл терминал, что дальше?
Честно говоря, многие при первом запуске Claude Code смотрят на мигающий курсор почти минуту, не зная, что напечатать. Страшно написать что-то не то и всё сломать.
Не волнуйтесь. Сегодня мы пройдем самый простой процесс: создадим проект всего из нескольких строк кода, заставим Claude сначала прочитать и понять его, а затем попросим изменить одну строчку. Весь процесс займет не более пяти минут, и вы получите первый опыт того, как «Claude помог мне правильно изменить код». Этого достаточно — как только вы пройдете этот путь однажды, всё остальное пойдет как по маслу.
Прочитав эту статью, вы получите:
- Полный алгоритм действий: от открытия терминала до завершения первой задачи. Просто повторяйте.
- Понимание «приветственного экрана» Claude Code при запуске.
- Работающий пример уровня «Hello World», дающий ожидаемый результат.
- Несколько важных советов, чтобы «не оступиться в первый раз» (как выдавать разрешения, как отменять ошибки).
01 Сначала создадим «Игрушечный проект»
Сразу к выводу: При первом использовании не беритесь за рабочий проект, создайте тренировочный (игрушечный).
Почему? Потому что в реальном проекте много файлов и сложных зависимостей. Claude потратит время на их чтение, а вы не поймете, что именно он сделал. В тренировочном проекте всего два-три файла, и любые изменения будут видны как на ладони — именно так нужно учиться.
Аналогия: Учиться водить лучше на пустой площадке. Никто после получения прав сразу не выезжает на скоростное шоссе. Сначала вы находите пустое место, привыкаете к педалям и рулю. Тренировочный проект — это ваша площадка: если что-то пойдет не так, вы просто создадите его заново.
Для тех, кто никогда не работал с командной строкой: каждый, кто пытался начать с рабочего проекта компании, испытывал панику — одна только прокрутка экрана, пока Claude читает файлы, заставляет потеть ладони. Сделайте иначе: создайте файлик на три строчки, пройдите весь процесс за 5 минут, и вы обретете уверенность.
Откройте ваш терминал (на Mac это «Терминал / Terminal», на Windows рекомендуется Git Bash или PowerShell) и введите следующие строки:
mkdir hello-claude
cd hello-claudeЭти две строки означают: создать новую папку с именем hello-claude и перейти в нее. mkdir = make directory (создать директорию), cd = change directory (сменить директорию).
Теперь создадим простейший файл на Python. Для Mac / Linux используйте:
echo 'def add(a, b):
return a + b' > main.pyВ Windows PowerShell echo для нескольких строк использовать немного сложнее, поэтому вы можете просто создать файл main.py в Блокноте, вставить туда эти две строки и сохранить:
def add(a, b):
return a + b💡 Краткий итог: При первом использовании Claude Code создайте крошечный проект на 2-3 строки как «площадку для тренировок». Ошиблись — удалили и создали заново, без паники.
02 Запуск Claude и понимание приветственного экрана
Проект создан, теперь запускаем Claude Code в той же папке. Убедитесь, что ваш терминал находится в директории hello-claude (если вы выполнили команду cd, то вы там), и введите:
claudeВнимание: обязательно запускайте claude в директории проекта, а не на рабочем столе или в корневой папке пользователя. Потому что Claude Code считает рабочим пространством ту директорию, в которой вы находитесь — где запустили, там он и читает файлы. Это самая частая ошибка новичков: запустить утилиту в домашней директории, спросить «что делает этот проект?», а Claude в недоумении, ведь домашняя директория — это не проект.
Аналогия: Приглашая мастера по ремонту, нужно привести его в ту квартиру, которую нужно ремонтировать. Вы не можете стоять у входа в подъезд и объяснять на пальцах — он должен зайти внутрь, чтобы увидеть, какую стену ломать. Команда cd перед запуском claude — это и есть «привести мастера в квартиру».
После запуска вы увидите приветственный экран. Согласно официальной документации, на нем отображается информация о вашей сессии, последних диалогах и обновлениях. Новичку нужно знать только три вещи:
| Что вы видите | Что это значит | Что с этим делать |
|---|---|---|
| Поле ввода / Курсор в самом низу | Место для общения с Claude | Просто печатайте и нажимайте Enter |
Команда /help в подсказках | Просмотр всех доступных команд | Вводите, когда забыли нужную команду |
Команда /resume в подсказках | Продолжить предыдущий диалог | При первом запуске игнорируйте |
Поле ввода — это ваше основное рабочее пространство. Вам не нужно учить сложный синтаксис, просто воспринимайте его как окно чата с собеседником, который может читать ваш код — общайтесь обычным человеческим языком.
Чтобы убедиться, что вы в правильном месте, задайте самый простой вопрос:
Что делает этот проект?Claude сам прочитает файлы в текущей директории (в нашем случае main.py) и объяснит, для чего нужен этот проект. Вам не нужно вручную «скармливать» ему файлы — официальная документация ясно говорит: Claude Code сам прочитает файлы проекта по мере необходимости, вам не нужно вручную добавлять контекст.
💡 Краткий итог: Запускайте
claudeв папке проекта, обращайте внимание только на «Поле ввода» и/help. Он сам найдет и прочитает файлы, общайтесь с ним простым языком.
03 Пусть Claude сначала прочитает и поймет код
Первая настоящая задача — не попросить его изменить код, а попросить объяснить его.
Почему сначала объяснение? По двум причинам: во-первых, это убедит вас, что Claude действительно прочитал ваш файл (а не выдумывает); во-вторых, задачи на объяснение абсолютно безопасны — он только читает и говорит, не трогая ни единого символа в файлах, что идеально подходит для первой пробы.
Аналогия: В первый день работы нового коллеги вы не поручаете ему рефакторинг ключевого модуля, а просите «прочитать код и рассказать, как он работает». Послушав его, вы поймете, понял ли он суть и можно ли ему доверять. Попросить Claude объяснить код — это и есть такой «первый рабочий день».
В поле ввода напечатайте:
Объясни, что делает файл main.py, понятным для новичка языком.Нажмите Enter. Claude прочитает main.py и выдаст простое объяснение, суть которого будет примерно такой: здесь определена функция add, которая принимает два параметра a и b и возвращает их сумму.
Успешное выполнение этого шага означает две вещи: Claude Code установлен правильно, авторизация прошла успешно, и он действительно может читать ваши реальные файлы. Фундамент заложен, теперь можно переходить к изменениям.
Разделите команды для Claude Code на три категории, чтобы вам было проще ориентироваться:
| Тип команды | Что делает | Пример | Риск |
|---|---|---|---|
| Объяснение | Читает и рассказывает вам | «Объясни этот код» | Нулевой, файлы не меняются |
| Изменение | Модифицирует существующий код | «Проведи рефакторинг этой функции» | Изменяет файлы, требует одобрения |
| Генерация | Создает что-то новое | «Напиши тестовый сценарий» | Создает/изменяет файлы, требует одобрения |
💡 Краткий итог: Первую задачу сделайте «Объясняющей» — убедитесь, что он видит файлы, и только потом поручайте работу.
04 Пусть Claude изменит одну строку (Важно: он сначала спросит вас)
А теперь кульминация: пусть Claude по-настоящему изменит код.
Продолжая текущий диалог, введите:
Добавь аннотации типов для этой функции и простую обработку ошибок.И тут произойдет самое важное: Claude не станет сразу менять ваш файл. Он сделает следующее:
- Найдет нужный файл (в нашем случае
main.py). - Покажет вам, что именно он собирается изменить, в виде diff (сравнения изменений).
- Остановится и будет ждать вашего одобрения.
- Только после того, как вы нажмете «Согласен» (Yes), он внесет изменения в файл.
Это железное правило, неоднократно подчеркнутое в официальной документации:
Claude Code всегда запрашивает разрешение перед внесением изменений в файлы. Вы можете одобрять отдельные изменения или включить режим «Принять всё» для текущей сессии.
Аналогия: Стажер, который спрашивает, прежде чем действовать. Хороший стажер не станет менять рабочий код без разрешения — он придет с черновиком: «Шеф, я думаю сделать так, посмотрите, нормально?» И только после кивка пойдет применять. По умолчанию Claude Code работает именно как такой стажер.
Вы увидите запрос с вариантами выбора, которые обычно означают следующее:
| Ваш выбор | Результат | Когда использовать |
|---|---|---|
| Да (Yes) | Применить это конкретное изменение | Вы поняли diff и согласны с ним |
| Да, и больше не спрашивать в этой сессии | Автоматически применять все последующие изменения | Вы доверяете ему и хотите ускорить работу |
| Нет (No), и указать причину | Изменение не применяется, вы можете уточнить задачу | В diff есть что-то, что вам не нравится |
Для первого раза настоятельно рекомендую честно выбирать «Да», не спешите включать «Принять всё». Честно говоря, когда только начинаешь пользоваться, очень велик соблазн расслабить контроль по максимуму (использовать флаг --dangerously-skip-permissions, что буквально означает «опасно пропускать разрешения», о котором мы поговорим позже). В итоге он без спроса меняет пять-шесть файлов, и когда вы это замечаете, уже невозможно разобрать, какие изменения были нужны вам, а какие он добавил по собственной инициативе. Вывод один: чем меньше у вас опыта, тем строже должен быть контроль — шаг за шагом.
Как читать diff: красным цветом / строками с - показаны удаленные старые строки, зеленым / с + — добавленные новые. Ваш main.py превратится примерно из этого:
def add(a, b):
return a + bВо что-то подобное (точный синтаксис Claude может немного отличаться, важен смысл):
def add(a: float, b: float) -> float:
if not isinstance(a, (int, float)) or not isinstance(b, (int, float)):
raise TypeError("a и b должны быть числами")
return a + bЗдесь появились аннотации типов (a: float) и базовая обработка ошибок (если переданы не числа — выдается ошибка). Именно в этот момент вы осуществили свой первый «акт совместного программирования с ИИ».
💡 Краткий итог: Перед изменением файлов Claude всегда спрашивает — в первый раз просто выберите «Да» после того, как поймете diff, не включайте автоматический режим ради скорости.
05 Что делать, если он ошибся: Две «таблетки от сожаления»
Самый большой страх новичка: А вдруг он всё сломает, всё запутает, а я даже не пойму, как это исправить?
Не волнуйтесь, есть два способа всё отменить, и они отлично работают.
Способ первый: Прямо в чате скажите «Верни как было». Claude помнит всю историю текущего сеанса. Если результат вам не нравится, просто скажите ему:
Мне не нравится последнее изменение, верни всё в первоначальное состояние.Он отменит свои правки. Аналогия: Сказать коллеге «Тот последний вариант никуда не годится, давай вернемся к предыдущему» — вам не придется вручную стирать код строка за строкой.
Способ второй: Использовать Контрольные точки (Checkpoint) для возврата. Это механизм «сохранений в игре» от Claude Code: перед каждым изменением файла он автоматически сохраняет его состояние, и вы можете мгновенно к нему вернуться.
Аналогия: Сохранение и загрузка в видеоигре. Вы сохранились перед битвой с боссом, проиграли — не нужно начинать игру с начала, просто загрузите сохранение. Контрольная точка — это такое сохранение, которое Claude делает за вас втихую перед началом работы.
Как это использовать? Согласно официальной документации:
/rewindИли нажмите Esc дважды подряд, когда поле ввода пустое, появится меню возврата.
⚠️ Важная деталь (явно указанная в документации): Если в поле ввода есть текст, двойное нажатие Esc очистит этот текст, а не откроет меню возврата. Поэтому перед вызовом меню убедитесь, что поле ввода пустое.
Важно понимать еще одну вещь: Контрольные точки могут отменить только те изменения файлов, которые Claude сделал через свои инструменты редактирования, это не заменяет Git. Официальный совет звучит так:
Рассматривайте checkpoints как «локальную отмену», а Git как «постоянную историю».
То есть контрольные точки нужны для быстрого реагирования на ошибку: «Ой, здесь сломалось, откатываем». А для сохранения реального прогресса всё равно нужно использовать коммиты Git (о том, как использовать Git вместе с Claude, мы поговорим в отдельной статье).
| Таблетка от сожаления | Как использовать | Когда подходит | Ограничения |
|---|---|---|---|
| Сказать «Верни как было» | Написать текстом в чат | Сразу после неудачного изменения 1-2 мест | Зависит от того, насколько правильно он вас поймет |
Контрольная точка /rewind | Команда /rewind или двойной Esc (при пустом вводе) | Точный возврат к конкретному состоянию | Отменяет только изменения от Claude, не заменяет Git |
💡 Краткий итог: Если всё сломалось — не паникуйте. Фраза «Верни как было» + Контрольные точки
/rewindспасут ситуацию; но для сохранения надежного прогресса используйте Git.
06 Практика: Пять минут на первый успешный цикл
Теория без практики мертва. Ниже представлен весь процесс, собранный в единую инструкцию с ожидаемыми результатами, которую можно просто повторять. Откройте терминал и следуйте за мной.
Шаг первый: Создаем игрушечный проект (Mac / Linux)
mkdir hello-claude
cd hello-claude
echo 'def add(a, b):
return a + b' > main.pyДля пользователей Windows: команды mkdir hello-claude и cd hello-claude вводите как есть, а main.py создайте через Блокнот и вставьте туда две строки Python-кода.
Ожидаемый результат: В папке hello-claude появился файл main.py с функцией add. Можно ввести ls (или dir на Windows), чтобы убедиться, что файл на месте.
Шаг второй: Запуск Claude Code
claudeОжидаемый результат: Появился приветственный экран, внизу мигает курсор в поле ввода. Если система просит войти, значит, вы пропустили шаги авторизации — вернитесь к статье 02.
Шаг третий: Просим объяснить код
В поле ввода печатаем:
Объясни, что делает файл main.py, понятным для новичка языком.Ожидаемый результат: Claude прочитает main.py и простыми словами объяснит, что это функция сложения двух чисел. Если он правильно описал функцию add — всё работает отлично.
Шаг четвертый: Просим изменить код и одобряем изменения
Добавь аннотации типов для этой функции и простую обработку ошибок.Ожидаемый результат: Claude покажет diff (красным - старые строки, зеленым + новые) и остановится в ожидании. Внимательно изучите изменения и выберите «Да / Yes».
Шаг пятый: Проверяем, что изменения сохранены
Выйдите из Claude (введите exit или нажмите Ctrl+D) и проверьте файл в терминале:
cat main.py(В Windows PowerShell используйте type main.py)
Ожидаемый результат: В файле main.py появились аннотации типов (например, a: float) и код обработки ошибок (raise TypeError(...)). Если код совпадает с тем, что вы одобрили — вы прошли весь цикл. Поздравляю!
⚠️ Если на каком-то этапе вы получаете ошибку прав доступа (на Mac / Linux что-то вроде
Error: EACCES: permission denied), решения зависят от конкретной ситуации и будут разобраны в разделе «Частые проблемы». Пока просто имейте в виду, что такое может быть.
💡 Краткий итог: Пройдите эти пять шагов. Пройти процесс до конца важнее, чем просто прочитать о нем — получив первый успешный опыт взаимодействия, вы обретете уверенность для дальнейшей работы.
07 Заключение
В этой статье мы сделали главное: полностью прошли первый рабочий цикл Claude Code — от создания проекта и запуска до объяснения кода, его изменения и одобрения правок.
Давайте еще раз повторим ключевые шаги:
| Шаг | Действие | Важный момент |
|---|---|---|
| Создание проекта | mkdir + cd + создать файл | Для первых шагов используйте игрушечные проекты |
| Запуск | Наберите claude в папке проекта | Где запустите, там он и будет работать |
| Объяснение | «Объясни файл xxx» | Нулевой риск, проверка того, что он видит файл |
| Изменение | Сформулируйте задачу простым языком | Он сначала покажет diff и подождет одобрения |
| Отмена | «Верни как было» / /rewind | Checkpoints — это локальная отмена, Git — постоянная история |
Теперь вы умеете: открывать терминал, запускать Claude в правильной директории, просить его на обычном языке прочитать и изменить код, понимать предлагаемые изменения (diff) и отменять их в случае ошибки. Этот алгоритм — ядро всей работы с Claude Code. Все более сложные функции в конечном итоге сводятся к этому же циклу «Запрос → Просмотр diff → Одобрение / Отмена».
Следующая статья: 08 · Интеграция с VS Code — мы освоили работу в командной строке, но, возможно, вам привычнее работать в редакторе кода, где удобнее просматривать изменения. В следующей статье мы установим Claude Code прямо в VS Code, чтобы он работал бок о бок с вашим кодом.
Эта диаграмма объединяет все пять шагов из статьи в единый визуальный поток: Создание игрушечного проекта → Запуск claude в директории проекта → Объяснение кода (Зеленый цвет · Только чтение, без риска) → Изменение кода (Желтый цвет · Сначала diff, ждет одобрения — «сначала спроси, потом делай») → Возврат через /rewind в случае ошибки (Розовый цвет · Страховка «таблеткой от сожаления»). Выделенные цветом шаги — это важнейшие механизмы безопасности, о которых всегда должен помнить новичок.