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

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

Короткий ответ

Главные грабли новичка: расплывчатые задачи, грязный контекст, слепое доверие к коду и слишком широкий доступ. Все четыре лечатся не магией, а дисциплиной. Ставь задачу конкретно. Чисти контекст между задачами через /clear. Читай, что агент реально изменил, прежде чем принять. Давай минимальный доступ под нужду, а не «всё подряд на всякий случай». Плюс три технические привычки: фиксируй повторяющиеся правила символом #, работай под git, разбивай крупные задачи на шаги. Дальше — по каждой ошибке подробно.

Постановка и доверие: агент делает не то и делает это тихо

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

Чем аукается: потерянное время на переделку и ложное ощущение, что «агент тупой». На деле тупой была постановка. Как избежать: формулируй задачу так, будто объясняешь толковому новому сотруднику, который твой проект видит впервые. Что нужно сделать, где, зачем, чего делать НЕ надо, как понять что готово. Про то, как ставить задачу правильно, есть отдельный разбор в этой библиотеке — если проваливаешься именно здесь, начни с него. Хорошая постановка экономит больше времени, чем любой другой навык работы с агентом.

Ошибка 2: слепо принимаешь код, не читая, что агент сделал. Соблазн понятный: агент выдал результат, всё вроде работает, жмёшь «принять» и идёшь дальше. Но «вроде работает» и «работает» — разные вещи. Агент мог решить задачу способом, который ты бы не выбрал: заглушил ошибку вместо того чтобы её починить, поменял смежный кусок, добавил зависимость, которая тебе не нужна. Пока ты не посмотрел на изменения, ты не знаешь, что именно принял.

Ключевая мысль: агент — это не автопилот, которому ты сдал руль. Это очень быстрый junior, за которым нужен ревью. Читай diff — что он добавил, что удалил, что тронул рядом. Тридцать секунд на просмотр изменений экономят час на отлов бага, который ты пропустил, потому что «выглядело нормально».

Контекст и деньги: сессия распухает, агент тупеет

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

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

Как избежать: две команды. Закончил одну задачу, переходишь к несвязанной — жми /clear, он полностью сбрасывает историю и даёт агенту чистый лист. Если задача длинная и бросать контекст нельзя, но он уже разросся — /compact сжимает разговор, сохраняя суть и выкидывая мусор. Простое правило: одна задача — одна чистая сессия. Не таскай вчерашний разговор в сегодняшнюю работу.

Доступ и безопасность: раздал ключи «на всякий случай»

Ошибка 4: слишком широкий доступ. Новичок, начитавшись, что «агент может всё», подключает всё подряд — десяток MCP-серверов, права на запись в боевую базу, доступ к рабочим сервисам — по принципу «пусть будет, вдруг пригодится». Это ошибка сразу в две стороны.

Первое — риск. Если ты дал агенту доступ к чему-то, он этим реально пользуется. Подключил базу с правом записи — агент может в неё писать и удалять. Широкий доступ, выданный вслепую, — это площадь возможной ошибки, которую ты сам себе расширил. Второе — контекст. Каждый подключённый MCP-сервер добавляет агенту описание своих инструментов, а это место в его голове. Десяток лишних серверов размывает внимание и ухудшает ответы, даже если ты ими не пользуешься.

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

Откат и масштаб: нечем откатить и слишком много за раз

Ошибка 5: не фиксируешь правила и повторяешь одни и те же поправки. Ты каждый раз поправляешь агента: «пиши комментарии по-русски», «не трогай этот файл», «используй такой-то стиль». Он слушается — в этой сессии. В следующей всё забыто, и ты повторяешь ту же поправку заново. День за днём одно и то же.

Как избежать: символ #. Если в начале сообщения поставить #, Claude Code воспринимает его как правило и предлагает записать в файл CLAUDE.md — это память проекта, которую агент подхватывает в каждой новой сессии. Один раз зафиксировал «#всегда пиши тесты рядом с кодом» — и больше не повторяешь. Твои поправки перестают испаряться и превращаются в постоянные правила игры.

Ошибка 6: работаешь не под git, без бэкапа. Самая болезненная из всех, потому что цена ошибки — потеря работы. Новичок запускает агента на проекте, который не под версионным контролем. Агент, дав ему волю, переписывает пол-проекта — и часть переписывает не так. А отката нет. Нет коммита, к которому можно вернуться, нет способа сказать «верни как было». Часы работы — коту под хвост.

ВНИМАНИЕ: без версионного контроля откатить наломанное нечем. Заведи git в проекте с первого дня и коммить перед тем, как дать агенту большую задачу. Тогда любой промах агента — это одна команда отката, а не катастрофа. Коммит — это твоя точка сохранения. Не садись за серьёзную работу с агентом без неё.

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

Как избежать: разбивай на шаги. Большую задачу — на маленькие понятные куски, каждый со своим результатом, который можно проверить. И используй plan-режим: агент сначала показывает план действий, ты его смотришь, правишь, одобряешь — и только потом он начинает делать. Так ты ловишь неверное понимание до того, как оно превратилось в тысячу строк не того кода. Медленно — это гладко. Дробление плюс план бьёт «сделай всё сразу» на любой нетривиальной задаче.

Шпаргалка

FAQ

Я новичок и всё равно наделаю этих ошибок. Это нормально?

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

Чем /clear отличается от /compact?

/clear полностью стирает историю разговора — как открыть новую чистую сессию, но не выходя из неё. Используй, когда переходишь к задаче, не связанной с предыдущей. /compact сжимает текущий разговор, сохраняя его суть, — используй, когда задача длинная, контекст нужен, но он уже разросся и агент начал тупить.

Обязательно ли работать под git, если проект маленький?

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

Сколько MCP-серверов и доступов подключать?

Только под реальную нужду прямо сейчас. Каждый лишний сервер — это и риск, и место в контексте агента, которое размывает его внимание. «Подключу всё, вдруг пригодится» — плохой план: пригождается редко, а качество ответов падает всегда. Появилась задача — подключил под неё. Нет задачи — нет сервера.

Что ты увидишь

Перед тем как применить правку, агент показывает diff — что добавил (+) и что убрал (−). Тридцать секунд на просмотр экономят час на отлов бага:

  src/auth.ts
-  const user = decode(token)
+  if (!token) throw new Error("no token")
+  const user = decode(token)

Итог

Первые ошибки новичка почти всегда не в Claude Code, а в том, как им пользуются: размытые задачи, грязный контекст, слепое принятие кода и доступ, розданный вслепую. Всё лечится дисциплиной — ясная постановка, /clear и /compact для контекста, ревью изменений, минимальный доступ, правила через #, git для отката и разбивка больших задач с plan-режимом. Ничего сложного, всё — привычка.

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