Cursor: 12 ошибок первой недели и как заметить их до того, как проект сломается

Коротко

Первая неделя в Cursor обычно проходит не гладко — не потому что инструмент плохой, а потому что часть его логики не очевидна из интерфейса. Ниже — 12 конкретных ошибок новичков, сгруппированных по темам: настройка, индексация репозитория, режимы работы, лимиты и биллинг, git-гигиена. Для каждой — симптом, признак, по которому её видно заранее, и быстрый фикс. Если вы ещё не установили Cursor и не сделали первую задачу, разумнее начать с базового гайда «как пользоваться Cursor» — здесь предполагается, что первый запуск уже позади.

Настройка: два способа не дать агенту контекст

1. Не настроены правила проекта. Симптом: агент упорно предлагает код не в стиле проекта — не те кавычки, не та структура папок, устаревший подход. Заметить можно уже на второй-третьей задаче: если правки раз за разом требуют одной и той же поправки постфактум, дело не в случайности, а в отсутствии контекста о конвенциях. Фикс — завести файл с правилами; как это сделать по шагам, разобрано в статье про настройку правил Cursor.

2. Работают без нужных расширений и интеграций. Симптом: агент отвечает по коду, но «не видит» внешние вещи — документацию библиотеки, таск-трекер, состояние браузера — и додумывает детали. Заметить: ответы про внешние сервисы звучат правдоподобно, но при проверке оказываются устаревшими — дело не в модели, а в отсутствии источника актуальных данных. Фикс — заранее смотреть, какие интеграции нужны под задачу, и подключать их по мере необходимости.

Индексация репозитория: агент работает по неполной картине

3. Индексируется весь репозиторий без исключений. Симптом: агент медленнее отвечает, иногда путает файлы из служебных и сборочных папок с актуальным кодом. Заметить: если в ответах всплывают упоминания зависимостей или файлов, которые вы точно не трогали, — это след индексации мусора. Фикс — исключить служебные и сгенерированные папки из индексации.

4. Открыт не тот корень проекта. Симптом: либо агент видит слишком мало — открыта подпапка вместо всего репозитория, — либо слишком много, когда открыта родительская папка сразу с несколькими проектами. Заметить: агент предлагает создать то, что уже есть в соседней папке, или никогда не ссылается на модули, которые точно есть в проекте. Фикс — открывать именно корень репозитория.

5. Первая агентная задача — до окончания индексации. Симптом: на только что открытом большом проекте первые ответы заметно хуже, чем через несколько минут работы. Заметить: индикатор состояния индексации виден в интерфейсе — стоит на него взглянуть перед тем, как писать промпт. Фикс — на большом проекте дать индексации закончиться, прежде чем доверять агенту что-то серьёзнее простого вопроса.

Режимы работы: три способа обмануться в том, что произойдёт

6. Путают режим вопроса и режим правок. Симптом: просите «просто объяснить», а получаете правки прямо в файлах — или наоборот. Заметить: если результат каждый раз удивляет по одному сценарию, переключение режима было неосознанным. Фикс — перед задачей проверять, какой режим сейчас активен, особенно если недавно переключали его.

7. Правки принимаются без чтения diff. Симптом: многофайловая правка принята одним кликом, а через день-два обнаруживается лишняя строка или случайно удалённый кусок логики. Заметить: если вы не можете вспомнить, что изменилось в последних трёх принятых правках, — вы их не читали. Фикс — читать diff построчно перед принятием, особенно на многофайловых правках.

8. Одна огромная задача вместо серии маленьких. Симптом: формулировка вроде «сделай раздел авторизации» вместо «добавь валидацию email на форме логина» — результат технически что-то делает, но не то, что было в голове. Заметить: если после diff первая мысль — «не знаю, с чего начать проверять», задача была сформулирована слишком широко. Фикс — дробить работу на шаги с понятным критерием «готово».

Лимиты и биллинг: то, что молча заканчивается в фоне

9. Не следят за расходом лимита в течение месяца. Симптом: ближе к концу расчётного периода запросы вдруг идут заметно медленнее или упираются в отказ посреди задачи. Заметить: расход обычно виден в настройках аккаунта — стоит заглядывать туда не только когда что-то уже пошло не так. Фикс — периодически проверять остаток лимита сознательно и заранее знать, что происходит при его исчерпании — это разобрано в статье про тарифы Cursor.

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

Git-гигиена: страховка, о которой вспоминают постфактум

11. Работают без коммитов и веток перед агентными правками. Симптом: агент внёс правки сразу в несколько файлов, результат не устроил — а откатывать нечем, коммит был два дня назад. Заметить: если вы не можете сказать, каким получится git diff относительно последнего коммита, — вы не застрахованы. Фикс — коммит или ветка перед любой задачей, которая трогает больше одного файла: секунды против часов отката руками.

12. Полагаются на встроенные чекпоинты вместо git. Симптом: внутренний откат правок в Cursor воспринимается как полноценная замена контроля версий, а потом выясняется, что он не так надёжен при переоткрытии проекта. Заметить: если вы не знаете точно, переживёт ли откат закрытие Cursor и перезапуск компьютера, — не полагайтесь на него как на единственную страховку. Фикс — чекпоинты как быстрый локальный откат внутри сессии, git — как настоящий источник истории проекта.

Все 12 ошибок одной таблицей

Почему это стоит знать заранее, а не разбирать постфактум

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

Если часть терминов из списка — режимы, индексация, правила проекта — пока не до конца понятны сами по себе, полезнее пройти бесплатные учебные треки: там логика инструмента разбирается по порядку, и список из 12 пунктов читается не как список угроз, а как то, что вы уже и так делаете правильно. А если хочется пройти первую неделю не методом проб и ошибок, а с разбором конкретно вашего проекта, есть бесплатная консультация — иногда быстрее один раз показать код человеку, чем набивать все двенадцать шишек самому. Более широкий каталог похожих граблей — не только по Cursor, а по вайб-кодингу в целом — собран в статье с типичными ошибками.

Частые вопросы

С чего начать, если Cursor только что установлен и первой задачи ещё не было?

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

Все 12 ошибок одинаково серьёзны?

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

Чекпоинты в Cursor — это не то же самое, что git?

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

Как понять, что я уперся в лимит тарифа, а не что-то сломалось?

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

Можно ли избежать всех 12 ошибок, если раньше не пользовался ИИ-агентами вообще?

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