Cursor Debug Mode — это режим агента Cursor для сложных багов: сначала гипотезы и runtime-доказательства, потом точечный фикс. Официальные источники: docs Debug Mode и help Debug mode.
Обзор режимов — Agent Mode. Без правок — Ask Mode. Сначала план фичи — Plan Mode. Старт: Cursor AI для начинающих. Pillar: n8n для начинающих.
Для кого Debug Mode
- Баг воспроизводится, но причина из кода не видна.
- Race conditions и timing/async проблемы.
- Performance и подозрения на memory leak.
- Регрессия: «раньше работало», нужно понять что изменилось.
Когда обычный Agent упирается в догадки, Debug даёт другой цикл — через runtime evidence.
Как пользоваться: маршрут на 25 минут
- Откройте панель:
Cmd+I/Ctrl+I. - Выберите Debug (
Shift+Tab/ mode picker). - Опишите баг: ожидаемое vs фактическое, стек, шаги.
- Дождитесь гипотез и инструментирования (логи → локальный debug server расширения).
- Воспроизведите баг по шагам агента.
- Агент разберёт логи и сделает узкий фикс.
- Проверьте снова; после подтверждения агент снимет instrumentation.
| Этап Debug | Что происходит | На что смотреть |
|---|---|---|
| 1. Hypothesize | Обзор файлов + несколько гипотез | Полнота описания бага |
| 2. Instrument | Логи в код, debug server | Не правьте логи руками |
| 3. Reproduce | Вы повторяете шаги | Точно по инструкции агента |
| 4. Analyze | Разбор собранных логов | Root cause из evidence |
| 5. Fix + cleanup | Узкий патч, снятие логов | Повторный reproduce |
Этапы — по docs/agent/debug-mode (проверка 2026-09-02). Help Debug mode подчёркивает: сначала root cause, потом фикс.
Советы из доки
- Давайте контекст: ошибки, стек, точные шаги воспроизведения.
- Выполняйте шаги агента буквально — иначе логи мимо.
- Race иногда ловятся только с несколькими повторами.
- Явно пишите expected vs actual.
Сильные стороны
- Фикс опирается на runtime, а не на «кажется, тут null».
- Инструментирование временное: после verify логи убираются.
- Удобен, когда Agent Mode уже «стрелял» наугад.
- Rules действуют и в Debug.
Типичные ошибки
- Описывать баг одной фразой без шагов и стека.
- Игнорировать шаги reproduce и «просто ещё раз запустить».
- Путать Debug Mode с Debug panel VS Code или с Bugbot PR review.
- Оставлять Debug на зелёную фичу с нуля — там лучше Agent/Plan.
FAQ: Cursor Debug Mode
Что такое Cursor Debug Mode?
Debug Mode — режим агента Cursor для багов: гипотезы, инструментирование логами, runtime-доказательства, затем точечный фикс. Канон: cursor.com/docs/agent/debug-mode и help/ai-features/debug-mode.
Как включить Debug Mode?
Откройте Agent-панель Cmd+I / Ctrl+I, Shift+Tab до Debug или mode picker → Debug. Опишите баг или вставьте ошибку и нажмите Return.
Чем Debug отличается от Agent?
Agent сразу пишет код. Debug сначала строит гипотезы, добавляет логи, просит воспроизвести баг, анализирует runtime и только потом делает узкий фикс.
Какие баги лучше отдавать в Debug?
Воспроизводимые, но неочевидные причины; race/timing; perf и утечки памяти; регрессии «раньше работало». Когда обычный Agent гадает — переходите в Debug.
Нужно ли воспроизводить баг вручную?
Да. Debug Mode даёт шаги воспроизведения: выполните их, чтобы логи поймали реальное поведение. Иногда полезно повторить несколько раз (race conditions).
Вывод
Cursor Debug Mode — режим для упрямых багов: гипотезы → логи → reproduce → точечный фикс. Фичи пишите в Agent/Plan, разбор без правок — в Ask. Карта: гайд Agent Mode.
Хотите нейросети под свои задачи, а не «для всех»?
Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артёма Денисова — все форматы на странице обучения. Тех-pillar — n8n для начинающих.