Agent Mode у Cursor на максимум: Plan Mode і прийоми професіоналів

16 хв. читання

Agent Mode — найпотужніший режим Cursor і водночас найнебезпечніший. У ньому ІІ не підказує по рядку, а працює як автономний розробник: сам шукає потрібні файли, пише й править код, запускає команди в терміналі, ставить залежності. На простому завданні це відчувається як магія. На реальному проєкті різниця між «магією» і «катастрофою» — у тому, чи вмієте ви цим режимом керувати.

Ця стаття — не про «увімкніть агента, і він усе зробить». Вона про те, як професіонали вичавлюють з Agent Mode максимум і при цьому тримають його на короткому повідку: планують до коду, відкочують помилки, розуміють, що саме автоматизують, і знають, де агент здатний реально нашкодити. Усе звірено з офіційною документацією та блогом Cursor на липень 2026 — включно зі свіжими механіками, про які мовчать старі гайди.

Чотири режими агента

Перш ніж «на максимум», розберемо, що взагалі є. У агента Cursor чотири режими, і плутати їх — перша помилка новачка.

РежимЩо робитьКоли вмикати
AgentПовний доступ: править код, ганяє термінал, ставить пакетиОсновна робота — фічі, рефакторинг
PlanСпершу досліджує і будує план, код не пишеСкладні, багатофайлові, неясні завдання
DebugШукає причину бага за гіпотезами й логамиКоли баг не відтворюється «на око»
AskТільки запитання, доступні лише інструменти пошуку — код не змінюєРозібратися в чужому коді, нічого не зламавши

Ask-режим спеціально урізаний: у нього немає прав на зміну коду, лише пошук. Це зручний «безпечний» спосіб вивчити незнайомий проєкт.

Plan Mode: думати до того, як писати

Головний прийом профі простий: не давайте агентові одразу писати код за складним завданням — спершу змусьте його спланувати. Cursor навіть посилається на дослідження Чиказького університету: досвідчені розробники частіше планують перед генерацією коду.

Plan Mode вмикається сполученням Shift+Tab прямо в полі вводу агента. Далі цикл такий:

  1. Агент досліджує кодову базу і знаходить потрібні файли.
  2. Ставить уточнювальні запитання за вимогами.
  3. Будує детальний план зі шляхами файлів і посиланнями на код.
  4. Чекає вашого схвалення — і лише потім пише.

Це принципово інша поведінка, ніж звичайний Agent: план фізично блокує правки до моменту, поки ви не натиснете Build. Ви читаєте й правите специфікацію, а не розгрібаєте вже написаний не туди код.

Корисна деталь: готовий план можна зберегти кнопкою Save to workspace — він ляже в папку .cursor/plans/ як markdown-файл. Це документація для команди й контекст для майбутніх агентів, які продовжать ту саму фічу. Важливий нюанс із документації: за замовчуванням план зберігається не в проєкт, а у вашу домашню директорію — у репозиторій він потрапить лише після явного Save to workspace.

Plan Mode варто вмикати для складних фіч із кількома варіантами рішення, завдань, що зачіпають багато файлів, неясних вимог і архітектурних рішень. Для швидкої правки, яку робили сто разів, план — зайва церемонія, ідіть одразу в Agent.

Як це виглядає на практиці. Ви тиснете Shift+Tab і пишете завдання: «Додати авторизацію через OAuth в наявний Express-бекенд». Замість коду агент спершу ставить уточнювальні запитання («Який провайдер — Google, GitHub? Де зберігати сесії?»), а після відповідей видає план на кшталт такого:

## План: OAuth-авторизація
1. Встановити passport + passport-google-oauth20
2. src/config/passport.ts — стратегія Google, callback-роут
3. src/routes/auth.ts — /auth/google і /auth/google/callback
4. src/middleware/requireAuth.ts — захист приватних роутів
5. Зберігати сесії в express-session + Redis

Ви читаєте цей план, правите пункти (наприклад, міняєте Redis на JWT), і лише потім тиснете Build. Помилка на рівні плану коштує одну правку рядка, а не переписаного «не туди» коду.

Хочете спробувати все це на живому проєкті — Cursor ставиться безкоштовно, агентний режим доступний і на free-тарифі. А якщо спершу потрібно зрозуміти, що це за редактор і на чиїх моделях він працює, — у нас є повний огляд можливостей Cursor.

Checkpoints: як відкотити агента (це не Ctrl+Z)

Агент щось зламав — як повернути? Не через Ctrl+Z. У Cursor для цього є Checkpoints — автознімки кодової бази, які агент робить перед значущими змінами. Відкат — із таймлайну чату: обираєте чекпоінт і повертаєте робочий простір до нього.

Ключове: чекпоінти зберігаються локально й окремо від Git. Офіційна рекомендація — використовувати їх лише для скасування дій агента, а для справжнього контролю версій тримати Git. Тобто чекпоінти — швидке «назад» усередині сесії, а не заміна комітам.

Auto-Run: що він реально контролює (і чого — ні)

Ось головна хибна думка, через яку летять десятки багрепортів на форумі Cursor. Налаштування Auto-Run (Run Mode) не стосується правок файлів. Воно керує лише термінальними командами й викликами MCP-інструментів. Редагування файлів агент застосовує напряму — і ваш контроль над ними — це перегляд дифу (прийняти/відхилити) і чекпоінти, а не Auto-Run.

Простіше кажучи: навіть із вимкненим авто-запуском команд агент усе одно сам править файли. Чекали, що Auto-Run їх захистить, — він не захищає.

У травні 2026 (Cursor 3.6) з’явився розумніший Run Mode — Auto-review. Він працює так: дозволені команди виконуються одразу, частина йде в пісочницю, решта — на класифікатор, який вирішує: дозволити, змінити підхід чи запитати вас.

Run ModeЩо робитьРизик
Ask Every Time (застарів)Запитує підтвердження на кожну командуМінімальний, але повільно
AllowlistАвтоматом лише команди з білого спискуНизький
Auto-reviewКласифікатор вирішує за кожною командоюСередній
Run EverythingВиконує все без запитуВисокий

І одразу важлива засторога від самої Cursor: allowlist і класифікатор — це «зручність за принципом best-effort, а не гарантія безпеки». Класифікатор може помилитися: пропустити небезпечне або заблокувати безневинне. Не покладайтеся на нього як на захист.

Головний ризик Agent Mode: як агент стер робочий стіл

Це не страшилка, а задокументований кейс із форуму Cursor (липень 2026) — і найслабше місце автономного режиму. Через зламане екранування лапок між оболонками агент виконав rmdir /s /q не по тій папці — і стер більшу частину робочого столу користувача разом із проєктом, попутно пошкодивши локальний git-репозиторій. Прапорець /q обійшов кошик: файли видалилися назавжди. Того ж тижня спливло ще одне схоже — «агент стер увесь диск C:».

Команда Cursor визнала це «відомим класом проблем на Windows» і порекомендувала захист, який і варто взяти на озброєння:

  • Auto-Run — на підтвердження, не «виконувати все».
  • Деструктивні команди в денай-лист (rmdir /s /q, rm -rf).
  • Часті коміти в git — точки повернення.
  • Окремі диски або віртуалки для ризикових операцій.

Є й вбудоване налаштування File-Deletion Protection — воно блокує пряме видалення файлів агентом, включно з rm. Але security-дослідники попереджають: його можна обійти непрямими термінальними командами, тож це захист не абсолютний, а ще один шар.

Мораль проста: ставтеся до агента як до дуже швидкого джуна з правами root. Потужно — але межі ставите ви.

TDD з агентом: тести як критерій

Один із найсильніших прийомів — зв’язка Plan Mode і розробки через тести. Cursor подає цей цикл як кращу практику:

  1. Попросіть агента написати тести за парами вхід/вихід, явно сказавши, що це TDD.
  2. Нехай запустить їх і переконається, що вони падають (реалізації ще немає).
  3. Закомітьте тести.
  4. Попросіть написати код, який проходить тести, не чіпаючи самі тести.
  5. Ітеруйте до зелених — і закомітьте реалізацію.

Тести дають агентові перевірний критерій успіху, тому він може ітерувати майже самостійно, а ви отримуєте гарантію, що згенерований код справді працює, а не «виглядає робочим».

Паралельні агенти й гонка моделей

Прийом для складних завдань: Cursor автоматично створює й керує git worktree для паралельних агентів. Кожен агент працює в ізольованій копії файлів, а результат вливається в робочу гілку кнопкою Apply. Гілки не заважають одна одній — можна вести кілька завдань одразу.

Окрема офіційно рекомендована техніка — гонка моделей: запустити один і той самий промпт на кількох моделях одразу й обрати кращий результат. Дорожче за витратами, але на важкому завданні окуповується якістю: там, де одна модель буксує, інша нерідко знаходить рішення з першого заходу, а ви просто лишаєте ту гілку, що сподобалася більше. Це особливо виручає на архітектурних завданнях, де «правильних» підходів кілька і заздалегідь не ясно, який ляже на ваш код чистіше.

Яку модель ставити під конкретне завдання — власний Composer, фронтир-модель чи режим Auto — розібрано окремо: яку модель вмикати в Cursor під задачу.

Для по-справжньому довгих автономних прогонів є патерн зі stop-хуком у .cursor/hooks.json: хук при завершенні діалогу перевіряє умову (наприклад, прапорець «готово» у службовому файлі) і повертає команду продовжити — агент «гризе» завдання, поки не виконає мету. Це просунутий сценарій, але він показує стелю автономності.

Як ревʼювити роботу агента

Автономність не скасовує ревʼю — вона його зміщує. Після роботи агента запустіть Review → Find Issues: окремий прохід по рядку аналізує зміни й підсвічує проблеми. Для пул-реквестів на GitHub є окремий продукт Bugbot — він автоматично коментує PR, ловить регресії та ризикові правки до того, як їх відкриє живий ревʼюер.

Для складних багів вмикайте Debug Mode: замість вгадування фіксів він генерує кілька гіпотез, додає логування, просить вас відтворити баг, аналізує зібрані дані й робить точкову правку за доказами, а не навмання.

Контекст: менше шуму — кращий результат

Профі керують не лише завданням, а й контекстом.

  • Не тегайте вручну десятки файлів через @. У агента потужний пошук — він сам знайде потрібне. Зайві файли лише збивають модель; тегайте @файл, лише коли точно знаєте, який потрібен.
  • Починайте новий чат під нове завдання. Довгі діалоги накопичують шум: після багатьох ходів і сумаризацій агент втрачає фокус. Cursor прямо визнає, що дотримання правил помітно деградує в сесіях за 100 тисяч токенів.
  • Переносьте контекст через @Past Chats, а не копіюванням усього діалогу — агент вибірково підтягне лише потрібне з історії.

Rules і Skills: статичне й динамічне

Два механізми налаштування поведінки агента, які часто плутають:

  • Rules — статичний контекст, завжди підвантажується на початку кожного діалогу (файли в .cursor/rules/). Ваші постійні правила проєкту.
  • Skills — динамічні можливості (файли SKILL.md), які агент підключає сам, лише коли вони доречні: свої команди на /, хуки до і після дій, доменні знання.

Важлива тонкість від саппорту Cursor: вбудовані жорсткі інструкції агента (рівня «MUST») можуть перебивати ваші Rules, особливо в довгих сесіях. Тому критичні обмеження формулюйте так само імперативно («MUST NOT видаляй…») і дублюйте і в правилах проєкту, і в користувацьких налаштуваннях.

Що з цього доступно на безкоштовному тарифі

Agent Mode і його ключові можливості доступні й без підписки, але із застереженнями щодо лімітів.

МожливістьFree (Hobby)Pro
Agent Mode, Plan Mode, Debug ModeТак, із лімітом агентних запитівТак, широкий ліміт
Checkpoints і відкатТакТак
Вибір моделі, гонка кількох моделейОбмеженоТак
Bugbot (авто-ревʼю PR)Ні (окремий платний аддон)Окремий аддон

Для знайомства з режимом free-тарифу вистачає: спробувати Plan Mode, чекпоінти й базовий агент можна без оплати. Упретеся в ліміт запитів — тоді є сенс дивитися на Pro.

Чек-лист профі перед автономним запуском

Перш ніж відпустити агента в «політ» на реальному репозиторії:

  • [ ] Працюєте в окремій гілці, не в main.
  • [ ] Є свіжий коміт — точка повернення.
  • [ ] Деструктивні команди в денай-листі, Auto-Run не в режимі «виконувати все».
  • [ ] Увімкнено File-Deletion Protection.
  • [ ] За складним завданням спершу пройшли Plan Mode, а не одразу код.
  • [ ] Готові читати дифи й тиснути «прийняти/відхилити», а не апрувити наосліп.

Коротко про головне

Agent Mode на максимум — це не «довірити агентові все», а грамотно розподілити контроль: план до коду через Plan Mode, тести як критерій, чекпоінти й git для відкату, розуміння, що Auto-Run про термінал, а не про файли, і здорова параноя щодо деструктивних команд. Тоді агент із непередбачуваної сили перетворюється на дуже швидкого й корисного помічника.

Якщо ви лише починаєте працювати через ІІ-агента й хочете зрозуміти сам підхід, почніть із розбору, що таке вайб-кодинг і де в нього межі, — а вже потім закручуйте гайки в Agent Mode.

Поширені запитання

Auto-Run захищає мої файли від правок агента? Ні. Auto-Run керує лише термінальними командами й MCP-викликами. Правки файлів агент застосовує напряму; контроль над ними — перегляд дифу й чекпоінти.

Як відкотити зміни агента? Через Checkpoints — автознімки перед правками, відкат із таймлайну чату. Це не Ctrl+Z і не заміна Git: для постійного контролю версій тримайте коміти.

Коли вмикати Plan Mode? На складних, багатофайлових чи неясних завданнях і архітектурних рішеннях. Хоткей — Shift+Tab. Для дрібних звичних правок можна одразу в Agent.

Чи може агент реально видалити мої файли? Так — є задокументований кейс, де агент через помилку в команді стер робочий стіл користувача. Захист: денай-лист деструктивних команд, File-Deletion Protection, часті коміти й робота в окремій гілці або віртуалці.

Чим Rules відрізняються від Skills? Rules — статичний контекст, завжди на початку діалогу. Skills — динамічні можливості (команди, хуки, знання), які агент підключає сам, лише коли вони доречні.

Чи варто довіряти агентові авто-запуск команд? З обережністю. Навіть режим Auto-review Cursor чесно називає «зручністю, а не гарантією безпеки» — класифікатор може пропустити небезпечну команду. Тримайте деструктивні команди в денай-листі й не вмикайте «виконувати все» на важливому проєкті.

Поділитися
Зв'язатися:
Крипто- та data-аналітик, інженер-програміст (факультет комп'ютерних наук ХНУРЕ). В IT з 2008 року: адміністрував корпоративний моніторинг у «Vodafone Україна», сім років розробляв і просував веб-проєкти, п'ять років керував маркетингом на метриках — конверсія, CTR, ROI, LTV.Криптовалютними ринками займаюся з 2021 року: ончейн-метрики, токеноміка, макроекономічні індикатори. Розробив власну data-driven модель аналізу ринку на 30+ метрик. Стек — Python (pandas, NumPy, SciPy, matplotlib), математична статистика та EDA; збір і звірку даних автоматизую AI-агентами.Принцип — «Don't trust, verify»: кожна цифра перевірена за першоджерелом, ключові — щонайменше за двома незалежними; прогнози — лише сценарії з умовами. Теза без даних не публікується.