Как пользоваться Cursor: IDE и Agent

Пользоваться Cursor — это не «скачал и сразу получил готовую программу». Сначала аккаунт и папка проекта, затем Agent, затем проверка diff. Ниже — порядок, который совпадает со Quickstart и справкой про Agent на момент подготовки текста. Мы не добавляем функции, которых нет в этих страницах.

Установка и первый проект

Заведите аккаунт на cursor.com, если его ещё нет. Как именно — на странице регистрации.
Скачайте сборку под свою ОС с cursor.com/download. Справка: macOS — перетащить в Applications; Windows — установщик; Linux — пакет apt / dnf или AppImage. Точные команды для Linux лучше скопировать из Quickstart в день установки: репозитории пакетов Cursor обновляет сам.
Откройте приложение и войдите, когда появится запрос.
Выберите папку: File → Open Folder. Так написано и в карточке первого проекта.

Системные минимумы, которые называет Quickstart: macOS 12 и новее, Windows 10 и новее. Для Linux предпочтительны пакеты apt/yum, а не только AppImage: у них иконка в меню, обновления и CLI.

Agent в редакторе

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

Откройте панель Agent: Mac — Cmd+I, Windows и Linux — Ctrl+I.
Опишите результат, а не только «почини». В справке пример: форма входа с почтой и паролем на главной.
Отправьте запрос. Дальше агент сам ищет файлы и вносит правки.
Смотрите diff по мере работы. Лишнее отклоняйте.

Конкретные файлы и папки можно указать через @ в поле ввода: например @auth.ts или @src/components/. Правила проекта, пользователя и команды, по справке, действуют во всех режимах.

Четыре режима

Справка сводит режимы в одну таблицу. Переключение: Shift+Tab или выпадающий список в панели Agent. У каждого режима своё окно контекста: смена режима начинает новый контекст. Для новой задачи справка советует новый чат.

Agent — собирать функции, рефакторить, чинить. Может менять файлы.
Ask — понять код и архитектуру. Только чтение, файлы не трогает.
Plan — большая задача, где сначала нужен план. Код — после вашего одобрения. В Quickstart Plan включают той же Shift+Tab: агент исследует репозиторий, задаёт уточнения, пишет план и ждёт.
Debug — ошибка, которую трудно воспроизвести «на глаз». Может менять файлы; заточен под runtime-улики.

Для большинства повседневных поручений справка рекомендует Agent. Ask — когда нужен ответ без правок.

Пошагово: первая полезная правка

Это сжатый конспект официального Quickstart, не отдельный «секретный сценарий».

После открытия папки попросите агента объяснить репозиторий: входные точки, главные модули, что прочитать перед правкой.
Попросите три небольших безопасных улучшения, выберите одно. Либо сразу опишите нужный результат.
Дождитесь diff. Попросите прогнать то, чем проект уже проверяет себя: тесты, типы, линтер, локальную сборку.
Если задача расползается на много файлов — переключитесь в Plan Mode и не утверждайте план «по привычке».

Хорошие первые задачи в Quickstart названы прямо: правка текстов, мелкая интерфейсная ошибка. Не начинайте с переписывания всей архитектуры.

Как смотреть и откатывать изменения

Правки Agent применяет по ходу работы. Их смотрят в diff и отклоняют точечно. Чтобы откатиться дальше, справка описывает Restore Checkpoint: наведите курсор на предыдущее сообщение и восстановите точку. Откатываются файлы, история чата при этом не стирается. Чтобы укоротить сам диалог, чат можно форкнуть с более раннего сообщения.

Остановить агента можно кнопкой Stop. Следующие указания можно ставить в очередь, пока он ещё работает: они дождутся конца текущего шага. Сообщение «на ходу» по справке не рвёт текущий tool call, а встаёт в очередь.

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

Облачные агенты и CLI

Тех же агентов можно запускать из браузера на cursor.com/agents. На сайте продукта также публикуют установку CLI:

curl https://cursor.com/install -fsS | bash

Команду имеет смысл брать с главной Cursor или из docs в день установки. Отдельные сюжеты про Projects, Origin и свои машины разобраны в новостях — это записи changelog, а не обязательный шаг для первого проекта на ноутбуке.

Если агент «не тот» или не открывается

Проверьте, что вы вошли тем же способом, которым регистрировались. Подписка может висеть на другой учётке.
Откройте папку проекта: без workspace агенту нечего читать.
Сверьтесь с режимом: Ask не будет писать в файлы, это не «поломка».
Модели и остаток лимита смотрите в редакторе и на Models & Pricing. Цифры сюда не копируем: они меняются.
Вопросы по списаниям и блокировке — в поддержку Cursor, не на контакты этого сайта.

Чем мы отличаемся от кабинета входа — в разделе о сервисе. Короткие ответы — в FAQ.