Cursor Agent Mode — это режим AI-ассистента в Cursor, который сам ищет по репозиторию, правит несколько файлов, запускает команды в терминале и закрывает ошибки по ходу задачи. Официальные источники: help Agent mode и docs Agent overview. Открывается в sidepane по Cmd+I / Ctrl+I.

Карта продукта для новичков — Cursor AI для начинающих. Модель Composer — отдельный гайд; autocomplete — Cursor Tab. Cloud/фоновые агенты — Background / Cloud Agents. Pillar: n8n для начинающих.

Для кого Agent Mode

  • Когда фича или баг затрагивает несколько файлов и нужен цикл «найти → править → проверить».
  • Когда Ask уже объяснил архитектуру, и пора писать код.
  • Когда нужен Plan перед большой перестройкой — сначала план, потом Agent.
  • Когда Debug должен опираться на логи/рантайм, а не на догадки.

Как пользоваться: маршрут на 25 минут

  1. Откройте панель: Cmd+I / Ctrl+I.
  2. Выберите режим Agent (или крутите Shift+Tab).
  3. Выберите модель (например Composer 2.5 или frontier из Other Models).
  4. Опишите задачу конкретно: что сделать, что не трогать, как проверить.
  5. Смотрите diff; при сбое — Stop, Restore Checkpoint, уточните ТЗ.
  6. Для облачного запуска без локальной IDE — cursor.com/agents.
Режим Лучше для Правит файлы?
Agent фичи, рефакторинг, фикс багов Да
Ask разобраться в коде, архитектура Нет (read-only)
Plan сложные фичи, сначала ревью плана Да (после approve плана)
Debug баги с runtime-доказательствами Да

Таблица режимов — с официального help Agent mode (проверка 2026-09-01). Смена режима стартует новый context window.

Что умеет Agent внутри

По overview агент собирается из инструкций (rules), tools и выбранной модели. Tools включают поиск по файлам, web, чтение (включая изображения), правки, shell, browser, генерацию изображений, уточняющие вопросы. Лимита на число tool calls в задаче в доке нет.

Полезные механики сессии:

  • Checkpoints — автоснимки до крупных правок; Restore откатывает файлы.
  • Очередь сообщений — следующий промпт ждёт конца текущего хода (Enter); срочный follow-up — по доке Cmd+Enter / Send now.
  • Subagents — параллельное делегирование; см. гайд Subagents.
  • Rules действуют во всех режимах — гайд Rules.

Сильные стороны

  • Автономный цикл по репозиторию, не только «дописать строку».
  • Четыре режима под разные риски правок.
  • Checkpoints снижают страх «агент всё сломал».
  • Связка с Cloud Agents, MCP, Skills, Hooks в одной экосистеме Cursor.

Типичные ошибки

  • Давать расплывчатое ТЗ без критерия «готово».
  • Держать Auto-run на опасных командах в незнакомом репо.
  • Чинить плохой результат десятью follow-up вместо Restore + уточнённый Plan.
  • Путать Agent Mode с моделью Composer или с Tab autocomplete.

FAQ: Cursor Agent Mode

Что такое Cursor Agent Mode?

Agent Mode — режим AI-ассистента Cursor, который ищет по кодовой базе, правит несколько файлов, запускает терминал и сам чинит ошибки. Канон: cursor.com/help/ai-features/agent и docs/agent/overview.

Как открыть Agent Mode?

Откройте Agent-панель: Cmd+I (Mac) или Ctrl+I (Windows/Linux), в mode picker выберите Agent. Цикл режимов — Shift+Tab (Agent / Ask / Plan / Debug).

Чем Agent отличается от Ask, Plan и Debug?

Agent пишет код и правит файлы. Ask — только чтение и ответы. Plan — сначала план на ревью, потом сборка. Debug — баги с опорой на runtime-доказательства.

Как откатить изменения Agent?

Restore Checkpoint у предыдущего сообщения: откатываются файлы к снимку, сообщения в чате остаются. Для постоянного контроля используйте Git.

Можно ли делегировать работу субагентам?

Да. Agent может запускать specialized subagents (research, shell, browser) в отдельных контекстах. Кастомные — markdown в .cursor/agents/. Подробнее: гайд Subagents на сайте.

Вывод

Cursor Agent Mode — рабочий режим для фич и фиксов: Cmd/Ctrl+I → Agent → чёткий промпт → diff и checkpoint. Ask/Plan/Debug переключайте по риску. Модель — Composer; набор кода — Tab; делегирование — Subagents.

Артём Денисов эксперт Нетологии и автор курса Яндекс Практикума по промпт-инжинирингу. Настраивает Agent Mode под контентные и автоматизационные репозитории с безопасным rollback.

Хотите нейросети под свои задачи, а не «для всех»?

Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артём Денисов — все форматы на странице обучения. Тех-pillar — n8n для начинающих.