Как пользоваться Cursor AI: первый рабочий сценарий

Cursor — это редактор на базе VS Code со встроенным ИИ-агентом. Я работаю не с «чатом сбоку», а с папкой проекта: агент видит файлы, предлагает правки и помогает разобраться в структуре репозитория.

Обычный редактор показывает код. В Cursor ещё панель AI (Ctrl+I / Cmd+I), режимы Agent, Ask, Plan, Debug и постоянный контекст через rules и AGENTS.md. Я включаю это, когда:

• быстро разбираю чужой или свой мини-проект без недели чтения доков;
• вношу точечную правку (README, лендинг, скрипт), а не «переписываю всё с нуля»;
• держу контроль: diff, checkpoints, git.

Cursor IDE vs VS Code с расширениями. VS Code + ChatGPT/Copilot — отдельные куски: чат, дополнение строк, иногда правки. В Cursor агент встроен в цикл: индексация папки, правила, checkpoints, одна панель режимов. Для первого вечера это меньше трения — не собираю «стек из пяти плагинов».

Когда Cursor полезен новичку и предпринимателю

Опыт программиста для первого сценария не обязателен. Обязателен контроль: вы должны понимать, какой файл изменился и зачем. Это я повторяю почти на каждом разборе.

Установщик беру только с cursor.com/download. Сторонние зеркала и «готовые сборки» почти всегда — устаревшая версия или риск для аккаунта.

Порядок установки, который я даю на первом занятии:

1. 01

   Откройте страницу загрузки на cursor.com.

2. 02

   Выберите установщик для Windows, macOS или Linux.

3. 03

   Запустите установщик и завершите мастер.

4. 04

   Войдите через Google или GitHub — без аккаунта лимиты и sync ведут себя странно.

5. 05

   При первом запуске откройте папку проекта (File → Open Folder), а не один файл.

На Linux с той же страницы download есть официальная CLI — удобно, если среда минимальная.

Системные требования и первый запуск

Cursor наследует требования VS Code: современная ОС, комфортнее 8+ ГБ RAM, место под индексацию. После входа я проверяю:

• язык интерфейса и раскладку;
• что в статус-баре видна модель или Auto;
• что открыта именно папка — без неё нет нормального codebase context.

Типичные ошибки при установке

Если нужен не один вечер, а регулярная практика — смотрите Обучение Cursor. Эта статья — про первый сценарий, не про весь курс.

Перед работой настраиваю минимум: папка проекта, панель чата и контроль версий. Не все тумблеры сразу.

Папка проекта, терминал, панель чата

• Explorer (слева) — дерево файлов. Agent опирается на то, что проиндексировано.
• Терминал (Ctrl+`) — git и скрипты. Команды агента я всегда смотрю глазами перед запуском.
• Панель AI (Ctrl+I / Cmd+I) — Ask, Agent, Plan, Debug. Одна точка входа, не «отдельный ChatGPT в углу».

Минимальные настройки для русскоязычного пользователя

1. 01

   Settings → Models: на первый вечер — Auto или то, что реально видно в списке (в РФ каталог может отличаться).

2. 02

   Settings → Rules: позже project rules; на старт хватает короткого AGENTS.md.

3. 03

   Git: git init в учебной папке и коммит «до экспериментов» — моя страховка помимо checkpoints.

4. 04

   Язык: в User Rules или AGENTS.md пишу «отвечай по-русски, diff маленькими порциями».

Настройка готова, когда я открываю папку, в Ask спрашиваю «какие файлы за что отвечают?» и получаю осмысленный ответ без правок.

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

Переключение: панель AI → селектор → Agent (иногда подпись «Agent (Chat)» — та же панель).

Agent vs Ask/Plan — что я выбираю с новичком

В доках Cursor часто рекомендуют Ask → Plan → Agent. На первом вечере у меня достаточно Ask → Agent:

1. 01

   Ask: «Где в проекте описан запуск локально?» — без риска правок.

2. 02

   Agent: «Добавь в README блок из 5 шагов запуска» — одна измеримая правка.

Plan включаю, когда трогаем много файлов и хочу утвердить план до diff.

Как сформулировать первую задачу агенту

Шаблон, который я даю ученикам:

Контекст: учебный репозиторий, правлю только README.md.
Задача: добавь раздел «Как запустить локально» — 5 нумерованных шагов.
Ограничения: не трогай другие файлы; не удаляй существующий текст.
Готово, когда: в README есть новый H2 и шаги соответствуют структуре проекта.

Ядро практики: один проверяемый результат за сессию. Так я сам захожу в незнакомый репозиторий.

Пошаговый цикл Ask → Agent → git

1. 01

   Установка с cursor.com → вход → Open Folder (учебная папка с README.md).

2. 02

   Ask: «Какие файлы отвечают за описание проекта?»

3. 03

   AGENTS.md (3–5 пунктов): язык русский; маленькие diff; спрашивать перед удалением.

4. 04

   Agent: правка одного файла (шаблон выше).

5. 05

   Review diff: зелёное/красное — что добавлено и удалено.

6. 06

   При сомнении — Restore Checkpoint (снимок внутри сессии).

7. 07

   Git: git status → git diff → git add -p → понятный commit.

8. 08

   Открыть README глазами и сравнить с задачей.

Шаблон промпта для первой правки одного файла

Структура: файл → действие → ограничения → критерий готовности. Избегайте «сделай мне сайт/бота/CRM» — Agent размажет правки, и ревью станет невозможным. Я такое вижу почти каждую неделю.

Чеклист перед принятием изменений

• Затронуты только ожидаемые файлы (часто 1–3).
• Нет массового удаления без явной просьбы.
• Терминальные команды одобрены осознанно.
• Текст/код читается и соответствует задаче.
• После accept — git diff и коммит.

Антипаттерны первого вечера

Если первый сценарий прошёл, но вы застряли на своём репозитории — логичный шаг: наставничество по вашему проекту.

Модели не помнят прошлые сессии сами по себе. Cursor rules и AGENTS.md — то, чем я держу постоянные инструкции: язык, стиль коммитов, запреты.

Где лежат rules и что писать на старте

• Создание: /create-rule в чате или Customize → Rules → Add Rule.
• Из документации: короче 500 строк, конкретно, без копипасты всего style guide.
• User Rules идут в Agent (Chat), не в Inline Edit (Ctrl+K).

Мини-пример rules для первого репозитория

Файл AGENTS.md в корне:

# Проект: учебный лендинг

- Отвечай по-русски.
- Правки маленькими diff; один логический кусок за раз.
- Перед удалением файла — спроси.
- Не трогай .env и секреты.
- Коммиты: `docs:`, `fix:`, `feat:` по смыслу.

Шаблоны задач держу в rules или docs/prompts.md, а не копирую простыни в каждый чат. Короткий контекст и одна задача работают лучше длинного промпта без структуры.

Дальше по кластеру Cursor: Rules, Agent mode, промпты с проверкой и что такое вайбкодинг. Весь список — в блоге.

На первом созвоне почти всегда спрашивают про бесплатный тариф и работу из России. Отвечаю как есть: без «вечного Pro» и без маркетинга обходов.

Лимиты free-тарифа (Hobby)

Официальный Hobby — бесплатно, без карты, с ограниченными Agent requests и доступом к Composer. Для первого сценария из этой статьи хватает, но:

• бесплатно ≠ безлимит на frontier-модели;
• для регулярной работы часто нужен Pro ($20/мес) — оплата через cursor.com;
• российские карты часто не проходят в Stripe — рыночный факт, не «гарантированный обход».

Лимиты смотрю в Settings и usage dashboard. Два пула usage на платных планах — в доках по моделям.

VPN, оплата и реалистичные ожидания для РФ

Редактор ставится с cursor.com; вход через Google/GitHub у большинства учеников проходит. Ограничения чаще в каталоге моделей: часть провайдеров может не показываться — это политика провайдеров, не «Cursor выключен».

Практические варианты, которые я проверяю на месте:

• Auto и модели, которые реально видны в списке (включая Composer);
• свой API key, если провайдер не режет регион;
• тест на вашей машине и сети — поведение Agent отличается.

На форуме Cursor (начало 2026) писали о нестабильности Agent у части пользователей из РФ без VPN. Это риск, не универсальное правило. VPN как продукт я не продаю; смотрим доступность моделей и рабочий сценарий.

Честные границы (без ROI)

От первого вечера реально получить:

• установку с официального сайта;
• Ask для разведки и Agent для одной маленькой правки;
• навык читать diff и делать git commit;
• понимание лимитов Hobby и региональных нюансов.

Не обещаю:

• доход «X ₽ в месяц» или «заменит программиста»;
• безлимитный Agent навсегда на free;
• что все премиум-модели точно работают в России;
• что Agent не ошибается и diff можно не смотреть.

Cursor ускоряет работу и обучение. Обучение и наставничество — про практику на вашем проекте, не про «кнопку богатства».

---

Автор: Пашкуров Пётр Сергеевич. Материал обновлён 29.07.2026. Источники: cursor.com/download, документация Agent, Rules, регионы (RU).