Duración de la caché (TTL)
El TTL de una caché es el tiempo que un prefijo de prompt permanece guardado sin usarse antes de que la siguiente petición tenga que procesarlo y escribirlo otra vez.
En la API de Anthropic, la duración por defecto es de cinco minutos. Una hora cuesta el doble del precio base de entrada al escribir, frente a 1,25 veces para cinco minutos, a septiembre de 2026. Cada lectura reinicia el plazo sin recargo. El reloj empieza al comenzar la petición, no al terminar la respuesta, así que una respuesta larga consume parte de ese plazo.
Elegir una duración depende de las pausas. Tras veinte minutos sin actividad, una caché de una hora permite leer el prefijo en vez de reconstruirlo. En una serie de peticiones separadas por menos de cinco minutos, solo eleva el precio de escritura.
Normalmente el agente elige por ti. A septiembre de 2026, Claude Code usa una hora para la conversación principal con uso incluido en una suscripción Claude y cinco minutos con clave de API, proveedor en la nube o créditos. Los subagentes usan cinco minutos por defecto. promptCacheTtl permite cambiar la elección de la conversación principal.
La primera petición después del vencimiento es la cara: vuelve a procesar todo el contexto. Con lecturas a una décima parte y escrituras a 1,25 veces o más, reconstruir una vez un contexto grande cuesta más que leerlo repetidamente desde la caché.