Туториал 1. Как разговаривать с агентом

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

1. Давайте контекст

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

«Это проект для хакатона. Стек — Python 3.12. Данные — обезличенный CSV в data/. Реальную инфру не трогаем.»

Ещё лучше — один раз сложить это в CLAUDE.md (команда /init создаст заготовку). Тогда контекст подхватывается автоматически в каждой сессии.

2. Дробите задачу

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

3. Просите план до кода

Перед крупным изменением включите режим плана: команда /plan (или Shift+Tab). Агент перейдёт в режим «только чтение» — изучит код и предложит план, ничего не меняя. Вы смотрите план, и только потом разрешаете делать.

4. Ссылайтесь на файлы

Чтобы агент работал с конкретным файлом, подтяните его в контекст через @:

«Посмотри @src/main.py и объясни, что делает функция parse.»

5. Ревьюйте, прежде чем соглашаться

Агент показывает, что собирается изменить. Не жмите «да» вслепую — посмотрите дифф (/diff). Если поехало не туда — Esc прерывает, можно переформулировать.


Мини-словарь команд (наберите / — увидите все):