Частые ошибки новичка

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

Девять ошибок, которые жгут время и счёт

1. Вываливаешь всё одной огромной задачей

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

Как надо. Режь на шаги. Сначала каркас и одна модель данных. Потом одна страница. Потом авторизация. Каждый кусок — отдельная задача, которую ты можешь глазами проверить за пару минут. Маленький шаг легко откатить, большой — приходится разбирать руками.

2. Не чистишь контекст

Почему больно. Чем длиннее разговор, тем больше токенов агент перечитывает на каждом ходу — а значит, дороже и медленнее. Плюс старые куски обсуждения начинают мешать: агент тащит решения из задачи, которую вы закрыли полчаса назад, и тупит.

Как надо. Закончил логически законченный кусок работы — пиши /clear и начинай новую тему с чистого листа. Важный контекст не теряется, если он лежит в файлах проекта и в CLAUDE.md (об этом ниже), а не только в истории чата. Правило простое: новая задача — новый чистый разговор.

Распухший контекст — самая частая причина двух жалоб разом: «дорого» и «агент поглупел». Чаще всего лечится одной командой /clear.

3. Ставишь расплывчатые задачи без критерия готовности

Почему больно. «Улучши этот код» или «сделай покрасивее» — агент додумывает, что ты имел в виду, и угадывает мимо. Ты получаешь не то, тратишь ход на переделку, и так по кругу.

Как надо. Описывай конкретный результат и как ты поймёшь, что готово. Не «почини форму», а «при пустом email форма не отправляется и показывает текст ошибки под полем». Когда есть проверяемый критерий, агент целится в мишень, а не в туман — и ты сразу видишь, попал он или нет.

4. Слепо веришь «готово, всё работает»

Почему больно. Агент уверенно пишет «функция реализована, всё работает» — а оно не запускается, или работает не так. Эта уверенность ничего не доказывает: модель не всегда сама прогнала код.

Как надо. Проверяй сам. Запусти, нажми кнопку, прогони тест, посмотри в лог. Считай «готово» гипотезой, пока не увидел результат своими глазами. Это не недоверие — это нормальная инженерная дисциплина, она же спасает тебя от того, чтобы строить дальше на сломанном фундаменте.

5. Даёшь доступ к боевому с первого дня

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

Как надо. Тренируйся на песочнице. Учебный репозиторий, тестовая папка, отдельный проект, где не страшно сломать. К боевому подпускай агента только когда понимаешь, что он делает, и держишь руку на подтверждении опасных действий. Необратимое и денежное — в последнюю очередь, осознанно.

6. Не ведёшь CLAUDE.md и объясняешь одно и то же

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

Как надо. Заведи в корне проекта файл CLAUDE.md и сложи туда устойчивые правила: команды запуска, договорённости по стилю, табу, особенности проекта. Этот файл подхватывается автоматически в начале сессии. Один раз записал — больше не объясняешь. Дополняй его по ходу, когда ловишь себя на том, что повторяешь одно и то же.

7. Гоняешь самую мощную модель на тупой механике

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

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

8. Не коммитишь по ходу

Почему больно. Час работы, всё навалено в один большой кусок, агент в очередной правке что-то сломал — а отката нет. Откатываться некуда, разбирать руками долго, иногда проще выкинуть всё и начать заново.

Как надо. Коммить после каждого рабочего куска. Заработал шаг — зафиксировал. Это твои точки сохранения: сломалось на следующем шаге — вернулся на один коммит назад и пошёл другим путём. Маленькие коммиты ещё и читаются легко: видно, что именно поменялось и где искать поломку.

9. Говоришь «разберись сам» на большой незнакомой базе

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

Как надо. Наводи. Скажи, в каком файле или модуле проблема, как воспроизвести, что ты уже видел в логах. Попроси сначала найти и показать тебе нужное место, и только потом править. Чем точнее наводка, тем меньше агент блуждает и тем чище правка.

Чеклист здорового старта

• Большую задачу режу на маленькие проверяемые шаги, а не вываливаю одним куском.
• Закончил тему — /clear, не таскаю распухший разговор.
• Каждая задача с конкретным результатом и критерием «как пойму, что готово».
• «Готово» проверяю сам: запуск, тест, лог — не верю на слово.
• Боевое и денежное — не в первый день; сначала песочница.
• Устойчивые правила и команды держу в CLAUDE.md, не повторяю каждый раз.
• Коммичу после каждого рабочего куска — всегда есть точка отката.

Иди и попробуй

Эти ошибки выглядят очевидными, когда читаешь их списком. Но проживаются они иначе: ты их по-настоящему поймёшь только своими руками, на своей задаче. И это нормально — так и устроено обучение. Один реальный агент, который чинит твой код, ставит твой проект или автоматизирует то, что тебе правда надоело делать вручную, научит тебя большему, чем гора статей и чужих гайдов, включая этот. Возьми маленькую задачу, которая тебе самому интересна, открой Claude Code и пройди её до рабочего результата. Споткнёшься — вспомнишь этот список и поймёшь, на какие грабли наступил. Это и есть весь путь: не идеально с первого раза, а каждый день чуть увереннее. Удачи — теперь твоя очередь.