Mecânica da API Claude: requisição, resposta e stop_reason
Como cada chamada à API do Claude é montada e lida: os campos da requisição e da resposta, o stop_reason, o usage, o streaming e os limites de taxa.
33 posts
Como cada chamada à API do Claude é montada e lida: os campos da requisição e da resposta, o stop_reason, o usage, o streaming e os limites de taxa.
Em que ordem um projeto com modelo de linguagem deve nascer, ser validado, ir para produção e ser mantido, com portões de avaliação e rollback.
Como isolar a chamada ao modelo numa camada única do código, separar os erros que valem nova tentativa e manter testes sem depender da rede.
Como mandar imagens e PDFs ao modelo, quanto isso custa em tokens e como reaproveitar um arquivo com a Files API sem reenviá-lo a cada chamada.
Como escolher o modelo medindo qualidade, latência e custo num conjunto de exemplos parecido com o seu tráfego real, em vez de escolher o maior.
Quando vale pedir ao modelo que pense mais antes de responder, quanto isso custa em tokens e tempo, e como medir se o ganho compensa.
Como obter respostas em formato que o código lê sem adivinhar, com a saída estruturada e o uso estrito de ferramentas, e o que cada um garante.
Como fazer o modelo apontar de onde tirou cada afirmação, com citações conferíveis, e como validar essas referências no código.
Como descrever uma ferramenta, devolver erros sem derrubar o laço, validar argumentos e tratar vários pedidos de uma vez com tool use.
A diferença entre skills, plugins e outras peças do Claude Code, onde cada uma mora, qual regra de precedência vale e como empacotar para o time.
Como construir um agente com Claude de duas formas, com o Agent SDK ou com um laço próprio sobre a API, e onde colocar os controles que não dependem do modelo.
Como o Claude Code decide se uma ação pode acontecer, como as permissões se combinam e como rodá-lo sem interface num script ou pipeline de CI.