Otimização de velocidade no Claude Code: diagnosticar sessões lentas

Quando o Claude Code parece lento, o modelo raramente é o único culpado. O mais comum é histórico grande, busca ampla por arquivos, logs sem filtro ou instruções abertas demais. Neste site, as sessões ficavam pesadas quando escrita, tradução, build, deploy e debug ficavam no mesmo histórico. A melhoria veio de olhar /usage e /context, compactar com intenção e limitar o escopo. Este guia mostra uma rotina para iniciantes: diagnosticar, reduzir exploração, preparar CLAUDE.md, usar subagentes e evitar erros que pioram a velocidade.

Diagnostique antes de ajustar

Comece com /usage. Usuários de API veem tokens da sessão e custo estimado localmente; assinantes veem uso do plano e atribuição. Use como painel, não como fatura final. Depois use /context. Ele mostra se o peso vem de histórico, memory, MCP, ferramentas ou regras. Se o problema é contexto permanente, trocar modelo não resolve. /compact resume o histórico. Diga o que deve ser preservado: arquivos alterados, testes falhando, decisões e perguntas abertas.

# Run these inside Claude Code before changing the workflow
/usage
/context
/compact Preserve changed files, test failures, decisions, and open questions

Crie um workflow padrão rápido

O fluxo básico é: /usage e /context antes de tarefas grandes, /compact em pausas naturais e /clear ao mudar para tarefa sem relação. Depois, limite a leitura. Informe arquivos iniciais, teste a rodar, diretórios a ignorar e evidências esperadas na resposta. Mantenha CLAUDE.md curto. A documentação de memory recomenda colocar ali apenas fatos necessários em toda sessão; fluxos específicos devem ir para rules ou skills.

claude -p "Fix only the null-check bug in src/api/auth.ts.
Read src/api/auth.ts and tests/auth.test.ts first.
Do not scan node_modules, dist, coverage, or unrelated feature folders.
Return the changed files, commands run, and remaining risks."

Coloque no CLAUDE.md apenas fatos sempre necessários

O exemplo é curto de propósito: dá ao Claude um mapa estável do repositório sem transformar memory em depósito permanente.

# CLAUDE.md

## Project commands
- Build: npm run build
- Test: npm run test
- Type check: npm run typecheck

## Fast navigation
- API code: src/api/
- UI components: src/components/
- Tests: tests/

## Do not read unless explicitly requested
- node_modules/
- dist/
- coverage/
- .wrangler/

## Compact instructions
When compacting, preserve changed files, failing tests, decisions, credentials policy, and next actions.

Meça com um benchmark pequeno

Não otimize só por sensação. Rode tarefa semelhante com prompt amplo e com prompt delimitado, comparando tempo, arquivos lidos e evidência final.

$runs = @(
  @{ Name = "wide"; Prompt = "Find and fix the auth bug in this project" },
  @{ Name = "scoped"; Prompt = "Fix the null-check bug in src/api/auth.ts only" }
)

foreach ($run in $runs) {
  $elapsed = Measure-Command { claude -p $run.Prompt }
  [pscustomobject]@{
    Name = $run.Name
    Seconds = [math]::Round($elapsed.TotalSeconds, 1)
  }
}

Três casos de uso práticos

Bug pequeno

Envie arquivo, teste falhando e critério de aceite. A exploração cai e a correção fica mais rápida.

Refatoração grande

Separe investigação, mudança, teste e revisão. Compacte entre fases mantendo decisões e riscos.

Pipeline de conteúdo

Traduções e verificações repetitivas podem ir para subagentes. A sessão principal guarda decisões e validação final.

Falhas a evitar

Usar /compact sem dizer o que preservar pode perder detalhes importantes.
Colocar tudo no CLAUDE.md cria custo permanente em cada sessão.
Remover verificação para ganhar tempo gera retrabalho. Filtre logs, mas preserve as linhas de erro.

Documentação oficial verificada

Claude Code costs and /usage: https://code.claude.com/docs/en/costs
Claude Code monitoring and telemetry: https://code.claude.com/docs/en/monitoring-usage
Claude Code memory and CLAUDE.md: https://code.claude.com/docs/en/memory

O que foi verificado nesta reescrita

Atualizado com base nas docs atuais de Costs, Monitoring e Memory, usando /usage, /context, /compact e CLAUDE.md.

Próximo passo

Se sua equipe quer acelerar o Claude Code, não comece comprando modelo maior ou adicionando automação. Primeiro padronize prompt, memory e evidência de verificação.