PPПётр ПашкуровCursor · наставничество · заказы

Руководство · Cursor

Execution and approvals в Cursor: как настроить

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

Cursor Agent mode: безопасный рабочий процесс

Что такое 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 советует быть конкретным в промпте; на практике я добавляю критерии готовности и явный список файлов, которые можно трогать.

Схема безопасного workflow: задача → diff → тесты → Apply

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

Формула, которую я даю на наставничестве — четыре блока в одном сообщении:

  1. 01

    Что — одна цель («добавить типы в formatDate», не «улучши проект»).

  2. 02

    Где — путь или glob (src/utils/date.ts, только этот файл).

  3. 03

    Как проверить — команда из Rules (npm test -- formatDate, npm run lint).

  4. 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 (и после правок)

Чек-лист UI diff и семь пунктов до, во время и после Agent сессии

Ниже — мой чек-лист из 12 пунктов (не официальная политика Cursor). Он совпадает с документацией и с тем, что я прошу на разборе.

До задачи

  1. 01

    В проекте есть Cursor Rules с командами проверки и запретами.

  2. 02

    Run Mode = Auto-review (не Run Everything).

  3. 03

    Секреты не в чате; чувствительные пути в ignore.

  4. 04

    Задача узкая: что / где / как проверить / что не трогать.

  5. 05

    Для незнакомой области — Ask или Plan, потом Agent.

Во время

  1. 01

    Следить за diff; Stop при уходе в сторону.

  2. 02

    Одобрять shell/MCP осознанно; не игнорировать prompt classifier block.

  3. 03

    Checkpoints перед крупным рефакторингом.

После

  1. 01

    Прогнать свои тесты/линтер (команда из Rules).

  2. 02

    Прочитать diff целиком; не merge «потому что зелёный один тест».

  3. 03

    Git commit только когда понимаю каждое изменение.

  4. 04

    Для облака/PR — отдельное ревью (Bugbot опционально).

Что можно поручить Agent mode без лишнего риска

В «зелёную зону» я отношу задачи, где область маленькая, есть тесты и Rules, а откат — дешёвый. По документации Cursor Agent как раз для feature work, refactor, bugfix и tests; матрица ниже — как я сам делю задачи после базовой настройки и Rules.

Матрица зелёная, жёлтая и красная зона делегирования Agent mode
Тип задачиПочему зелёная зонаКак проверяю
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 vulnschangelog, npm audit, полный CI
Правки CI/CD, Dockerfile, deploy-скриптовСлом пайплайна / продdiff построчно, dry-run
Кросс-модульный рефакторингСкрытые связиинтеграционные тесты, smoke
Изменение API-контрактовПолом клиентовконтрактные тесты, consumers
MCP: черновик в staging WP/TGPII, токены в телесодержимое, не прод

Обновление зависимостей — классический кейс на разборе: агент обновил 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-reviewallowlist → sandbox (если можно) → classifier → approval promptDefault с 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 и тесты человеком.

Три слоя, которые я проговариваю на разборе:

  1. 01

    Rules — что агент должен помнить (стек, команды, запреты).

  2. 02

    Diff — что агент реально изменил в файлах.

  3. 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 есть — они изолируют контекст, не снимают ответственность. Прототип автоматизации в отдельной папке репозитория — только с проверкой каждого артефакта; прод без ревью остаётся красной зоной.

Что читать дальше

Если после Rules и этого чек-листа всё ещё неясно, что поручить Agent на вашем репозитории — на наставничестве разбираем конкретную задачу: формулируем промпт, смотрим diff вместе, фиксируем критерии готовности.

Что прислать в Telegram:

  • ссылку на репо или описание стека;
  • одну задачу, которую боитесь дать агенту;
  • есть ли .cursor/rules и какие команды тестов реально работают.

По теме в блоге

Как пользоваться Cursor AI и Cursor Rules. Если Agent mode уже в работе — следующий шаг: промпты для Cursor. Про подход к разработке с ИИ — вайбкодинг.

Автор: Пашкуров Пётр Сергеевич. Источники: документация Agent, Rules, модели и pricing.

FAQ

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

Что такое 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

Разобрать задачу с наставником в Telegram

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

Отвечаю сам — без бота и «оставьте заявку».