💻 VS Code + Extensao Claude Code
Visual Studio Code e a IDE mais popular do mundo, e a extensao oficial Claude Code transforma ela em um ambiente completo para desenvolvimento assistido por IA. A interface lado a lado coloca seus arquivos a esquerda e o agente a direita.
📥 Instalacao Rapida
Baixe VS Code em code.visualstudio.com
Va em Extensions (Ctrl+Shift+X) e busque "Claude Code"
Clique em Install e faca login com sua conta Anthropic
💰 Planos Disponiveis
- Pro ($17/mes): Acesso ao Claude Code com limites de uso
- Max ($60/mes): Limites mais altos, ideal para automacoes intensivas
- Max Ultra ($200/mes): Uso ilimitado para times e projetos grandes
💡 Dica Pratica
Comece com o plano Pro para aprender. Quando voce perceber que esta batendo nos limites frequentemente, e hora de fazer upgrade para Max. A maioria dos usuarios intermediarios fica bem no Max normal.
📁 Estrutura de Projetos
Cada projeto no Claude Code vive em sua propria pasta. O agente precisa saber em qual projeto esta trabalhando, por isso sempre abrimos uma pasta especifica antes de comecar.
Estrutura Recomendada
✓ O que FAZER
- ✓ Um projeto = uma pasta
- ✓ Sempre abrir a pasta antes de iniciar
- ✓ Criar claude.md na raiz
✗ O que NAO fazer
- ✗ Trabalhar sem abrir uma pasta
- ✗ Misturar multiplos projetos
- ✗ Esquecer de criar estrutura inicial
🔍 Explorer
O VS Code tem dois paineis principais quando usado com Claude Code: o Explorer a esquerda mostra seus arquivos, e o painel Claude Code a direita e onde voce conversa com o agente.
🖥️ Layout da Interface
Esquerda: Explorer
- • Arvore de arquivos do projeto
- • Clique para abrir arquivos
- • Arraste arquivos para reorganizar
- • Right-click para opcoes
Direita: Agente
- • Chat com Claude Code
- • Mostra acoes executadas
- • Historico de conversas
- • Controles de modo
💡 Dica Pratica
Voce pode ter multiplas abas abertas no painel direito - diferentes arquivos ou ate mesmo multiplas conversas com Claude Code. Use isso para trabalhar em paralelo ou comparar versoes.
⚡ Bypass Permissions
Por padrao, Claude Code pede permissao antes de cada acao que modifica arquivos. O modo Bypass Permissions permite que o agente trabalhe de forma autonoma, essencial para automacoes complexas.
Modos de Permissao
🛡️ Ask Before Edits
Pede permissao para cada edicao. Seguro mas lento.
⚡ Bypass Permissions
Executa sem perguntar. Rapido e essencial para automacoes.
📋 Edit Automatically
Edita automaticamente mas nao executa bash livremente.
Abrir Settings
Clique no icone de engrenagem no canto inferior esquerdo do VS Code
Buscar "Claude Code"
Digite na barra de busca das configuracoes
Ativar "Allow bypass permissions mode"
Marque a checkbox para habilitar o modo
⚠️ Atencao
Com bypass permissions, o agente pode executar qualquer comando. Use em projetos que voce confia e mantenha backups. Para projetos sensiveis, prefira o modo Ask Before Edits.
📋 Plan Mode
Plan Mode e um modo especial onde Claude pensa antes de agir. Ele analisa o projeto, faz pesquisas, formula perguntas e cria um plano detalhado antes de executar qualquer codigo.
🎯 Quando Usar Plan Mode
- • Iniciando um novo projeto ou automacao complexa
- • Quando nao tem certeza de qual abordagem usar
- • Para tarefas que envolvem multiplas APIs ou integracoes
- • Antes de qualquer mudanca significativa na arquitetura
🔍 O que Claude Faz em Plan Mode
- Analisa: Le toda a estrutura do projeto e arquivos relevantes
- Pesquisa: Busca documentacao de APIs e melhores praticas
- Pergunta: Faz perguntas clarificadoras sobre detalhes
- Planeja: Propoe uma solucao detalhada antes de implementar
💡 Fluxo Recomendado
Plan Mode primeiro, Bypass depois. Descreva seu objetivo em Plan Mode, responda as perguntas, revise o plano, e so entao mude para Bypass para executar.
🤖 Agente vs Arquivos
Entender a relacao entre o agente (que raciocina) e os arquivos (que persistem) e fundamental. O agente e temporario - quando voce fecha o VS Code, a conversa acaba. Os arquivos sao permanentes.
🧠 Agente (Temporario)
- • Raciocina e toma decisoes
- • Le e interpreta instrucoes
- • Coordena execucao de tools
- • Conversa e faz perguntas
- • Perde-se ao fechar
📁 Arquivos (Permanente)
- • Workflows (instrucoes)
- • Tools (scripts Python)
- • claude.md (system prompt)
- • Outputs gerados
- • Persistem sempre
🔄 Implicacao Pratica
Quando voce faz deploy de uma automacao no Modal, o agente NAO vai junto. Apenas os workflows e tools sao deployados. Isso significa:
- • Automacoes em producao nao sao "self-healing" automaticamente
- • Para melhorar, voce edita localmente e faz novo deploy
- • O agente e seu assistente de desenvolvimento, nao de producao
🚀 Proximo Passo
Agora que voce entende a interface, no proximo modulo vamos mergulhar no Framework WAT - a arquitetura que separa Workflows, Agents e Tools para criar automacoes confiaveis.
📋 Resumo do Modulo
Proximo Modulo:
5.2 - Framework WAT: Workflows, Agents e Tools para automacoes confiaveis