Первый заход в редактор обычно ломается не на установке, а на слишком широкой задаче. Человек открывает проект и пишет «улучши код». Агент начинает трогать несколько файлов, а в diff уже нельзя отделить нужную правку от побочной. Ниже — короткий цикл, после которого остаётся одно понятное изменение или честный откат: открыть папку, попросить объяснить устройство, выбрать одну маленькую правку, прочитать diff и только потом решать, оставлять ли её.
Кто уже пользуется Claude в чате, получает объяснение функции текстом: файл не меняется, пока совет не перенесён руками. Cursor подключают в другой момент — когда тот же вопрос нужно закрыть правкой в открытой папке, а агент показывает diff, который можно отклонить. Как Claude оказывается моделью внутри редактора, а не только окном переписки, на сайте разобрано в материале о двух сценариях работы.
Что открыть до первого запроса
Справка по установке просит завести аккаунт до запуска приложения и прямо говорит: зарегистрироваться можно бесплатно на cursor.com. Скачивание — со страницы загрузки продукта. В Quickstart названы минимумы: macOS 12 и новее, Windows 10 и новее. Для Linux там рекомендуют пакет через apt или dnf, а не только переносной AppImage: у пакета есть значок, обновления и командная строка. Точные строки установки имеет смысл копировать из Quickstart в день установки, а не из чужой статьи.
После входа откройте папку проекта: File → Open Folder. Одна вкладка с файлом — это ещё не проект. Если открыт родительский каталог со всеми соседними сайтами, агент будет читать лишнее. Если открыта пустая папка, объяснение «кодовой базы» будет выдумкой. Этот первый отрезок — папка, панель Agent и проверка diff — на русском собран в гиде Cursor Chat. Дальше остаётся, как не отдать агенту весь проект одной фразой.
Вход выполняется в приложении Cursor, когда оно его запросит. Форма на постороннем сайте, бот и «доступ со скидкой» к этому циклу не относятся. Лимиты и платные ступени смотрите на странице тарифов продукта: здесь их нет, потому что они меняются без этой статьи.
Сначала попросите объяснить проект
Панель Agent открывается сочетанием Cmd+I на Mac и Ctrl+I на Windows и Linux. Первый запрос в Quickstart — не правка, а карта:
Explain this codebase. Point me to the main entry points, key modules, and anything I should read before making changes.
По-русски это звучит так: «Объясни этот проект. Назови точки входа, главные модули и что прочитать до правок. Файлы не меняй.» Ответ полезен, если в нём есть конкретные пути файлов, а не общие слова про «архитектуру». Откройте два названных файла и проверьте, что они действительно лежат в папке. Если агент ссылается на каталоги, которых нет, открыта не та папка либо он достраивает проект по привычке. Во втором случае правку начинать рано.
Режим Ask для такого вопроса подходит лучше Agent: по справке Ask только читает код и не меняет файлы. Переключение — выпадающий список в панели или Shift+Tab. Длинное объяснение лучше закончить до перехода к правке и в следующем запросе своими словами перечислить файлы, которые вы сами открыли.
Одна маленькая правка, а не переписывание
Quickstart советует следующий шаг таким запросом: предложи три небольших безопасных улучшения, объясни компромиссы и жди выбора. Хорошие первые задачи там названы прямо: поправить текст или мелкую ошибку интерфейса. Переписывание структуры, смена библиотек и «ускорь всё» к этому списку не относятся.
Если вы уже знаете дефект, не просите три идеи. Опишите результат и границу. Например, в учебном магазине цена на карточке выводится числом без валюты:
В карточке товара цена показывается числом без валюты. Добавь знак ₽ сразу после числа, в том же месте вывода. Не меняй расчёт, корзину, скидки и оформление заказа. Покажи diff и остановись. Если не найдёшь единственное место вывода, ничего не правь и перечисли найденные файлы.
В запросе есть объект, запрет на соседние части и условие остановки. Фраза «сделай как лучше» такого условия не содержит: агент сам решит, что «лучше» — это новый компонент. Смена провайдера и отдельный ключ API к этой первой правке не относятся. Если редактор уже принимает свой адрес, разведение быстрого черновика и более тяжёлого разбора лежит в другом тексте: Flash для черновиков и Pro для сложного.
Что смотреть в diff
Правки появляются по ходу работы, их смотрят в diff и отклоняют лишнее. Для примера с ценой достаточно четырёх вопросов:
- Изменился ли только вывод, а не формула цены?
- Нет ли второго места, где то же число осталось без знака, и не начал ли агент «чинить» его заодно в письме и в счёте?
- Не появились ли новые файлы, о которых вы не просили?
- Какая проверка проекта уже существует: тест, линтер, сборка? Попросите запустить её и принести команду вместе с итогом. «Тесты прошли» без имени команды ничего не доказывает.
Если проверки в проекте нет, так и запишите. Не просите агента сочинить большой новый набор тестов в том же заходе: это уже вторая задача.
Откат: checkpoint и Git — разные вещи
В документации Agent checkpoint — локальный снимок файлов сессии. Агент создаёт его перед существенными изменениями. Если поворот оказался неверным, снимок открывают на шкале чата и восстанавливают файлы, либо нажимают Restore Checkpoint у предыдущего запроса, либо кнопку «+» при наведении на сообщение. Восстановление возвращает файлы и не стирает реплики чата. Справка прямо отделяет это от Git: checkpoint нужен, чтобы отменить шаги агента, а постоянная история — в Git.
Поэтому до широкой правки посмотрите git status. Если рабочее дерево уже грязное, чужие несохранённые правки смешаются с правками агента, и откат будет трудно читать. Для первой учебной правки удобен чистый статус или отдельная ветка.
В треде 170624 это два разных сообщения, и смешивать их не стоит. Сотрудник Cursor @mohitjain 7 сентября 2026 года описывает ограничение Restore: откатываются только правки, сделанные инструментом редактирования. Команда в терминале, правка субагента и ручное изменение остаются в Changes; файлы .ipynb восстановление тоже не забирает. Отдельно, 4 сентября 2026 года, участник @AcidDiz жалуется на другое: после rollback файлы, которые менял сам Cursor, иногда всё равно остаются в Git Changes. Это сообщение пользователя, не формулировка справки и не то же ограничение, которое назвал сотрудник. Кнопка по-прежнему нужна, но единственной копией истории она не является.
Пока агент ещё работает, Enter ставит следующее сообщение в очередь: оно подождёт конец текущего шага. На Mac немедленная отправка описана как Cmd+Enter. Не пишите «продолжай» поверх плохой правки. Верните файлы и сузьте запрос.
Вопросы, которые возникают в первой сессии
Можно ли пропустить аккаунт?
Страница установки говорит обратное: перед установкой нужен аккаунт Cursor, и создать его предлагают на cursor.com. Сторонний сайт аккаунт не заводит.
Почему объяснение лучше начать в Ask?
Ask не записывает файлы. Так вы отделяете чтение проекта от права его менять. К Agent переходят, когда уже есть одна выбранная правка.
Checkpoint удалит переписку?
Нет. По справке откатываются файлы. Текст чата остаётся. Это же означает, что старые неверные инструкции никуда не делись: для новой попытки часто чище новый чат с коротким условием.
Что делать, если агент затронул лишние файлы?
Не принимайте diff «чтобы не потерять время». Отклоните лишнее или восстановите checkpoint и повторите запрос с явным списком запрещённых каталогов. Вторая широкая правка поверх первой только удлиняет разбор.
Итог первой сессии — не скорость агента, а понятный diff на одну задачу. Папка выбрана верно, объяснение ссылается на реальные файлы, правка не выходит за границу, проверка либо запущена, либо честно отсутствует, а путь назад известен до того, как вы попросите следующую функцию.
