Claude Code no VS Code: instalação e primeiro uso

Em resumo

• Instale a extensão, abra com o ícone Spark e entre na sua conta.
• Você tem um painel de chat, diffs no código, menções de arquivos e checkpoints.
• A extensão e o terminal usam o mesmo motor.

O que é a extensão do Claude Code?

Somos a RocketLauncher, uma empresa de software, e construímos com o Claude Code todos os dias. A extensão do VS Code é um jeito gráfico de usá-lo. Em vez de digitar em um terminal, você conversa com o Claude em um painel ao lado do seu código. O Claude pode ler o seu projeto, editar arquivos e rodar comandos, e você revisa cada mudança antes de ela ser mantida.

O que você precisa antes

• VS Code 1.94.0 ou mais novo.
• Um plano pago do Claude (Pro, Max, Team ou Enterprise) ou uma conta do Claude Console. O plano gratuito do Claude não inclui o Claude Code. Veja como usar o Claude Code de graça para conhecer as opções.
• Uma pasta de projeto para trabalhar.

Como instalar

1. Abra o VS Code.
2. Abra a visualização de Extensões com Ctrl+Shift+X (Windows e Linux) ou Cmd+Shift+X (Mac).
3. Busque por Claude Code e instale a extensão da Anthropic.
4. Abra a paleta de comandos com Ctrl+Shift+P ou Cmd+Shift+P.
5. Digite Claude Code e escolha Open in New Tab.
6. Entre com a sua conta do Claude ou do Console quando for pedido.

Usa o Cursor? A mesma extensão também instala lá.

Sua primeira execução

1. Abra uma pasta de projeto com File, Open Folder.
2. Abra um arquivo. O ícone Spark aparece então na barra do editor, no canto superior direito. Clique nele para abrir o Claude.
3. Digite uma tarefa pequena e clara, por exemplo: "Explique o que este projeto faz e liste os arquivos principais."
4. Leia a resposta. Depois peça uma mudança, por exemplo: "Adicione uma seção curta no README sobre como rodar."
5. O Claude propõe as edições como um diff. Aceite ou rejeite cada uma.

Comece com uma pergunta de só leitura. Ela mostra como o Claude enxerga o projeto antes de mudar qualquer coisa.

Principais recursos

Diffs no código e revisão do plano

O Claude mostra as mudanças como diffs no editor. Você também pode pedir que ele faça um plano primeiro. Leia o plano, edite e depois deixe o Claude executar.

@-menções

Digite @ para apontar um arquivo ao Claude. Se você selecionar linhas de código, o Claude vê a seleção automaticamente. Aperte Alt+K (Windows e Linux) ou Option+K (Mac) para inserir uma referência ao arquivo e ao intervalo de linhas.

Saída do terminal

Faça referência à saída do terminal com @terminal:name, onde name é o título do terminal. O Claude lê o erro sem você precisar colar.

Checkpoints

O Claude registra as edições que faz nos arquivos. Passe o mouse sobre uma mensagem para achar o botão de rewind e volte o seu código até aquele ponto.

Abas e histórico

Abra mais de uma conversa em abas ou janelas separadas. Cada uma guarda o próprio histórico. Uma bolinha colorida no ícone Spark avisa quando uma aba precisa de permissão ou terminou.

Atalhos que valem a pena

Em versões recentes do macOS, um atalho do sistema pode ocupar o Cmd+Esc. Se ele não fizer nada, mude a configuração do sistema.

Dicas que economizam tempo

• Adicione um arquivo CLAUDE.md na raiz do projeto com as suas regras e comandos. O Claude lê no início de cada sessão.
• Use o git. Faça um commit antes de uma tarefa grande para poder sempre voltar.
• Uma tarefa por conversa. Abra uma aba nova para a próxima.
• Peça ao Claude para rodar os testes ou o build depois de uma mudança.
• Adicione skills para as tarefas que você repete.
• Conecte ferramentas com MCP quando quiser que o Claude alcance apps reais. Comece pelo nosso guia de MCP para quem não programa.

Se algo não funcionar

• O ícone Spark não aparece. Ele só aparece com um arquivo aberto no editor. Abra qualquer arquivo e olhe no canto superior direito.
• A extensão não carrega. Confira se o VS Code está na versão 1.94.0 ou mais nova e reinicie.
• O login falha. Confirme que o seu plano inclui o Claude Code. O plano gratuito do Claude não inclui.
• O Claude edita a pasta errada. Abra no VS Code a pasta exata do projeto, não uma pasta acima dela.

Extensão ou terminal?

Os dois rodam o mesmo motor do Claude Code. O seu CLAUDE.md, as configurações e os servidores MCP funcionam nos dois. Escolha a extensão se você gosta de painéis, diffs e de clicar. Escolha o terminal se você gosta de velocidade e de scripts. Muita gente usa os dois.

Transforme isso em um serviço com o GoHighLevel

Quando você estiver à vontade no VS Code, pode construir coisas reais para negócios locais. Um projeto típico é uma landing page, um formulário de leads ou um conjunto de automações, com o Claude Code escrevendo os arquivos e o GoHighLevel cuidando por trás do CRM, das mensagens e dos agendamentos. Você também pode conectar o Claude à sua conta do GoHighLevel, veja como conectar o Claude ao GoHighLevel. Nosso kit Claude Code + GoHighLevel percorre um projeto completo, e os outros kits cobrem recepcionistas, sites e geração de leads. Não prometemos renda. Os resultados dependem do seu trabalho e dos seus clientes.