El almacenamiento en caché de prompts en Claude funciona almacenando el trabajo computacional realizado sobre los mensajes para que pueda reutilizarse en solicitudes de seguimiento. Esto hace que las solicitudes que usan contenido en caché sean más baratas y más rápidas de ejecutar.

El proceso sigue un patrón simple: tu solicitud inicial escribirá en la caché, y las solicitudes de seguimiento pueden leer de la caché. La caché vive durante 5 minutos, por lo que esta función solo es útil si envías el mismo contenido repetidamente, pero esto ocurre con mucha frecuencia en aplicaciones reales.
Puntos de interrupción de caché (Cache Breakpoints)
El trabajo realizado sobre los mensajes no se almacena en caché automáticamente. Tenemos que agregar manualmente un "punto de interrupción de caché" a un bloque. El trabajo realizado para todo lo anterior al punto de interrupción se almacenará en caché, y la caché solo se usará en solicitudes de seguimiento si el contenido hasta el punto de interrupción inclusive es idéntico.

Cuando necesites agregar puntos de interrupción de caché, debes usar la forma extendida para escribir bloques de texto en lugar de la forma abreviada. Aquí está la diferencia:
# Forma corta: no se pueden agregar puntos de interrupción de caché
user_message = {
"role": "user",
"content": "Hi there!"
}
# Forma larga: requerida para puntos de interrupción de caché
user_message = {
"role": "user",
"content": [
{
"type": "text",
"text": "Hi there!",
"cache_control": {
"type": "ephemeral"
}
}
]
}Cómo funcionan los puntos de interrupción de caché
Los puntos de interrupción de caché abarcan mensajes y también pueden almacenar en caché mensajes del asistente. Cuando colocas un punto de interrupción, todo lo anterior a ese punto se almacena en caché. Recuerda: ¡el contenido debe ser idéntico para usar la caché!

En una solicitud de seguimiento, Claude lee el trabajo procesado previamente desde la caché en lugar de reprocesarlo:

Ubicación del punto de interrupción
¡No estás restringido a bloques de texto! Puedes agregar puntos de interrupción de caché a las indicaciones del sistema y a las definiciones de herramientas. Estas son en realidad las oportunidades de almacenamiento en caché más comunes, ya que rara vez cambian entre solicitudes.
# Definiciones de herramientas con punto de control de caché
tools = [
add_duration_to_datetime_schema,
get_current_datetime_schema,
{
"name": "set_reminder",
"description": "Sets a reminder...",
"input_schema": { ... },
"cache_control": {"type": "ephemeral"}
}
]
# Indicación del sistema con punto de control de caché
system = [
{
"type": "text",
"text": "You are a senior software...",
"cache_control": {"type": "ephemeral"}
}
]Orden de la caché
Detrás de escena, las herramientas, las indicaciones del sistema y los mensajes se unen en ese orden específico cuando se envían a Claude. Esto afecta la forma en que funcionan tus puntos de interrupción de caché.

Puedes agregar hasta cuatro puntos de interrupción de caché en total. Si colocas un punto de interrupción en tu última herramienta, todo lo anterior a esa herramienta se almacenará en caché, pero la indicación del sistema y los mensajes no. Esto te brinda un control detallado sobre qué se almacena en caché según lo que cambia en tu aplicación.
Longitud mínima de contenido
Existe una longitud mínima para el almacenamiento en caché, y depende del modelo. Para Claude Haiku 4.5, el modelo que usa este curso, el contenido debe tener al menos 4,096 tokens de longitud para ser almacenado en caché. Esta es la suma de todos los mensajes y bloques que intentas almacenar en caché, no de bloques individuales.
Un mensaje como "Hi there!" es demasiado corto para almacenarse en caché, pero un prompt genuinamente largo alcanza el mínimo. El contenido por debajo del mínimo simplemente se procesa sin almacenarse en caché, y no se devuelve ningún error. Para saberlo, observa el uso (usage) de la respuesta: cache_creation_input_tokens y cache_read_input_tokens serán ambos 0.
La clave para un almacenamiento en caché de prompts efectivo es identificar las partes de tus solicitudes que se mantienen constantes -por lo general tus indicaciones del sistema y definiciones de herramientas- y colocar puntos de interrupción de manera estratégica para maximizar los aciertos de caché mientras minimizas el reprocesamiento.