Claude Code no Cursor: guia de configuração e fluxo de trabalho

O Cursor já vem com seu próprio agente de IA. Ele consegue editar arquivos, executar comandos e atuar em todo o seu codebase. Então por que instalar um segundo agente no mesmo editor?

O Claude Code é a ferramenta de codificação agentic da Anthropic: ele lê seu codebase, planeja mudanças, edita arquivos, executa testes e te entrega um diff para revisar. A extensão para VS Code traz esse fluxo para o Cursor, que é construído sobre a mesma base do VS Code. O resultado são dois sistemas de IA separados na mesma janela, cada um com seu próprio contexto, sua própria cobrança e seu próprio jeito de trabalhar. Se isso é útil ou não depende do que você está construindo.

Antes de seguir: “Claude Code no Cursor” hoje pode significar duas coisas diferentes. Existe a extensão do Claude Code (o foco deste artigo) e existe a opção de selecionar modelos Claude pelo seletor nativo de modelos do Cursor (um produto totalmente separado que só usa o Claude como backend). Vou voltar a essa diferença em uma seção própria. Se o que você quer é um comparativo direto entre as duas ferramentas como produtos independentes, temos um artigo separado Claude Code vs. Cursor para isso.

O que é o Claude Code no Cursor?

O Claude Code é a ferramenta agentic de codificação da Anthropic. Ele lê codebases, edita arquivos, executa comandos no terminal, gerencia fluxos de trabalho com git e se conecta a serviços externos via MCP (Model Context Protocol). Está disponível como CLI, extensão para VS Code, app desktop e na web.

O Cursor é construído em um ambiente derivado do VS Code, e a extensão do Claude Code para VS Code é oficialmente suportada nele. A documentação da Anthropic lista “Install for Cursor” como um caminho de instalação direto, separado da instalação padrão do VS Code. Não é um improviso da comunidade.

Dois fluxos de IA em um único editor. Imagem do autor.

Aqui está o que costuma confundir: quando alguém diz “Claude Code no Cursor”, pode estar falando de rodar a própria extensão ou CLI do Claude Code dentro do Cursor, o que te dá todo o fluxo agentic da Anthropic com painel próprio, modelo de permissões e histórico de sessão. Ou pode estar falando de usar modelos Claude como backend da IA nativa do Cursor. São relacionados, mas não são o mesmo produto e não se comportam da mesma forma.

Claude Code vs. modelos Claude no Cursor

Veja o que cada um realmente significa.

Modelos Claude no Cursor

O Cursor tem um seletor de modelos que permite escolher entre Claude Sonnet, Claude Opus, GPT, Gemini e outros. No modo “auto”, o Cursor seleciona o modelo automaticamente. Ao usar o Claude Sonnet no chat ou no modo agente do Cursor, você está usando o produto Cursor: sua UX, sua cobrança, seu gerenciamento de contexto. O modelo é o Claude, mas a experiência é do Cursor.

Claude Code no Cursor

Instalar a extensão do Claude Code no Cursor te dá um painel próprio, uma janela de contexto própria e a cobrança atrelada à sua assinatura Anthropic ou à sua chave de API. Os dois podem rodar na mesma janela do editor, mas não compartilham contexto. O Claude Code não tem noção do que o agente nativo do Cursor está fazendo.

Selecionar “Claude Sonnet” no seletor de modelos do Cursor não é a mesma coisa que instalar o Claude Code. Se você quer o fluxo de planejar e executar do Claude Code e a memória de projeto CLAUDE.md, precisa da extensão ou da CLI. Uma frase comum na comunidade de desenvolvedores resume bem a diferença: “O Cursor é um IDE com recursos de IA. O Claude Code é um agente de IA com acesso ao IDE.”

Como configurar o Claude Code no Cursor

Configurar o Claude Code no Cursor envolve três caminhos, e o ideal depende do seu cenário.

Antes de tudo: o Claude Code exige um plano pago da Anthropic. O nível gratuito no Claude.ai não inclui a ferramenta. O mínimo é o plano Pro por US$ 20 por mês. Você também vai precisar do Cursor rodando na engine do VS Code versão 1.98.0 ou superior.

Os três caminhos são:

• Caminho 1: a extensão do VS Code (oficial, recomendada para a maioria dos desenvolvedores)
• Caminho 2: o terminal integrado (menos atrito se o Claude Code já estiver instalado)
• Caminho 3: servidor MCP (avançado, para times ou ambientes com múltiplas ferramentas)

Se o Claude Code já está instalado na sua máquina, pule direto para o Caminho 2.

Caminho 1: a extensão do VS Code (recomendado)

Abra o painel de Extensões do Cursor com Cmd+Shift+X no Mac ou Ctrl+Shift+X no Windows e Linux. Busque por “Claude Code” e instale a extensão publicada pela Anthropic. O ID da extensão é anthropic.claude-code.

Buscando o Claude Code no Cursor. Imagem do autor.

Um aviso importante: às vezes a extensão não aparece na busca do marketplace do Cursor. Acontece com frequência suficiente para você se preparar. Se não aparecer, a documentação do VS Code da Anthropic tem um botão “Install for Cursor” que aciona diretamente o URI cursor:extension/anthropic.claude-code. Se isso também falhar, a mesma página traz instruções para instalação manual via VSIX.

Depois de instalada, um ícone de faísca aparece na barra de ferramentas do editor quando há um arquivo aberto, não apenas uma pasta. Ele também aparece na Barra de Atividades na lateral esquerda e na Barra de Status no canto inferior direito, ambos visíveis sem um arquivo aberto. Clique em qualquer um deles e depois em Sign in na primeira sessão para autenticar pelo navegador.

Alguns pontos para checar se algo parecer estranho:

• Se o ícone não aparecer após a instalação, rode “Developer: Reload Window” pela Paleta de Comandos

• Se você tem ANTHROPIC_API_KEY no seu shell mas ainda vê o prompt de login, inicie o Cursor a partir de um terminal com cursor . para herdar o ambiente

Caminho 2: o terminal integrado (menos atrito)

Se o Claude Code já está instalado na sua máquina, pule a extensão. Abra o terminal integrado do Cursor com `Ctrl+`` e digite claude`. O Claude Code roda uma sessão interativa no terminal enquanto o editor fica aberto ao lado. Isso evita totalmente problemas de compatibilidade de extensão.

Se o Claude Code ainda não estiver instalado, o instalador nativo é o método recomendado. Ele é autocontido, não exige Node.js e atualiza automaticamente em segundo plano:

# macOS, Linux, ou WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell (requer Git for Windows)
irm https://claude.ai/install.ps1 | iex

O método via npm (npm install -g @anthropic-ai/claude-code) ainda funciona, mas hoje é legado.

Caminho 3: servidor MCP (avançado)

Se você está configurando para uso pessoal, pode pular.

Para times que montam ambientes MCP com várias ferramentas, você pode rodar o Claude Code como um servidor MCP local e conectá-lo pelas configurações MCP do Cursor adicionando isto ao seu mcp.json:

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "claude",
      "args": ["--mcp"]
    }
  }
}

Isso expõe as ferramentas do Claude Code ao lado de quaisquer outros servidores MCP que você configurou. Funciona com o Cursor. A maioria dos desenvolvedores individuais não vai precisar disso.

O que você pode fazer com o Claude Code no Cursor

O Claude Code cobre um leque maior de tarefas do que muita gente espera de uma ferramenta baseada em chat. Veja o que você tem dentro do Cursor:

• Explicar código desconhecido ou legado lendo diretamente os arquivos relevantes
• Planejar e implementar recursos em vários arquivos, com uma etapa de revisão antes de qualquer mudança
• Depurar a partir de mensagens de erro ou stack traces, rastreando o problema no codebase
• Gerar testes, executá-los e corrigir falhas até passarem
• Fazer staging das mudanças, escrever mensagens de commit, criar branches e abrir pull requests

A sintaxe de menção com @ vale a pena conhecer. Digite @ seguido do nome de um arquivo ou pasta para trazê-lo ao contexto. O Claude Code aceita fuzzy matching, então nomes parciais funcionam. Se você selecionar código no editor, o Claude vê automaticamente.