intermedio
Prompting para Claude: Opus 5.5, Sonnet 5.5 y Haiku 5.5
Cubre: Claude Fable 5.1, Opus 5.5, Sonnet 5.5 y Haiku 5.5
Respuesta rápida:
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.
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_pytop_kfuera; ponerlos devuelve 400. - 7 de octubre de 2026. Claude Haiku 5.5, el primer Haiku con niveles de esfuerzo.
mediumpor defecto, ydisabledsolo se acepta hastahigh. - 28 de septiembre de 2026. Claude Sonnet 5.5:
between_toolssustituye adisabledcomo 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.