Guia de campo do Claude Code em português

Claude Code no VS Code e no Cursor: extensão, terminal ou os dois

“Claude Code ou Cursor?” é uma pergunta comum, mas os dois não disputam o mesmo lugar: o Cursor é um editor, derivado do VS Code, e o Claude Code roda dentro dele pela mesma extensão do VS Code (p. 11). Abaixo, as três formas de usar o Claude Code no editor, o que cada uma exige e os dois tropeços que mais aparecem.

O motor é um só

O Claude Code roda no terminal, no app Desktop, nas extensões de editor, na web e no celular, e o motor é o mesmo em toda parte; muda onde o trabalho acontece e o que ele enxerga (p. 11). Na sua máquina, todas as telas leem a mesma configuração: no seu usuário, a pasta ~\.claude\ e o arquivo ~\.claude.json, onde ficam os servidores MCP; no projeto, a .claude\, o CLAUDE.md e o .mcp.json. O que você ajusta no terminal vale no Desktop e no editor.

OndePara quêO que precisa
TerminalTudo; o único com claude -p para scriptsO instalador nativo (p. 8)
VS CodeTrabalhar sem sair do editor, com diff no próprio arquivoExtensão "Claude Code", VS Code 1.94 ou mais novo
Cursor e outros derivadosO mesmo, no editor que você já usaA mesma extensão do VS Code
JetBrainsIntelliJ, PyCharm, WebStorm e afinsPlugin do JetBrains Marketplace e a CLI instalada

A tabela resume a da página 11 do guia, conferida na documentação oficial (code.claude.com/docs/en/platforms e /en/vs-code) em 15/10/2026.

1. A extensão

No VS Code ou no Cursor, abra o painel de extensões, procure "Claude Code" e instale. A extensão abre a conversa num painel do editor e mostra cada alteração como diff no próprio arquivo, para você aceitar ou recusar. Ela usa a mesma conta: na primeira vez, o login abre no navegador, como no terminal (p. 10). Lembre que o plano gratuito do claude.ai não inclui o Claude Code; o login precisa de Pro, Max, Team, Enterprise ou da conta da API.

2. O terminal do editor

Muita gente prefere rodar claude no terminal integrado do editor. Aqui está a pegadinha: a extensão traz uma cópia própria da CLI, que não entra no PATH (p. 11). Instalar a extensão não faz o comando claude existir no terminal. Para isso, faça também a instalação nativa, no PowerShell, sem ser administrador:

PowerShell

irm https://claude.ai/install.ps1 | iex

O executável vai para %USERPROFILE%\.local\bin\claude.exe (p. 8). Depois, feche e reabra o editor inteiro, não só o terminal: o terminal do editor herda o PATH do editor, que foi lido quando ele abriu (p. 9).

3. Os dois juntos

Não há conflito em ter a extensão e a CLI. Como as duas leem a mesma configuração, uma permissão liberada no terminal, uma skill ou um servidor MCP valem nas duas. Um uso comum: a extensão para revisar diffs enquanto edita, e o terminal para o que só ele faz, como claude -p em script e o atalho ! para rodar um comando do shell.

Os dois tropeços mais comuns

"claude não é reconhecido" no terminal do Cursor ou do VS Code

É o PATH. Ou só a extensão está instalada (a cópia dela não entra no PATH), ou o editor foi aberto antes da instalação. Confira em duas linhas, num terminal novo:

PowerShell

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
$env:PATH -split ';' | Select-String '\.local\\bin'

A primeira deve responder True; a segunda, imprimir a pasta. O passo a passo completo está no artigo sobre o erro "não é reconhecido", ao lado.

A cobrança foi para a API em vez do plano

Se existe uma ANTHROPIC_API_KEY no ambiente e você aprovou o uso dela, ela passa na frente da assinatura, no terminal e no editor (p. 10). /status mostra qual credencial está em uso.

Então, Claude Code ou Cursor?

A escolha real é de editor e de assinatura, não de um contra o outro. Quem já usa o Cursor pode continuar nele e rodar o Claude Code pela extensão ou pelo terminal integrado; o que o Claude Code faz depende da assinatura da Anthropic e da configuração em .claude\, não do editor. Quem não programa e quer resolver tarefas de escritório não precisa de editor nenhum: o terminal ou o app Desktop bastam para as 22 receitas do capítulo 13.

Leia também