Extensão do Claude Code: o que ela faz dentro do editor e quando vale a pena usar?

Pedir código pra um assistente que não enxerga o teu projeto é uma coisa

ter o Claude Code morando dentro do editor, com o diff piscando na tua frente antes de você aceitar, é outra história completamente diferente

Existe uma extensão oficial da Anthropic publicada no Marketplace do VS Code, a Claude Code for VS Code, com o identificador anthropic.claude-code

E existe também um plugin dedicado pras IDEs JetBrains, com uma pegada um pouco diferente

Neste post eu te conto o que a extensão do Claude Code faz de fato dentro do editor, o que ela precisa pra rodar, como instalar e em que tipo de tarefa ela realmente rende mais

Bora? =)

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

O que muda em relação a usar o Claude Code fora do editor

A diferença não é o modelo, é a superfície

Segundo a documentação oficial da extensão, ela entrega uma interface gráfica nativa do Claude Code dentro da IDE: painel lateral dedicado e diffs inline das mudanças em tempo real

E a doc é bem direta: essa é a forma recomendada de usar o Claude Code no VS Code

O que você ganha na prática:

• revisar e editar o plano do Claude antes de aceitar (ou seja, você corrige a rota antes do estrago)
• aceitar edições automaticamente conforme elas vão sendo feitas, quando você já confia na tarefa
• mencionar arquivos com @, incluindo intervalo de linhas puxado direto da sua seleção
• histórico de conversas ali do lado, sem caçar terminal antigo
• várias conversas em abas ou janelas separadas

O painel ainda pode ser arrastado pra qualquer lugar do VS Code, e a extensão lembra a posição preferida

Então dá pra montar um fluxo bem massa: barra lateral pra sessão principal, abas extras pras tarefas paralelas

E se o Claude fizer besteira?

Aí entra o sistema de checkpoints do Claude Code, que salva o estado do código antes de cada mudança

Você volta pra uma versão anterior apertando Esc duas vezes ou com o comando /rewind, e na hora de voltar escolhe restaurar só o código, só a conversa ou os dois

Isso muda bastante o custo de interromper o Claude no meio de uma tarefa que claramente pegou o caminho errado

Uma nota técnica que vale guardar: a extensão do VS Code usa o primeiro snapshot de cada arquivo como linha de base dos diffs da sessão

Ou seja, o que você vê marcado como mudança é a diferença em relação a esse primeiro snapshot, não em relação ao último salvamento manual

O que você precisa antes de instalar

Antes de sair clicando em install, se liga nos requisitos:

• VS Code 1.98.0 ou superior
• um plano pago do Claude (Pro, Max, Team ou Enterprise) ou uma conta do Claude Console

O Claude Code está incluído em todos os planos pagos do Claude, sem necessidade de chave de API

O login é solicitado no primeiro uso, então não precisa configurar nada antes

Se você quer entender quanto dá pra rodar antes de bater no teto, vale olhar os limites de uso do Pro e do Max com calma

Já no caso das IDEs JetBrains a conta é outra: o plugin exige o CLI do Claude Code instalado à parte

Tome cuidado com isso, porque instalar só o plugin e esperar mágica é frustração garantida

Como instalar e abrir a extensão no VS Code

É o clássico next, next e finish, mas tem dois detalhes que derrubam gente

1. Abra a Extensions view do editor com Ctrl+Shift+X (Windows/Linux) ou Cmd+Shift+X (Mac)

2. Busque por Claude Code e instale a extensão

Alternativa: ela também está disponível no registro Open VSX

3. Abra o painel do Claude com Ctrl+Esc (Windows/Linux) ou Cmd+Esc (Mac)

Erro comum deste passo: no macOS Tahoe e versões posteriores, o atalho do Game Overlay do sistema ocupa Cmd+Esc e intercepta a tecla antes do VS Code

Solução: desmarcar o Game Overlay, ou remapear a extensão pelo editor de atalhos do VS Code (Cmd+K Cmd+S), buscando por Claude Code: Focus input e atribuindo outra tecla

4. Prefere não depender de atalho? Use a paleta de comandos com Ctrl+Shift+P (Windows/Linux) ou Cmd+Shift+P (Mac), digite Claude Code e escolha uma opção como Open in New Tab

5. Ou simplesmente clique em ✱ Claude Code no canto inferior direito da janela

Feito isso, o login aparece no primeiro uso e você já está dentro

VS Code x JetBrains: o que cada integração entrega

As duas rodam o mesmo Claude Code, mas o caminho e os detalhes mudam

Em que tipo de tarefa a extensão rende mais

Nem toda tarefa precisa de painel

Mas tem quatro cenários em que a integração no editor muda o jogo de verdade

Refatoração de um trecho específico de arquivo aberto:

Em vez de copiar e colar um bloco de código no chat, você seleciona as linhas e manda a referência com @, já com o intervalo

No JetBrains, o atalho Cmd+Option+K (ou Alt+Ctrl+K) gera a referência pronta, algo assim:

@src/auth.ts#L1-99

Menos copia e cola, menos chance de mandar o pedaço errado

Mudanças amplas que você precisa ler antes de aceitar:

Aqui o combo é plano revisável + diff

Você edita o plano antes dele começar, e depois acompanha as mudanças no diff inline (ou no visualizador de diff da IDE, no caso do JetBrains)

E deixa o auto-aceite desligado, óbvio

Tarefas em paralelo:

O VS Code permite abrir várias conversas em abas ou janelas separadas

Sessão principal na barra lateral, a investigação chata numa aba extra, e você troca sem perder o fio

Correção guiada por diagnóstico, no JetBrains:

O CLI puxa os diagnósticos de inspeção da IDE pra dentro da conversa

Então aquele monte de aviso que a IDE já te mostrou vira contexto, e não descrição manual sua

Quando vale a pena trocar seu fluxo atual

Vou ser honesto contigo: a resposta depende de onde você já vive

Se você passa o dia dentro do VS Code ou de uma IDE JetBrains e já paga um plano do Claude, a troca é ganho direto

A doc oficial trata a extensão como a forma recomendada de usar o Claude Code no VS Code, e trazer o diff pra dentro do editor tira do caminho aquele vaivém entre terminal e arquivo

Se você é do time terminal raiz e gosta assim, tudo bem também: o CLI continua atendendo

Inclusive, no JetBrains ele não é opcional, o plugin exige o CLI instalado à parte

E o ponto que mais confunde: a extensão não é um produto pago separado

O Claude Code está incluído em todos os planos pagos do Claude, sem chave de API

O plano Pro sai por US$ 20 por mês, e os planos Max ficam em US$ 100 e US$ 200 por mês, correspondendo a 5x e 20x o uso do Pro por sessão de 5 horas

Ou seja: o custo de entrada é o plano, não a extensão 🙂

Conclusão

A extensão do Claude Code não substitui o CLI, ela é o mesmo Claude Code com outra superfície

Ela troca a interface por uma que enxerga o teu editor: painel lateral, diff inline, plano revisável, @ com intervalo de linhas e histórico ali do lado

O próximo passo é simples e leva poucos minutos:

1. instale pela Extensions view buscando ‘Claude Code’
2. abra o painel com Ctrl+Esc ou Cmd+Esc
3. rode uma tarefa pequena mandando um trecho com @ e intervalo de linhas
4. revise o plano antes de aceitar e deixe o auto-aceite desligado nessa primeira vez

E se der ruim, você tem os checkpoints como rede de segurança: Esc duas vezes ou /rewind, escolhendo restaurar só o código, só a conversa ou os dois

Faça o teste numa refatoração boba primeiro, sem drama, e sente se o teu fluxo melhora

até o próximo post! 😀