Cursor para iniciantes: tutorial completo passo a passo

Cursor para iniciantes: aprenda a instalar, configurar o modelo, usar os modos Plan e Ask e criar sua primeira automação em Python com IA.

Introdução

Imagina chegar no trabalho e receber uma planilha com quase 300 produtos para cadastrar, um por um, no sistema da empresa. Horas de copiar e colar, certo? Agora imagina pedir para uma IA fazer isso por você e só acompanhar o resultado. É exatamente esse tipo de coisa que você vai aprender neste guia de Cursor para iniciantes.

O Cursor é uma ferramenta de agentes de IA que trabalha direto nos arquivos do seu computador. Você explica o que quer, ele cria o código, testa, corrige e entrega pronto. E não precisa ser programador para tirar proveito disso.

Ao longo deste tutorial, você vai instalar o Cursor, entender qual plano faz sentido para você, configurar o modelo de IA do jeito certo, conhecer os modos de uso e criar uma automação real em Python, partindo do zero.

Para fazer o download do(s) arquivo(s) utilizados na aula, preencha com o seu e-mail:

Não vamos te encaminhar nenhum tipo de SPAM! A Hashtag Treinamentos é uma empresa preocupada com a proteção de seus dados e realiza o tratamento de acordo com a Lei Geral de Proteção de Dados (Lei n. 13.709/18). Qualquer dúvida, nos contate.

O que é o Cursor e o que ele faz por você

O Cursor é uma ferramenta onde você coloca agentes de IA para trabalhar por você. Funciona assim: você seleciona uma pasta do computador (ou até o computador inteiro), diz o que precisa e o agente usa os arquivos daquela pasta para entregar a solução.

Essa solução pode ser quase qualquer coisa:

  • Uma automação, como cadastrar produtos num sistema ou preencher formulários
  • Uma análise de dados, com faturamento, quantidade de vendas e até um dashboard
  • Um site ou sistema completo, com login, cadastro e banco de dados

Se você quer entender melhor esse conceito, vale ver o que agentes de IA já conseguem fazer no dia a dia.

Tela inicial do Cursor para iniciantes com chat do agente e lista de projetos

Um detalhe que talvez confunda no começo: os modelos próprios do Cursor são da família Grok. Isso acontece porque, em agosto de 2026, o Cursor passou a fazer parte da SpaceX, dona da xAI, empresa que criou o Grok. Mesmo assim, nos planos pagos mais altos você também consegue usar modelos de outras empresas, como Claude e GPT, tudo no mesmo lugar.

Para uma visão geral das funcionalidades do Cursor, temos um guia completo aqui no blog. Neste artigo, o foco é botar a mão na massa.

Cursor, Claude Code ou Codex: qual escolher

O Cursor tem dois concorrentes diretos bem conhecidos. A diferença principal está nos modelos de IA que cada um usa:

FerramentaEmpresaModelos de IAQuando escolher
CursorSpaceX (xAI)Grok e Composer, além de Claude, GPT e Gemini nos planos mais altosVocê quer variar entre modelos numa única assinatura
Claude CodeAnthropicClaudeVocê só quer usar os modelos Claude
CodexOpenAIGPTVocê só quer usar os modelos do ChatGPT

Ou seja, se você só quer os modelos do Claude, faz mais sentido entender como funciona o Claude Code. Se prefere os modelos do GPT, vá de Codex, o agente de programação da OpenAI. Agora, se você quer testar modelos diferentes sem pagar várias assinaturas e ainda aproveitar os modelos Grok, que são muito bons, o Cursor é a escolha certa.

Como instalar o Cursor e escolher seu plano

Instalar o Cursor é bem simples:

  1. Pesquise "Cursor download" no Google ou acesse a página oficial de download do Cursor.
  2. Clique no botão de download para o seu sistema e aguarde o instalador baixar.
  3. Execute o instalador e avance até o fim, no famoso próximo, próximo, concluir.
  4. Abra o Cursor e faça login. Se ainda não tiver conta, crie uma com seu e-mail. É de graça.
Site oficial do Cursor com o botão Baixar para Windows

Pronto, depois do login você já cai na tela principal, onde vai fazer todos os seus pedidos.

Comece no plano gratuito e suba quando precisar

O Cursor tem um plano gratuito, e a tela é exatamente igual à dos planos pagos. A diferença é que alguns modelos aparecem com um cadeado ao lado, indicando que só ficam disponíveis com assinatura.

Planos do Cursor Grátis, Plus, Premium e Super com preços mensais

Veja o que cada plano oferece hoje:

PlanoPreço por mêsO que libera
GrátisUS$ 0Uso limitado dos modelos Grok, sem personalizar o esforço e sem modelos de outras empresas
PlusUS$ 8Mais uso dos modelos Grok, mas ainda sem modelos de outras empresas
PremiumUS$ 304x mais uso que o Plus, modelos de terceiros (Claude, GPT, Gemini), agentes na nuvem, automações e Grok Bot
SuperUS$ 10015x mais uso que o Plus e prioridade nos horários de pico

Fique atento a um detalhe: no Premium e no Super, os modelos de outras empresas são cobrados à parte, pelo preço da API de cada uma. Os preços acima são de novembro de 2026 e podem mudar, então confira a tabela de preços atualizada do Cursor antes de assinar.

A recomendação aqui é simples: comece no plano gratuito. Quando bater no limite, e isso costuma acontecer rápido se você usar bastante, suba para o Plus ou direto para o Premium se quiser os modelos de terceiros. O Super só vale para quem usa IA o tempo todo e vive batendo no limite.

Uma dica: se acabou de assinar um plano, feche o Cursor e abra de novo para ele reconhecer a assinatura.

Crie seu primeiro projeto no Cursor com uma automação em Python

Agora vem a parte prática. O desafio é o seguinte: você precisa cadastrar os 293 produtos da base vendas_ecommerce.csv dentro de um sistema web, que tem login e senha. Fazer isso na mão levaria horas. Com o Cursor, você só explica a tarefa.

Para acompanhar junto, baixe os arquivos do projeto no formulário logo acima. São dois:

  • prompt.txt: o pedido com o link do sistema, o e-mail e a senha de teste
  • vendas_ecommerce.csv: a base com código, marca, tipo, categoria, preço unitário, custo e observação de cada produto

Coloque os dois numa pasta do seu computador. Aqui, a pasta se chama ProjetoCursor.

Escolha a pasta e onde a tarefa vai rodar

Na tela principal, logo acima da caixa de mensagem, você vai ver dois botões.

O primeiro define onde a tarefa vai rodar. O Cursor permite rodar em uma máquina remota, mas isso é um recurso mais avançado que a maioria das pessoas não vai usar. Deixe marcado This PC, ou seja, o seu próprio computador.

Menu Run on do Cursor com a opção This PC selecionada

O segundo botão é o seletor de pasta. Use Open Folder para abrir uma pasta que já existe ou New Folder para criar uma nova. Selecione a pasta onde estão os arquivos do projeto.

Quer ver o que tem dentro dela? Clique no ícone do canto superior direito para abrir a barra lateral. Ali você encontra:

  • Files: os arquivos da pasta, que você pode abrir num visualizador interno
  • Browser: o navegador que o Cursor usa quando precisa acessar sites
  • Terminal: onde ele roda os comandos
  • Changes: as alterações que o agente fez nos arquivos
Arquivo prompt.txt aberto no visualizador do Cursor ao lado da base CSV

O Cursor sempre tenta fazer tudo dentro dele mesmo. Quando precisa de algo que só existe fora, no seu computador, ele pede sua autorização antes.

Peça a automação e acompanhe o agente trabalhando

Com a pasta selecionada, é só escrever o pedido na caixa de mensagem. O prompt usado aqui foi este:

Codigo
Olha, eu quero que você olhe o arquivo prompt.txt que está dentro da pasta do projeto e a base de dados em CSV. Eu quero que você crie a automação em Python de todo aquele pedido que está dentro do arquivo prompt.txt.
Prompt pedindo ao Cursor uma automação em Python a partir do prompt.txt

Repare que o pedido indica a linguagem, Python. Isso é opcional. Se você não disser, o agente escolhe a linguagem que achar melhor. Indicar ajuda quando você quer entender ou mexer no código depois.

Clique em enviar e deixe o agente trabalhar. Durante o processo, ele vai pedir algumas autorizações, como fazer uma pesquisa na web ou rodar um comando. Você tem três opções:

  • Run: autoriza só desta vez
  • Always Run: autoriza sempre que aparecer esse tipo de ação
  • Skip: pula a ação
Cursor pedindo autorização com as opções Skip, Always Run e Run

Vale acompanhar o que acontece por trás. O agente leu o prompt e a base, abriu o site do sistema, inspecionou o formulário, criou um ambiente virtual (venv), instalou o Playwright e testou o login e o cadastro de um único produto antes de rodar a base inteira. É uma forma inteligente de confirmar que tudo funciona antes de processar centenas de linhas.

Sistema de login aberto no navegador interno do Cursor durante a automação

O Playwright é a biblioteca que controla o navegador. Se quiser entender como o Playwright preenche formulários na web, temos um passo a passo completo, e você também pode consultar a documentação oficial do Playwright.

No fim, o agente entregou dois arquivos na sua pasta:

  • cadastrar_produtos.py: o código da automação, com cerca de 115 linhas
  • requirements.txt: a lista de bibliotecas que o código precisa
Resultado da automação no Cursor com cadastrar_produtos.py e requirements.txt

Sempre que quiser rodar o cadastro de novo, basta usar este comando no terminal, ou simplesmente pedir ao Cursor para executar:

Codigo
.\.venv\Scripts\python.exe cadastrar_produtos.py

O agente ainda sugeriu algumas opções úteis para controlar a execução:

OpçãoO que faz
HEADLESS=1Roda a automação sem abrir a janela do navegador
LIMITE=5Cadastra só os 5 primeiros produtos, ótimo para testar
SLOW_MO=50Deixa a digitação mais lenta, para você acompanhar na tela

E se você quiser ver o código, é só clicar no arquivo. Ele abre dentro do próprio Cursor, com funções para ler a base, fazer login e cadastrar cada produto.

Código Python de cadastro de produtos gerado pelo agente do Cursor

Organize projetos, conversas e o tema do Cursor

Na barra da esquerda, você encontra as opções New Chat, Automations, Customize e a lista dos seus projetos.

Um projeto nada mais é do que uma pasta onde você pode ter várias conversas. Isso é muito útil: enquanto o agente trabalha na automação, você pode abrir uma nova conversa no mesmo projeto e pedir outra coisa, como "faça uma análise da minha base de vendas". Cada conversa cuida de uma tarefa, sem misturar os assuntos.

E se o fundo claro incomoda seus olhos, clique na engrenagem e vá em Appearance. Em Theme, você escolhe entre tema claro, escuro, alto contraste ou o padrão do sistema. Ali também dá para ajustar a largura do chat, o tamanho da fonte e o nível de detalhe das ações do agente.

Configurações de aparência do Cursor com a escolha do tema escuro
Ícone Inteligência ArtificialInteligência Artificial Impressionador

Você vai aprender de forma prática a usar as principais ferramentas de Inteligência Artificial que estão revolucionando o Mercado de Trabalho, para se destacar em qualquer empresa que use as ferramentas dessa revolução. Independente da sua área, aqui você vai aprender como usar a Inteligência Artificial na sua realidade para se destacar.

Black Friday · Lote Especial · Lote 1 · Último Lote

De R$ 1.497 56% OFF54% OFF53% OFF

por 12x R$ 6467,5069

Preço do Lote Especial por tempo limitadoPreço do Lote Especial só até amanhã, 13/11, às 23h59Preço do Lote Especial até 13/11, às 23h59Último dia do Lote Especial: o preço vale até hoje, às 23h59Preço do Lote 1 por tempo limitadoPreço do Lote 1 só até amanhã, 20/11, às 23h59Preço do Lote 1 até 20/11, às 23h59Último dia do Lote 1: o preço vale até hoje, às 23h59Preço do Último Lote por tempo limitadoPreço do Último Lote só até amanhã, 27/11, às 23h59Preço do Último Lote até 27/11, às 23h59Último dia do Último Lote: o preço vale até hoje, às 23h59

Começar agoraQuero a oferta de Black FridaySeta para a direita
Fundo Inteligência ArtificialTelas Inteligência Artificial
Luz Inteligência Artificial

Configure o modelo, o contexto e o esforço da IA

Toda mensagem que você manda para o Cursor usa um modelo de IA. Clicando na setinha ao lado do nome do modelo, você vê a lista completa. Nos planos que liberam modelos de terceiros, aparecem opções como Grok 4.7, Composer, Claude Opus, Claude Sonnet, Gemini e GPT.

Lista de modelos de IA disponíveis no Cursor, como Grok 4.7 e Claude Opus

Os modelos Grok são os que oferecem mais limite de uso dentro da assinatura, já que são os modelos da casa. Por isso, uma boa estratégia é usar o melhor modelo Grok disponível como padrão e testar os outros quando fizer sentido.

Ao passar o mouse sobre um modelo, aparece o botão Edit. É ali que você ajusta como o modelo vai trabalhar:

Opções de contexto, esforço e Fast ao editar um modelo no Cursor
ConfiguraçãoO que fazRecomendação
ContextDefine a janela de contexto, ou seja, quanta informação a IA guarda em memória durante a conversaUse a maior disponível (500K no Grok 4.7, até 1M no Claude Opus)
EffortDefine quanto a IA pensa antes de responder. Mais esforço, respostas melhores e mais demoradasComece no segundo maior nível e suba se as respostas vierem fracas
FastFaz a IA responder mais rápido, mas gasta o dobro de tokensAtive só quando estiver com muita pressa
AutoDeixa o Cursor escolher o modelo por vocêPrefira escolher o modelo manualmente

A janela de contexto funciona como a memória de curto prazo da IA. Quando ela lê seus arquivos, abre um site, testa um código, tudo isso vai ocupando essa memória. Quanto maior, melhor ela consegue lidar com tarefas longas. Se quiser se aprofundar, entenda o que é janela de contexto e por que ela faz tanta diferença.

Sobre o esforço: os níveis vão de Low até Extra High, e alguns modelos têm ainda o Max. Começar no segundo maior equilibra bem qualidade e consumo. Se seus tokens estiverem acabando rápido demais, desça um nível. Se as respostas estiverem ruins, suba.

E em vez de ativar o Fast, uma alternativa mais econômica é trabalhar em paralelo: enquanto um pedido roda, abra outra conversa e adiante outra tarefa. Assim você não fica parado esperando.

Lembrando que a personalização de esforço e os modelos de outras empresas não estão disponíveis no plano gratuito.

Use os modos Plan, Debug, Multitask e Ask a seu favor

Até aqui você usou o Cursor no modo padrão: pede a tarefa e ele executa. Mas existem outros modos de uso, cada um pensado para uma situação. Você acessa todos pelo botão de + na caixa de mensagem.

Menu de modos do Cursor com Plan, Debug, Multitask e Ask
ModoPara que serveQuando usar
Padrão (Agent)Executa a tarefa diretoTarefas simples, como a automação deste tutorial
PlanCria um plano detalhado antes de executar, para você revisar e ajustarTarefas longas e complexas, como um sistema de cadastro com login
DebugEncontra a causa de um problema no projetoQuando algo está dando erro e você não sabe por quê
MultitaskExecuta vários pedidos em paralelo na mesma conversaQuando você quer disparar várias tarefas de uma vez
AskResponde perguntas sobre o projeto sem editar nenhum arquivoQuando você quer tirar dúvidas com segurança

O Plan merece atenção especial. Se o agente executa algo grande do jeito errado, corrigir depois gasta muito token e dá trabalho. Com o plano em mãos, você corrige o caminho antes de qualquer linha de código ser escrita. Você também pode ativar esse modo com o atalho Shift+Tab, como explica a documentação oficial do modo Plan.

O Ask é ótimo para perguntas do tipo "consigo colocar essa automação para rodar todo dia às 7h da manhã?". Ele verifica e responde, mas não mexe em nada. Se a resposta for sim, aí você pede para executar.

Já o Multitask pode deixar a conversa confusa, com várias respostas misturadas. Sem ele, os pedidos que você manda enquanto o agente trabalha entram numa fila. Uma alternativa mais organizada é abrir uma conversa nova para cada pedido.

Troque para a visão de IDE se você já programa

O Cursor é um fork do VS Code, ou seja, foi criado a partir de uma cópia dele, com recursos de IA adicionados por cima. Por isso, além da janela de agente em formato de chat, ele oferece uma visão de IDE, o ambiente de desenvolvimento que todo programador conhece.

Para abrir, clique no botão IDE no canto superior direito. Uma nova janela vai aparecer com os arquivos à esquerda, o código no centro e o agente na lateral.

Visão de IDE do Cursor, parecida com o VS Code, com código e agente lado a lado

Nessa visão você tem tudo o que o VS Code oferece: extensões, criação de arquivos e pastas, várias abas de conversa com a IA. As funcionalidades do agente são as mesmas nas duas janelas, só muda a forma de visualizar. Se você nunca programou, a janela de agente tende a ser mais intuitiva. Se já está acostumado a programar, a IDE deixa tudo à vista ao mesmo tempo.

Ganhe tempo com comandos, Git e automações

Digite uma barra / na caixa de mensagem e uma lista de comandos vai aparecer. Eles funcionam como atalhos para tarefas específicas:

  • commit: salva uma versão das alterações do projeto
  • code-review: revisa o código sem editar nada
  • explain: explica como um arquivo ou trecho funciona
  • create-branch: cria uma nova ramificação do projeto
Lista de comandos com barra no Cursor, como commit e code-review

Muitos desses comandos usam Git e GitHub, ferramentas que guardam cada versão do seu projeto. Na prática, é como ter um Ctrl+Z infinito: se algo quebrou duas versões atrás, você volta para a versão que funcionava. Se ainda não usa, vale criar uma conta no GitHub e instalar o Git. Você pode até pedir ao próprio Cursor: "instale o Git para mim e configure meu GitHub".

Quanto mais ferramentas você conecta ao Cursor, como o Slack, mais comandos aparecem nessa lista. E ele também trabalha com recursos avançados, como skills e MCPs, que ampliam o que o agente consegue fazer.

Defina só o objetivo com o comando /goal

O /goal muda a forma de pedir. Em vez de explicar como o agente deve fazer a tarefa, você diz apenas o objetivo e ele faz tudo o que for preciso para chegar lá.

Compare com o projeto deste tutorial. No prompt, você deu bastante orientação: qual arquivo ler, qual base usar, que a automação deveria ser em Python. Com o /goal, bastaria algo como "cadastre todos os produtos da base no meu sistema".

Comando /goal no Cursor para definir um objetivo ao agente

Isso é útil, por exemplo, quando você recebe um projeto pela metade, cheio de erros, e só precisa que ele funcione. O cuidado é que, com mais liberdade, o agente tende a gastar muito mais tokens e pode seguir caminhos diferentes do que você esperava.

Agende tarefas repetitivas com o Automations

Fez uma tarefa que precisa se repetir? Com o Automations você transforma isso numa automação que roda sozinha, a partir de um gatilho ou de uma agenda. Por exemplo, a cada cinco horas, ou toda segunda-feira às 9h.

O Cursor já traz vários modelos prontos para você usar:

  • Find critical bugs: analisa as últimas alterações e avisa sobre erros graves pelo Slack
  • Summarize changes daily: envia um resumo diário do que mudou no projeto
  • Generate docs: cria e atualiza a documentação do projeto
  • Scan codebase for vulnerabilities: procura falhas de segurança de tempos em tempos
Modelos de automações prontas no Cursor, como Find critical bugs

Para acessar, clique em Automations na barra da esquerda ou use o comando /automate. Esse recurso está disponível a partir do plano Premium. E se quiser ir além, vale entender como funcionam as skills em agentes de IA, que deixam o agente ainda mais especializado nas suas tarefas.

Conclusão

Neste guia de Cursor para iniciantes, você viu como instalar a ferramenta, escolher o plano certo, configurar o modelo, o contexto e o esforço da IA, e usar os modos Plan, Debug, Multitask e Ask. Mais do que isso, você criou uma automação real em Python que cadastra centenas de produtos sozinha, só explicando o que precisava.

O próximo passo é entender o código que a IA escreve para você. Quando você sabe Python, consegue revisar, ajustar e criar automações muito mais poderosas com o Cursor. Se quer dominar a linguagem do zero ao avançado, conheça o Python Impressionador, o curso completo de Python da Hashtag Treinamentos.

Caso prefira esse conteúdo no formato de videoaula, assista ao vídeo abaixo ou acesse o nosso canal do YouTube!

FAQ - Perguntas Frequentes sobre Cursor para iniciantes

1. O Cursor é gratuito?

Sim. O Cursor tem um plano gratuito com uso limitado dos modelos Grok. Para ter mais uso, existe o Plus, de US$ 8 por mês, e para usar modelos de outras empresas, como Claude e GPT, é preciso o Premium, de US$ 30 por mês.

2. Preciso saber programar para usar o Cursor?

Não. Você descreve a tarefa em português e o agente cria e executa o código. Saber programar, principalmente Python, ajuda a revisar e ajustar o que a IA entrega.

3. Qual a diferença entre o Cursor e o VS Code?

O Cursor foi criado a partir do VS Code e funciona com a mesma base, inclusive com extensões. A diferença é que ele tem agentes de IA integrados e uma janela em formato de chat, além da visão tradicional de IDE.

Hashtag Treinamentos

Para acessar outras publicações de Python, clique aqui!


Quer aprender mais sobre Python com um minicurso básico gratuito?

Posts mais recentes de Python

Posts mais recentes da Hashtag Treinamentos