02 / 06 · Начинающий

Первая задача

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

5 шагов20 минутпервый коммит

✅

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

⚠️

Перед запуском — сделайте git commit. Это страховка: если что-то пойдёт не так, вы всегда вернётесь через git checkout ..

ℹ️ Что такое git? Развернуть, если не знаете

git — программа для отслеживания изменений. Представьте «ctrl+Z» для всего проекта — вы можете вернуться к любому сохранённому состоянию.

Вам нужны всего 3 команды:

git add .
git commit -m "перед CC: всё работает"
git checkout .

git add . — отметить все файлы. git commit — сохранить состояние. git checkout . — откатить несохранённые правки.

Шаг 1: Откройте терминал в папке проекта

Перейдите в папку проекта

Claude Code работает с файлами в текущей директории. Поэтому первое — перейти в корень вашего проекта.

# Windows PowerShell
cd E:\Clients\myproject

# Или Git Bash / WSL
cd /e/Clients/myproject

Запустите Claude Code

claude

# Появится приветствие:
╭─────────────────────────────╮
│  Claude Code v1.x           │
│  Model: claude-sonnet-5     │
│  Cwd: E:\Clients\myproject  │
╰─────────────────────────────╯

Включите Plan Mode

Нажмите Shift+Tab два раза. В строке ввода должен появиться индикатор [plan] или [auto-approve: off].

Это означает: Claude покажет план перед любым изменением файлов и спросит подтверждение.

💡

Для первых задач Plan Mode — обязателен. Потом, когда привыкнете — решите сами нужен ли он.

⚠️

Частая ошибка новичков: отключение Plan Mode для «скорости» уже на первых задачах. Это ошибка — пока вы не понимаете что Claude делает интуитивно, Plan Mode защищает от неожиданных изменений. Включайте его всегда для задач которые меняют больше 2-3 файлов.

💪

Это нормально — если что-то пойдёт не так. У вас есть git. Любое изменение CC можно откатить командой git checkout .. Экспериментируйте смело.

Шаг 2: Правильно сформулируйте задачу

Качество задачи напрямую влияет на качество результата. Плохая задача → плохой код.

❌ Плохо

«Добавь авторизацию»

Непонятно: какую систему, какие поля, как хранить сессии, какой стек.

✅ Хорошо

«Добавь авторизацию через email+password. Проект на Laravel 11. Использовать встроенный Auth, сохранять сессию в Redis. Форма входа: resources/views/auth/login.blade.php»

❌ Плохо

«Почини это»

Что именно? Где ошибка?

✅ Хорошо

«При регистрации падает ошибка "Column 'phone' doesn't exist". Миграция в database/migrations/2024_01_add_phone.php. Поправь схему»

Формула хорошей задачи

[ЧТО сделать] + [ГДЕ находится] + [КАКОЙ стек/версия] + [КОНТЕКСТ]

Примеры:
- «Напиши тест для метода UserService::create() в app/Services/UserService.php.
  Используй PHPUnit, мокай UserRepository»

- «В компоненте UserCard.vue (src/components/UserCard.vue) добавь отображение
  аватара. Аватар хранится в поле user.avatar_url, по умолчанию показывать
  /img/default-avatar.png»

- «Оптимизируй SQL запрос в app/Repositories/OrderRepository.php метод
  getByUser(). Сейчас N+1 проблема — добавь eager loading»

Шаг 3: Оцените план Claude

После вашей задачи Claude в Plan Mode покажет что он собирается делать:

Claude: Вот мой план:

1. Прочитаю app/Services/UserService.php
2. Создам файл tests/Unit/Services/UserServiceTest.php
3. Напишу тест для метода create() с моком UserRepository
4. Запущу php artisan test --filter=UserServiceTest

Продолжить? [y/n]

Что проверить в плане:

✅Правильные ли файлы он собирается менять?
✅Нет ли лишних изменений, о которых вы не просили?
✅Логичны ли шаги?
⚠️Если что-то не так — напишите правку до подтверждения плана

🧭

🧭 Консенсус практиков: не верьте фразам вроде «готово» или «тесты пройдут» на слово — прогоняйте реальную команду и смотрите вывод сами. Модель может быть уверена и при этом неправа. Так советуют Thorsten Ball, Simon Willison, Boris Cherny и др. — см. сводную шпаргалку.

Шаг 4: Проверьте результат

После выполнения задачи обязательно проверьте что получилось:

Прочитайте изменённые файлы

# Посмотреть что изменилось
git diff

# Или попросить Claude объяснить что он сделал
You: Объясни что ты изменил и почему

Запустите тесты или приложение

php artisan test
# или попросите Claude:
You: Запусти тесты и покажи результат

🧭

🧭 Консенсус практиков: тесты — страховка от того, что агент молча сломает или ослабит рабочий код (иногда модель склонна «упрощать» тест, лишь бы он прошёл). Просите тесты уже на первых задачах. Так делают Kent Beck, Harper Reed, obra и др. — см. сводную шпаргалку.

Если что-то не так — скажите Claude

Не нужно исправлять вручную. Просто опишите проблему:

You: Тест падает с ошибкой "Undefined method mock::shouldReceive()".
     Вот полный вывод: [вставьте ошибку]

Claude: Понял, в тесте не подключен Mockery. Исправляю...

Полезные команды в процессе работы

Команда	Что делает
`/help`	Список всех команд CC
`/clear`	Очистить историю сессии (сбрасывает контекст)
`/status`	Показать текущую модель, токены, настройки
`Ctrl`+`C`	Остановить выполнение (если Claude что-то делает долго)
`Shift`+`Tab`×2	Включить/выключить Plan Mode
`/model opus`	Переключиться на Opus для сложной задачи

Чеклист первой задачи

☐Открыл терминал в папке проекта
☐Запустил claude
☐Включил Plan Mode (Shift+Tab×2)
☐Написал задачу с контекстом (что + где + стек)
☐Проверил план перед подтверждением
☐Проверил результат (diff, тесты)
☐Сделал git commit если всё хорошо

✅

Первая задача выполнена! Теперь изучите типичные ошибки новичков — чтобы не наступать на одни и те же грабли.

Готовы к более сложным задачам?

⚡

Продвинутый: Рабочий процесс

Spec pipeline, паттерны для крупных фич, советы экспертов

⚡

Продвинутый: Промпт-лайфхаки

34 приёма для идеальных задач — формулы и шаблоны

←

НазадМинимальная настройка

ДалееТипичные ошибки

→