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

Sacá el formato del prompt y ponelo en un JSON schema

Pedir 'devolvé solo JSON' funciona hasta que aparece un caso que no probaste; structured outputs lo restringe en la generación.

JSON outputs: pasás un schema en output_config.format con type json_schema y la respuesta lo cumple. Strict tool use: strict en true en la definición de la tool valida los argumentos que Claude envía. Costos: la primera llamada con un schema nuevo es más lenta (se cachea 24 hs) y suben los tokens de entrada. Sigue habiendo que revisar stop_reason: un refusal o un max_tokens pueden devolver algo que no parsea. No se combina con prefilling.

Ejemplo
"output_config": {
  "format": { "type": "json_schema", "schema": { ...tu schema... } }
}
// En una tool: "strict": true
// Chequeá stop_reason antes de parsear.
#structured-outputs#json-schema#strict-tool-use