Guia operacional
Como instalar e configurar o Claude Code no VS Code
A base técnica pra rodar os projetos de IA da mentoria. Claude Code roda dentro do VS Code, então esse é o primeiro guia antes de qualquer prompt, agente ou automação.
Fase 1 — Instalar o essencial
Duas instalações e uma pasta de trabalho. Nada disso exige conhecimento técnico prévio.
Instalar o VS Code
Baixe em code.visualstudio.com, escolha a versão do seu sistema (Windows ou Mac) e siga o instalador padrão. É gratuito.
Instalar o Node.js
É o pré-requisito técnico do Claude Code, o motor que roda por trás dos panos. Baixe em nodejs.org, escolha a versão LTS (a recomendada, marcada na própria página) e instale normalmente. Você não vai precisar mexer nele diretamente depois disso.
Abrir o VS Code numa pasta de projeto
Menu File → Open Folder e escolha (ou crie) uma pasta vazia pra ser o espaço de trabalho dos seus projetos de IA. É dentro dela que o Claude Code vai atuar.
Fase 2 — Instalar o Claude Code
Via extensão, direto na interface do VS Code. Sem precisar digitar comando.
Abrir a aba de Extensions
Ícone de quadrados empilhados na barra lateral esquerda do VS Code (atalho Ctrl+Shift+X no Windows, Cmd+Shift+X no Mac).
Instalar a extensão oficial Claude Code
Busque por Claude Code, confirme que é a extensão publicada pela Anthropic e clique em Install. Ela abre um painel lateral dedicado dentro do VS Code, sem precisar digitar comando nenhum.
Autenticar
Na primeira abertura, a extensão pede login. Escolha o método (conta Claude.ai ou chave de API) e conclua a autorização, que abre numa aba do navegador.
Dá pra instalar o mesmo Claude Code por linha de comando em vez do painel visual. Abra o terminal integrado do VS Code (Terminal → New Terminal) e rode npm install -g @anthropic-ai/claude-code. Depois, dentro da pasta do projeto, o comando claude inicia uma sessão.
Os dois caminhos abrem a mesma ferramenta. A extensão só poupa você de decorar comando.
Fase 3 — Primeiro uso
Um teste rápido pra confirmar que está tudo funcionando antes de seguir pra próxima etapa da mentoria.
Abrir o painel do Claude Code
Clique no ícone do Claude Code na barra lateral esquerda, que aparece depois de instalado. Ele abre um painel de conversa, parecido com um chat.
Fazer um pedido de teste
Escreva algo simples, como lista os arquivos dessa pasta e me diz o que cada um faz. Não precisa ser nada relacionado ao seu projeto de verdade ainda, é só pra confirmar a instalação.
Conferir a resposta
Se o Claude Code listar os arquivos e explicar o que encontrou, a instalação está completa. A partir daqui, ele já pode entrar nos projetos reais da mentoria.
Checklist final
- ✓ VS Code instalado e abrindo normalmente
- ✓ Node.js instalado na versão LTS
- ✓ Extensão Claude Code instalada e autenticada
- ✓ Pedido de teste respondido com sucesso