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

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

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

В первой главе вы оформили доступ, установили Claude Code и разобрались с выбором модели. Инструмент готов к работе, но пока вы не запускали в нём ни одной задачи. Теперь мы разберём саму рабочую среду: как устроен запуск, что показывает интерфейс, по какому циклу работает агент и как выглядит правильно поставленный первый запрос.

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

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

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

• Сессия — один непрерывный диалог с Claude Code, привязанный к директории запуска. Сохраняется локально и может быть продолжена позже.
• Рабочая директория — папка, из которой вы запустили claude. По умолчанию именно в ней и её подпапках агент читает и правит файлы.
• Агентный цикл — повторяющаяся последовательность «собрать контекст — выполнить действие — проверить результат», по которой агент решает задачу.
• Инструмент (tool) — способность агента совершить конкретное действие: прочитать файл, найти текст, запустить команду в оболочке, отредактировать код.
• Промпт — ваш запрос агенту на обычном языке.
• Строка состояния — служебная строка интерфейса, где видно текущий режим разрешений и другую информацию о сессии.

Запуск: директория решает всё

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

cd ~/projects/my-app
claude

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

Над строкой ввода вы увидите служебную информацию: версию, текущую модель и рабочую директорию. Проверьте директорию сразу — это самая частая причина недоумения «почему он не видит мой файл».

Есть и другие способы запуска, полезные в разных ситуациях:

claude                          # интерактивная сессия
claude "почини ошибку сборки"   # интерактивная сессия с первым запросом
claude -p "объясни эту функцию" # разовый запрос, вывод и выход
claude -c                       # продолжить последнюю сессию в этой папке
claude -r                       # выбрать сессию из списка и продолжить

Режим -p не открывает интерфейс: выполняет запрос, печатает ответ и завершается. Удобно для скриптов, но учиться лучше в интерактивном режиме.

Что происходит после Enter

Введите первый запрос — например, что делает этот проект? — и понаблюдайте. Вы увидите не мгновенный ответ, а последовательность шагов: агент ищет файлы, читает часть из них, иногда запускает команду, и только потом отвечает.

Это и есть агентный цикл. Он состоит из трёх фаз, которые перетекают друг в друга:

• Сбор контекста. Агент ищет файлы по имени, ищет текст внутри файлов, читает найденное. Он не знает вашего проекта заранее и выясняет всё на месте.
• Действие. Правка файла, создание нового файла, запуск команды в оболочке.
• Проверка. Запуск тестов, линтера, сборки — чтобы убедиться, что сделанное работает.

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

Важный вывод для практики: вам не нужно перечислять, какие файлы читать и какие команды запускать. Достаточно описать задачу. Формулировки вроде «открой src/auth/login.ts, найди там строку 42» превращают агента в редактор и лишают его сильной стороны — он и сам найдёт нужное место быстрее.

Как формулировать запросы

Качество результата зависит от запроса сильнее, чем от чего-либо ещё. Разница видна на паре примеров.

Плохо:

почини баг

Хорошо:

после ввода неверного пароля пользователь видит пустой экран
вместо сообщения об ошибке — найди причину и исправь

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

Большую задачу полезно разбить на шаги прямо в тексте запроса:

1. добавь таблицу профилей пользователей
2. сделай эндпоинт для чтения и обновления профиля
3. покрой эндпоинт тестами

И ещё один приём, который экономит время: перед изменениями попросите агента изучить код. Запросы вроде «разберись, как устроена схема базы» или «объясни структуру папок» дают ему контекст, а вам — уверенность, что вы правите то, что нужно.

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

Управление ходом работы

Агент работает автономно, но остаётся управляемым в любой момент. Это ключевое отличие от «запустил и жди».

• Esc останавливает Claude немедленно. Текущий вызов инструмента отменяется, агент ждёт вашего следующего указания. Пользуйтесь этим, как только видите, что работа пошла не в ту сторону, — не ждите завершения.
• Текст плюс Enter без остановки. Наберите поправку и отправьте её: агент прочитает сообщение, как только закончит текущее действие, и учтёт его при выборе следующего шага.
• Ctrl+C прерывает работу или очищает строку ввода.
• Ctrl+D дважды или команда /exit завершают сессию.

Внутри сессии доступны служебные команды, начинающиеся со слэша. На старте достаточно трёх: /help показывает список доступных команд, /clear начинает разговор с чистого листа, /exit выходит. Наберите просто /, чтобы увидеть меню доступных команд, — подробно мы разберём их в отдельном уроке.

Сессия не пропадает после выхода: Claude Code сохраняет её локально. Вернуться к разговору можно командой claude -c (последняя сессия в этой папке) или claude -r (выбор из списка).

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

• Запуск из неправильной директории. Агент видит только рабочую директорию и вложенные папки. Запущенный из домашней папки или из подпапки проекта, он не найдёт нужных файлов, и вы будете искать проблему не там. Проверяйте путь в шапке интерфейса сразу после запуска.
• Слишком общий запрос. «Улучши код» или «почини баг» не содержат ни симптома, ни границ задачи. Агент вынужден догадываться и часто угадывает не то. Добавьте, что именно не работает и как должно быть.
• Микроменеджмент вместо задачи. Перечисление файлов и строк лишает агента возможности самому найти причину, а вас — выигрыша во времени. Опишите цель, а поиск оставьте ему.
• Ожидание мгновенного ответа. Агентный цикл занимает время: чтение файлов и запуск тестов не бесплатны. Пауза перед ответом — норма, а не зависание.

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

• Нужно ли вручную добавлять файлы в контекст? — Нет. Claude Code сам находит и читает нужные файлы по ходу работы. Явно указывать путь стоит только тогда, когда вы точно знаете нужное место и хотите сэкономить шаги.
• Что делать, если агент пошёл не туда? — Нажмите Esc, чтобы остановить его, и объясните, что не так. Можно и не останавливать: отправьте поправку сообщением, она будет учтена после текущего действия.
• Разговор сохраняется после выхода? — Да, сессии хранятся локально. claude -c продолжает последнюю сессию в текущей папке, claude -r даёт выбрать из списка.
• Чем claude -p отличается от обычного запуска? — Это разовый запрос без интерактивного интерфейса: команда выполняется, ответ печатается, программа завершается. Удобно в скриптах, неудобно для обучения.
• Можно ли работать сразу с несколькими проектами в одной сессии? — По умолчанию сессия ограничена рабочей директорией. Расширять область доступа мы научимся, когда разберём разрешения.

Итоги

Отличное начало — вы провели первую сессию и увидели агента в деле. Теперь вы понимаете, почему директория запуска настолько важна, что происходит между вашим Enter и ответом, как выглядит запрос, на который агент отвечает делом, и как остановить его одним нажатием Esc, если что-то пошло не так. Это база, на которой держится всё остальное.

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