Eu vivo em terminal desde a era LAMP, então a CLI do Claude Code pareceu casa desde o primeiro dia. Mas entendo que a maioria das pessoas que eu configuro pra usar ferramentas de IA são donos de agência e profissionais de marketing que não fazem ideia do que fazer com um cursor piscando.
Pra quem quer algo mais visual, a resposta já existe: a extensão do Claude Code pro VS Code roda exatamente o mesmo agente num painel gráfico dentro do editor. Tudo é igual (modelo, assinatura e capacidades), você só não está mais usando o terminal.
Eu continuo usando a CLI todo dia e recomendo a extensão pra quase todo mundo que não usa.
O que é a extensão do Claude Code pro VS Code
Tirando o marketing, a extensão é um painel gráfico pro 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 diz que ela é o jeito recomendado de usar o Claude Code dentro do VS Code.
Você instala pelo VS Code Marketplace e faz login com uma assinatura paga do Claude (Pro, Max, Team ou Enterprise) ou com uma conta do Claude Console. Não precisa de chave de API.
Uma coisa que vale saber antes de se comprometer: a extensão não coloca o comando claude no seu PATH. A CLI é uma instalação separada, e alguns recursos chegam nela primeiro. As duas convivem na mesma janela, e isso faz diferença mais adiante.
Por que tem gente que desiste do terminal
Uma sessão de terminal é linear, e linear sai caro quando o trabalho é de ida e volta. O prompt que você escreveu vinte minutos atrás está perdido em algum lugar do histórico de rolagem. Duas tarefas em paralelo são duas abas idênticas até você clicar na errada.
Pra quem tem anos de hábito de shell, nada disso é problema. Pra todo o resto, eu entendo que é, e isso decide se uma ferramenta entra no trabalho do dia a dia ou vira algo que a pessoa testou uma vez.
Cobri a configuração do terminal no meu guia de como configurar o Claude Code no macOS, e continuo achando que vale aprender.
O que a extensão do VS Code faz melhor
A extensão junta num lugar só a conversa, os arquivos, a saída do terminal e os diffs, e é daí que vem o ganho principal. Quando o Claude propõe uma mudança, o diff aparece no editor, que é onde diff deve ficar. Quando você quer apontar um trecho específico, você @-menciona o arquivo com o intervalo exato de linhas que selecionou, em vez de descrever em texto.
A revisão do plano é o recurso pelo qual eu pagaria à parte. Antes de o Claude mexer em qualquer coisa, você lê o plano, edita e só depois aprova. Pra quem já viu um agente refatorar com toda a confiança o módulo errado, é a diferença entre supervisionar e limpar a sujeira.
O histórico de sessões deixa de ser um rolo de terminal e vira algo que você reabre. Trabalho com cliente quase nunca cabe numa sessão limpa. Você começa algo na segunda, uma call interrompe, você volta na quarta. Com as conversas a um clique, retomar custa quase nada.
Os checkpoints completam isso: a extensão acompanha as edições de arquivo do Claude e deixa você voltar a um estado anterior quando um caminho se mostra errado. Experimento barato muda a coragem com que as pessoas delegam, e é exatamente essa mudança que eu quero quando entrego a ferramenta pra alguém novo.
Os prints são o recurso escondido. No momento em que o seu ciclo de ajuste envolve algo visual, um layout quebrado ou um template que renderiza errado, você cola a imagem no prompt em vez de escrever um parágrafo explicando onde a sidebar quebrou. Em trabalho com WordPress, que quase nunca é só texto, isso sozinho já justifica o painel.
Boas práticas se você for pela extensão
Comece toda tarefa que não seja trivial no modo de plano. Ler e anotar o plano antes de aprovar é o hábito que separa quem supervisiona agente de quem limpa a bagunça depois. Custa um minuto e pega os erros caros.
O modo de aceitação automática, que aplica as edições sem parar em cada uma, é ótimo quando você já confia na direção, com uma condição: disciplina de controle de versão e um limite claro do que o agente consegue alcançar. Escrevi bastante sobre isso em quando seu agente de IA tem as chaves de tudo, e o resumo é que recurso de conveniência é justamente onde os erros de permissão se escondem. O modo muda pra onde vai a sua atenção. Nunca deveria mudar se ela vai.
Use sessões paralelas do jeito que o trabalho chega de verdade. Uma sessão refatora uma integração com WooCommerce enquanto outra escreve testes pra ela. Peças que se encostam, abas separadas.
E mantenha a CLI instalada de qualquer jeito. Rodar claude no terminal integrado do VS Code, ao lado da extensão, te dá as duas na mesma janela, e os recursos exclusivos da CLI ficam a um painel de distância quando você precisar.
Foi isso que recomendei a um desenvolvedor júnior que me procurou no LinkedIn: ele só sabia usar o VS Code e ferramentas visuais, e estava apanhando do Claude Code e da configuração do terminal. Configurar o VS Code fez ele trabalhar mais rápido sem uma curva de aprendizado enorme.
Quando o terminal continua sendo a escolha certa
A CLI segue sendo a melhor ferramenta pra qualquer coisa com script ou sem interface. E as novidades também costumam chegar primeiro na CLI, antes de a extensão alcançar.
É por isso que eu não troquei, e não vou trocar. Os meus fluxos de WordPress com Claude Code rodam pelo terminal porque é lá que a minha automação mora. A extensão é outra porta pro mesmo lugar, e escolher uma não te tranca fora da outra.
A árvore de decisão é curta. À vontade no shell e trabalhando com scripts ou pipelines: CLI. Alérgico a terminal, ou trabalhando em algo com parte visual: extensão. Onboarding de um time com perfis variados: extensão como padrão e CLI pra quem pedir, o tipo de padrão que quem faz trabalho de CTO fracionado define uma vez pra ninguém rediscutir a cada dev novo.
Qual das duas o seu colega menos técnico usaria de verdade amanhã?
Se você está descobrindo como o Claude Code entra no fluxo de trabalho real do seu time, que permissões ele recebe e onde entram as etapas de revisão humana, isso é um projeto de CTO fracionado e consultoria de IA. Vamos conversar.