CLI Completo

# 1. Modo interativo (REPL) — sessão contínua com histórico e contexto acumulado
claude

# 2. Modo one-shot — uma única pergunta, resposta e encerra
claude "explique este código"
claude "crie um componente React de botão com TypeScript"
claude "qual é a diferença entre Promise.all e Promise.allSettled?"

# 3. Pipe input — envia conteúdo via stdin
cat arquivo.py | claude "revise este código e sugira melhorias"
git diff HEAD~1 | claude "escreva um commit message para este diff"
cat error.log | claude "o que causou este erro?"

# 4. Com arquivo de entrada
claude --file problema.txt
claude --file especificacao.md "implemente o que está descrito neste arquivo"

# Opus — mais capaz, mais lento, mais caro. Para tarefas complexas de arquitetura.
claude --model claude-opus-4-5

# Sonnet — equilíbrio ideal entre qualidade e velocidade. Padrão recomendado.
claude --model claude-sonnet-4-6

# Haiku — mais rápido, mais barato. Para tarefas simples e repetitivas.
claude --model claude-haiku-4-5

# Definir modelo padrão via variável de ambiente (evita digitar toda vez)
export CLAUDE_MODEL=claude-sonnet-4-6

# Adicionar diretório inteiro ao contexto (útil para monorepos)
claude --add-dir ./src
claude --add-dir ./packages/ui --add-dir ./packages/api

# Formato de saída
claude --output-format text     # texto simples (padrão)
claude --output-format json     # JSON estruturado (bom para scripts)
claude --output-format stream-json  # JSON streamado linha por linha

# Exemplo: processar saída JSON com jq
claude --output-format json "liste as funções exportadas em src/utils.ts" | jq '.message'

# Output detalhado para debugging
claude --verbose "por que este teste está falhando?"

# Padrão: confirma ações potencialmente destrutivas (deletar arquivos, etc)
claude

# Plan mode: apenas planeja, não executa nenhuma ação
# Ótimo para entender o que será feito antes de autorizar
claude --no-auto-accept

# CUIDADO: aceita TUDO automaticamente sem pedir confirmação
# Use apenas em ambientes controlados (CI, containers, projetos descartáveis)
claude --dangerously-skip-permissions

# Definir ferramentas permitidas explicitamente
claude --allowedTools Read,Write,Bash
claude --allowedTools Read  # apenas leitura, nunca modifica nada

# Ajuda e informações
/help              # lista todos os comandos disponíveis
/status            # mostra status da sessão (tokens usados, modelo, custo estimado)
/cost              # mostra custo acumulado da sessão atual
/model             # troca o modelo durante a sessão

# Gerenciamento de contexto
/clear             # limpa todo o histórico da conversa (contexto zerado)
/compact           # comprime o contexto mantendo apenas o essencial
                   # útil quando a sessão fica muito longa e o contexto enche

# Memória persistente
/memory            # abre o arquivo de memória para edição
                   # conteúdo persiste entre sessões

# Ferramentas de desenvolvimento
/review            # inicia um review de Pull Request
                   # pode aceitar número ou URL do PR

# Exemplo de uso do /compact
# Após uma sessão longa de debugging:
> /compact
# Claude resume o contexto em um sumário e continua de onde parou

# Obrigatória: chave de API da Anthropic
export ANTHROPIC_API_KEY="sk-ant-api03-..."

# Opcional: modelo padrão (evita usar --model toda vez)
export CLAUDE_MODEL="claude-sonnet-4-6"

# Opcional: para usar com proxies ou gateways corporativos
export ANTHROPIC_BASE_URL="https://seu-gateway.empresa.com"

# Opcional: desabilitar telemetria de uso
export CLAUDE_TELEMETRY_DISABLED=true

# Configuração persistente em ~/.zshrc ou ~/.bashrc
cat >> ~/.zshrc << 'EOF'
# Claude Code
export ANTHROPIC_API_KEY="sk-ant-api03-..."
export CLAUDE_MODEL="claude-sonnet-4-6"
EOF
source ~/.zshrc

# Controle de execução
Ctrl+C    # cancela a ação em andamento (Claude para de digitar/executar)
Ctrl+D    # encerra a sessão REPL (equivalente a /exit)

# Navegação no histórico
↑ (seta cima)    # prompt anterior no histórico da sessão
↓ (seta baixo)   # próximo prompt no histórico

# Edição de texto
Tab              # autocomplete de caminhos de arquivo
Ctrl+A           # ir para o início da linha
Ctrl+E           # ir para o final da linha
Ctrl+U           # apagar da posição atual até o início da linha
Ctrl+K           # apagar da posição atual até o final da linha

# Formatação de prompts longos
# Use \ + Enter para continuar o prompt na próxima linha:
> Analise o arquivo src/auth.ts \
  e identifique possíveis vulnerabilidades de segurança