Claude Code no VS Code: como usar (guia passo a passo)
Dá pra usar o Claude Code dentro do VS Code com a extensão oficial. Veja como instalar, ver diffs no editor e mandar contexto pro agente em .NET.

Sim, dá pra usar o Claude Code dentro do VS Code. A Anthropic tem uma extensão oficial que conecta o agente ao editor: os diffs aparecem na tela em vez de virar texto no terminal, o código que você seleciona vira contexto automático, e os erros que o editor aponta entram na conversa sem você copiar nada.
O detalhe que confunde muita gente: o Claude Code continua sendo um agente de terminal. A extensão não é um painel de chat estilo Copilot. Ela é uma ponte entre o terminal e o editor. Vou te mostrar como instalar, o que a integração te dá de verdade, e como isso fica num projeto .NET no VS Code.
Como o Claude Code funciona no VS Code
Antes de instalar, vale entender o modelo, porque ele é diferente do que a maioria espera.
O Claude Code roda no terminal. Você abre o terminal integrado do VS Code (aquele que abre embaixo do editor), navega até a raiz do projeto e digita claude. A partir daí, você conversa com o agente ali no terminal mesmo. Ele lê seus arquivos, edita código, roda comandos.
Se você quer entender o que é o Claude Code antes de seguir, leia primeiro o que é o Claude Code e como ele funciona. Aqui eu assumo que você já sabe o básico.
A extensão entra como camada visual em cima disso. Quando o agente vai mudar um arquivo, em vez de mostrar o diff em texto no terminal, ele abre o diff no editor, do jeito que você já está acostumado a ver num git diff. E o caminho de mão dupla também vale: o que você faz no editor (selecionar um trecho, ter um erro de compilação na tela) chega até o agente.
Como instalar a extensão do Claude Code no VS Code
São três passos. O primeiro só é necessário se você ainda não tem o Claude Code instalado na máquina.
1. Instale o Claude Code
Se ainda não tem, instale via npm (precisa do Node.js 18 ou superior):
npm install -g @anthropic-ai/claude-code
Pra confirmar que deu certo:
claude --version
2. Abra o terminal integrado e rode claude
Dentro do VS Code, abra o projeto .NET. Depois abra o terminal integrado com Ctrl + crase (a tecla acima do Tab) e digite:
claude
Na primeira vez que você roda isso dentro do VS Code, o Claude Code detecta o editor e instala a extensão Claude Code for VS Code sozinho. Você não precisa ir no Marketplace na mão. Se preferir instalar manualmente, abra a aba de extensões (Ctrl + Shift + X) e busque por "Claude Code for VS Code".
3. Confirme que a integração subiu
Com o claude rodando no terminal e a extensão ativa, peça uma mudança qualquer ("renomeia a variável x pra total em Program.cs"). Se o diff abrir no editor em vez de aparecer só como texto no terminal, a ponte está funcionando. É esse o sinal de que o VS Code e o agente estão conversando.
Funciona igual no Cursor e no Windsurf, que são forks do VS Code. O comando claude no terminal integrado instala a extensão do mesmo jeito.

O que a integração com o editor te dá
Aqui é onde "usar no VS Code" passa a valer a pena de verdade, em vez de ser só estética. Três coisas mudam.
Diffs no editor. Quando o agente edita um arquivo, a mudança abre como diff lado a lado no VS Code. Você revisa a alteração com as cores e o realce de sintaxe do editor, não num bloco de texto monocromático no terminal. Pra quem revisa cada mudança antes de aceitar (e você deveria), isso muda o jogo. Ler um diff de C# com syntax highlighting é muito mais rápido do que ler o mesmo diff cru.
Seleção vira contexto. Selecione um método inteiro no editor, volte pro terminal e peça "extrai isso pra um método separado". O Claude Code já sabe qual trecho você selecionou. Você não precisa colar o código nem explicar onde ele está. O agente recebe a seleção como contexto automático.

Diagnostics do editor entram na conversa. Essa é a que mais gente não conhece. Os erros e warnings que aparecem na aba "Problems" do VS Code (erro de compilação, variável não usada, namespace faltando) são compartilhados com o agente. Então você pode dizer "corrige os erros que tão aparecendo" sem listar nenhum. Ele lê os diagnostics direto do editor.
Quer dominar o Claude Code num fluxo profissional de .NET?
No nosso curso de Claude Code, você aprende a usar o agente do setup ao deploy em projetos C# reais, sem desperdiçar token.
Ver cursosNa prática, o terceiro ponto é o que mais economiza tempo num projeto .NET. Você salva um arquivo, o OmniSharp ou o C# Dev Kit aponta três erros, e você simplesmente fala "resolve". O agente vê os mesmos erros que você vê.
Atalhos que valem a pena decorar
Depois de instalar, dois atalhos resolvem a maior parte do uso diário:
Cmd + Esc(Mac) ouCtrl + Esc(Windows/Linux): abre ou foca o Claude Code rápido, sem você precisar clicar no terminal.Cmd + Option + K(Mac) ouAlt + Ctrl + K(Windows/Linux): insere uma referência de arquivo (@arquivo) no prompt. Útil pra apontar proappsettings.jsonou pra uma classe específica sem digitar o caminho inteiro.
E tem o Tab, que dentro da conversa serve pra ver as mudanças pendentes. Decorar esses três já cobre 90% do que você faz no dia a dia.
VS Code ou só o terminal: quando usar cada um
Resposta honesta: na maioria das vezes, use o VS Code. A integração não tem custo (é o mesmo agente, os mesmos tokens) e os diffs no editor sozinhos já justificam.
Mas tem dois casos onde rodar só no terminal puro faz sentido. Primeiro, em servidor ou SSH, onde você não tem interface gráfica. O Claude Code roda liso num terminal remoto. Segundo, quando você quer focar num fluxo headless de verdade, tipo rodar o agente num script de automação. Aí o editor só atrapalha.
Pra trabalho normal de feature no seu projeto .NET, abrir o VS Code e rodar claude no terminal integrado é o melhor dos dois mundos: você tem o agente autônomo do terminal e a revisão visual do editor.
Se você está decidindo entre o Claude Code e o autocomplete do Copilot, esse não é bem o ponto desse artigo, mas vale ler o comparativo entre Claude Code e GitHub Copilot pra dev C#. Spoiler: muita gente usa os dois, em contextos diferentes.
Dica pra projeto .NET no VS Code
Duas coisas que aumentam muito a qualidade do agente num projeto C#.
A primeira é ter o C# Dev Kit instalado no VS Code. Ele dá ao editor a inteligência de compilação que alimenta os diagnostics. Quanto melhor o editor entende seu código, melhores os erros que chegam ao Claude Code. Os dois se reforçam.
A segunda é usar um arquivo CLAUDE.md na raiz do projeto pra dar contexto fixo ao agente: qual a versão do .NET, qual o padrão de testes (xUnit, NUnit), convenções de nomenclatura. Isso vale tanto no terminal quanto no VS Code, e evita que o agente chute decisões de arquitetura. Antes de pedir uma mudança grande, também vale usar o modo plan pra planejar antes de codar, principalmente em refatoração que toca vários arquivos.
Um exemplo de comando que fica natural nesse fluxo, depois de abrir o projeto no VS Code:
claude
> seleciona o ProdutoController e cria os testes xUnit pros endpoints GET e POST, rodando dotnet test no final pra confirmar que passam
O agente lê a seleção, escreve os testes, roda o dotnet test no terminal integrado e mostra o resultado, sem você sair do editor.
Vale a pena usar o Claude Code no VS Code?
Pra quem programa em .NET no VS Code, sim, sem muito o que pensar. A extensão é oficial, gratuita, instala sozinha e transforma a revisão de diffs e a passagem de contexto em algo natural. O agente continua sendo o mesmo do terminal, com toda a autonomia, mas você ganha a camada visual que faltava.
Se você quer ir além do "instalei e funcionou" e aprender a usar o Claude Code de ponta a ponta num projeto C# profissional (gestão de contexto, hooks, controle de custo de token e workflow de revisão), é exatamente isso que a gente ensina no curso de Claude Code pra devs C# .NET. É o caminho mais rápido de sair do uso amador pro uso que de fato acelera seu dia.
Pra fechar, um ponto que pouca gente fala: a integração com o editor não te dispensa de revisar o código. Pelo contrário. Como ficou mais fácil aceitar mudanças, a tentação de aprovar no automático cresce. Continue lendo cada diff. O VS Code só deixou isso mais confortável, não opcional.
Fontes oficiais: a documentação de integração com IDEs do Claude Code está no site da Anthropic, e o tutorial de .NET no VS Code está no Microsoft Learn em português.