Mantén las sesiones de Claude Code baratas: una lista de verificación de fallos de caché
Trata los cambios de clave de caché, la compactación y los conmutadores beta como operaciones costosas y verifica la tasa de acierto tras el turno cálido.
Tu sesión ha estado cálida y de repente la factura se dispara. La medición de Opus 4.7 indicó un consumo de cuota Q5h aproximadamente 2,4 veces superior a la tasa de Opus 4.6 para conteos de tokens visibles similares. Claude Code 2.1.260 expuso una probable causa de fallo de caché de prompt en /cost y en la línea de estado. Esa etiqueta es una herramienta de triaje; los ahorros siguen dependiendo de la siguiente solicitud.
La etiqueta de causa acota la búsqueda
Un fallo puede provenir de un modelo cambiado, una nueva definición de herramienta, una bandera beta o una reconstrucción del contexto. El campo de causa de /cost te da la primera pista. Si la causa apunta a una configuración que cambiaste, corrige la configuración. Si apunta a una reconstrucción que esperabas, anota el coste y sigue adelante. Úsala para elegir la siguiente entrada a inspeccionar. Una reconstrucción del contexto es el coste esperado de un cambio grande; una reconstrucción inesperada es la que hay que perseguir.
Los cambios de prefijo son la parte costosa
Una caché de prompt solo ayuda cuando el principio de la solicitud se mantiene igual. El prefijo incluye el modelo, el prompt de sistema, las herramientas y los valores beta que envía el cliente. Cambia uno de ellos y el prefijo en caché puede quedar obsoleto. Una edición al inicio de la solicitud es la que hay que vigilar. Agrupar cambios: coloca una nueva herramienta, modelo o beta antes de que la sesión se caliente, o en un punto donde una reconstrucción única sea asequible. Durante una tarea larga, mantén el prefijo estable.
Activar Remote Control en una sesión cálida de Claude Code provoca una reconstrucción única de la caché de prompt porque la función añade un valor anthropic-beta a la clave de caché. Claude Code 2.1.196 y versiones posteriores desactivan Remote Control, /schedule y los conectores MCP de claude.ai cuando ANTHROPIC_BASE_URL apunta a un endpoint no de Anthropic. Si ejecutas un proxy, prueba esa ruta antes de depender de funciones remotas en una sesión larga. Un proxy puede ser un banco de pruebas útil, pero también puede alterar la solicitud.
La compactación es una decisión de presupuesto
La compactación reescribe el contexto, y un contexto reescrito puede romper el prefijo que hacía la sesión barata. Claude Code 2.1.260 movió la auto-compactación para que se active justo antes del límite de 1M de tokens en sesiones de Opus y Fable, mientras que /ultrareview recibió una espera máxima de 45 minutos en lugar de 30.
Forzar la compactación temprano puede hacer que pagues una reconstrucción para ahorrar tokens que aún no necesitabas. Espera hasta el límite y la herramienta gestiona el desbordamiento, pero la tarea aún tiene que sobrevivir a un contexto comprimido. El límite es una válvula de seguridad, no un objetivo. Un contexto comprimido puede mantener la tarea en marcha, o puede descartar el detalle que el siguiente paso necesita. Para trabajo largo, compacta en un límite de tarea, no a mitad de una refactorización delicada. Trata la espera más larga de /ultrareview como un elemento de coste. Presupuéstalo. Anota el conteo de tokens antes y después, para que el coste de la reconstrucción sea visible.
La lista de verificación convierte la factura en una pregunta de depuración
La lista de abajo es la parte que conservas. Cada elemento es una comprobación de un minuto. Ejecuta los elementos en el orden en que aparecen los modos de fallo: causa, prefijo, conmutación beta, compactación, verificación. Usa la lista para abaratar el siguiente turno cálido. La factura actual es historia.
- Revisa /cost para la causa del fallo y anota si sigue a un cambio de configuración.
- Congela el modelo, el prompt de sistema, las herramientas y las banderas beta hasta que el turno cálido esté verificado.
- Evita activar el control remoto a mitad de sesión a menos que puedas permitirte una reconstrucción.
- Deja que la auto-compactación se ejecute cerca del límite en lugar de forzarla temprano.
- Verifica la tasa de acierto tras el turno cálido antes de iniciar la siguiente tarea larga.
La línea base A/B de claude-code-cache-fix v3.0.0 en Claude Code v2.1.117 informó de una tasa de acierto de caché del 95,5% en el primer turno cálido a través del proxy frente al 82,3% directo. Esa comparación no es una promesa para tu configuración. El turno cálido es el número a vigilar. Registra la tasa de acierto, la etiqueta de causa y la configuración que cambiaste, para que el próximo pico sea más fácil de atribuir. Si el turno cálido aún falla, usa la etiqueta de causa para encontrar la siguiente entrada que congelar.
