Cursor AI для начинающих: как открыть проект, дать контекст и проверить изменения

Cursor может закончить задачу и показать аккуратный отчёт, хотя нужная кнопка по-прежнему не работает или вместе с ней изменился соседний экран. Слово «готово» в чате сообщает только о завершении работы Agent. Решение о готовности принимаете вы: по diff, запущенному проекту и заранее записанным критериям.

В этом гайде мы не будем обходить все настройки Cursor. Пройдём один безопасный цикл: откроем копию небольшого проекта, попросим Agent сначала объяснить её, дадим контекст одной правки, просмотрим изменения и только после проверки сохраним результат в Git.

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

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

Команда для этого шага: git --version.

Если команда не найдена, установите Git с официального сайта, снова откройте терминал и повторите проверку. Затем сохраните исходную версию:

Команды по порядку: git init, git add ., git commit -m "Сохранить исходную версию" и git status.

Если первый commit просит указать user.name и user.email, выполните предложенные Git команды настройки, повторите commit и снова запустите git status. Только после успешного commit последняя команда должна показать чистое состояние без незакоммиченных файлов. Эта точка понадобится после работы Agent: вы сможете увидеть все отличия и вернуть исходную версию.

В Cursor легко принять все AI-функции за один чат. Для первого проекта достаточно различать три режима.

Tab предлагает продолжение прямо во время набора. Текущая справка Tab описывает его как автодополнение: предложение появляется возле курсора, а пользователь принимает его клавишей Tab. Это удобно для локального фрагмента, но Tab не ведёт многошаговую работу по проекту.

Inline Edit меняет выбранный участок. Выделите код, нажмите Cmd/Ctrl+K и опишите локальную правку. Официальная справка относит этот режим к точечному редактированию в текущем файле.

Agent подходит, когда сначала нужно разобраться в папке, найти связанные файлы, внести изменение и запустить команды. Именно с ним продолжим. Откройте Agent через Cmd/Ctrl+I, но пока не просите писать код.

Отправьте Agent короткую задачу на чтение:

Этот маршрут совпадает с актуальным Quickstart Cursor: сначала выбрать папку и попросить Agent объяснить кодовую базу, затем переходить к небольшой правке. Сверьте ответ с файлами и README. Если Agent называет команду запуска, которой нет в проекте, попросите показать, из какого файла он её взял.

Широкий запрос «улучши страницу» оставляет Agent право самому решить, что считать улучшением. Он может переписать текст, поменять цвета и затронуть файлы, которые вы не собирались редактировать.

Дайте две части контекста:

• намерение: что пользователь должен сделать и что увидеть;

• состояние: где находится нужная страница, какое поведение есть сейчас и какие ограничения уже действуют.

Если вы точно знаете релевантный файл, добавьте его в сообщение через @. Текущая документация по prompting разрешает прикреплять файлы и папки, вывод терминала, прошлые чаты и Git diff. Если нужный файл неизвестен, не прикладывайте весь проект вручную: Agent умеет найти релевантные места поиском.

Допустим, на учебной странице уже есть форма заявки, но после заполнения непонятно, что произошло. Нужна одна правка: после корректной отправки показать текст «Заявка сохранена в учебном режиме», не отправляя данные наружу.

Прикрепите @index.html или найденный Agent файл формы и отправьте:

Прочитайте список файлов и план, пока Agent ждёт подтверждения. Если ради сообщения под формой он предлагает новый сервер или замену библиотеки интерфейса, попросите вариант в рамках существующего проекта. Разрешайте работу только после того, как план вернулся к одной правке и названным файлам. Чем раньше замечено расширение scope, тем меньше чужих строк придётся разбирать в diff.

Для сообщения под существующей формой достаточно короткого плана и явной паузы в чате. Если следующая задача затронет несколько файлов, потребует сначала изучить документацию или выбрать один из вариантов реализации, переключитесь в Plan Mode клавишами Shift+Tab в поле Agent.

Текущий Quickstart Cursor описывает такой порядок: Agent исследует кодовую базу, задаёт уточняющие вопросы, собирает подробный план и ждёт одобрения перед реализацией. Используйте режим не ради длинного документа, а когда до первой правки есть решение, которое нужно принять вам.

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

Разрешите Agent выполнить согласованную правку и наблюдайте за списком файлов. Когда работа закончится, откройте diff view. Актуальный Quickstart прямо предлагает просмотреть diff, а затем запустить те проверки, которыми уже пользуется проект: тесты, type checker, линтер или локальную сборку.

В diff добавленные строки отмечены отдельно от удалённых. Не пытайтесь сразу оценить красоту кода. Сначала проверьте границы задачи:

1. Изменены только названные файлы.

2. У формы появился нужный текст и условие его показа.

3. Нет сетевого запроса, которого не было в брифе.

4. Исходный текст страницы не исчез.

5. Не добавлены зависимости, конфигурация или новая инфраструктура.

Затем откройте терминал проекта и выполните git status и git diff. Git даёт независимый список изменений относительно сохранённой исходной версии. Если вы не понимаете строку, попросите Agent объяснить её связь с критерием задачи, но не принимайте объяснение вместо проверки поведения.

Запустите проект командой из README и пройдите случаи по одному:

• отправьте форму с пустыми полями;

• заполните только часть обязательных полей;

• заполните всё и проверьте точный текст подтверждения;

• обновите страницу и убедитесь, что остальной интерфейс выглядит как до правки;

• откройте инструменты разработчика и убедитесь, что форма не отправляет внешний запрос.

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

Лишнее изменение можно попросить убрать отдельной командой, а затем снова проверить diff. Если проще вернуться к исходной точке, используйте Git. Перед восстановлением убедитесь, что выбрали нужные файлы: откат удаляет незакоммиченные изменения, в том числе сделанные вручную.

Когда все критерии выполнены, diff понятен, а команды проекта проходят, сохраните результат отдельным коммитом. Это и есть практическое принятие правки: не нажатие одной кнопки, а проверенное состояние репозитория.

На собственном сайте или боте такой цикл быстро выходит за пределы одной формы: появляются Git, логи, база данных, деплой и защита. В программе курса «Вайбкодинг на максималках» эти этапы соединены в работу над собственным проектом. Курс построен вокруг Codex и VS Code, поэтому его не стоит воспринимать как курс по Cursor; полезен именно общий процесс от идеи и фичи до работающего проекта.

Слишком мало контекста. Запрос «добавь подтверждение» не сообщает, после какого действия оно появляется, какой нужен текст и отправляются ли данные. Вернитесь к наблюдаемому поведению и ограничениям.

Слишком много контекста. Не прикрепляйте всю папку только потому, что видите символ @. Текущая документация Cursor советует явно прикладывать файл, когда вы знаете, что он релевантен; в остальных случаях Agent сам ищет нужные места. Случайные документы занимают контекст и отвлекают от задачи.

Следующая просьба до проверки. Когда первая версия не работает, легко продолжить чат командами «поправь», «теперь точно» и «попробуй иначе». Остановитесь, воспроизведите один симптом и только потом отправьте его Agent. Так новая правка отвечает на найденную поломку, а не на догадку.

Секреты в приложенных файлах. Перед добавлением папки или вывода терминала проверьте, нет ли там API-ключей, токенов, клиентских данных и содержимого .env. Для учебной формы они не нужны.

В текущей документации Cursor есть отдельная функция Agent Review, которая запускает AI-проверку локальных изменений. Она может быть дополнительным слоем, но не заменяет просмотр обычного diff и ручную проверку интерфейса. Для первого проекта не усложняйте маршрут: исходная точка Git, одна правка, понятный diff, повторяемые случаи.

Постоянные правила тоже можно отложить. После двух-трёх задач станет видно, какие команды и ограничения вы повторяете. Тогда перенесите устойчивые договорённости в Cursor Rules, а разовый критерий конкретной формы оставьте в её запросе.

Следующей задачей добавьте форме кнопку сброса: она очищает поля и сообщение, но не меняет остальную страницу. Сначала запишите поведение, затем попросите Agent назвать файлы, проверьте diff и повторите ручной маршрут. Две небольшие принятые правки дадут больше понимания Cursor, чем обзор всех режимов без собственного репозитория.