Руководство · Cursor
Execution and approvals в Cursor: как настроить
Cursor Agent mode — режим, в котором ИИ читает проект, правит файлы и запускает команды по задаче. Безопасный процесс: одна ограниченная задача, критерии готовности (test, lint, build), просмотр diff до Apply и запрет на секреты, прод-деплой и массовое удаление без ревью. Cursor Rules задают стек, команды проверки и запреты заранее.

Что такое Cursor Agent mode и чем он отличается от Ask, Plan и Debug
Cursor Agent mode — автономный режим в панели агента: модель читает кодовую базу, редактирует файлы, запускает терминал и итерирует до результата. Это не «чат с подсказками» — правки применяются по ходу сессии, и вы смотрите diff в реальном времени. В официальной таблице Cursor (2026) в одной панели живут четыре режима ввода: Agent, Ask, Plan и Debug — переключение Shift+Tab в поле ввода агента.
Люди ищут «cursor agent», «cursor агенты», «cursor agent mode» с одной целью: как делегировать работу агенту и не разнести проект. Устаревшие гайды 2024–25 иногда называют эту панель Composer; в актуальной справке Cursor это Agent panel и режимы Agent / Ask / Plan / Debug. Composer я упоминаю только как устаревающий синоним панели Ctrl+I, чтобы не путать с формулировками из старых обзоров.
| Режим | Что делает | Правит файлы? | Когда я выбираю |
|---|---|---|---|
| Ask | Объяснения, архитектура, разведка | нет | Перед Agent: понять код без правок |
| Plan | План, правки после согласования плана | после плана | Крупная multi-file задача в незнакомом репо |
| Debug | Отладка с runtime evidence | да | Баг с логами/стеком, не «безопасный Agent» |
| Agent | Рефакторинг, фичи, тесты, итерации | да | Узкая задача с тестами и Rules |
Когда Agent mode уместен, а когда достаточно Ask
Agent уместен, когда вы готовы к правкам в файлах и есть способ проверить результат (тесты, линтер, build из Rules). Ask — когда нужно только прочитать: «объясни этот модуль», «где в проекте валидируется форма» — без риска случайного diff. На разборе типичная ошибка: человек открывает Agent с промптом «расскажи, как тут всё связано» — агент начинает «улучшать» код. Для разведки — Ask; для правок — Agent с узким scope.
Plan — промежуточный вариант: сначала план и согласование подхода, потом правки. Я рекомендую Plan, если репозиторий новый и задача затрагивает несколько модулей: меньше шанс, что агент разнесёт структуру одним промптом «сделай как в проде».
Debug тоже пишет файлы — не смешайте его с «безопасным workflow». Это отдельный режим для отладки, не замена дисциплины diff + тестов в Agent.
Как включить и переключиться в Agent mode в Cursor
Переключиться в Agent mode: откройте панель агента Ctrl+I (Windows/Linux) или Cmd+I (macOS). В поле ввода Shift+Tab циклично меняет режимы Agent / Ask / Plan / Debug; в dropdown у поля ввода тот же выбор. Панель агентов (cursor agents window в поисковых запросах) — это та же боковая Agent panel, не отдельный продукт.
Где в интерфейсе переключатель режимов
Переключатель сидит в поле ввода Agent panel: иконка или подпись режима слева или над текстовым полем, плюс Shift+Tab. Если после обновления Cursor не видите Plan — проверьте версию редактора и справку: Plan и Debug появились в актуальной линейке режимов. Editor и Agent panel — разные вещи: editor — вкладка кода, Agent — панель Ctrl+I / Cmd+I.
Agent window и очередь задач
В Agent panel можно ставить сообщения в очередь, пока агент работает — удобно для уточнений, но не для «накидать пять больших задач». Я держу одну активную задачу на сессию: очередь — для «не трогай package.json» или «остановись после тестов», а не для параллельных фич.
Checkpoints — локальные снимки файлов в сессии Agent; Restore Checkpoint откатывает правки внутри сессии. Это не замена Git: checkpoint = быстрый undo, Git = постоянный контроль версий. Перед крупным рефакторингом я прошу агента создать checkpoint или сам коммичу чистое состояние — так откат не зависит только от UI.
Безопасный рабочий процесс: задача → diff → тесты → Apply
Безопасный workflow в Agent mode — не «надеяться на модель», а цепочка: узкая задача → diff в реальном времени → свои тесты/линт → commit после ревью. Cursor советует быть конкретным в промпте; на практике я добавляю критерии готовности и явный список файлов, которые можно трогать.

Как сформулировать ограниченную задачу и критерии готовности
Формула, которую я даю на наставничестве — четыре блока в одном сообщении:
- 01
Что — одна цель («добавить типы в
formatDate», не «улучши проект»). - 02
Где — путь или glob (
src/utils/date.ts, только этот файл). - 03
Как проверить — команда из Rules (
npm test -- formatDate,npm run lint). - 04
Что не трогать —
package.json, конфиги, другие модули.
Пример промпта, который я разбираю с учеником:
В src/utils/date.ts добавь явные типы для formatDate и parseUserDate.
Не меняй другие файлы. Критерий готовности: npm test -- date.test.ts зелёный
и npm run lint без ошибок в src/utils/date.ts.
Не трогай package.json и lockfile.После такого промпта агент ищет по кодовой базе, правит файл, может запустить тесты — в зависимости от Run Mode. Я не ухожу из сессии, пока идут правки: смотрю diff, при уходе в сторону — Stop.
Walkthrough на разборе: ученик с Vitest в Rules, файл src/utils/date.ts без типов на публичных функциях. Agent правит ~15 строк, в diff видно только date.ts и новые тесты в date.test.ts — если агент лезет в package.json, Stop и уточнение scope. Я прогоняю npm test -- date.test.ts сам в терминале, не полагаюсь только на вывод агента «тесты прошли». Diff читаю целиком: иногда агент добавляет any или отключает eslint-disable. Commit — когда я понимаю каждую строку.
Чек-лист перед Apply (и после правок)

Ниже — мой чек-лист из 12 пунктов (не официальная политика Cursor). Он совпадает с документацией и с тем, что я прошу на разборе.
До задачи
- 01
В проекте есть Cursor Rules с командами проверки и запретами.
- 02
Run Mode = Auto-review (не Run Everything).
- 03
Секреты не в чате; чувствительные пути в ignore.
- 04
Задача узкая: что / где / как проверить / что не трогать.
- 05
Для незнакомой области — Ask или Plan, потом Agent.
Во время
- 01
Следить за diff; Stop при уходе в сторону.
- 02
Одобрять shell/MCP осознанно; не игнорировать prompt classifier block.
- 03
Checkpoints перед крупным рефакторингом.
После
- 01
Прогнать свои тесты/линтер (команда из Rules).
- 02
Прочитать diff целиком; не merge «потому что зелёный один тест».
- 03
Git commit только когда понимаю каждое изменение.
- 04
Для облака/PR — отдельное ревью (Bugbot опционально).
Что можно поручить Agent mode без лишнего риска
В «зелёную зону» я отношу задачи, где область маленькая, есть тесты и Rules, а откат — дешёвый. По документации Cursor Agent как раз для feature work, refactor, bugfix и tests; матрица ниже — как я сам делю задачи после базовой настройки и Rules.

| Тип задачи | Почему зелёная зона | Как проверяю |
|---|---|---|
| Rename переменной/функции в 1–3 файлах | Малый diff, IDE + тесты ловят поломки | diff + npm test |
| Добавление типов, JSDoc, докблоков | Локальные правки, линтер видит ошибки | npm run lint |
| Unit-тесты к известному модулю | Изолированный файл тестов | Осмысленность assert, edge cases |
| Мелкий bugfix с воспроизводимым тестом | Одна гипотеза, один модуль | Регрессионный тест остаётся зелёным |
| Форматирование по правилам из Rules | Предсказуемый стиль | lint + diff без логических изменений |
Запрос «ии агент cursor» и «cursor ai coding agent» часто ведут сюда: люди хотят «локального ии агента для программирования в cursor» — по факту это Agent mode на вашем workspace с вашими Rules, не отдельный сервис. Локальный агент читает ваш диск (с учётом ignore) и выполняет команды в терминале по Run Mode — не магия «автономного разработчика».
Что делегировать только с ручной проверкой
«Жёлтая зона» — задачи, где агент может сделать технически правильное, но опасное для проекта. Я поручаю, но diff + CI + второй проход глазами обязательны.
| Тип задачи | Риск | Что проверяю |
|---|---|---|
Обновление зависимостей (package.json, lockfile) | Major, transitive vulns | changelog, npm audit, полный CI |
| Правки CI/CD, Dockerfile, deploy-скриптов | Слом пайплайна / прод | diff построчно, dry-run |
| Кросс-модульный рефакторинг | Скрытые связи | интеграционные тесты, smoke |
| Изменение API-контрактов | Полом клиентов | контрактные тесты, consumers |
| MCP: черновик в staging WP/TG | PII, токены в теле | содержимое, не прод |
Обновление зависимостей — классический кейс на разборе: агент обновил vite и lockfile, unit-тесты зелёные, но e2e падает на плагине. Без npm audit и smoke я не коммичу. Для major — только с бэкапом ветки и явной задачей в Plan, не одним промптом в Agent.
Что не поручать Agent mode
«Красная зона» — задачи, где цена ошибки выше выгоды автоматизации. Агент может ошибиться даже с Rules; Run Modes не дают 100% safety boundary.
| Тип задачи | Почему не поручать |
|---|---|
Секреты, ключи API, .env | Утечка в чат, коммит, лог терминала |
| Прод-деплой, миграции БД | Необратимые изменения без runbook |
| Массовое удаление, «почисти проект» | File-Deletion Protection не гарантия |
git push --force, rewrite history | Потеря истории для всех |
| Платёжка, персональные данные | Compliance, юридика |
| «Прочитай .env и настрой» | Прямой запрос на секреты в контекст |
На разборе иногда присылают промпт «удали всё ненужное в src/» — даже с File-Deletion Protection я не даю такие задачи. Scope списком файлов или папкой с тестами.
Продакшен: можно ли доверять агенту прод? Мой ответ — нет как автономному исполнителю. Agent может подготовить diff в ветке; выкат, миграции, флаги — только человек по runbook. Cloud Agents тоже не «безопаснее» по умолчанию — там другой контур риска (ветка/PR), не нулевой.
Run Modes: Auto-review, Allowlist и Run Everything
Run Modes — отдельная ось от Agent / Ask / Plan / Debug. Они регулируют, сколько автономии у shell, MCP и Fetch: Auto-review, Allowlist, Run Everything. Настройка: Settings → Agents → Approvals & Execution. «Agent mode» ≠ «Run Everything»: можно быть в Agent с жёстким Auto-review.
| Run Mode | Поведение | Кому |
|---|---|---|
| Auto-review | allowlist → sandbox (если можно) → classifier → approval prompt | Default с Cursor 3.6 (29.05.2026), новички |
| Allowlist | Только allowlist без approve; опционально sandbox для остальных shell | Опытные с вылизанным allowlist |
| Run Everything | Всё без промптов | Не рекомендую на разборе |
Цепочка Auto-review для shell/MCP/Fetch: совпало с allowlist → выполняется; иначе shell → sandbox с ограничениями FS/сети; не sandboxится → classifier (allow / другой путь / approval prompt). Критичная оговорка из docs: Auto-review is not a security boundary — классификатор недетерминирован; для строгого контроля — Allowlist и ручные approve.
Дополнительные защиты (могут требовать approve даже при мягком Run Mode): Browser Protection, File-Deletion Protection (включая rm), External-File Protection (файлы вне workspace). Конфигурация: ~/.cursor/permissions.json, /.cursor/permissions.json с autoRun.allow_instructions / block_instructions; sandbox.json для сети и путей.
С Cursor 3.5 (22.05.2026) режим Ask Every Time deprecated; Run in Sandbox переименован в связку Allowlist + sandbox. Не описывайте Ask Every Time как текущий default — для новых установок рекомендован Auto-review.
CLI (для продвинутых): в headless approvalMode allowlist | unrestricted — без IDE classifier; риск выше. На первом занятии не трогаем.
Как Cursor Rules снижают риск в Agent mode
Cursor Rules снижают риск, потому что подмешивают стек, команды lint/test/build и запреты в каждый режим панели — Agent, Ask, Plan, Debug. Project Rules в .cursor/rules/*.mdc, User/Team Rules, AGENTS.md — всё это вероятностическое руководство, не детерминированный gate. Rules сужают поведение агента, но не заменяют diff и тесты человеком.
Три слоя, которые я проговариваю на разборе:
- 01
Rules — что агент должен помнить (стек, команды, запреты).
- 02
Diff — что агент реально изменил в файлах.
- 03
Свои тесты/линт — прошёл ли проект ваши критерии, не только вывод агента.
Подробная настройка — в материале Cursor Rules: alwaysApply, globs, чек-лист «правило молчит». Запросы «cursor agents md» ведут к AGENTS.md и .cursor/agents/ — это следующий уровень после базовых project rules.
Минимальный набор rules перед первой «боевой» задаче агенту
Перед первой задаче в Agent я проверяю, что в overview.mdc есть:
- стек и версии (Node, TS, тест-раннер);
- одна строка команд проверки, которая реально работает в терминале;
- запрет секретов и массового удаления;
- «не менять lockfile без задачи»;
- язык ответов, если чат на русском.
Без этого Agent «угадывает» Jest вместо Vitest и выдумывает yarn test. Rules не гарантируют соблюдение — но без них разброс выше.
Agent mode vs Cloud Agents и фоновые агенты
Локальный Agent mode и Cloud Agents — разные контуры. Cloud Agents (cursor.com/agents) работают на выделённой машине в облаке и не используют Run Modes IDE — нет той же цепочки approve на каждое действие. Ревью там через ветку и PR, не через локальный diff в реальном времени.
| Локальный Agent (Ctrl+I) | Cloud Agents | |
|---|---|---|
| Run Modes IDE | да | нет |
| Где правки | ваш workspace | облачная VM / ветка |
| Ревью | diff в UI + тесты | PR, CI, человек |
| Когда уместен | повседневные задачи в своём репо | длинные задачи, изоляция |
Background agents и Cursor Agent CLI — смежные темы: фоновая работа и headless-режим. В этой статье их не разбираю пошагово. Граница простая: облако само по себе не «безопаснее» — там другой workflow ревью.
Subagents — делегирование подзадач в отдельное контекстное окно; кастомные в .cursor/agents/*.md, есть readonly: true. Следующий уровень после одиночного Agent; не снимает ревью артефактов.
MCP, субагенты и автоматизация: где граница ответственности
MCP расширяет агента внешними инструментами (репозиторий, браузер, CMS, Telegram). Это отдельная большая тема — здесь только граница ответственности. MCP не снимает ручной ревью: агент может отправить сообщение, создать пост или дернуть webhook с персональными данными и токенами. Для подключений держите staging/dev, проверяйте содержимое и не публикуйте в прод без человека.
В обзорах иногда обещают «автоворонку лидов в Cursor: правила и два субагента за вечер». Идея субагентов после Rules и MCP в CRM полезная, но я не обещаю лиды за вечер и не копирую чужие призывы. Subagents в Cursor есть — они изолируют контекст, не снимают ответственность. Прототип автоматизации в отдельной папке репозитория — только с проверкой каждого артефакта; прод без ревью остаётся красной зоной.
Что читать дальше
- Промпты для Cursor — как формулировать задачи агенту.
- Что такое вайбкодинг — границы цикла intent → patch → verify.
- Обучение Cursor — регулярная практика на вашем стеке.
Если после Rules и этого чек-листа всё ещё неясно, что поручить Agent на вашем репозитории — на наставничестве разбираем конкретную задачу: формулируем промпт, смотрим diff вместе, фиксируем критерии готовности.
Что прислать в Telegram:
- ссылку на репо или описание стека;
- одну задачу, которую боитесь дать агенту;
- есть ли
.cursor/rulesи какие команды тестов реально работают.
По теме в блоге
Как пользоваться Cursor AI и Cursor Rules. Если Agent mode уже в работе — следующий шаг: промпты для Cursor. Про подход к разработке с ИИ — вайбкодинг.
Автор: Пашкуров Пётр Сергеевич. Источники: документация Agent, Rules, модели и pricing.
Частые вопросы
Что такое Cursor Agent mode?
Cursor Agent mode — режим в панели агента (Ctrl+I / Cmd+I), в котором ИИ читает кодовую базу, редактирует файлы, запускает терминал и итерирует до результата. Правки видны в diff в реальном времени. Это не Ask: Agent действительно меняет проект, поэтому нужны Rules, узкий scope и проверка diff и тестов.
Чем Agent mode отличается от Ask в Cursor?
Ask — только чтение: объяснения и архитектура без правок файлов. Agent — автономные правки, shell и итерации. Plan — сначала план, правки после согласования. Debug — отладка с runtime evidence, тоже пишет файлы. Переключение: Shift+Tab в поле ввода Agent panel.
Как переключиться в Agent mode в Cursor?
Откройте панель агента: Ctrl+I (Windows/Linux) или Cmd+I (macOS). В поле ввода Shift+Tab переключает Agent / Ask / Plan / Debug; тот же выбор в dropdown режима. Убедитесь, что выбран Agent, а не Ask, если нужны правки в файлах.
Что можно поручить агенту в Cursor?
Зелёная зона: rename в 1–3 файлах, типы и докблоки, unit-тесты к известному модулю, мелкий bugfix с тестом — при наличии Rules и команд lint/test. Всегда смотрите diff и прогоняйте свои тесты, не только вывод агента.
Что нельзя поручать Agent mode?
Красная зона: секреты и .env, прод-деплой, миграции БД без runbook, массовое удаление файлов, git push --force, платёжка и персональные данные. Агент может ошибиться даже с Rules; File-Deletion Protection не даёт полной гарантии.
Нужно ли проверять diff перед Apply?
Да. В Agent mode правки применяются по ходу сессии — смотрите diff в реальном времени, отклоняйте нежелательные изменения, Stop при уходе в сторону. Checkpoints откатывают сессию, но не заменяют Git. Commit только после того, как понимаете каждую строку diff.
Что такое Run Modes и чем Auto-review отличается от Run Everything?
Run Modes — отдельная настройка (Settings → Agents → Approvals & Execution) для shell, MCP и Fetch. Auto-review: allowlist → sandbox → classifier → approve; рекомендован с Cursor 3.6, но docs прямо говорят: Auto-review is not a security boundary. Run Everything выполняет всё без промптов — не для новичков.
Как Cursor Rules помогают в Agent mode?
Rules (.cursor/rules/*.mdc, AGENTS.md) подмешиваются во все режимы панели — Agent, Ask, Plan, Debug. Они фиксируют стек, команды lint/test/build и запреты. Rules вероятностические: сужают поведение, но не заменяют diff и ручной прогон тестов. Три слоя: Rules + diff + свои тесты.
Что такое Cursor Cloud Agents?
Cloud Agents работают на выделённой машине в облаке (cursor.com/agents) и не используют Run Modes IDE. Ревью через ветку и PR, не через локальный diff в реальном времени. Облако не «безопаснее» автоматически — другой контур риска и ревью.
Связаны ли MCP и Agent mode?
Да: в Agent mode агент может вызывать MCP-серверы по Run Mode (approve/sandbox/classifier). MCP расширяет действия (CMS, браузер, Telegram), но не снимает ревью содержимого и токенов. Подключение MCP — отдельная тема; прод-публикации без человека — красная зона.
Можно ли доверять агенту продакшен?
Нет как автономному исполнителю. Agent может подготовить diff в ветке; выкат, миграции, флаги и прод-деплой — только человек по runbook. То же для Cloud Agents: PR и CI, не «агент сам в прод». Rules и Run Modes не дают 100% safety boundary.
Связанные страницы

Разобрать задачу с наставником в Telegram
На разборе смотрю ваш репозиторий: формулируем одну безопасную задачу для Agent, критерии готовности и чек-лист diff до Apply — не абстрактный курс.
Отвечаю сам — без бота и «оставьте заявку».






