Claude (Anthropic): IA do código ao produto

O cérebro do stack: o Claude, da Anthropic. Ele aparece em dois papéis bem diferentes — e separar os dois é metade do entendimento.

O que é

Família de modelos de IA da Anthropic, usada de duas formas:

• Claude Code — agente de terminal que ajuda a construir o produto (lê o repo, planeja, edita, abre PR).
• Anthropic SDK — a IA dentro do produto, como feature pro usuário final.

Mesmo modelo por baixo, papéis distintos.

Onde usamos

• Engenharia: Claude Code no dia a dia (entender código, refactor, debugging, PRs).
• Produto: resumos de conversa, narrativas mensais, copiloto com streaming, classificação e extração de texto — via Anthropic SDK.
• CI: o AI Code Review das PRs (#06) também é Claude.

Conceitos-chave

• Escolha de modelo por tarefa. Há modelos mais fortes (raciocínio difícil, código complexo) e mais rápidos/baratos (classificação, resumo simples). Não use o mais caro pra tudo nem o mais simples pra tarefa difícil — decida por custo × qualidade.
• Janela de contexto grande permite jogar documentos inteiros no prompt — mas contexto relevante vence contexto volumoso.
• Tool use (function calling) — o modelo chama funções suas pra buscar dado ou agir, em vez de alucinar.
• Saída estruturada — quando a resposta vira dado, force formato (JSON/schema) e valide; não confie no "provavelmente respondeu certo".

Boas práticas

• Prompt é código: versionado no repo, revisado, melhorado com base em resultado (Lealdade a Dados).
• Dê exemplos (few-shot) pra tarefas com formato específico — vale mais que instrução longa.
• Controle custo: pré-gere em background (Trigger.dev) em vez de ao vivo; reaproveite contexto com prompt caching; agrupe (batch) quando der.
• Meça qualidade com um conjunto de exemplos de referência antes de mudar prompt em produção.
• Streaming pra resposta nascer na tela em vez de travar.

Pegadinhas

• ⚠️ A IA erra/alucina. Toda feature precisa de plano pra isso: citação da fonte, revisão humana, fallback. Confiança cega vira bug com cara de fato.
• ⚠️ Custo e latência são decisão de arquitetura, não detalhe.
• ⚠️ Dado sensível que vai pro modelo é decisão de privacidade — anonimize quando possível.
• ⚠️ Versão do modelo muda comportamento — fixe a versão em produção e teste antes de subir.

Quando usar (e quando não)

Use pra texto, resumo, classificação, geração, extração e apoio à decisão. Não use pra terceirizar julgamento de produto nem pra lógica que precisa ser 100% determinística sem revisão.

Claude é alavanca, não piloto automático. Acelera de quem constrói a quem usa — a responsabilidade pelo resultado continua humana.

Próximo da série: #03 — Supabase.