⚠️ Типичные ошибки

8 ошибок, которые делают все новички — и как их не повторить.

Расплывчатые задачи без контекста

Чем меньше контекста — тем хуже результат. Claude угадывает что вы имеете в виду, и часто угадывает неправильно.

❌ Плохо

«Добавь пагинацию»

✅ Хорошо

«Добавь пагинацию на страницу /orders (routes/web.php). Контроллер OrderController, метод index(). Laravel Eloquent, 20 записей на страницу, стиль Bootstrap 5»

Правило: всегда указывайте ЧТО + ГДЕ (путь к файлу) + СТЕК/ВЕРСИЮ. Это 80% успеха.

Не проверять результат перед коммитом

Claude может совершать ошибки. Он уверенно пишет неверный код. Многие новички автоматически коммитят всё что Claude сделал, а потом удивляются что в продакшне что-то сломалось.

Правило: всегда делайте git diff после задачи. Если есть тесты — запускайте их. Не коммитьте не читая.

Слишком большие задачи за раз

«Реализуй весь модуль корзины» — это не одна задача, это 20 задач. Claude попытается сделать всё сразу, потеряет контекст и сделает что-то не так.

❌ Плохо

«Реализуй весь модуль заказов: корзина, оформление, оплата, статусы, уведомления»

✅ Хорошо

«Создай модель Order с миграцией. Поля: user_id, total, status (enum: pending/paid/shipped). Потом по одному шагу.»

Правило: одна задача = одно чёткое изменение. Разбивайте большие задачи на шаги.

Не использовать Plan Mode для рискованных задач

Некоторые задачи затрагивают много файлов или делают необратимые изменения (миграции БД, рефакторинг архитектуры). Без Plan Mode Claude может начать менять файлы которые вы не ожидали.

Правило: включайте Plan Mode (Shift+Tab×2) для: миграций, рефакторинга, задач на 3+ файла, изменений конфигов.

Работать без CLAUDE.md

Без CLAUDE.md Claude не знает ваш стек, соглашения, правила именования. Каждую сессию придётся объяснять всё заново. Или Claude будет делать «стандартно» — что может не совпадать с вашим проектом.

Правило: создайте CLAUDE.md в первые 15 минут работы с проектом. Минимум: стек, как запускать, правила. Шаблон здесь.

Накапливать слишком длинную сессию

Чем длиннее сессия, тем больше токенов в контексте, тем «толще» каждый запрос. После нескольких часов работы Claude начинает «забывать» начало разговора и давать менее точные ответы.

Правило: начинайте новую сессию (/clear или перезапуск) для каждой новой крупной задачи. Хорошо написанный CLAUDE.md компенсирует потерю истории.

Доверять Claude безоговорочно

Claude может уверенно объяснять то, что неверно. Особенно для редких библиотек, устаревших API, специфических конфигов. Он не гуглит в реальном времени — его знания ограничены датой обучения.

Правило: для критически важного кода (безопасность, финансы, продакшн-конфиги) — проверяйте в официальной документации. Claude — помощник, а не оракул.

Игнорировать ошибки вместо объяснения

Когда Claude делает что-то не то, многие пишут «нет, переделай» без объяснения что именно не так. Claude пробует ещё раз, но без направления — с тем же результатом.

❌ Плохо

«Нет, это неправильно. Переделай.»

✅ Хорошо

«Не то — ты создал новый контроллер, а нужно добавить метод в существующий UserController (app/Http/Controllers/UserController.php). Переделай там.»

Правило: при правке всегда объясняйте ЧТО конкретно не так и КАК должно быть. Чем точнее — тем лучше следующая попытка.

Что делать когда что-то пошло не так

Ситуация	Действие
Claude изменил не те файлы	`git checkout .` — откат всех изменений. Потом переформулировать задачу точнее.
Claude завис / долго думает	`Ctrl`+`C` — прерывает выполнение без потери сессии.
Ответы стали хуже / Claude путается	`/clear` — сбросить контекст и начать новую сессию.
Непонятно что именно Claude изменил	`git diff` — показывает все изменения. Или спросить: «Что ты изменил и почему?»
Ошибка 403 / слетела авторизация	Смотрите FAQ → авторизация и 403.

✅

Готовы к последнему разделу! Осталось изучить ответы на частые вопросы — про стоимость, лимиты, VPN, и разницу между тарифами.