Saltar al contenido

intermedio

Prompting para Claude: Opus 5.5, Sonnet 5.5 y Haiku 5.5

11 min de lectura

Cubre: Claude Fable 5.1, Opus 5.5, Sonnet 5.5 y Haiku 5.5

Respuesta rápida:

Ajusta el esfuerzo como parámetro en vez de pedirlo dentro del prompt, añade cada turno del asistente byte a byte con sus bloques de pensamiento, inyecta recordatorios como mensajes de sistema a mitad de conversación, y pon o quita la verificación según el modelo: fuera en Opus 5.5, dentro en Sonnet 5.5 y Haiku 5.5.

Casi todo lo que antes se arreglaba desde el prompt se ha mudado a dos sitios: un parámetro, effort, que decide cuánto piensa el modelo, y la forma en que tu arnés guarda la conversación. El prompt sigue mandando en lo que pides. Ya no manda en cuánto cuesta pensarlo.

El esfuerzo es el mando, y no vale el mismo número en todos los modelos

effort es la palanca principal sobre profundidad, calidad, latencia y coste. Hay cinco niveles —low, medium, high, xhigh, max— y el valor por defecto cambia por modelo: medium en Opus 5.5, high en Sonnet 5.5 y medium en Haiku 5.5.

El nombre no significa la misma cantidad de pensamiento: Opus 5.5 en medium iguala o supera a Opus 5 en high. Un prompt afinado a high en la generación anterior no lo está en esta: al cambiar de modelo hay que barrer la escalera otra vez.

Dos trampas de fontanería. Cambiar el effort de nivel superior entre peticiones invalida la caché de prompt; el cambio por mensaje de la beta mid-conversation-output-config-2026-07-01 la conserva. Y budget_tokens está muerto: devuelve 400 en Claude 4.7 y posteriores.

El razonamiento tampoco se pide por escrito. Un prompt que le pide escribir sus pasos en <thinking> puede ser rechazado, y pedirle que repita su razonamiento dispara la categoría reasoning_extraction. Apóyate en el pensamiento y, si el coste aprieta, baja effort.

text

Parámetros de la petición. Nada de esto va dentro del prompt:
effort = medium    # Opus 5.5 medium · Sonnet 5.5 high · Haiku 5.5 medium
# Cambiarlo entre peticiones invalida la caché de prompt.

El historial es de solo añadir

La restricción más grande de la generación: cada turno del asistente se añade al historial byte a byte tal como lo devolvió la API, con sus bloques de pensamiento dentro. No se editan turnos anteriores, no se reconstruyen system ni tools entre peticiones, no se resume nada en su sitio.

En Claude 5.1 y posteriores, cualquiera de esas ediciones invalida todos los bloques de pensamiento posteriores, y un prefijo que no cuadra puede lanzar el error bound to a different conversation. thinking.block_binding.prefix_mismatch_behavior, con "error" y "drop_block" en la beta thinking-binding-controls-2026-08-01, decide cuál de los dos fallos te toca.

Tres conversaciones de cinco turnos. Editar un turno anterior invalida todos los bloques de pensamiento posteriores; reconstruir system o tools los invalida todos; añadir un mensaje de sistema a mitad de conversación no invalida ninguno.Abre el diagrama a tamaño completo

Lo que sí se hace es meter el recordatorio como mensaje de sistema a mitad de conversación o acotado al turno, en la beta mid-conversation-system-clear-at-2026-08-21. Reescribir el system de arriba para colgarle una línea nueva es el fallo que esto sustituye.

text

Mensaje de sistema insertado a mitad de conversación:

Recordatorio desde este punto y hasta el final: [la regla nueva].

Ya no hay temperature: lo que quieres, lo escribes

temperature, top_p y top_k se retiraron en la versión de API 2026-10-21: poner cualquiera de ellos devuelve 400. El proveedor indica omitirlos y guiar el comportamiento desde el prompt.

Quien se apoyaba en temperature: 0 para tener una salida estable tiene que decir qué es lo estable: el mismo formato, las mismas secciones, el mismo orden. Quien subía top_p por variedad tiene que pedir la variación que quería.

Quedan el esfuerzo y las instrucciones explícitas de formato y longitud. En Sonnet 5.5 y Haiku 5.5 el pensamiento y las respuestas se alargan mucho en xhigh y max, reservados para trabajo con una mejora medida.

text

Devuelve la ficha con estas cuatro secciones y en este orden: Resumen,
Evidencia, Riesgos, Siguiente paso. Si un dato no está en el contexto,
escribe "sin dato" en esa línea en lugar de rellenarla con una estimación.

La verificación se pone o se quita según el modelo

Quítala en Opus 5 y Opus 5.5. Los dos verifican su trabajo sin que se lo pidas, y las instrucciones heredadas —"incluye un paso de verificación final", "usa un subagente para verificar"— provocan sobreverificación: tokens y latencia sin ganancia de calidad. Se borran, no se reescriben.

text

Líneas que se eliminan al pasar a Opus 5.5:
"Include a final verification step for any non-trivial task."
"Use a subagent to verify your work."

Ponla en Sonnet 5.5 y Haiku 5.5: los dos informan de un cambio como hecho sin ejecutar la comprobación que lo ejercite, y los niveles nombrados son low y medium en los dos.

text

Antes de decir que un cambio está hecho, ejecuta la comprobación que
lo ejercite: el test o el comando que toca el código que acabas de
escribir. Si falta una dependencia, instálala con el gestor de
paquetes del proyecto, nunca con sudo. Si falla, dilo con la salida.

Cuando se comporta mal

Una regla deja de aplicarse a los tres turnos y el pensamiento llega vacío. El arnés reescribió el system para colgarle el recordatorio, o reconstruyó tools entre peticiones. En Claude 5.1 y posteriores eso invalida todos los bloques siguientes. Mueve el recordatorio a un mensaje de sistema a mitad de conversación y deja de tocar el prefijo.

La petición devuelve 400 sin más pista. Casi siempre es temperature, top_p o top_k, retirados en 2026-10-21; budget_tokens, desde Claude 4.7; thinking: {"type": "disabled"} en Opus 5.5, donde pensar no se puede apagar; o tool_choice de tipo any o tool en Opus 5.5 y Sonnet 5.5. Es un problema de petición, no de redacción.

Cierra el turno describiendo lo que va a hacer a continuación. Un end_turn de solo texto es un informe, no una prueba de que el trabajo esté terminado. Sin instrucción, el modelo describe el paso siguiente o pide permiso para algo que la petición ya autorizaba. Dile que nadie está mirando y que siga con lo reversible.

Qué cambió y cuándo

  • 21 de octubre de 2026. Versión de API 2026-10-21: temperature, top_p y top_k fuera; ponerlos devuelve 400.
  • 7 de octubre de 2026. Claude Haiku 5.5, el primer Haiku con niveles de esfuerzo. medium por defecto, y disabled solo se acepta hasta high.
  • 28 de septiembre de 2026. Claude Sonnet 5.5: between_tools sustituye a disabled como suelo del pensamiento.
  • 30 de noviembre de 2026. Sonnet 4.5 se retira; Haiku 4.5 y Opus 4.5 están al caer.

Si vienes de la generación anterior: barre el esfuerzo otra vez en el modelo nuevo, quita budget_tokens, deja de reconstruir system y tools, mueve los recordatorios a mensajes a mitad de conversación, arregla la verificación por modelo y quita el muestreo.

Resumen

En la generación 5.5 el control de la respuesta se ha mudado a un parámetro, `effort`, y la conversación ha dejado de ser un texto que puedas reescribir: editar un turno anterior, el `system` o las `tools` invalida todos los bloques de pensamiento posteriores. El muestreo desapareció, y poner o quitar la verificación depende del modelo que tengas delante.

Artículos relacionados

¿Listo para crear mejores prompts?

SystemPrompt Master aplica el método de estas guías para escribir el prompt del modelo que elijas y guarda cada versión.