Cursor é um editor baseado em VS Code que integra modelos de IA diretamente no fluxo de desenvolvimento. Claude, o modelo da Anthropic, é um dos provedores que Cursor oferece nativamente — e para muita gente, o que melhor funciona escrevendo e refatorando código.
Este guia cobre como configurá-lo, o que mudou nos últimos meses, e a pergunta que quase todo mundo faz antes de se decidir.
Cursor ou Claude Code? Qual convém?
É a dúvida mais comum, e a resposta curta é que não competem tanto quanto parece.
Cursor é um editor. Você tem o código à vista, autocompletar enquanto escreve, e um agente que trabalha sobre os arquivos abertos. O contexto visual é o ponto forte: você vê exatamente o que está mudando, linha por linha.
Claude Code é um agente de terminal. Não tem editor próprio — roda no seu shell, sobre o repositório completo. É mais forte em tarefas longas e autônomas: migrações, refatorações que tocam vinte arquivos, trabalho que você não quer supervisionar passo a passo.
Na prática, muitos desenvolvedores usam os dois: Cursor para o trabalho do dia a dia onde você quer ver o diff, Claude Code para as tarefas grandes que você lança e revisa ao final. Não precisa escolher.
Se você já tem uma inscrição no Claude, também pode usar Claude Code dentro do terminal integrado do Cursor. É a combinação que mais gente termina adotando.
Quais modelos do Claude estão disponíveis no Cursor?
Cursor incorpora os modelos da Anthropic conforme saem. Até o momento o catálogo inclui:
- Claude Opus 5 — o mais capaz, para arquitetura e problemas difíceis
- Claude Sonnet 5 — o equilíbrio entre capacidade e velocidade; a opção padrão para a maioria do trabalho
- Claude Fable 5
- Claude 4.5 Haiku — o mais rápido e econômico, para tarefas mecânicas
Atenção: vários desses modelos estão ocultos por padrão no seletor. Se você não vê o que está procurando, ative-o na configuração de modelos antes de assumir que não está disponível.
Se você vem de guias antigos: os identificadores tipo claude-3-sonnet-20240229 já não existem. Os modelos com data no nome são retirados, e uma configuração que os referencia retorna um erro 404. Sempre use o seletor do Cursor em vez de escrever o ID manualmente.
Preciso de uma chave de API da Anthropic?
Não. E este é o ponto onde mais guias desatualizadas confundem as pessoas.
Com uma inscrição no Cursor, os modelos do Claude vêm inclusos. Você escolhe o modelo no seletor e pronto — não há chave de API, não há configuração adicional, não há cobrança separada com a Anthropic.
A chave de API própria é uma opção, não um requisito. Serve se você já tem créditos na Anthropic que quer aproveitar, ou se sua organização exige cobrar o consumo por sua própria conta.
Como configurar sua própria chave de API da Anthropic?
- Crie a chave em console.anthropic.com → seção API Keys
- No Cursor, abra Cursor Settings → Models
- Procure por Anthropic, cole a chave e clique em Save
Importante: a chave é exibida apenas uma vez ao ser criada. Guarde-a em um gerenciador de senhas, nunca em um arquivo do repositório.
As três limitações que vale a pena saber antes
Usar sua própria chave tem consequências que não são óbvias:
- A política de Retenção Zero de Dados do Cursor deixa de se aplicar. Seus dados passam a ser regidos pela política de privacidade da Anthropic. Se você escolheu Cursor pelo seu gerenciamento de dados, isso muda.
- O autocompletar (Tab) continua usando os modelos próprios do Cursor. A chave personalizada afeta apenas o chat e o agente. Tab não é configurável.
- A chave viaja em cada solicitação através dos servidores do Cursor sobre conexões criptografadas, embora não seja armazenada de forma permanente lá.
Como usar o Claude dentro do Cursor?
A interface mudou bastante em relação às versões de 2024. Os atalhos atuais:
| Atalho | O que faz |
|---|---|
Tab |
Aceita a sugestão de autocompletar |
Cmd/Ctrl + I |
Abre o Agente no painel lateral |
Cmd/Ctrl + E |
Mostra ou oculta o layout do agente |
Cmd/Ctrl + K |
Edição inline — seleciona código e descreve a mudança |
Cmd/Ctrl + . |
Menu de modos (Agente, Plano, etc.) |
Cmd/Ctrl + Shift + L |
Adiciona o código selecionado ao contexto |
Cmd/Ctrl + N |
Chat novo |
Todos os atalhos são personalizáveis na configuração de teclado.
O modo Plano
Vale a pena conhecê-lo porque é o mais útil que foi adicionado recentemente. Em vez de escrever código imediatamente, o modo Plano faz perguntas, investiga o repositório e gera um plano de implementação que você pode revisar e editar antes que uma única linha seja escrita.
Serve para funcionalidades complexas, mudanças que tocam vários arquivos, requisitos ambíguos, e decisões de arquitetura onde você quer avaliar a estratégia primeiro. Para mudanças rápidas, o modo Agente normal é suficiente.
O “modo Composer” que as guias antigas mencionam foi absorvido dentro do Agente. Se você está procurando Composer e não consegue encontrar, não está quebrado — mudou de nome.
Como dar instruções permanentes ao Claude?
Repetir “use TypeScript estrito” em cada conversa é uma perda de tempo. Cursor tem dois mecanismos para que as instruções persistam.
Regras de projeto (.cursor/rules)
São arquivos .mdc com frontmatter YAML dentro de .cursor/rules/:
---
description: Convenções de componentes React
globs: ["src/components/**/*.tsx"]
alwaysApply: false
---
Use componentes de função com hooks, nunca classes.
Os props são tipados com interfaces, não com `type`.
Cada componente exportado traz seu teste ao lado.
O campo globs limita a regra aos arquivos que correspondem. Com alwaysApply: true, a regra se aplica a todo o projeto.
O erro mais frequente: a extensão tem que ser .mdc. Um arquivo .md dentro de .cursor/rules/ é ignorado silenciosamente — sem aviso, sem erro. É a causa número um de “configurei as regras e nada acontece”.
.cursor/rules/
react-patterns.mdc # ✅ é reconhecido
api-guidelines.md # ❌ é ignorado — extensão incorreta
frontend/
components.mdc # ✅ podem ser organizados em pastas
AGENTS.md
Se você não precisa de regras condicionais, um AGENTS.md na raiz do projeto é suficiente: markdown plano, sem metadados ou configuração. Cursor o lê da mesma forma.
Se você também usa Claude Code, a CLI do Cursor detecta também os arquivos CLAUDE.md na raiz, então ambas as ferramentas podem compartilhar o mesmo contexto.
O arquivo
.cursorrulesdas versões antigas ficou obsoleto. Se você ainda tem um, migre-o para.cursor/rules/.
Como controlar o que o modelo vê?
Dois arquivos, com propósitos distintos:
.cursorignore— exclui arquivos completamente. O Agente, Tab, a edição inline e as menções@não podem acessá-los. Aqui vão segredos,.env, credenciais..cursorindexingignore— exclui apenas do índice de busca. Os arquivos continuam acessíveis para a IA, mas não aparecem nas buscas do repositório. Aqui vão arquivos gerados, dependências vendorizadas, builds.
Ambos usam a sintaxe de .gitignore. Cursor já ignora por padrão o que está no seu .gitignore.
Uma limitação que surpreende: os padrões de negação (!) não podem incluir novamente arquivos dentro de uma pasta que você excluiu com *. É preciso excluir explicitamente as subpastas primeiro e depois designorar o arquivo pontual.
Como escrever melhores prompts?
A diferença entre um resultado útil e um inservível quase sempre está no prompt.
Seja específico sobre o resultado, não sobre o sintoma:
✅ "Converta esta função para async/await e adicione tratamento de erros
com try/catch, propagando o erro original"
❌ "Arrume isto"
```**Ancore o pedido em código que já existe:**
```markdown
✅ "Com base no padrão de `utils/validate.js`, crie uma função
equivalente em `helpers/format.js`"
Mencionar arquivos concretos e usar os nomes de funções e variáveis que já estão no projeto dá ao modelo muito mais do que qualquer descrição abstrata.
Peça o plano antes do código quando a mudança é grande. É literalmente para isso que existe o modo Plan.
Solução de Problemas
O modelo que quero não aparece no seletor. Está oculto por padrão. Ative-o nas configurações de modelos.
Erro de API key. Verifique se você tem créditos disponíveis na sua conta Anthropic — uma key válida sem saldo falha da mesma forma. Se persistir, regenere a key.
Configurei regras e nada muda. Verifique a extensão: tem que ser .mdc, não .md.
O agente não vê um arquivo. Veja se está alcançado por .cursorignore — ou por seu .gitignore, que Cursor respeita por padrão.
Respostas lentas. Tente Haiku para tarefas mecânicas e reserve Opus para o difícil. Um contexto menor também ajuda.
Conclusão
A combinação de Cursor e Claude mudou bastante no último ano: os modelos com data no nome desapareceram, .cursorrules ficou obsoleto, Composer foi absorvido dentro do Agent, e a API key própria passou de requisito a opção.
O que não mudou é o importante: a IA potencia seu critério, não o substitui. Revise e entenda o código gerado antes de mandá-lo para produção.
Você usa Cursor, Claude Code, ou os dois? Que regras tem em seu .cursor/rules? Conte-nos nos comentários 