Cursor AI Tutorial para Iniciantes: Do Zero

Instalação e primeiro setup

Cursor está disponível em cursor.com para Mac, Windows e Linux. O download é direto — instala como qualquer outro app. Na primeira vez que abre, ele pergunta se você quer importar configurações do VS Code. Se você tem VS Code configurado, aceite. Suas extensões, atalhos e temas migram automaticamente.

Após o login, você cai no free trial com acesso a features premium por 14 dias. Aproveite o trial pra testar com projeto real antes de decidir se paga. O plano Free que fica após o trial tem limite menor mas é suficiente pra avaliar se o workflow faz sentido pra você.

Antes de qualquer coisa: entenda o que você recebe em cada plano e se vale pagar. O artigo sobre o plano de $20 do Cursor quebra os detalhes que a página oficial não deixa claro.

Feature 1: Autocomplete — seu primeiro ganho imediato

O autocomplete do Cursor vai além do autocomplete tradicional. Ele lê o contexto do arquivo atual, outros arquivos do projeto e o que você acabou de fazer pra sugerir completions que fazem sentido semanticamente — não só sintaticamente.

Na prática: você começa a escrever uma função, ele sugere o corpo inteiro com base no nome da função e no contexto do arquivo. Tab pra aceitar, Esc pra ignorar. Simples. No começo parece mágica. Depois de uma semana, parece natural — e voltar pra um editor sem isso parece lento.

Um ponto de atenção: não aceite sugestões sem ler. O autocomplete da IA às vezes sugere código correto sintaticamente mas errado pra o que você quer fazer. Ler o que você está aceitando é um hábito que evita bugs difíceis de detectar depois.

Feature 2: Chat — pergunte sobre o seu proprio codigo

Ctrl+L abre o chat do Cursor. A diferença pra ChatGPT ou Claude.ai direto é o contexto: você pode referenciar arquivos do seu projeto, funções específicas e até erros do terminal diretamente na conversa. A IA responde com conhecimento do que está no seu projeto, não de um codebase genérico imaginário.

Pra referenciar um arquivo no chat, use @nomedoarquivo. Pra referenciar uma função específica, @nomeDaFuncao. Pra incluir a documentação de uma biblioteca, @docs e o nome da lib. Esses atalhos são o que diferencia o chat do Cursor de qualquer chatbot genérico.

Casos de uso que funcionam muito bem no chat: 'Por que essa função retorna undefined em X cenário?', 'Explique o que esse código faz em linguagem simples', 'Qual a diferença entre useEffect com [] e sem dependências nesse componente específico?' — perguntas que exigem contexto do código real, não só teoria.

Feature 3: Composer — editar múltiplos arquivos de uma vez

Ctrl+I abre o Composer. Essa é a feature que mais impressiona iniciantes e que mais diferencia Cursor de uma IDE comum. No Composer, você descreve uma tarefa e a IA edita os arquivos necessários — criando, modificando e deletando com coerência entre eles.

Exemplo real: 'Adicione validação Zod no formulário de cadastro, atualize o tipo TypeScript correspondente e adicione o erro de validação no componente de input.' Normalmente são 3 arquivos pra editar. Com Composer, você escreve uma vez e ele propõe todas as mudanças em diff. Você revisa e aceita ou rejeita arquivo por arquivo.

O ponto mais importante sobre Composer: sempre revise o diff antes de aceitar. Cursor pode editar arquivos que você não pediu ou fazer mudanças mais amplas do que o esperado. O diff visual existe exatamente pra isso — use-o.

Seu primeiro projeto com Cursor: setup em 15 minutos

O que iniciantes costumam errar no começo

O erro mais comum: pedir pra IA fazer tudo de uma vez. 'Cria um sistema de autenticação completo com JWT, refresh token, recuperação de senha e integração com banco de dados.' Isso resulta em código que funciona no papel mas tem 50 decisões implícitas que você não vai entender nem conseguir manter.

Trabalhe em incrementos pequenos. Uma feature de cada vez. Um arquivo de cada vez quando estiver aprendendo. À medida que você entende o que a IA está gerando, pode aumentar a granularidade dos pedidos. Mas sempre com revisão — nunca aceite Composer sem ler o diff.

Cursor AI serve pra quem ainda está aprendendo a programar?

Essa é uma pergunta honesta que merece uma resposta honesta: depende de como você usa. Se você usa Cursor pra gerar código que não entende e apenas cola em produção, vai aprender mal e ter bugs que não consegue resolver. Se você usa pra entender código que gerou — perguntando 'por que essa linha está aqui?', 'o que esse pattern significa?' — é uma ferramenta de aprendizado excelente.

O maior risco pra quem está aprendendo é a ilusão de progresso. Gerar código que funciona não é o mesmo que entender como funciona. Se o objetivo é aprender de verdade, use Cursor como ferramenta de exploração — peça explicações, não só soluções.