Tutorial Cursor 2026: como usar o Agent em 15 minutos

Este tutorial Cursor mostra como usar o editor se você vai abri-lo pela primeira vez. Ele segue a documentação oficial do Cursor em 1º de novembro de 2026, quando a versão atual era o Cursor IDE 3.27.

Uma nota sobre o método: a equipe do NxCode escreveu este guia a partir desses documentos e não executou os passos em uma instalação nova. O NxCode é o nosso próprio produto, um criador de apps com IA, e é separado do Cursor. Quando o guia diz o que você deve ver, isso vem da documentação, então sua tela pode ter pequenas diferenças. Quando as páginas oficiais divergem ou deixam uma lacuna, nós avisamos.

Se você já leu um tutorial antigo do Cursor, prepare-se para algumas surpresas. O modo Composer, o Inline Edit do Cmd+K e o modo Chat separado sumiram da documentação atual.

Sua rota de 15 minutos

Minutos	O que você faz	O que você obtém
0–3	Instala, faz login, abre uma pasta de prática	O Cursor rodando no seu computador
3–5	Aprende as duas janelas e alguns atalhos	Você sabe onde fica o Agent
5–10	Roda a primeira tarefa com Ask e depois Agent	Uma pequena página melhorada pelo Agent
10–12	Revisa as alterações e testa	Você sabe o que o Agent realmente fez
12–14	Pratica restaurar um checkpoint	Você sabe como desfazer
14–15	Adiciona uma regra de projeto	O Agent segue suas preferências

O que é o Cursor?

O Cursor é um editor de código com um agente de IA integrado. Você descreve uma tarefa em linguagem comum, e o Agent lê seu projeto, edita arquivos e pode executar comandos.

Se você já usou o VS Code, o editor vai parecer familiar. Os atalhos normais de edição são os mesmos, e você pode importar suas extensões, temas, configurações e atalhos.

Três coisas acontecem dentro do Cursor em um dia normal:

O Agent assume tarefas em todo o projeto.
O Tab prevê o que você vai digitar enquanto escreve código por conta própria.
As Rules dizem ao Agent como seu projeto deve ser tratado.

O Cursor serve para quem quer trabalhar com código ou aprender a trabalhar. Quem só quer um app pronto e não tem interesse em ler diffs tem outra tarefa pela frente, e tratamos disso em "Quando usar outra ferramenta", mais abaixo. O NxCode é uma opção nesse caso.

Instale o Cursor e abra pela primeira vez

Passo 1: baixar

Acesse cursor.com/download e escolha seu sistema.

Sistema	Requisito	O que baixar
macOS	12 ou posterior	`.dmg`, para Apple Silicon ou Intel
Windows	10 ou posterior	`.exe`, x64 ou ARM64, cada um com instaladores System e User
Linux	Debian/Ubuntu ou RHEL/Fedora	Primeiro o repositório apt ou yum; AppImage também disponível

No Linux, o quickstart oficial prefere os repositórios apt e yum porque eles adicionam um ícone na área de trabalho, atualizações automáticas e a ferramenta de linha de comando.

Passo 2: abrir o Cursor e fazer login

A ordem oficial é curta: baixar, abrir, fazer login, escolher uma pasta, começar com uma tarefa pequena. Você precisa de uma conta.

O login do Cursor pode levar você a uma página compartilhada da xAI com a marca Grok ou xAI. Isso é esperado, porque novos clientes agora começam em The X Subscription, a assinatura sob a qual o Cursor é vendido. Fazer login não mescla contas nem muda um plano.

Guias antigos listam "escolher seu modelo de IA" como um passo da primeira abertura. A documentação atual não tem esse passo. Você pode definir um padrão depois em Cursor Settings > Models ou trocar durante uma conversa.

A documentação também não diz se, em uma conta nova, você cai primeiro na Agents Window ou no editor. A próxima seção mostra como alternar entre os dois, então qualquer início serve.

Passo 3: escolher um plano

Comece no Free ($0, uso limitado), passe para o Plus ($8/mês) se os limites atrapalharem seu trabalho e escolha o Premium ($30/mês) só quando precisar de Cloud Agents, modelos de terceiros ou suas próprias chaves de API.

Os preços não incluem impostos. Acima desses estão Super ($100) e Ultra ($200). Para detalhes, veja nosso guia de preços do Cursor ou a página oficial de preços. Compre apenas pelo site oficial ou pela compra dentro do app, já que a página de preços usa a expressão "not authorize any resellers or third-party sellers" (não autoriza revendas nem vendas de terceiros).

Passo 4: opcional, trazer sua configuração do VS Code

Importar as configurações do VS Code não é mais descrito como um passo da primeira abertura. Se quiser fazer isso, pressione Cmd+Shift+J (Ctrl+Shift+J no Windows e Linux) para abrir Cursor Settings e vá em General > Account > VS Code Import > Import.

As extensões no Cursor vêm do Open VSX, não do VS Code Marketplace, e nem toda extensão está lá. Se alguma faltar depois da importação, esse é o motivo provável.

Confira a pessoa ou empresa que publicou antes de instalar qualquer coisa. Em 29 de outubro de 2026, o Cursor alertou sobre uma extensão maliciosa que se passava por Anthropic.claude-code (versões 2.1.312 e 2.1.313) no marketplace dele.

Conheça a interface

Duas janelas: Agents Window e o editor

O Cursor tem duas interfaces principais, e a documentação diz que ambas continuam suportadas. Você pode manter as duas abertas ao mesmo tempo.

	Agents Window	Editor (IDE)
Construída em torno de	Agentes	Seus arquivos
Boa para	Vários repositórios, agentes em paralelo, trabalho local, na nuvem e por SSH	Ler e editar código ao lado do Agent
Como chegar	Cmd+Shift+P, depois Open Agents Window	Cmd+Shift+P, depois Open IDE

No Windows e Linux, a paleta de comandos é Ctrl+Shift+P.

Alguns recursos existem só na Agents Window, incluindo múltiplos workspaces, a nova visualização de diff, agentes em nuvem em paralelo e a interface nativa de Worktrees.

No primeiro dia, use o editor. Você vê o arquivo e a conversa lado a lado, o que facilita acompanhar o que o Agent está fazendo.

O painel do Agent

No editor, pressione Cmd+I (Ctrl+I) para abrir o painel lateral. A documentação o chama de "Agent panel", e a tabela de atalhos o chama de "Sidepanel". São a mesma coisa.

Dentro do painel, você vai usar:

A caixa de entrada para o seu pedido. Arraste ou cole imagens nela, ou use o microfone para falar.
O menu de modos, que alterna entre Agent, Ask, Plan e Debug.
O seletor de modelos no topo da caixa de entrada.
@ para apontar algo específico e / para chamar skills e comandos.

A lista oficial atual de @ é curta: um arquivo ou pasta, como @index.html ou @src/components/, @Terminals, @Chats, @Commit (Diff of Working State), @Branch (Diff with Main) e @Browser. Se você não sabe qual arquivo importa, pule o @. A documentação diz que o Agent encontra os arquivos relevantes com a própria busca.

Tutoriais antigos ensinam @codebase, @docs e @web. Eles não estão na lista atual, e não conseguimos confirmar se ainda funcionam.

A barra lateral também tem uma página Customize, que reúne plugins, skills, MCP, subagentes, regras, comandos e hooks em um só lugar. Você vai usá-la mais tarde.

Termos que você precisa conhecer: o que os nomes significam agora

Muitos nomes do Cursor mudaram. Esta tabela mostra o que cada um significa hoje.

Termo	O que significa agora	Se um tutorial antigo disser
Composer	O modelo próprio do Cursor, atualmente Composer 2.5, descrito como rápido e econômico	"Modo Composer": não está mais na documentação, use o Agent
Agent	O modo padrão e a principal forma de trabalhar	"Mude para Agent no Composer": não é preciso mudar nada
Chat	Não é um modo separado. A documentação escreve "Agent (Chat)"	"Abra o Chat para fazer perguntas": use o Ask, o modo somente leitura
Inline Edit	Aposentado; veja abaixo	"Selecione o código e pressione Cmd+K para editar no lugar": selecione o código, pressione Cmd+K ou Cmd+L, e ele vai para o Agent
Tab	Autocompletar, nome inalterado	"Supermaven": a palavra não aparece na documentação oficial que lemos
Free	O plano de $0 para novos clientes	"Hobby": um plano legado mantido para quem já o tinha
Regra `.mdc`	O tipo de arquivo exigido para regras de projeto	"`.cursorrules`": legado e com descontinuação prevista

A página de ajuda do Cursor diz que o Cmd+K "used to open inline edit, which has been replaced by this workflow" (abria a edição inline, que foi substituída por este fluxo). Uma publicação da equipe do Cursor no fórum oficial dá a data, 26 de outubro de 2026, e diz que isso inclui gerar comandos com Cmd+K no terminal. A substituição sugerida é usar Cmd+I e pedir ao Agent. Uma página de ajuda sobre o terminal ainda menciona gerar comandos em linguagem natural, então a documentação não é totalmente consistente aqui. Este guia segue a publicação da equipe.

Atalhos para o primeiro dia

A tabela de referência do Cursor lista apenas teclas de Mac, e as páginas de ajuda acrescentam algumas de Windows e Linux. Quando nada está listado, dizemos isso em vez de adivinhar. Nesses casos, veja as configurações de atalhos no app (Cmd+R e depois Cmd+S, ou Ctrl+R e depois Ctrl+S).

Ação	Mac	Windows / Linux
Abrir ou fechar o painel do Agent	Cmd+I, Cmd+L ou Cmd+K	Ctrl+I, Ctrl+L ou Ctrl+K
Enviar o código selecionado para um novo chat	Cmd+L ou Cmd+K	Ctrl+L ou Ctrl+K
Adicionar o código selecionado ao chat atual	Cmd+Shift+L	Não listado, veja no app
Alternar entre modos	Shift+Tab	Shift+Tab
Abrir o menu de modos	Cmd+.	Ctrl+.
Alternar entre modelos	Cmd+/	Ctrl+/
Aceitar uma sugestão do Tab	Tab	Tab
Aceitar o Tab palavra por palavra	Cmd+→	Ctrl+→
Rejeitar uma sugestão do Tab	Escape, ou continue digitando	Escape, ou continue digitando
Aceitar todas as alterações	Cmd+Return	Não listado, veja no app
Rejeitar todas as alterações	Cmd+Shift+Backspace	Não listado, veja no app
Cursor Settings	Cmd+Shift+J	Ctrl+Shift+J
Paleta de comandos	Cmd+Shift+P	Ctrl+Shift+P

Duas teclas dependem de onde você está. Cmd+K abre o painel no editor, mas na Agents Window abre uma paleta de comandos. Cmd+Return também tem vários significados conforme o contexto, como mostra a referência de atalhos de teclado. Cmd+Shift+Backspace também aparece listado para cancelar uma resposta em andamento, então pressione com cuidado.

Primeira tarefa passo a passo: melhore um pequeno projeto com o Agent

Este exemplo usa uma única página web, então você não precisa de nada além do Cursor e de um navegador. Primeiro você faz perguntas, depois deixa o Agent fazer alterações.

Passo 1: criar o projeto de prática

Crie uma pasta vazia chamada cursor-practice e escolha essa pasta no Cursor. Crie um arquivo chamado index.html e cole isto:

<!doctype html>
<html>
  <head><meta charset="utf-8"><title>Tip calculator</title></head>
  <body>
    <h1>Tip calculator</h1>
    <label>Bill <input id="bill" type="number"></label>
    <button onclick="calculate()">Calculate 15% tip</button>
    <p id="result"></p>
    <script>
      function calculate() {
        const bill = Number(document.getElementById("bill").value);
        document.getElementById("result").textContent = "Tip: " + (bill * 0.15);
      }
    </script>
  </body>
</html>

Salve o arquivo e abra no navegador. Pressione o botão com a conta vazia e você verá "Tip: 0". Esse é o pequeno problema que você vai corrigir.

Passo 2: pergunte antes de mudar qualquer coisa

Pressione Cmd+I (Ctrl+I). Abra o menu de modos e escolha Ask, ou pressione Shift+Tab até ele aparecer. Digite:

Explain what index.html does in plain language.
Then list the problems a user could run into.

O que você deve ver: uma resposta escrita no painel. Seu arquivo não muda, porque o Ask é somente leitura. A resposta provavelmente vai mencionar a conta vazia. O texto exato varia entre execuções, então não espere uma resposta fixa.

Passo 3: dê ao Agent uma tarefa específica

Volte para o Agent. Trocar de modo abre uma nova janela de contexto, então escreva o pedido de forma que ele se sustente sozinho:

In @index.html, improve the tip calculator:
1. If the bill is empty, zero or negative, show "Enter a bill above 0".
2. Show the tip with two decimal places.
3. Add a dropdown for 10%, 15% and 20%, with 15% selected by default.
Keep everything in this one file. Do not add libraries.

O que você deve ver: o Agent lê o arquivo e começa a editar. O ponto importante para quem está começando é que as edições são aplicadas enquanto o Agent trabalha. Você não aprova cada alteração antes. Você revisa o resultado depois, em uma visualização de diff.

O Agent também pode querer executar um comando. Como isso é tratado depende do modo de execução, definido em Cursor Settings > Agents > Approvals & Execution. As opções são Auto-review (o padrão), Allowlist e Run Everything. Por enquanto, deixe no padrão.

Passo 4: revise o diff

O Cursor mostra as edições em uma visualização de diff. A documentação não dá o nome exato do botão, então procure perto do arquivo editado e do painel do Agent. Leia linha por linha. Um diff mostra linhas removidas e adicionadas, então você vê exatamente o que mudou. Nesta tarefa, procure:

uma verificação do valor da conta
um menu com três porcentagens
uma gorjeta arredondada para duas casas decimais
nada sem relação com o pedido, como um arquivo novo que você não solicitou

Rejeite o que não quiser. Para aceitar ou rejeitar tudo de uma vez no Mac, use Cmd+Return ou Cmd+Shift+Backspace. No Windows e Linux, veja no app, como dito acima.

Passo 5: teste por conta própria

Recarregue a página no navegador e tente estes casos:

Entrada	Resultado esperado
Conta vazia	A mensagem "Enter a bill above 0"
-5	A mesma mensagem
100 com 15%	Tip: 15.00, ou parecido
100 com 20%	Tip: 20.00, ou parecido

Se algum falhar, diga ao Agent exatamente o que aconteceu: "Com uma conta de -5, a página mostra Tip: -0.75. Ela deveria mostrar a mensagem." Isso funciona muito melhor do que "está quebrado".

Passo 6: pratique desfazer

Agora faça uma alteração que você pretende jogar fora:

Change the page background to bright green and make all text 40px.

Recarregue o navegador para ver. Depois role a conversa para cima e clique em Restore Checkpoint nesse pedido. Uma página de ajuda chama esse botão de Revert. Recarregue de novo e o verde deve ter sumido. Se não sumiu, restaure a partir do pedido anterior. O Agent cria checkpoints antes de alterações significativas, então, se não aparecer botão para uma alteração tão pequena, rejeite-a no diff. Suas mensagens continuam na conversa, porque uma restauração só reverte arquivos.

Esse é todo o ciclo diário: perguntar, instruir, revisar, testar e desfazer se preciso. Se ler diffs é a parte que você nunca quer fazer, é útil descobrir isso cedo. Pode ser um sinal de que o NxCode, nosso próprio criador de apps, serve melhor para você do que um editor.

Quando usar Agent, Ask, Plan e Debug

Existem quatro modos. Alterne com Shift+Tab ou pelo menu no painel do Agent.

Modo	Use quando	Pode alterar arquivos?	Exemplo de prompt
Agent	Você quer construir, refatorar ou corrigir algo. Este é o padrão	Sim	"Adicione um botão de limpar e apague o resultado quando ele for pressionado."
Ask	Você quer entender o código	Não, somente leitura	"Como a gorjeta é calculada aqui?"
Plan	A tarefa é grande ou pouco clara e você quer verificar a abordagem antes	Depois da sua aprovação	"Planeje como dividir esta página em arquivos HTML, CSS e JS separados."
Debug	Um bug precisa de evidências do programa em execução	Sim	"A gorjeta fica errada depois que mudo a porcentagem. Encontre a causa."

Um jeito simples de escolher:

Ainda não entendeu? Ask.
Sabe o que quer e a alteração é pequena? Agent.
Mexe em muitos arquivos, ou você não tem certeza da abordagem? Plan.
Um bug que você não consegue explicar lendo o código? Debug.

No modo Plan, o Agent faz perguntas de esclarecimento, pesquisa seu código e escreve um plano. Nada é construído até você clicar em Build. Por padrão, os planos são salvos no seu diretório pessoal, e Save to workspace move um plano para o projeto. O Cursor também pode sugerir o Plan quando seu pedido parecer complexo.

No modo Debug, o Agent forma hipóteses, adiciona logs e usa as informações de execução para encontrar a causa.

Revisar e desfazer alterações

Checklist de revisão

Use isto antes de manter qualquer alteração do Agent:

Leia o diff inteiro, não só o resumo.
Todo arquivo alterado tem relação com a tarefa.
Você consegue explicar cada alteração. Se não conseguir, pergunte no modo Ask.
Nada que deveria ficar foi apagado.
Nenhuma senha, chave ou outro segredo aparece no código.
Você testou por conta própria, incluindo uma entrada inválida.

Além da sua revisão, o Cursor tem o Agent Review, iniciado com /agent-review ou pela aba Source Control.

Como os checkpoints funcionam

O Agent cria um checkpoint automaticamente antes de alterações significativas. Os checkpoints são armazenados localmente e são separados do Git.

Há três formas de restaurar:

Clique em um checkpoint na linha do tempo do chat para pré-visualizar e depois restaure.
Clique em Restore Checkpoint em um pedido anterior.
Passe o mouse sobre uma mensagem e clique no botão +.

Restaurar reverte arquivos, mas não apaga mensagens. Para encurtar a conversa também, crie um fork a partir de uma mensagem anterior.

As páginas oficiais divergem em um nome aqui. A documentação do Agent chama o botão de Restore Checkpoint, enquanto a página de ajuda do Plan o chama de Revert, seguido de Confirm. Procure qualquer um dos dois rótulos.

Use o Git para tudo o que você quer manter

O conselho do próprio Cursor é "use Git for permanent version control" (usar o Git para controle de versão permanente). Checkpoints são um desfazer rápido, e o Git é o seu histórico de longo prazo. Antes de uma tarefa maior do Agent, salve um estado que funciona:

git init
git add .
git commit -m "Working version before Agent task"

Você só precisa de git init uma vez por projeto.

Adicione regras ao seu projeto

Regras são instruções permanentes, para você não ter que se repetir. Adicione uma ao projeto de prática. Há três formas de criar uma regra de projeto:

Digite /create-rule no chat.
Vá em Customize > Rules > Add Rule.
Execute New Cursor Rule pela paleta de comandos.

Ou crie o arquivo por conta própria em .cursor/rules/practice.mdc:

---
description: Conventions for this practice project
globs:
alwaysApply: true
---

- Keep everything in index.html unless asked otherwise.
- Do not add libraries.
- Use clear variable names and short comments.

Agora peça ao Agent outra pequena alteração. Ele deve seguir essas regras sem que você precise dizer.

Quatro pontos para saber:

A extensão precisa ser .mdc. Arquivos terminados em .md são ignorados pelo sistema de regras nessa pasta.
AGENTS.md é a opção mais simples. É Markdown puro, colocado na raiz do projeto ou em uma subpasta. O Cursor lê CLAUDE.md da mesma forma.
As regras valem só para o Agent. Não afetam o Tab nem o Bugbot.
Mantenha curtas. O Cursor sugere menos de 500 linhas por regra.

As regras têm quatro tipos: Always Apply, Apply Intelligently, Apply to Specific Files e Apply Manually (com uma menção @). A precedência é Team, depois Project, depois User. .cursorrules é legado e será descontinuado, então não comece um projeto novo com ele.

MCP, Skills, subagentes e Cloud Agents em resumo

Você não precisa de nada disso no primeiro dia. É só para reconhecer os nomes.

MCP conecta o Agent a ferramentas e serviços externos. Instale por Customize > MCPs > Add to Cursor ou configure .cursor/mcp.json em um projeto ou ~/.cursor/mcp.json globalmente. Se os dois definirem o mesmo nome, o do projeto vence. Nosso guia de MCP no Cursor vai mais fundo.
Skills são pastas com um arquivo SKILL.md que ensinam um procedimento ao Agent. O Agent as usa quando são relevantes, ou você chama uma com /. Exemplos integrados incluem /create-rule, /review e /shell.
Subagentes têm contexto próprio e podem rodar em paralelo. Os integrados são Explore e Browser. Os personalizados ficam em .cursor/agents/.
Cloud Agents rodam em máquinas isoladas na nuvem, então não dependem de o seu computador ficar online. Escolha Cloud no menu da caixa de entrada do agente. Alguém com papel de admin precisa conectar GitHub, GitLab, Bitbucket ou Azure DevOps antes, e você precisa de acesso de leitura e escrita ao repositório. Não estão disponíveis no Free nem no Plus.

A linha de comando: `agent`

O Cursor também tem uma CLI, e o comando é agent. Instale com:

# macOS, Linux, WSL
curl https://cursor.com/install -fsS | bash

# Windows PowerShell
irm 'https://cursor.com/install?win32=true' | iex

Verifique com agent --version e faça login com agent login. Depois rode agent em uma pasta de projeto para uma sessão interativa, ou agent -p "your request" para uma única execução não interativa. Ela lê os mesmos arquivos .cursor/rules, AGENTS.md e CLAUDE.md que o editor. Quem está começando pode deixar isso para depois.

Erros comuns

Seguir um tutorial antigo. Se um guia manda abrir o modo Composer, pressionar Cmd+K para editar no lugar ou escolher um modelo na primeira abertura, ele descreve um Cursor mais antigo.

Achar que nada mudou até você aceitar. As edições do Agent já são aplicadas enquanto ele trabalha. Confira o diff antes de seguir em frente e não execute o código só na confiança.

Escrever pedidos vagos. "Corrija isto" dá pouco material ao Agent. Diga o que acontece, o que deveria acontecer e onde: "Quando a conta está vazia, a página mostra Tip: 0. Ela deveria mostrar uma mensagem."

Começar grande demais. Não comece com um app completo. Use tarefas pequenas primeiro e o modo Plan para qualquer coisa maior.

Tratar checkpoints como backups. Eles são locais e separados do Git. Faça commit de tudo o que for importante para você.

Salvar uma regra como .md. Parece correto e não faz nada. Use .mdc, ou AGENTS.md na raiz do projeto.

Mudar o modo de execução no primeiro dia. Deixe o padrão até entender o que o Agent executa no seu computador e qual permissão cada opção concede.

Escolher um modelo de terceiros sem checar o custo. No Premium e acima, modelos de terceiros cobram créditos pré-pagos pelo preço de tabela da API desde a primeira requisição. Eles não usam sua cota semanal.

Aceitar código que você não sabe explicar. O modo Ask existe para isso. Pergunte "o que esta alteração faz, passo a passo?" antes de mantê-la.

Solução de problemas

Interface e configuração

O que você vê	Motivo provável	O que fazer
Nenhum modo Composer em lugar algum	Ele não existe mais como modo	Use o Agent com Cmd+I (Ctrl+I)
Cmd+K não edita no lugar	O Inline Edit foi aposentado	Selecione o código, pressione Cmd+K e descreva a alteração no Agent
Cmd+K abre uma paleta de comandos	Você está na Agents Window	Use Cmd+Shift+P e depois Open IDE para voltar ao editor
Aparece uma página de login Grok ou xAI	Login compartilhado	Isso é esperado. Fazer login não mescla contas
Falta uma extensão	Ela pode não estar no Open VSX	Procure uma alternativa no Open VSX
Uma regra é ignorada	Extensão ou local errado	Use `.cursor/rules/name.mdc` e verifique o tipo dela
O Agent esquece o contexto anterior	Você trocou de modo	Cada troca abre uma nova janela de contexto, então repita os pontos principais
Um atalho não faz nada no Windows	Pode ser diferente da tecla do Mac	Veja as configurações de atalhos com Ctrl+R e depois Ctrl+S

Modelos, planos e a CLI

O que você vê	Motivo provável	O que fazer
Claude ou GPT não aparece	Plano ou região	Free e Plus excluem modelos de terceiros. Alguns modelos também ficam ocultos em certas regiões
Cloud Agents indisponíveis	Plano ou configuração do repositório	Exige Premium ou acima, um provedor Git conectado e acesso ao repositório
Você atingiu um limite de uso	Limite do plano alcançado	Veja Usage em grok.com/dashboard. Em planos pagos, espere o reset semanal, use créditos pré-pagos ou faça upgrade
Não encontra a cobrança	A cobrança mudou de lugar	The X Subscription usa grok.com/dashboard/billing. Planos legados usam cursor.com/dashboard/spending
`agent: command not found`	`~/.local/bin` não está no seu PATH	Adicione ao PATH e abra um novo terminal

Quando usar outra ferramenta

O Cursor é uma ferramenta para trabalhar com código. Estes cenários podem apontar para outro caminho:

Você não quer escrever nem revisar código. Você quer um app funcionando a partir de uma descrição. É para isso que serve o NxCode, nosso próprio produto. Nós o fazemos, então leve isso em conta ao ler, e veja nossa comparação com Cursor e Copilot.
Você vive no terminal. Experimente primeiro o comando agent do Cursor ou compare com o fluxo do nosso tutorial de Claude Code.
Você usa JetBrains. Talvez nem precise trocar de editor, porque o agente do Cursor se conecta ao JetBrains por ACP.
Você ainda está comparando ferramentas. Nosso ranking de ferramentas de programação com IA apresenta as opções.

Experimentar o Cursor no Free não custa nada, então uma pequena tarefa real é uma forma razoável de decidir. Se o fluxo acima pareceu natural, fique. Se o próprio código atrapalhou, o primeiro cenário provavelmente é o seu.

Perguntas frequentes

Como começar a usar o Cursor pela primeira vez?

Baixe o Cursor em cursor.com/download, abra o programa, faça login e escolha uma pasta. Depois pressione Cmd+I (Ctrl+I no Windows e Linux) para abrir o Agent e peça que ele explique o código. O quickstart do Cursor recomenda começar com uma tarefa pequena como essa.

O que aconteceu com o modo Composer no Cursor?

O modo Composer não está na documentação atual do Cursor. Composer agora é o nome do modelo próprio do Cursor, atualmente Composer 2.5. Os quatro modos são Agent, Ask, Plan e Debug. Para o trabalho em vários arquivos que tutoriais antigos faziam no modo Composer, use o Agent.

O que aconteceu com a edição inline do Cmd+K no Cursor?

O Inline Edit foi aposentado. Uma publicação da equipe do Cursor no fórum oficial data isso de 26 de outubro de 2026. No editor, selecione o código e pressione Cmd+K ou Cmd+L (Ctrl+K ou Ctrl+L no Windows e Linux) para levar a seleção ao Agent e descreva a alteração ali.

O Cursor é grátis?

Sim, existe um plano Free de $0 com uso limitado de Agent, Chat e Tab. O Cursor não publica um número para esses limites. A página de preços atual não diz se é preciso cartão de crédito, então confira ao se cadastrar. Os planos pagos começam no Plus, por $8 por mês sem impostos.

Quais modelos de IA posso usar no Cursor?

Os modelos do próprio Cursor são Grok 4.7, que ele chama de modelo principal, Grok 4.6, Grok 4.5 e Composer 2.5. Modelos de terceiros, como Claude, GPT e Gemini, exigem Premium ou acima e são cobrados pelo preço de tabela da API, com créditos pré-pagos. Free e Plus não os incluem.

O Agent do Cursor altera meus arquivos antes de eu aprovar?

Sim. O Agent aplica as edições enquanto trabalha, e você as revisa depois em uma visualização de diff, onde pode rejeitar o que não quiser. O Agent também cria checkpoints antes de alterações significativas, então você pode restaurar estados anteriores dos arquivos.

Preciso saber programar para usar o Cursor?

Dá para experimentar sem muita experiência, porque o modo Ask explica o código em linguagem simples, mas você ainda precisa ler diffs e julgar o resultado. Se você prefere descrever um app e não mexer com código, o NxCode, nosso próprio produto, foi feito para isso.

Onde posso comprar o Cursor, e dá para assinar da China continental?

O Cursor diz que as assinaturas são vendidas apenas pelo site oficial ou por compra dentro do app, e que não autoriza revendas. A compra no app iOS cobre as regiões da App Store, exceto a China continental. Não foi possível verificar nas páginas oficiais se as assinaturas pela web têm restrição na China continental.

Fontes

Todas as páginas foram verificadas em 1º de novembro de 2026. Atalhos, planos e nomes podem mudar, então trate o app e as páginas oficiais como a palavra final.