Módulo 1: Fundamentos Claude Code
Instalação, configuração inicial e primeiros comandos. Construa a base sólida para dominar Claude Code profissionalmente.
Por que isso é importante
Claude Code revolucionou desenvolvimento com IA. Custa apenas US$ 20/mês (vs US$ 200+ em APIs) e oferece funcionalidades que 99% dos desenvolvedores ainda não conhecem. Este módulo estabelece fundação sólida para produtividade 10x.
Claude Code evoluiu de simples chatbot para ambiente de desenvolvimento completo. É ferramenta oficial da Anthropic que integra Claude Sonnet 3.5 diretamente no terminal e IDEs como Cursor.
Neste módulo você aprenderá instalação correta, configuração profissional, comandos essenciais e primeiros workflows. Base necessária para técnicas avançadas dos próximos módulos.
Aula 1: Instalação e Configuração Inicial
🎯 Objetivos desta Aula
- • Instalar Claude Code corretamente
- • Fazer autenticação segura
- • Verificar funcionalidades básicas
- • Configurar ambiente de desenvolvimento
Pré-requisitos
Node.js 20+
Claude Code requer Node.js versão 20 ou superior para funcionar corretamente.
# Verificar versão do Node.js
node --version
# Deve retornar v20.x.x ou superior
# Se não tiver instalado: https://nodejs.orgTerminal/Command Line
Conhecimento básico de terminal (Windows CMD/PowerShell, macOS/Linux Terminal).
Conta Anthropic (Opcional)
Para recursos avançados. Pode usar conta gratuita inicialmente.
Instalação via NPM
Passo 1: Instalar Globalmente
# Instalação global do Claude Code
npm install -g @anthropic-ai/claude-code
# Ou usando yarn
yarn global add @anthropic-ai/claude-code
# Ou usando pnpm
pnpm add -g @anthropic-ai/claude-code⚠️ Importante: Se receber erros de permissão no macOS/Linux, use sudoapenas se necessário. Prefira configurar NPM para instalar pacotes globais sem sudo.
Passo 2: Verificar Instalação
# Verificar se Claude Code foi instalado
claude --version
# Deve retornar versão atual (ex: 1.2.0)
# Se comando não encontrado, reinicie terminalPasso 3: Primeira Execução
# Inicializar Claude Code
claude
# Primeira execução irá:
# 1. Criar diretórios de configuração
# 2. Solicitar autenticação
# 3. Fazer download de dependências necessáriasNa primeira execução, Claude Code criará estrutura de pastas em ~/.config/claude-desktop/e solicitará processo de autenticação.
Aula 2: Autenticação e Configuração de Conta
🔧 O Que Você Vai Fazer
Configurar autenticação segura, entender planos disponíveis e fazer primeiros testes de funcionamento.
Processo de Autenticação
Opção 1: Login via Navegador (Recomendado)
# Na primeira execução, Claude Code abrirá navegador
claude
# Você será redirecionado para: https://claude.ai/oauth/authorize
# 1. Faça login com sua conta Google/email
# 2. Autorize Claude Code a acessar sua conta
# 3. Volte ao terminal que estará aguardando💡 Dica: Este método é mais seguro pois não expõe tokens. Claude Code gerencia autenticação automaticamente.
Opção 2: API Key Manual (Avançado)
# Para usar API key personalizada
export ANTHROPIC_API_KEY="seu-api-key-aqui"
# Ou criar arquivo de configuração
echo 'ANTHROPIC_API_KEY=seu-api-key-aqui' >> ~/.claude-config⚠️ Cuidado: API keys customizadas têm custo por token. Para aprendizado, use autenticação via navegador que inclui créditos gratuitos.
Verificação de Funcionamento
# Teste básico de funcionamento
claude
# Quando interface carregar, digite:
Olá Claude Code! Como você funciona?
# Resposta deve aparecer indicando que conexão está ativa
# Teste comando slash:
/help
# Lista todos comandos disponíveis✅ Sinais de Funcionamento Correto
- • Claude responde a perguntas básicas
- • Comando /help lista opções disponíveis
- • Interface carrega sem erros
- • Histórico de conversas é salvo
Aula 3: Interface e Navegação Básica
📚 Conceitos Importantes
Session:
Conversa contínua com Claude mantendo contexto.
Comandos Slash:
Funções especiais iniciadas com / (ex: /help, /clear).
Elementos da Interface
Área de Input
- • Enter: Enviar mensagem
- • Shift+Enter: Nova linha
- • Ctrl+C: Cancelar geração
- • Setas ↑/↓: Navegar histórico
Área de Output
- • Scroll: Navegar respostas longas
- • Ctrl+A: Selecionar tudo
- • Ctrl+C: Copiar selecionado
- • q: Sair de resposta longa
Layout da Interface
┌─────────────────────────────────────────────┐
│ Claude Code v1.2.0 - Session: main │
├─────────────────────────────────────────────┤
│ │
│ [Área de conversação e respostas] │
│ │
│ Claude: Olá! Como posso ajudar você hoje? │
│ │
├─────────────────────────────────────────────┤
│ > Digite sua mensagem aqui_ │
└─────────────────────────────────────────────┘Comandos Slash Essenciais
Lista todos comandos disponíveis com descrições detalhadas.
Limpa histórico da sessão atual. Útil para iniciar conversa nova.
Sai do Claude Code e volta ao terminal normal.
Mostra versão atual do Claude Code e informações do sistema.
Salva sessão atual em arquivo para referência futura.
Aula 4: Primeiros Prompts e Boas Práticas
🔥 Prática Essencial
Hora de testar Claude Code com prompts práticos de desenvolvimento. Foque em ser específico e contextual.
Estrutura de Prompts Eficazes
Fórmula: Contexto + Tarefa + Formato
# ❌ Prompt vago
"Crie uma função JavaScript"
# ✅ Prompt específico
"Contexto: Estou desenvolvendo uma aplicação React para e-commerce
Tarefa: Preciso de uma função que valide CPF brasileiro
Formato: TypeScript com testes unitários Jest e documentação JSDoc"1. Contexto
- • Tecnologia usada
- • Propósito da aplicação
- • Restrições conhecidas
2. Tarefa
- • O que exatamente fazer
- • Requisitos específicos
- • Edge cases a considerar
3. Formato
- • Linguagem/framework
- • Estilo de código
- • Documentação necessária
Exemplos Práticos por Categoria
🔍 Debug de Código
Contexto: Aplicação Next.js 14 com tRPC e Prisma
Problema: Usuários relatam erro 500 ao fazer login
Código problema: [cole seu código aqui]
Stack trace: [cole erro completo]
Preciso de:
1. Análise da causa raiz do erro
2. Solução step-by-step
3. Prevenção de problemas similares
4. Logs para monitoramento futuro⚡ Otimização de Performance
Contexto: Component React renderiza lista de 1000+ itens
Performance atual: 2s para renderizar, FPS cai para 30
Stack: React 18, TypeScript, sem virtualização
Analyze este component e sugira:
1. Técnicas de otimização específicas
2. Implementação de virtualização
3. Memoização estratégica
4. Métricas para medir melhorias
[componente aqui]🏗️ Arquitetura de Sistema
Contexto: Preciso arquitetar sistema de notificações real-time
Requisitos:
- 10k usuários simultâneos
- Push notifications + email + SMS
- Retry logic para falhas
- Dashboard de métricas
Preciso de:
1. Arquitetura completa (diagramas em texto)
2. Stack tecnológica recomendada
3. Padrões de design aplicáveis
4. Pontos de falha e mitigações
5. Estimativa de custos de infraestrutura🎯 Exercício Prático
Sua Vez: Faça Estes Prompts
Peça para Claude revisar um código seu e sugerir melhorias
Escolha conceito técnico complexo e peça explicação didática
Descreva bug real que você enfrentou e veja a análise
Detalhe funcionalidade que precisa implementar
🚀 Parabéns! Módulo 1 Concluído
Você agora tem fundação sólida para Claude Code. Próximo módulo: workflows customizados e comandos reutilizáveis que eliminam 80% da repetição no seu desenvolvimento.