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

Я учу людей работать с Cursor на разборах и в наставничестве. Чаще всего первый вопрос звучит так: «С чего начать, чтобы не сломать проект в первый же вечер?» Ответ простой: установить редактор с официального сайта, открыть папку проекта, сначала поговорить с Ask, потом дать одну маленькую задачу Agent и обязательно посмотреть diff перед коммитом. В России редактор обычно ставится нормально, но список моделей в Settings может отличаться от скриншотов в англоязычных гайдах; бесплатного Hobby хватает на первый вечер, вечного безлимита на free нет.

Что такое Cursor AI и чем он отличается от обычного редактора

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

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

- быстро разбираю чужой или свой мини-проект без недели чтения доков;

- вношу точечную правку — README, лендинг, скрипт — а не «переписываю всё с нуля»;

- держу контроль: diff, checkpoints, git.

Cursor не заменяет мышление и ревью. У меня в работе он ускоряет рутину только если я готов проверить, что именно изменилось в файлах.

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

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

Как установить Cursor: Windows, macOS и Linux

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

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

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

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

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

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

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

Типичные ошибки: скачивание не с cursor.com, открытие одного файла вместо папки, пропуск входа в аккаунт, сразу огромный репозиторий вместо учебной папки на 3–5 файлов. Подписки Cursor продаются только через cursor.com — «дешёвые аккаунты» у посредников я не рекомендую.

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

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

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

На первый вечер в Settings → Models выбираю Auto или то, что реально видно в списке. В AGENTS.md на старте хватает 3–5 строк: язык русский, маленькие diff, спрашивать перед удалением. В учебной папке делаю `git init` и коммит «до экспериментов» — страховка помимо checkpoints.

Один чат — одна задача. Сменили тему с README на CSS — новый чат. Иначе модель тащит старый контекст. Я сам на этом обжигался.

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

Agent mode: как не потеряться в режимах

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

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

На первом вечере у меня достаточно Ask → Agent:

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

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

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

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

```

Контекст: учебный репозиторий, правлю только README.md.

Задача: добавь раздел «Как запустить локально» — 5 нумерованных шагов.

Ограничения: не трогай другие файлы; не удаляй существующий текст.

Готово, когда: в README есть новый H2 и шаги соответствуют структуре проекта.

```

Хороший первый промпт умещается в экран чата и содержит критерий готовности.

Первый рабочий сценарий: Ask → Agent → проверка diff

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

Цикл, который прошу повторить:

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

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

3. AGENTS.md: язык русский, маленькие diff, спрашивать перед удалением.

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

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

6. При сомнении — Restore Checkpoint.

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

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

Checkpoints удобны внутри сессии, но не заменяют git. Для истории между вечерами — только коммиты.

Антипаттерны первого вечера: огромный промпт «с нуля всё», сразу Agent без Ask, один чат на десять задач, Auto-run всех команд терминала, принять diff «на доверии». Agent ошибается — моя задача ловить это на diff, а не на проде.

Cursor rules и контекст проекта

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

Project Rules лежат в `.cursor/rules/*.mdc` — в git, с globs. AGENTS.md в корне — простой старт без frontmatter. User Rules в Customize → Rules — глобально на все проекты.

Мини-пример AGENTS.md для учебного репозитория:

```markdown

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

- Отвечай по-русски.

- Правки маленькими diff; один логический кусок за раз.

- Перед удалением файла — спроси.

- Не трогай .env и секреты.

- Коммиты: docs:, fix:, feat: по смыслу.

```

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

Бесплатный тариф и работа из России

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

Официальный Hobby — бесплатно, без карты, с ограниченными Agent requests и доступом к Composer. Для первого сценария из этой статьи хватает, но бесплатно ≠ безлимит на frontier-модели. Для регулярной работы часто нужен Pro ($20/мес) через cursor.com; российские карты часто не проходят в Stripe.

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

Не ждите «как в рекламе все Claude/GPT из коробки в РФ». Смотрите фактический список в Settings.

От первого вечера реально получить установку, Ask для разведки, Agent для одной маленькой правки, навык читать diff и понимание лимитов Hobby. Не обещаю доход «X ₽ в месяц», безлимитный Agent навсегда на free и что diff можно не смотреть.

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

Можно ли бесплатно? Да, Hobby с ограниченными запросами. Для первого сценария хватает; для ежедневной интенсивной работы лимиты упираются быстро.

Нужен ли опыт программирования? Профессия не обязательна. Нужны понятия папка, файл, diff и простой git commit. Ask позволяет учиться без риска сломать проект.

Cursor или VS Code? Если цель — быстро править README или разобраться в небольшом проекте с агентом, Cursor даёт готовый цикл. Если уже живёте в VS Code с отлаженным стеком расширений — можно остаться там.

Где безопасно скачать? Только cursor.com/download.

---

Полная версия гайда с картинками — на vaybkoder.ru/blog/kak-polzovatsya-cursor-ai/ (https://vaybkoder.ru/blog/kak-polzovatsya-cursor-ai/). Если застряли на своём репозитории — напишите в Telegram цель, что уже сделано и где стопор.