Cursor Background Agents: как пользоваться

Cursor Background Agents — это прежнее имя Cloud Agents: coding agent, который работает не на вашем ноутбуке, а в изолированной Ubuntu VM в облаке Cursor. Агент клонирует репозиторий, ставит зависимости, правит код, гоняет тесты и обычно отдаёт ветку с pull request плюс артефакты проверки. Канон: cursor.com/docs/cloud-agent; help: What are background agents?. Не путать с локальным Agent mode и с Bugbot (ревью чужого PR).

Соседи: Cursor для начинающих, Cursor CLI, Copilot agent, Jules, Codex Web. Pillar — n8n / автоматизация.

Для кого Background / Cloud Agents

Берите Cloud Agent, если задача оформлена (баг, фича, тесты, дока) и вы хотите закрыть цикл без локальной сессии: параллельно несколько агентов, закрытый ноутбук, demo через скрин/видео. Если нужен быстрый интерактив у себя на диске — локальный Agent. Если цель только поймать баги в уже открытом PR — Bugbot.

*По cursor.com/docs/cloud-agent и cloud-agent/setup (август 2026). Naming History: Cloud Agents were formerly called Background Agents. Spend limit и API pricing модели — в кабинете.

Как пользоваться: маршрут на 1 вечер

1. Админ аккаунта подключает source control (GitHub/GitLab/Bitbucket/Azure DevOps) с read-write к репо.
2. Paid plan Cursor и spend limit для Cloud Agents.
3. Соберите environment в dashboard (agent-led setup) или через .cursor/environment.json + Dockerfile.
4. Задайте секреты в Cloud Agents dashboard — не ждите магии от локального .env.
5. Стартуйте узкую задачу с критерием «готово» и путями файлов.
6. Смотрите PR + artifacts; при необходимости remote desktop; review человеком до merge.

# Пример .cursor/environment.json (из доки Cursor setup)
{
  "build": {
    "dockerfile": "Dockerfile",
    "context": ".."
  },
  "install": "pnpm install && ./custom_script.sh"
}

# Старт с GitHub issue/PR
@cursor Добавь валидацию пустого email в signup,
обнови тесты и открой draft PR. Не трогай CI YAML.

Окружение, MCP и hooks

Резолв окружения: .cursor/environment.json в репо → personal saved → team saved. Multi-repo среды клонируют несколько репозиториев; long-running для multi-repo в доке пока отмечен как недоступный. MCP настраивается на cursor.com/agents; hooks берутся из .cursor/hooks.json репозитория (не из домашнего каталога пользователя).

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

• Параллельные агенты без локального железа онлайн.
• Полный цикл: build, test, computer use, artifacts, remote desktop.
• Много точек входа: Desktop, Web, iOS, Slack, GitHub, Linear, API.
• Явная история имени: Background Agents → Cloud Agents.

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

• Запускать без environment — агент пишет код, но не может проверить.
• Путать с Bugbot (ревью) или с локальным Agent mode.
• Ждать user-level hooks из ~/.cursor на облачной VM.
• Давать расплывчатую задачу без критерия «готово».
• Фиксировать цены из блогов вместо spend limit в кабинете.

FAQ: Cursor Background Agents

Вывод

Background Agents сегодня официально Cloud Agents: async работа в VM Cursor с PR и артефактами. Старт: SCM + paid plan + environment → узкая задача → review PR. Для ревью чужих диффов — Bugbot; для терминала — Cursor CLI.