Claude Code: instalação, autenticação e primeiro uso real

# Pré-requisito: Node.js 18+ instalado
node --version   # deve ser >= 18

# Instalar Claude Code globalmente
npm install -g @anthropic-ai/claude-code

# Verificar instalação
claude --version

# Autenticação — duas opções:

# Opção 1: via conta Claude.ai (Pro ou Team) — recomendado para início
claude
# Abre um fluxo OAuth no browser — autoriza e volta ao terminal

# Opção 2: via API key da Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."
claude  # usa a key automaticamente
# Ou coloque no ~/.bashrc / ~/.zshrc para persistir

# Verificar que está autenticado:
claude --version   # exibe modelo em uso e créditos disponíveis

# Configuração inicial (opcional mas recomendado):
claude config set preferredModel claude-sonnet-4-5   # define modelo padrão
claude config set theme dark                          # tema do terminal

# Modo interativo padrão — uma sessão de conversa
cd meu-projeto
claude

# Interface interativa abre. Você digita, Claude responde e age.
# Exemplos de prompts que funcionam bem:

# "O que esse projeto faz? Me explique a arquitetura"
# → Claude lê os arquivos principais e descreve o projeto

# "Tem algum bug óbvio no arquivo src/auth.ts?"
# → Claude lê o arquivo e analisa

# "Adicione rate limiting na rota POST /api/login"
# → Claude edita o arquivo, possivelmente instala dependências, roda testes

# "Faça commit com uma mensagem descritiva"
# → Claude executa git add + git commit com mensagem gerada

# Comandos especiais dentro da sessão interativa:
# /help                → lista comandos disponíveis
# /clear               → limpa o histórico da sessão
# /compact             → compacta o contexto (economiza tokens em sessões longas)
# /cost                → exibe custo da sessão atual
# /model claude-opus-4-6  → troca o modelo na sessão
# Ctrl+C               → cancela a ação atual sem encerrar
# /exit ou Ctrl+D      → encerra a sessão

# Claude Code tem um conjunto de ferramentas nativas que usa internamente:

# Leitura de arquivos
# → Glob (encontrar arquivos por padrão: "src/**/*.ts")
# → Read (ler conteúdo de um arquivo específico)
# → Grep (buscar string ou regex em arquivos)

# Escrita e edição
# → Edit (fazer substituição exata em arquivo existente)
# → Write (criar novo arquivo ou reescrever existente)

# Execução de comandos
# → Bash (rodar qualquer comando shell com confirmação do usuário)

# Quando Claude usa cada uma:
# - Você pede "o que tem na pasta src/" → Glob
# - Você pede "explique o arquivo main.py" → Read
# - Você pede "onde usamos a função parseToken?" → Grep
# - Você pede "corrija o bug na linha 42" → Edit (cirúrgico)
# - Você pede "crie um novo módulo de autenticação" → Write
# - Você pede "rode os testes e me diga se passam" → Bash

# IMPORTANTE: Bash pede confirmação por padrão
# Claude mostra o comando antes de rodar:
# "Posso executar: npm test -- --coverage"
# Você aprova (Enter) ou recusa (Ctrl+C)

# Você pode ver o que Claude está fazendo em tempo real —
# cada ação de ferramenta é exibida antes de ser executada

# 1. Contexto importa: rode claude do diretório raiz do projeto
cd ~/projetos/minha-api
claude   # Claude enxerga todo o projeto

# 2. Seja específico no que quer, vago no como
# ❌ "edite o arquivo auth.ts linha 42 para verificar se o token expirou"
# ✅ "a autenticação está deixando passar tokens expirados — corrija"

# 3. Para sessões longas, use /compact periodicamente
# Claude tem janela de contexto de 200k tokens mas sessões longas ficam lentas
# /compact resume o histórico e libera espaço

# 4. Use /cost para monitorar gasto
/cost   # mostra tokens usados e custo estimado da sessão

# 5. Para tarefas grandes, divida em sessões
# Uma sessão = uma tarefa coesa
# "Implemente autenticação" → uma sessão
# "Adicione testes para o módulo de autenticação" → próxima sessão

# 6. CLAUDE.md no projeto economiza contexto nas próximas sessões
# Em vez de explicar a stack toda vez, documente uma vez no CLAUDE.md
# Claude lê automaticamente no início de cada sessão

# 7. Para revisar o que Claude vai fazer antes de aprovar:
# Pause quando Claude propõe um Bash e leia o comando inteiro
# Claude Code é auditável — você sempre vê antes de aprovar