Background Agents do Cursor: quais planos liberam e o que o repositório exige

Ilustração de um fluxo de tarefas automatizadas representando os background agents do Cursor conectados a um repositório de código
Resposta rápida

Os Background Agents do Cursor hoje se chamam Cloud Agents e estão liberados nos planos Premium (US$ 30/mês), Super, Ultra, Teams e Enterprise. Free e Plus ficam de fora. Os planos legados Pro, Pro+, Ultra e Start continuam com acesso, e o Hobby não. Para rodar, você precisa de repositório em GitHub, GitLab, Azure DevOps Services ou Bitbucket Cloud com permissão de escrita, uso on-demand ligado com limite de gastos e uma conta fora do Legacy Privacy Mode.

Se você procurou pelos agentes em segundo plano do Cursor, vai encontrar o recurso com outro nome: Cloud Agents. A ideia é a mesma. Cada agente roda numa máquina virtual dedicada, com o repositório, as dependências, os secrets e o acesso à rede, e trabalha por minutos ou horas planejando a tarefa, editando código, rodando comandos e testando o resultado (documentação dos Cloud Agents).

Este post segue uma ordem prática. Primeiro, quais planos liberam o recurso e como ele é cobrado. Depois, o que o repositório e a conta precisam ter. Por fim, para qual perfil o agente na nuvem compensa e quando o Agent no editor já resolve.

Background Agents virou Cloud Agents: o que mudou no nome e na forma de assinar

O nome Background Agents foi aposentado. A central de ajuda do Cursor confirma que o recurso agora se chama Cloud Agents.

A forma de assinar também mudou. Desde 12 de outubro de 2026, os planos do Cursor são vendidos dentro da The X Subscription, uma assinatura única que cobre Grok, Cursor e X, segundo o anúncio oficial no fórum.

Com isso, os planos antigos Pro, Pro+ e Ultra viraram legados. Quem já assinava pode manter, mas novos clientes não conseguem mais comprar (planos legados).

É por isso que muito tutorial antigo fala de um "Pro de US$ 20" como porta de entrada. Esse plano existe só para quem já estava nele.

Quais planos do Cursor liberam os Cloud Agents

Pela central de ajuda, os Cloud Agents estão disponíveis do Premium para cima, no Teams e no Enterprise. Free e Plus não incluem o recurso.

PlanoPreço mensalPreço anualUso relativo ao PlusInclui Cloud Agents
FreeUS$ 0não se aplicanão informadoNão
PlusUS$ 8US$ 80referênciaNão
PremiumUS$ 30US$ 3004xSim
SuperUS$ 100US$ 1.00015xSim
UltraUS$ 200US$ 2.00050xSim

Preços mensais e uso relativo vêm da página de preços. Os valores anuais estão em Models & Pricing.

No Teams, cada assento é Premium, Super ou Ultra, a US$ 30, US$ 100 ou US$ 200 por usuário/mês, com o mesmo uso semanal do plano individual equivalente (preços do Teams). O Enterprise também libera o recurso.

Nos legados, o Pro (US$ 20/mês), o Pro+ (US$ 60/mês), o Ultra (US$ 200/mês) e o Start (₹649/mês, só na Índia) incluem Cloud Agents. O Hobby, que era o gratuito, não inclui (planos legados).

Plus ou Premium: onde está a diferença

O ponto que pega muita gente é o Plus. Ele fica restrito a modelos Grok e da própria casa, sem Cloud Agents, Automations, Bugbot, modelos de terceiros nem chaves de API próprias (preços).

O Premium é o degrau de entrada real. Ele traz Cloud Agents e Automations, hospedagem de código no Origin, revisão com Bugbot, Grok Bot e modelos de terceiros a preço de lista da API (Models & Pricing).

Então, se você está pensando em baixar o plano do Cursor para o Plus, saiba que os agentes na nuvem vão junto.

Como os Cloud Agents são cobrados no Cursor

Não existe franquia própria nem taxa de VM, computação ou memória. O Cloud Agent consome o mesmo uso do plano que o Agent no editor e na CLI, ao preço de API do modelo escolhido (central de ajuda).

A ordem é simples: primeiro sai do uso incluído no plano e, quando ele acaba, passa para o uso on-demand às mesmas taxas.

Na prática, o agente come do mesmo pool semanal que você usa no dia a dia (Models & Pricing). Quanto ele rende depende do modelo escolhido e de quanto tempo a tarefa roda.

Tem um detalhe que trava o primeiro uso. Antes de iniciar o primeiro Cloud Agent, você precisa habilitar o uso on-demand e definir um limite de gastos (documentação).

Tome cuidado aqui: uma tarefa de horas num modelo caro pode consumir boa parte do pool da semana. O limite de gastos é o que segura a conta.

O que o repositório precisa ter para rodar um Cloud Agent

São quatro exigências, todas verificáveis antes de disparar o agente.

  1. Repositório num provedor suportado. O agente clona o código a partir de GitHub, GitLab, Azure DevOps Services ou Bitbucket Cloud, trabalha numa branch separada e faz push das mudanças no final (documentação).
  2. Permissão de leitura e escrita. Vale para o repositório principal e também para qualquer repositório dependente ou submódulo.
  3. Acesso pelo app do Cursor. Os Cloud Agents acessam o código pelo app do Cursor no GitHub ou no GitLab, e não pelas suas credenciais pessoais. No GitHub, o app pede permissões de repositório (clonar e criar branches), pull requests, issues, checks/status e actions/workflows (integração com GitHub).
  4. Ambiente de execução configurado. Você escolhe entre setup guiado pelo próprio agente, snapshot salvo ou Dockerfile, configurado no arquivo .cursor/environment.json, que fica versionado no repositório (setup do ambiente).

Os campos do .cursor/environment.json

Dois campos do arquivo aparecem na documentação. O install define o script de instalação rodado no build do ambiente.

O repositoryDependencies lista repositórios extras, no formato github.com/org/repo, que entram no token do GitHub gerado para aquele ambiente.

Pensa nisso como o package.json da VM: em vez de dizer quais pacotes o projeto usa, ele diz como a máquina do agente precisa ser montada.

Qual ambiente o agente usa primeiro

Se existir mais de uma configuração, o Cursor resolve nesta ordem: ambiente salvo pessoal, depois ambiente salvo do time, depois o .cursor/environment.json do repositório (setup do ambiente).

Esse último só entra em execuções com um único repositório. Se você editou o arquivo e nada mudou, vale conferir se não tem um ambiente pessoal ou do time passando na frente.

Para empresas que não querem o código rodando na infraestrutura do Cursor, existe a opção de máquinas self-hosted.

Cloud Agents funcionam com o modo de privacidade do Cursor?

Funcionam com o Privacy Mode, mas não com o Legacy Privacy Mode (documentação). Muito site por aí ainda diz que é preciso desligar a privacidade, e isso está desatualizado.

Sintoma: a conta ou o time está no Legacy Privacy Mode e o recurso não é suportado.

Causa: o modo legado bloqueia o armazenamento de dados na nuvem. Só que o agente precisa guardar o código e os dados do ambiente na nuvem enquanto executa.

Solução: usar o Privacy Mode atual. Com ele, o código não é usado para treino e só fica guardado enquanto o agente roda.

A visão de segurança dos Cloud Agents acrescenta que o Cursor não treina com o código acessado nem com os prompts e respostas das execuções, e que a maioria dos modelos roda sob acordos de retenção zero com os provedores.

Como prevenir: antes de liberar o recurso para o time, confira em qual modo de privacidade a conta está. Descobrir isso com o agente já configurado é retrabalho.

Como acompanhar e assumir a tarefa de um Cloud Agent

O agente roda sozinho, mas você não perde o controle. Dá para acompanhar de vários lugares, mandar instruções novas e puxar o trabalho para a sua máquina.

  1. Inicie e acompanhe de onde estiver. No Cursor Desktop, escolha Cloud no dropdown abaixo do campo do agente. No navegador, acesse cursor.com/agents de qualquer dispositivo. Também dá pelo app do Cursor para iOS ou no Slack e no Microsoft Teams com @Cursor (documentação).
  2. Mande instruções de follow-up. Na thread do Slack ou do Teams, @Cursor adiciona instruções a um agente que já existe ali. Se você automatiza o fluxo, a API de Cloud Agents permite enviar um prompt de follow-up a um agente ativo.
  3. Assuma a tarefa localmente. A opção Move to → Local só aparece quando já existe um agente local aberto para o mesmo repositório, e aí ela continua o mesmo agente com mudanças e contexto (fórum do Cursor). Sem isso, trabalhe direto na branch do agente:
git fetch origin <branch>
git checkout <branch>

O erro comum deste passo é procurar o Move to → Local sem ter um agente local aberto no repositório. A opção não some por bug: ela simplesmente não aparece nessa condição.

Resultado esperado: a branch do agente aparece no seu ambiente local, pronta para revisar, ajustar e seguir.

Para quem os Cloud Agents compensam e quando o Agent no editor basta

A decisão sai de três coisas: o plano que você tem, as restrições da conta e o tipo de tarefa.

Compensa para

  • Quem delega tarefas longas. Trabalho de minutos a horas roda na VM do agente, sem prender a sua máquina nem o seu editor.
  • Quem dispara trabalho longe do computador. Celular, navegador, Slack ou Teams viram ponto de partida para uma tarefa.
  • Times que já vivem no GitHub ou no GitLab. O agente entrega numa branch separada, o que encaixa num fluxo de revisão por PR.

O Agent no editor basta para

  • Quem está no Free ou no Plus. Esses planos não têm o recurso, e o custo em tokens é o mesmo pool de qualquer forma. Para tarefas curtas e interativas, conduzir no editor é mais direto, e o vibe coding no Cursor já cobre bem esse fluxo.
  • Quem não pode dar escrita via app. Se a política da empresa não permite instalar o app do Cursor com acesso de escrita no repositório, o agente na nuvem não tem como trabalhar.
  • Quem está preso no Legacy Privacy Mode. Enquanto a conta não migrar para o Privacy Mode atual, o recurso fica indisponível.

Se o que pesa é a conta no fim do mês, também vale comparar com a ideia de migrar para o Claude Code antes de subir de plano.

Próximo passo antes de disparar o primeiro Cloud Agent

Antes do primeiro disparo, passe por este checklist:

  • Confirme se o seu plano inclui o recurso: Premium, Super, Ultra, Teams, Enterprise ou um legado Pro, Pro+, Ultra ou Start.
  • Ligue o uso on-demand e defina um limite de gastos.
  • Instale o app do Cursor no GitHub ou no GitLab com acesso de escrita no repositório, nos dependentes e nos submódulos.
  • Versione um .cursor/environment.json com o campo install preenchido.
  • Verifique se a conta ou o time não está no Legacy Privacy Mode.

Feito isso, comece com uma tarefa pequena e veja quanto ela consumiu do pool semanal. Esse número, da sua conta e do seu modelo, vale mais que qualquer estimativa genérica antes de soltar o agente numa tarefa de horas.

Perguntas frequentes

Cloud Agents funcionam com Bitbucket Server, o self-hosted, ou só com o Bitbucket Cloud?

A documentação cita especificamente o Bitbucket Cloud como provedor suportado, junto com GitHub, GitLab e Azure DevOps Services. Não há menção a uma versão on-premise do Bitbucket na lista de provedores.

Fontes consultadas

Consulta em .

Acompanhe os tutoriais do Hora de Codar no YouTube. Se quiser aprofundar o contexto, veja FREEBUFF: A IA GRATUITA QUE PODE SUBSTITUIR O CURSOR?.

Escrito por | Matheus Battisti

Matheus Battisti
Fundador da Hora de Codar

Programador apaixonado pelo mundo das tecnologias, sempre buscando em aprender e se aprofundar em linguagens, frameworks e o que mais for necessário para executar um bom trabalho. Agora tem uma nova missão que é de passar seu conhecimento adiante para formar novos programadores e especializar mais os que já são.

Formações

Formação Vibe Coding

Formação Vibe Coding

Do Prompt ao Produto: Crie Software Real com IA

  • 474 aulas
  • 20 projetos
  • 39h 30min

Blog | Mais populares