reasoning_effort (Chat Completions) o un reasoning.effort (Responses) distinto en cualquier solicitud, y Phaseo cambia el esfuerzo de Claude sin reiniciar su caché de prompts. No tienes que cambiar nada más en tu código, siempre que devuelvas el razonamiento de Claude sin cambios en cada solicitud.
Phaseo sigue enviando a Claude el esfuerzo de la primera solicitud de tu conversación y añade cada cambio como un marcador de esfuerzo después de tu nuevo mensaje. Todo lo que está antes del marcador se mantiene igual, así que Claude lo lee de la caché. Si descartas el razonamiento, Phaseo cambia en su lugar el esfuerzo de nivel superior, y Claude vuelve a procesar todo desde su primera respuesta en adelante en lugar de leerlo de la caché.
Cómo mantiene Phaseo la caché
Claude solo lee una conversación en caché cuando el inicio de la solicitud es idéntico byte a byte, y el esfuerzo de nivel superior forma parte de ese inicio. El esfuerzo por mensaje de Anthropic cambia el nivel dentro demessages, con un mensaje system que tiene content vacío y un output_config.effort. Phaseo escribe esos marcadores por ti:
Phaseo no guarda nada entre solicitudes. Cada respuesta de Claude termina con una entrada de razonamiento que registra el nivel con el que se ejecutó, y Phaseo reconstruye cada marcador anterior, en el mismo lugar, a partir de las entradas que devuelves:
Los mensajes que devuelves nunca se modifican. Los marcadores solo existen en la solicitud que Phaseo envía a Claude.
Devuelve el razonamiento sin cambios
La entrada de esfuerzo no tiene texto. En Chat Completions es la última entradareasoning.encrypted de reasoning_details:
reasoning de output, con un id que empieza por rs_effort_:
Cambia el esfuerzo en tu código
Añade la respuesta completa de Claude a tu conversación y luego establece el esfuerzo que quieras en la siguiente solicitud. Elcache_control de nivel superior activa la caché en las rutas de Claude; consulta Caché de prompts.
Chat Completions
Responses
Phaseo no guarda las respuestas, así que envía la conversación completa eninput, incluidos todos los elementos de output.
Anthropic Messages
En/v1/messages, envía tú mismo el marcador: un mensaje system con content vacío y output_config.effort. Mantén el mismo output_config.effort de nivel superior en cada solicitud, y deja cada marcador en su sitio en las solicitudes posteriores. Phaseo añade la cabecera beta mid-conversation-output-config-2026-07-01, así que no tienes que enviarla.
cURL
- Justo después de un mensaje de usuario: la respuesta de Claude a ese mensaje usa el nuevo nivel.
- En cualquier otro lugar, por ejemplo entre la respuesta de Claude y tu siguiente mensaje, como en el ejemplo anterior: el nuevo nivel empieza con tu siguiente mensaje.
Cuándo el cambio reinicia la caché
Phaseo cambia el esfuerzo de nivel superior, como hace con otros proveedores, cuando:- Falta el razonamiento. Tu última respuesta de Claude no tiene entrada de esfuerzo, porque tu cliente descartó
reasoning_detailso los elementosreasoning. - El cambio llega entre pasos del bucle de herramientas. Tu último mensaje solo contiene resultados de herramientas, así que un marcador solo se aplicaría a partir de tu siguiente mensaje. Phaseo cambia el esfuerzo de nivel superior para que este paso se ejecute con el nivel que pediste, y los cambios posteriores vuelven a usar marcadores.
- La solicitud no establece ningún esfuerzo o desactiva el razonamiento. Envía
reasoning_effortoreasoning.efforten cada solicitud."none"yreasoning.enabled: falsedesactivan el razonamiento. - La ruta no lo admite. Consulta Modelos compatibles.
Modelos compatibles
En las demás rutas, incluido Claude en Azure, un cambio de esfuerzo va al nivel superior.
Comprueba que la caché se mantuvo
Lee los recuentos de caché en la solicitud posterior a un cambio:usage.prompt_tokens_details.cached_tokens en Chat Completions, usage.input_tokens_details.cached_tokens en Responses y usage.cache_read_input_tokens en Anthropic Messages. Campos de uso y precios enumera todos los campos.
Medimos la misma conversación de Chat Completions de cinco solicitudes en anthropic/claude-haiku-5.5 el 11 de noviembre de 2026, una vez devolviendo las entradas de esfuerzo y otra sin ellas. El esfuerzo fue high, high, low, low, high, y un documento de 3.400 tokens llegó en el segundo mensaje: