Consejos // Claude en la práctica

Tips para trabajar mejor con Claude

Un tip corto por vez, con un ejemplo para copiar. Recórrelos al azar o busca el que necesitas.

APIAvanzadoClaude API

Streaming: que se corte el stream no es mensaje completo

Un turno armado desde un stream cortado puede dejar un tool_use truncado en el historial y romper la request siguiente.

Los argumentos de un tool_use llegan como JSON parcial en varios deltas: recién se pueden parsear en content_block_stop. Guardá el turno en el historial solo después de message_stop. Si el stream se interrumpe, descartá el turno parcial y reintentá; y mirá stop_reason antes de seguir el loop.

Ejemplo
if event.type == "content_block_stop":
    parsear_input_del_bloque()   # recién acá es JSON válido
if event.type == "message_stop":
    historial.append(turno)      # turno completo
# stream cortado antes → descartar turno parcial y reintentar
#streaming#tool-use#robustez