Agent Mode — найпотужніший режим Cursor і водночас найнебезпечніший. У ньому ІІ не підказує по рядку, а працює як автономний розробник: сам шукає потрібні файли, пише й править код, запускає команди в терміналі, ставить залежності. На простому завданні це відчувається як магія. На реальному проєкті різниця між «магією» і «катастрофою» — у тому, чи вмієте ви цим режимом керувати.
- Чотири режими агента
- Plan Mode: думати до того, як писати
- Checkpoints: як відкотити агента (це не Ctrl+Z)
- Auto-Run: що він реально контролює (і чого — ні)
- Головний ризик Agent Mode: як агент стер робочий стіл
- TDD з агентом: тести як критерій
- Паралельні агенти й гонка моделей
- Як ревʼювити роботу агента
- Контекст: менше шуму — кращий результат
- Rules і Skills: статичне й динамічне
- Що з цього доступно на безкоштовному тарифі
- Чек-лист профі перед автономним запуском
- Коротко про головне
- Поширені запитання
Ця стаття — не про «увімкніть агента, і він усе зробить». Вона про те, як професіонали вичавлюють з Agent Mode максимум і при цьому тримають його на короткому повідку: планують до коду, відкочують помилки, розуміють, що саме автоматизують, і знають, де агент здатний реально нашкодити. Усе звірено з офіційною документацією та блогом Cursor на липень 2026 — включно зі свіжими механіками, про які мовчать старі гайди.
Чотири режими агента
Перш ніж «на максимум», розберемо, що взагалі є. У агента Cursor чотири режими, і плутати їх — перша помилка новачка.Режим Що робить Коли вмикати Agent Повний доступ: править код, ганяє термінал, ставить пакети Основна робота — фічі, рефакторинг Plan Спершу досліджує і будує план, код не пише Складні, багатофайлові, неясні завдання Debug Шукає причину бага за гіпотезами й логами Коли баг не відтворюється «на око» Ask Тільки запитання, доступні лише інструменти пошуку — код не змінює Розібратися в чужому коді, нічого не зламавши
Ask-режим спеціально урізаний: у нього немає прав на зміну коду, лише пошук. Це зручний «безпечний» спосіб вивчити незнайомий проєкт.
Plan Mode: думати до того, як писати
Головний прийом профі простий: не давайте агентові одразу писати код за складним завданням — спершу змусьте його спланувати. Cursor навіть посилається на дослідження Чиказького університету: досвідчені розробники частіше планують перед генерацією коду.
Plan Mode вмикається сполученням Shift+Tab прямо в полі вводу агента. Далі цикл такий:
- Агент досліджує кодову базу і знаходить потрібні файли.
- Ставить уточнювальні запитання за вимогами.
- Будує детальний план зі шляхами файлів і посиланнями на код.
- Чекає вашого схвалення — і лише потім пише.
Це принципово інша поведінка, ніж звичайний 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 подає цей цикл як кращу практику:
- Попросіть агента написати тести за парами вхід/вихід, явно сказавши, що це TDD.
- Нехай запустить їх і переконається, що вони падають (реалізації ще немає).
- Закомітьте тести.
- Попросіть написати код, який проходить тести, не чіпаючи самі тести.
- Ітеруйте до зелених — і закомітьте реалізацію.
Тести дають агентові перевірний критерій успіху, тому він може ітерувати майже самостійно, а ви отримуєте гарантію, що згенерований код справді працює, а не «виглядає робочим».
Паралельні агенти й гонка моделей
Прийом для складних завдань: 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 чесно називає «зручністю, а не гарантією безпеки» — класифікатор може пропустити небезпечну команду. Тримайте деструктивні команди в денай-листі й не вмикайте «виконувати все» на важливому проєкті.
Гід «Все про Cursor». Це частина великого гіда по Cursor: встановлення й перші кроки, вайб-кодинг на практиці, агенти й інтеграції, тарифи та робота в команді. повному гіді по Cursor.
