Cursor AI: Tutorial Completo, Do Zero ao App Pronto em 30 Minutos

Se alguém nos perguntasse qual ferramenta mais mudou nossa forma de trabalhar nos últimos 12 meses, a resposta seria imediata: Cursor AI.

Não é exagero. O Cursor transformou a maneira como construímos projetos, prototipamos ideias e entregamos soluções para clientes aqui na Marfin. E os números mostram que não somos os únicos: em fevereiro de 2026, a Anysphere (empresa por trás do Cursor) atingiu US$ 2 bilhões em receita anual recorrente, dobrando o faturamento em apenas três meses. Com mais de 1 milhão de usuários e uma avaliação de US$ 29,3 bilhões, o Cursor é hoje o SaaS de crescimento mais rápido da história.

Neste tutorial, vamos te mostrar do zero como instalar, configurar e criar seu primeiro projeto funcional no Cursor. Sem enrolação. Se você seguir cada passo, em 30 minutos vai ter um app rodando.

O que é o Cursor AI?

O Cursor é um editor de código com inteligência artificial profundamente integrada. Ele é baseado no VS Code (então se você já usa VS Code, vai se sentir em casa), mas vai muito além de um simples autocomplete de código.

O diferencial do Cursor está em três pilares que o separam de qualquer outra ferramenta do mercado.

Primeiro, ele entende o contexto completo do seu projeto. Quando você pede "adicione um sistema de login", o Cursor analisa toda a estrutura de arquivos, banco de dados, rotas e dependências para gerar código que funciona dentro do seu projeto, não um snippet genérico.

Segundo, ele trabalha com múltiplos arquivos simultaneamente. Diferente de ferramentas que só editam o arquivo aberto, o Cursor cria, modifica e coordena mudanças em vários arquivos ao mesmo tempo. Isso é fundamental para qualquer projeto real.

Terceiro, ele itera com você conversando. Você descreve o que quer em português, ele gera, você pede ajustes, ele refina. Esse ciclo de vibe coding é o que torna o Cursor tão produtivo.

Se você ainda não conhece o conceito de vibe coding, recomendamos ler nosso guia completo: O que é Vibe Coding: O Guia Completo para Criar Software Conversando com IA.

Cursor vs. outras ferramentas: por que escolhemos ele

Antes de mergulhar no tutorial, vale entender como o Cursor se posiciona no ecossistema.

Cursor vs. GitHub Copilot: O Copilot é excelente para autocompletar linhas de código, mas funciona como um assistente passivo. O Cursor é um agente ativo: ele planeja, executa e edita múltiplos arquivos. É a diferença entre alguém que termina suas frases e alguém que escreve o documento inteiro com você.

Cursor vs. Claude Code: O Claude Code opera no terminal e é extraordinário para tarefas de programação complexas, como refatoração de projetos inteiros, debugging profundo e automações. É a ferramenta de coding com IA mais utilizada do mundo. A combinação ideal? Usar o Cursor para desenvolvimento no dia a dia e o Claude Code para tarefas que exigem raciocínio mais pesado e operações em larga escala.

Cursor vs. Lovable/v0: Lovable e v0 são ótimos para prototipar rapidamente e validar ideias sem configuração. Mas quando o projeto precisa crescer, ter código limpo e controle granular, o Cursor é onde a mágica acontece. Muitos times usam exatamente essa combinação: prototipam no Lovable e migram para o Cursor quando o projeto amadurece.

Na Marfin, nosso workflow combina essas ferramentas estrategicamente. Cursor no dia a dia. Claude Code para tarefas complexas. Lovable quando precisamos validar uma ideia em minutos.

Instalação e configuração inicial

Vamos ao prático. A instalação leva menos de 5 minutos.

Passo 1: Download e instalação

Acesse cursor.com e baixe a versão para o seu sistema operacional (Windows, Mac ou Linux). A instalação é padrão, sem complicações. Se você já tem o VS Code instalado, o Cursor oferece a opção de importar suas extensões e configurações automaticamente.

Passo 2: Criando sua conta

Ao abrir o Cursor pela primeira vez, crie uma conta. Existe um plano gratuito (Hobby) que permite experimentar a ferramenta com um limite de requests. Para uso profissional, o plano Pro custa US$ 20/mês e oferece requests ilimitados com modelos rápidos e 500 requests com modelos premium (como Claude Sonnet e GPT-5.4).

Passo 3: Configurações essenciais

Antes de começar a codar, ajuste estas configurações para ter a melhor experiência.

Abra as configurações (Ctrl+Shift+J ou Cmd+Shift+J no Mac) e vá em "Models". Recomendamos selecionar Claude Sonnet como modelo padrão. Na nossa experiência, ele oferece o melhor equilíbrio entre qualidade de código e velocidade de resposta.

Em "Features", ative o "Composer" (que permite gerar código em múltiplos arquivos) e o "Tab completion" (que sugere completions em tempo real enquanto você digita).

Em "Rules for AI", adicione regras globais que o Cursor vai seguir em todos os projetos. Por exemplo: "Sempre escreva código em TypeScript", "Use Tailwind CSS para estilização", ou "Comente o código em português". Essas regras evitam que você repita as mesmas instruções a cada prompt.

Entendendo as funcionalidades principais

O Cursor tem três formas principais de interação, cada uma ideal para um tipo de tarefa.

Chat (Ctrl+L / Cmd+L)

O chat lateral é para conversas sobre o código. Você pode selecionar um trecho de código, apertar Ctrl+L e perguntar "o que esse código faz?", "como otimizo isso?" ou "explique esse erro". É ideal para entender código existente, debugar problemas e pedir sugestões.

Inline Edit (Ctrl+K / Cmd+K)

O Ctrl+K permite editar código diretamente no editor usando linguagem natural. Selecione um trecho, aperte Ctrl+K e descreva a mudança: "converta essa função para async/await", "adicione tratamento de erro" ou "refatore usando o padrão Observer". As mudanças aparecem como um diff que você aceita ou rejeita.

Composer (Ctrl+I / Cmd+I)

O Composer é a funcionalidade mais poderosa do Cursor. Ele opera em nível de projeto, criando e editando múltiplos arquivos simultaneamente. É aqui que o vibe coding realmente acontece. Você descreve o que quer construir e o Composer gera toda a estrutura.

Tutorial prático: criando um app do zero

Vamos construir algo real. Vamos criar uma aplicação de gerenciamento de tarefas com as seguintes funcionalidades: adicionar, editar e remover tarefas, marcar como concluída, filtrar por status e persistência local dos dados.

Passo 1: Criando o projeto

Abra o Cursor e crie uma nova pasta para o projeto. Depois, abra o Composer (Ctrl+I) e escreva o seguinte prompt:

"Crie um app de gerenciamento de tarefas usando React com TypeScript e Tailwind CSS. O app deve ter: lista de tarefas com título e descrição, botão para adicionar nova tarefa com modal, opção de marcar como concluída, opção de editar e deletar, filtros por status (todas, pendentes, concluídas), persistência no localStorage, design moderno e responsivo com tema escuro."

Observe o que acontece: o Composer gera toda a estrutura do projeto. Ele cria o package.json, configura o TypeScript, monta os componentes React, aplica o Tailwind e implementa todas as funcionalidades que pedimos. Tudo de uma vez, coordenado entre múltiplos arquivos.

Passo 2: Revisando e ajustando

Revise os arquivos gerados. O Composer mostra todas as mudanças como diffs, e você pode aceitar ou rejeitar cada uma. Nesta etapa, normalmente fazemos pequenos ajustes conversando.

Por exemplo: "mude a cor do botão de adicionar para verde", "aumente o tamanho da fonte do título das tarefas", "adicione uma animação suave quando uma tarefa é marcada como concluída". Cada instrução gera uma nova iteração em segundos.

Passo 3: Rodando o projeto

Abra o terminal integrado (Ctrl+`) e execute os comandos para instalar as dependências e iniciar o servidor de desenvolvimento. O Cursor geralmente já configura os scripts corretos no package.json, então basta rodar npm install seguido de npm run dev.

Se algo der erro (e às vezes dá), copie a mensagem de erro e cole no chat do Cursor (Ctrl+L). Na maioria dos casos, ele identifica o problema e sugere a correção automaticamente.

Passo 4: Iterando e melhorando

Aqui é onde o Cursor brilha. Com o app rodando, você pode continuar conversando para adicionar funcionalidades. Alguns exemplos de prompts que usamos frequentemente:

"Adicione drag-and-drop para reordenar tarefas." "Implemente busca por texto no título e descrição." "Adicione categorias com cores diferentes para as tarefas." "Crie um resumo no topo mostrando total de tarefas, pendentes e concluídas."

Cada prompt gera modificações em tempo real. Em 30 minutos, você tem um app completo e funcional.

Dicas avançadas para tirar o máximo do Cursor

Depois de meses usando o Cursor diariamente, acumulamos práticas que fazem diferença significativa na produtividade.

Use o .cursorrules

Na raiz do seu projeto, crie um arquivo chamado .cursorrules. Nele, defina regras específicas para aquele projeto. Por exemplo: stack tecnológica, padrões de código, convenções de nomenclatura, bibliotecas preferidas. O Cursor consulta esse arquivo em toda interação e gera código consistente com suas preferências.

Um exemplo prático de .cursorrules:

"Este projeto usa Next.js 14 com App Router, TypeScript strict mode, Tailwind CSS e Shadcn/UI para componentes. Use server components por padrão. Nomeie arquivos em kebab-case. Escreva testes com Vitest. Toda função exportada deve ter JSDoc em português."

Referencie arquivos com @

No chat ou no Composer, use @ para referenciar arquivos específicos. Por exemplo: "@components/Header.tsx mude o menu de navegação para incluir um dropdown de perfil do usuário". Isso dá ao Cursor contexto preciso sobre qual parte do projeto você quer modificar.

Você também pode usar @docs para referenciar documentações externas, @web para buscar informações atualizadas na internet e @codebase para que o Cursor analise o projeto inteiro antes de responder.

Escreva prompts específicos

A qualidade do output do Cursor depende diretamente da qualidade do input. Compare estes dois prompts:

Prompt vago: "Adicione autenticação." Prompt específico: "Implemente autenticação com NextAuth.js usando provider do Google. Crie uma página de login em /login com botão de 'Entrar com Google'. Proteja as rotas /dashboard e /settings com middleware. Armazene a sessão do usuário e exiba o nome e foto no header."

O segundo prompt gera código que funciona na primeira tentativa. O primeiro gera código que precisa de várias rodadas de ajuste.

Use o Ctrl+K para micro-edições

Para mudanças pequenas e localizadas, o Ctrl+K é mais eficiente que o Composer. Selecione exatamente o trecho que quer modificar, descreva a mudança e aceite o diff. É rápido e preciso.

Combine Cursor com Claude Code

Para tarefas complexas que envolvem refatoração em larga escala, migração de dependências ou debugging profundo, o Claude Code é um aliado poderoso. Ele roda no terminal e pode analisar e modificar seu projeto inteiro de forma autônoma. A combinação dos dois é o setup que recomendamos para projetos profissionais.

Planos e preços do Cursor em 2026

O Cursor oferece três planos.

Hobby (gratuito): Inclui 2.000 completions e 50 requests com modelos premium por mês. Ideal para experimentar e projetos pessoais pequenos.

Pro (US$ 20/mês): Completions ilimitados com modelos rápidos, 500 requests com modelos premium e acesso ao modo Agent. É o plano que usamos na Marfin e que recomendamos para a maioria dos profissionais.

Business (US$ 40/mês por usuário): Tudo do Pro, mais funcionalidades de equipe, administração centralizada, políticas de privacidade e SSO. Voltado para empresas, e 60% da receita do Cursor já vem de clientes enterprise.

Para quem está começando, o plano gratuito é suficiente para seguir este tutorial e decidir se o Cursor faz sentido para seu workflow.

Casos de uso reais

Além de desenvolvimento de software tradicional, vemos o Cursor sendo usado para diversos cenários criativos.

Profissionais de marketing usam o Cursor para criar landing pages personalizadas, ferramentas interativas de diagnóstico, calculadoras de ROI e dashboards de analytics. Tudo isso sem depender de desenvolvedores. Veja nosso artigo sobre Ferramentas de IA para Marketing para entender como integrar o Cursor no seu stack.

Designers usam o Cursor para materializar protótipos funcionais a partir de mockups do Figma. A barreira entre design e código está desaparecendo.

Empreendedores validam ideias de produto em dias, construindo MVPs funcionais que antes levariam semanas com uma equipe de desenvolvimento.

Analistas de dados criam dashboards interativos, ferramentas de visualização e automações para processamento de dados.

Os limites do Cursor (e como contornar)

Seria irresponsável da nossa parte não falar sobre limitações.

Projetos muito grandes. Em projetos com centenas de arquivos, o Cursor pode perder contexto. A solução: use o .cursorrules para manter contexto e referencie arquivos específicos com @ em vez de pedir mudanças genéricas.

Código gerado nem sempre é perfeito. A IA pode gerar código com bugs, especialmente em lógica complexa. Sempre revise, teste e não aceite código cegamente. Isso é especialmente importante para segurança (autenticação, autorização, validação de dados).

Dependência de modelos. A qualidade do output depende do modelo de IA selecionado. Modelos premium (Claude Sonnet, GPT-4o) geram código significativamente melhor que modelos rápidos. Use os premium para tarefas críticas e os rápidos para mudanças simples.

Curva de aprendizado dos prompts. Escrever bons prompts é uma habilidade. No começo, seus prompts vão ser vagos e o resultado vai exigir muitas iterações. Com prática, você aprende a ser preciso na primeira tentativa.

Começando agora

O caminho mais rápido para aprender o Cursor é usar ele num projeto real. Não em tutoriais. Não em exercícios hipotéticos. Num projeto que você realmente precisa entregar.

Instale, siga os passos que descrevemos, construa algo. Quando travar (e vai travar), use o chat do Cursor para debugar. A cada problema resolvido, você entende melhor como a ferramenta pensa.

Se você quer entender o contexto maior de como ferramentas como o Cursor estão transformando a criação de software, leia nosso guia sobre O que é Vibe Coding. E se quer aprender a criar sites completos com IA de forma prática, confira Como Criar um Site com IA em 2026.

O Cursor não é o futuro da programação. É o presente. E quem aprender a usar agora vai ter uma vantagem competitiva difícil de alcançar.

Leia também: