Claude Code no VS Code ou no terminal: o que muda na prática?

Fala aí, beleza? O Claude Code é o MESMO agente nos dois lugares, o que muda é a camada entre tu e ele

A documentação oficial apresenta a extensão como a forma recomendada de usar Claude Code no VS Code, com interface gráfica nativa dentro do editor

E não é decisão pra vida toda: quem já roda o Claude Code num terminal externo conecta os dois rodando /ide dentro da sessão

Então a pergunta boa não é "qual é melhor", é "qual rende mais na tarefa que tu tem na frente agora?"

VS Code x terminal: comparativo direto

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

Visualização de diff: revisar a mudança antes de ela existir

Esse é o bloco que mais separa os dois mundos

Quando o Claude quer editar um arquivo, o editor mostra a comparação lado a lado entre o original e a mudança proposta, e pede permissão

Aí tu tem três saídas: aceitar, rejeitar ou dizer o que fazer diferente

E tem um detalhe que muda o jogo: dá pra editar o conteúdo proposto DENTRO da própria visualização de diff, antes de aceitar

O Claude é informado de que aquele arquivo não é mais a proposta original dele, então ele não segue trabalhando em cima de algo que tu já mexeu

"Por que isso importa tanto?"

Porque em refatoração grande a leitura muda de natureza: em vez de aprovar um texto que descreve a mudança, tu lê a mudança em si, linha contra linha, e corrige o pedaço torto sem precisar de mais uma rodada de prompt

É a diferença entre revisar o resumo e revisar o código 😀

Contexto do arquivo aberto: o que o editor entrega de graça

Com o IDE conectado, o arquivo aberto, a posição do cursor e o trecho selecionado entram no contexto automaticamente

Sem colar caminho, sem repetir "olha o arquivo X, função Y"

Erros de diagnóstico do IDE, tipo lint e sintaxe, também são compartilhados com o Claude durante o trabalho

Quando tu quer ser cirúrgico e apontar uma faixa exata de linhas, tem atalho: seleciona no editor e usa Option+K no Mac ou Alt+K no Windows e Linux

Isso insere uma referência @-mention parecida com @file.ts#5-10 no prompt

Pra alternar o foco entre o editor e o campo de prompt do Claude, o atalho é Cmd+Esc / Ctrl+Esc

Tome cuidado com isso: no macOS Tahoe e versões posteriores, o atalho do Game Overlay do sistema captura Cmd+Esc antes do VS Code

A solução é desmarcar a caixa Game Overlay, ou refazer o atalho no editor de Keyboard Shortcuts (Cmd+K Cmd+S) buscando por ‘Claude Code: Focus input’

Fluxo de aprovação: modo manual, acceptEdits e plan mode

Pensa nos modos de permissão como o botão que regula o quanto o agente te interrompe

No modo manual, ele pede permissão antes de editar arquivo e antes da maioria dos comandos de shell

O acceptEdits desloca a revisão pra depois: em vez de aprovar cada edição, tu revisa o resultado no editor ou por git diff, o que combina bem com quem já tem o hábito de usar o Claude Code com Git no dia a dia

Já o plan mode descreve o que ele vai fazer e espera tua aprovação

E é aqui que o editor brilha de novo: no VS Code o plano abre como documento Markdown completo, onde dá pra escrever comentários inline

O Claude lê essas anotações antes de começar

Ou seja, tu não aprova nem rejeita em bloco, tu comenta no meio do plano igual review de PR, massa demais

E se a coisa foi pro lado errado mesmo assim, tem o rewind

Na extensão ele aparece ao passar o mouse sobre uma mensagem, com Fork conversation from here, Rewind code to here e Fork conversation and rewind code

No terminal, o menu abre com /rewind ou apertando Esc duas vezes com o campo de prompt vazio, listando os prompts enviados na sessão, com Restore code and conversation, Restore conversation, Restore code e Summarize from here

Os checkpoints ficam salvos junto da conversa e são apagados junto com as sessões depois de um período configurável: 30 dias por padrão, ajustável em cleanupPeriodDays

Ao retomar a sessão, o /rewind continua disponível

Como instalar e abrir o Claude Code no VS Code

Do zero até o painel aberto dentro do editor, com os erros comuns de cada passo

1. Abra a view de extensões do VS Code com Cmd+Shift+X no Mac ou Ctrl+Shift+X no Windows e Linux, e busque por ‘Claude Code’

O erro comum aqui é buscar por nome parecido e instalar outra coisa: confira que é a extensão do Claude Code mesmo, que é o caminho recomendado pela documentação da extensão para o editor

2. Abra o painel pela paleta de comandos: Cmd+Shift+P / Ctrl+Shift+P, digite ‘Claude Code’ e escolha Open in New Tab

O erro comum deste passo é ficar esperando o painel aparecer sozinho depois da instalação: passa pela paleta que resolve

3. Na primeira abertura do painel aparece a tela de login: clique em Sign in e conclua a autorização no navegador

4. Se tu já usa o Claude Code num terminal externo e quer conectar com o editor, roda o comando de barra dentro da sessão:

/ide

O erro comum aqui é digitar /ide no shell, como se fosse comando do sistema: ele é comando de barra, então vai DENTRO da sessão do Claude Code já rodando

5. Depois do login aparece o checklist inicial ‘Learn Claude Code’

Fechou sem querer? Dá pra reabrir desmarcando a opção ‘Hide Onboarding’ nas configurações do VS Code em Extensions > Claude Code

Se tu quer o caminho completo com as telas, tem um post do blog dedicado a instalar e usar a extensão no editor

Quando o terminal ainda ganha: CI, scripts e pipe

Aqui a extensão não substitui a linha de comando, e nem tenta

O modo não interativo, feito pra CI, scripts e uso em pipe, é acionado por flag: claude -p (ou --print) executa um único prompt e sai

Ele lê stdin e escreve na saída padrão, então encaixa direto no fluxo que tu já usa no shell:

cat erro.log | claude -p "explique a causa provável desse erro"

Pra liberar ferramentas sem prompt de permissão, existe o --allowedTools, que é o que faz o negócio rodar sem humano na frente

E tem o --bare, pensado pra CI e scripts, que reduz o tempo de inicialização pulando a descoberta automática de extras: hooks, skills, plugins, servidores MCP, memória automática e CLAUDE.md

Outro detalhe que só faz sentido em script: o modo não interativo devolve saída 0 em caso de sucesso e código diferente de zero em falha

Com isso tu ramifica o pipeline pelo resultado, sem ficar tentando ler texto de saída com regex 🙂

Veredito: em qual situação cada modo rende mais

Sem inventar teste que não fiz, dá pra separar por tipo de tarefa

O editor rende mais quando: a tarefa é ler e aprovar mudança em código que tu conhece (o diff lado a lado editável entrega isso mastigado), quando tu quer planejar antes de executar e anotar o plano em Markdown, e quando tu toca várias frentes ao mesmo tempo em abas ou janelas separadas

Soma o contexto que vem de graça (aba aberta, cursor, seleção e diagnósticos do IDE) e o atrito cai bastante

O terminal rende mais quando: não tem humano na frente

CI, script, pipeline, tarefa que precisa devolver código de saída, ou quando tu quer inicialização enxuta com --bare

E o melhor: não precisa casar com um lado

Dá pra usar os dois na mesma sessão conectando com /ide, e a documentação oficial aponta a extensão como o caminho recomendado dentro do VS Code

Conclusão

A escolha entre Claude Code no VS Code e no terminal não é de ferramenta, é de tipo de trabalho

Revisão e planejamento pedem os olhos do editor

Automação pede a linha de comando

Próximo passo concreto, bem pequeno: instala a extensão, roda uma tarefa curta no plan mode só pra ver o plano abrir como Markdown anotável, e depois faz a MESMA tarefa pelo terminal

Compara o atrito dos dois antes de fixar um fluxo, aí a decisão vira tua e não do hype

Bora testar? Até o próximo post!