Курс/Когда что-то пошло не так

6 мин · +100 баллов

Типичные ошибки в работе с агентом

Пять привычек, которые отнимают время, и исправление для каждой.

К концу этого урока

Ты сможешь заранее узнавать пять типичных ошибок и применять исправление.

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

Пять ошибок и исправления

  1. 1Всё в одном разговоре. Начинаешь с инструмента для бюджета, потом спрашиваешь про письмо для отпуска, потом возвращаешься к бюджету. Контекст Claude теперь забит посторонним. Исправление: набери /clear, когда переходишь к несвязанной задаче.
  2. 2Правка за правкой. Claude делает неправильно, ты поправляешь, всё ещё неправильно, ты поправляешь снова. Разговор заполняется неудачными попытками. Исправление: после двух неудачных правок набери /clear и напиши более точный первый запрос с учётом того, что выяснилось.
  3. 3Очень длинный CLAUDE.md. Файл памяти проекта разрастается до сотен правил, и важные теряются. Исправление: держи его коротким; удаляй то, что Claude и так делает правильно без напоминания.
  4. 4Доверие без проверки. Результат выглядит верным, но ломается в необычных случаях. Исправление: всегда проси проверку — тест, скрипт или скриншот — и смотри на доказательства.
  5. 5Бесконечное исследование. «Разберись, почему тормозит» без всяких рамок, и Claude читает сотни файлов. Исправление: назови, где искать и каким должен быть ответ, например «назови причину в трёх предложениях».
Вторая ошибка и её исправление
you ▸ график всё ещё неправильный
you ▸ нет, опять не то, недели сдвинуты
you ▸ /clear
you ▸ В @app.js недельный график должен начинаться с понедельника и включать сегодня. Прошлые попытки сдвигали недели на день из-за часовых поясов. Исправь, добавь тест на неделю на стыке месяцев и запусти его.
Для новичков
›Почему помогает начать заново

Claude держит весь разговор в контекстном окне, а у него ограниченный размер. Когда окно заполнено неудачными попытками и посторонними темами, Claude работает хуже. /clear очищает контекст, но оставляет файлы как есть, поэтому ясный новый запрос начинается с чистого листа.

Для опытных
✦Если ты уже опытный

В основе всего одно ограничение: по мере заполнения контекстного окна качество падает. Смотри на него через /context, сжимай через /compact с указаниями («сосредоточься на изменениях API») или сжимай часть сессии из меню /rewind. Быстрые вопросы задавай через /btw, тогда они не попадают в историю. Безжалостно сокращай CLAUDE.md, а правила, которые должны выполняться всегда, переноси в хуки. Для работы без присмотра добавь независимую проверку: сабагента, который видит только diff и критерии и сообщает лишь о пробелах, влияющих на правильность.

Проверь себя

Две правки по одной и той же ошибке не помогли, она осталась. Что советует документация?

Проверь себя

Какой запрос не ведёт к «бесконечному исследованию»?

Факты проверены по официальной документации Claude Code 24 октября 2026 г. · источник

ЕАЕвгений Арсентьев

Автор

Евгений Арсентьев

PhD · CEO, digital health