Kaique Mitsuo Silva Yamamoto
IaDesenvolvimento com ia

Cursor em Profundidade — Composer 2, Agentes e Cloud

Guia completo do Cursor IDE: Composer 2 com planning, agentes autônomos, cloud agents, @-mentions, rules, configuração avançada e comparação com Claude Code.

Cursor evoluiu de "autocomplete com IA" para uma IDE agêntica completa. O Composer 2 executa planos autonomamente, cria branches, abre PRs e trabalha em background via cloud agents.


Composer 2 — O agente do Cursor

Fluxo Plan → Build

  1. Escreva o PRDfeature-prd.md com requisitos detalhados
  2. Abra ComposerCmd+K (inline) ou painel lateral
  3. Referencie arquivos@specs/auth.md @src/db/schema.ts
  4. Peça o plano — Composer gera task list do PRD
  5. Revise o plano — edite, reordene, remova tarefas
  6. Execute — Composer implementa autonomamente
  7. Revise diffs — aceite/rejeite cada alteração

Prompt efetivo no Composer

@specs/billing.md @src/models/user.ts @src/db/schema.ts

Implement the billing module from @specs/billing.md.

Requirements:
- Follow the existing model patterns in @src/models/user.ts
- Use the schema from @src/db/schema.ts
- Write Vitest tests for each endpoint BEFORE implementing
- After implementing, run: pnpm lint:fix && pnpm vitest run
- If any test fails, fix until all pass

Create a plan first, then execute one task at a time.

Cloud Agents

Cloud agents rodam em máquinas da Cursor — você pode fechar o laptop e voltar depois.

Como usar

  1. Abra Composer com uma tarefa grande
  2. Clique em "Run in Cloud"
  3. Cursor cria uma branch, abre máquina, executa
  4. Você recebe notificação quando terminar
  5. Review do PR no GitHub ou dentro do Cursor

Quando usar cloud agents

CenárioUse cloud?
Corrigir um lintNão — faça local
Implementar módulo inteiroSim — 30+ min de trabalho
Refatorar 20 arquivosSim — paralelizável
Debug de erro específicoNão — precisa do seu ambiente
Gerar testes para móduloSim — trabalho repetitivo

@-mentions no Cursor

SintaxO que inclui
@fileConteúdo de um arquivo
@folderTodos os arquivos de uma pasta
@codeTrecho selecionado
@gitDiff do git (changes, branch, log)
@webResultado de busca na web
@docsDocumentação de bibliotecas
@terminalOutput do terminal

Exemplo prático

@file specs/auth.md @file src/api/users.ts @git diff

Review the changes in @git diff against the spec in @file specs/auth.md.
Does the implementation match the spec? List any deviations.

Rules do Cursor

Cursor tem seu próprio sistema de rules (similar ao CLAUDE.md):

.cursorrules (raiz do projeto)

# Cursor Rules

## Stack
TypeScript, Next.js 16, React 19, Tailwind CSS v4

## Conventions
- 2-space indent, single quotes
- Components in PascalCase
- Always use <Link> for internal navigation
- Always use Vitest (never Jest)

## Code Style
- Prefer functional components
- Use TypeScript strict mode
- No `any` types — use `unknown` instead
- Always handle errors explicitly

Rules por diretório

.cursor/
├── rules/
│   ├── backend.md        # Regras para Go
│   ├── frontend.md       # Regras para React
│   └── tests.md          # Regras para testes

Comparação: Cursor vs Claude Code

AspectoCursorClaude Code
InterfaceIDE visual (VS Code fork)Terminal / CLI
AutocompleteInline (Tab)Não tem (foco em agente)
AgenteComposer 2claude CLI
CloudCloud agents built-inclaude --cloud
GitIntegrado na IDEVia comandos shell
SubagentesCloud agents paralelosSubagents no terminal
Pricing$20/mês (Pro) + usageUsage-based (API)
Melhor paraCoding assistido no dia a diaTarefas agênticas complexas

Quando usar qual

  • Cursor: dia a dia no editor, autocomplete, refatoração assistida, Composer para features
  • Claude Code: tarefas complexas no terminal, pipes de dados, scripts automatizados, cloud agents para work longo
  • Ambos: Cursor para escrever + Claude Code para rodar no terminal em paralelo

Erros comuns com Cursor

ErroConsequênciaCorreção
Composer sem @-mentionsCursor "adivinha" o contexto erradoSempre referencie arquivos relevantes
Aceitar diffs sem revisarBugs em produçãoRevise CADA diff
Cloud agent sem specResultado vagoPRD antes de cloud
Não atualizar .cursorrulesRegras obsoletasVersionar e revisar mensalmente

On this page