Estou vivendo em terminais desde a era LAMP, então a CLI Claude Code se sentiu como casa desde o primeiro dia. Mas entendo que a maioria das pessoas que configuro com ferramentas de IA são donos de agências e profissionais de marketing que não fazem ideia de como interagir com um cursor piscante.
Para quem quer algo mais visual, a resposta já existe: a extensão Claude Code VS Code executa o exato mesmo agente através de um painel gráfico dentro do editor. Tudo é igual (modelo, assinatura e capacidades), você apenas não está usando o terminal mais.
Ainda executo a CLI diariamente e recomendo a extensão para quase todos que não a usam.
O que a extensão Claude Code VS Code realmente é
Tirando o marketing, a extensão Claude Code VS Code é um painel gráfico para o mesmo agente que roda no terminal. Mesmo modelo, mesmo CLAUDE.md, mesmo sistema de permissões, mesmo preço. A própria documentação da Anthropic a chama de forma recomendada de usar Claude Code dentro do VS Code.
Você a instala do VS Code Marketplace e faz login com uma assinatura Claude paga (Pro, Max, Team ou Enterprise) ou uma conta Claude Console. Não há necessidade de uma chave de API.
Uma coisa que vale a pena saber antes de se comprometer: a extensão não adiciona o comando claude ao seu PATH. A CLI é uma instalação separada, e alguns recursos chegam à CLI primeiro. Ambas podem conviver na mesma janela, o que importa depois.
Por que algumas pessoas desistem do terminal
Uma sessão de terminal é linear, e linear é caro quando seu trabalho é iterativo. O prompt que você escreveu vinte minutos atrás está em algum lugar no buffer de scrollback. Duas tarefas paralelas significam duas abas que parecem idênticas até você clicar na errada.
Para alguém com anos de hábitos de shell, nada disso é um problema. Para todos os outros, entendo que é, e decide se uma ferramenta se torna parte do trabalho diário ou algo que tentaram uma vez.
Cobri a setup do terminal no meu guia para configurar Claude Code no macOS, e ainda acho que vale a pena aprender.
O que a extensão VSCode faz melhor
A extensão colapsa a conversa, seus arquivos, a saída do terminal e os diffs em uma superfície, e esse é o núcleo do ganho. Quando Claude propõe uma mudança, o diff aparece no editor onde diffs pertencem. Quando você quer apontar para um bloco específico, você @-menciona o arquivo com o intervalo exato de linhas da sua seleção em vez de descrevê-lo em prosa.
Revisão de plano é o recurso pelo qual eu pagaria separadamente. Antes de Claude tocar em qualquer coisa, você pode ler seu plano, editá-lo e só então aprovar. Para quem assistiu um agente confiantemente refatorar o módulo errado, essa é a diferença entre supervisão e limpeza.
O histórico de sessão deixa de ser um buffer de scrollback e se torna objetos reais que você reabre. O trabalho com clientes raramente cabe em uma sessão limpa. Você começa algo segunda, uma ligação interrompe, você volta quarta. Com conversas a um clique de distância, retomar custa quase nada.
Checkpoints complementam: a extensão rastreia as edições de arquivo do Claude e permite que você reverta para um estado anterior quando uma direção se mostra errada. Experimentos baratos mudam o quão ousadamente as pessoas delegam, e esse shift é exatamente o que quero quando entrego essa ferramenta para alguém novo.
Screenshots são o recurso oculto. No momento em que seu ciclo de feedback inclui algo visual, um layout quebrado ou um template que renderiza errado, você cola a imagem no prompt em vez de escrever um parágrafo descrevendo onde a sidebar quebrou. Para trabalho com WordPress, que raramente é apenas texto, isso sozinho justifica o painel.
Melhores práticas se você optar pela rota da extensão
Comece cada tarefa não trivial em modo de plano. Ler e anotar o plano antes da aprovação é o hábito que separa pessoas que supervisionam agentes daqueles que limpam após eles. Custa um minuto e pega os erros caros.
Modo de auto-aceitação, que aplica edits sem pausar para cada um, é bom uma vez que você confia na direção, com uma condição: disciplina de controle de versão e um limite claro no que o agente pode alcançar. Escrevi sobre isso em extensão em quando seu agente de IA tem as chaves para tudo, e a versão curta é que recursos de conveniência são exatamente onde erros de permissão se escondem. O modo muda onde sua atenção vai. Nunca deveria mudar se ela vai.
Use sessões paralelas do jeito que o trabalho realmente chega. Uma sessão refatora uma integração WooCommerce enquanto outra escreve testes contra ela. Peças sobrepostas, abas separadas.
E mantenha a CLI instalada mesmo assim. Rodar claude no terminal integrado do VS Code ao lado da extensão dá a você ambas as superfícies em uma janela, então recursos apenas de CLI ficam a um painel de distância quando você precisa deles.
Isso é o que recomendei a um desenvolvedor júnior que me contatou no LinkedIn: ele só sabia como usar VS Code e outras ferramentas visuais e estava lutando com Claude Code e a setup do terminal. Configurar VS Code o fez capaz de trabalhar mais rápido sem uma curva de aprendizado enorme.
Quando o terminal ainda é a chamada certa
A CLI permanece sendo a ferramenta melhor para qualquer coisa com script ou headless. Novos recursos também tendem a chegar à CLI antes da extensão acompanhar.
É por isso que não mudei, e não vou. Meus workflows WordPress Claude Code rodam através do terminal porque é onde minha automação vive. A extensão é uma superfície alternativa, e escolher uma não o bloqueia da outra.
A árvore de decisão é curta. Confortável em um shell e trabalhando com scripts ou pipelines: CLI. Alérgico a terminais, ou trabalhando em qualquer coisa com um componente visual: extensão. Onboarding de um time com perfis mistos: extensão como padrão, CLI para quem pedir.
Qual superfície seu colega menos técnico realmente usaria amanhã?
Se você está descobrindo como Claude Code se encaixa no fluxo de trabalho real do seu time, quais permissões ele obtém e onde os gates de revisão humana vão, esse é o tipo de engajamento que assumo como consultor de estratégia de IA. Vamos conversar.