Cursor Agent Mode: как работает, чем отличается от чата и как использовать правильно

Горячая клавиша для открытия агента: Cmd/Ctrl + I.

Что агент умеет делать

Агент работает с инструментами, которые недоступны в обычном чате:

Работа с файлами — читает файлы через @-упоминания и контекст всего проекта, создаёт новые файлы, редактирует существующие, переименовывает и перемещает.

Терминал — запускает команды: тесты, сборку, линтер, git-операции. Видит вывод и реагирует на ошибки без твоего участия.

Поиск по кодовой базе — находит нужные места через встроенный индекс с кастомной моделью эмбеддингов. Агент не угадывает где что лежит — он ищет.

Браузер — встроенный браузер для просмотра документации и отладки UI прямо в IDE. В актуальных версиях работает в 10 раз быстрее, поддерживает drag-and-drop.

MCP-серверы — если настроены, агент использует их инструменты. Figma, Linear, GitHub, твоя база данных — всё что подключено через MCP.

Plan Mode: сначала план, потом код

Plan Mode — двухшаговый режим. Cursor строит детальный план что собирается делать, ты просматриваешь и корректируешь, потом агент выполняет.

Как включить: кнопка + → Plan, или напечатай /plan в поле ввода.

Когда нужен: для сложных задач с большим количеством файлов, где важно проверить направление до начала работы. Помогает не тратить токены на неправильный путь.

Плюс Plan Mode — кнопка Build in Parallel: Cursor определяет независимые части плана и запускает их одновременно через асинхронные субагенты. Большая задача выполняется быстрее.

Субагенты: параллельная работа

Субагенты — это независимые агенты, которые главный агент запускает для выполнения отдельных частей задачи. Каждый работает в своём контексте с собственным набором инструментов.

Как это работает на практике. Ты просишь агента: «Добавь аутентификацию с JWT». Главный агент разбивает задачу:

• Субагент 1 — читает всю кодовую базу и составляет карту зависимостей
• Субагент 2 — пишет middleware для JWT
• Субагент 3 — обновляет роуты и тесты

Все трое работают параллельно, результаты собираются обратно в главный агент.

Асинхронные субагенты — важное обновление 2026 года. Раньше субагенты блокировали родителя до завершения. Теперь субагент может работать в фоне (is_background: true) пока главный агент занимается другим.

Дерево субагентов — субагенты могут порождать собственных субагентов. Для больших многофайловых задач это позволяет строить иерархическую структуру работы.

/multitask — режим через кнопку + → Multitask или команду /multitask. Cursor сам определяет какие задачи из очереди независимы друг от друга и запускает их параллельно. Вместо последовательного выполнения получаешь одновременную работу нескольких субагентов.

Настроить субагентов можно через .cursor/subagents.json — задать конкретную модель, дать кастомный промпт, ограничить права на запись.

Cloud Agents: работает без тебя

Cloud Agents — это агентные запуски в облачной инфраструктуре Cursor. Ты ставишь задачу и можешь закрыть ноутбук — агент продолжает работу в облаке.

Как использовать:

1. Построй план через Plan Mode
2. Нажми Build in Cloud вместо обычного запуска
3. Задача уходит в облачный агент
4. Возвращаешься когда готово, проверяешь результат

Cloud Agents поддерживают multi-repo окружения — агент может работать сразу с несколькими репозиториями в одной сессии.

Для Enterprise доступны self-hosted cloud agents — запускаешь агента в собственной инфраструктуре через Dockerfile. Рабочий процесс подключается к Cursor через HTTPS без инбаунд-портов и VPN.

Доступность: Cloud Agents включены на Pro и выше. Self-hosted — Enterprise план.

Worktrees: разные задачи на разных ветках

Worktrees позволяют запускать агентские задачи в изолированных git-ветках одновременно. Каждая задача работает в своём worktree, не мешая основной ветке.

В Agents Window видны все активные worktrees. Когда агент закончил — переносишь ветку в локальный foreground одним кликом, проверяешь и мержишь.

Полезно для параллельной разработки фич: одна задача в фоне, другая в фокусе.

Bugbot: автономный поиск и исправление багов

Bugbot — встроенный агент Cursor 3.1 (апрель 2026), который работает на уровне pull request. Анализирует PR, находит баги, предлагает исправления, по данным Cursor улучшает 78% своих собственных фиксов.

Запуск: в PR-интерфейсе Cursor нажми Run Bugbot. Работает отдельно от основного чата, не расходует запросы Agent mode.

Права доступа и безопасность

По умолчанию Agent mode спрашивает разрешение перед выполнением потенциально опасных команд — удаление файлов, изменение конфигурации, запись в системные директории.

Режим «Run Everything» — агент никогда не блокируется на запросах разрешений. Включается в настройках сессии. Полезно для опытных пользователей, которые доверяют агенту и хотят максимальную автономность.

Sandbox с сетевым контролем — можно определить конкретные домены, к которым агент имеет доступ при выполнении команд. Настраивается в sandbox.json. На Enterprise — администраторы управляют политиками на уровне организации.

Readonly субагенты — если нужно дать агенту читать код без права на изменения, используй readonly: true в конфиге субагента.

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

Официальный гайд Cursor по лучшим практикам работы с агентами опубликован в их блоге. Ключевые принципы:

Пиши конкретно. «Добавь аутентификацию» — слишком широко. «Добавь JWT middleware в /api/auth, обнови роуты в routes/user.ts, добавь тест в __tests__/auth.test.ts» — агент понимает объём работы.

Используй Plan Mode для больших задач. Прежде чем агент начнёт менять десятки файлов, пусть сначала покажет план. Дешевле поправить направление на этапе планирования.

@-упоминания для контекста. Если агенту нужен конкретный файл или раздел — упомяни через @. Это быстрее и дешевле по токенам, чем ждать пока он сам найдёт через поиск.

Проверяй контекст. В актуальных версиях Cursor видно разбивку использованного контекста: сколько заняли rules, skills, MCPs, субагенты. Если контекст перегружен — чисти ненужные источники.

Не прерывай без необходимости. Остановка главного агента останавливает все дочерние субагенты. Если нужно добавить уточнение — лучше дождись паузы когда агент сам спрашивает.

Про модели которые работают в Agent mode и их расход токенов — в нашей статье какие модели доступны в Cursor.

Про лимиты запросов и что делать когда Agent mode съел весь план — в материале лимиты Cursor: сколько бесплатных запросов.

Если сравниваешь Cursor с Claude Code по автономности агентов — смотри наш разбор Cursor vs Claude Code vs Codex.

Источники:

• Cursor Docs — Subagents
• Cursor Blog — Best practices for coding with agents
• Cursor Blog — Self-hosted cloud agents
• Cursor Changelog 2.4 — Subagents release
• Cursor Changelog 2.5 — Async subagents
• Cursor Changelog — /multitask и Build in Parallel