Novedades de Claude Opus 5.5

Claude Opus 5.5 está diseñado para "agentic coding" (programación agéntica) de larga duración y trabajo de conocimiento, con un precio de $4 / $20 USD por millón de tokens de entrada / salida. Cuatro "breaking changes" (cambios incompatibles) afectan al código que ya se ejecuta en Claude Opus 5: el pensamiento no se puede desactivar, el uso forzado de herramientas devuelve un error, los bloques de pensamiento están vinculados al modelo y a la conversación y, en la API de Claude y Google Cloud, no se acepta la herramienta de uso de computadora anterior computer_20251124. Los tres primeros también se aplican a Claude Fable 5.1. Otro cambio altera la forma de la respuesta sin que falle ninguna solicitud: el texto entre llamadas a herramientas se devuelve en bloques thinking cuyo texto está vacío con la configuración predeterminada de display. Una aplicación que hace streaming de ese texto a sus usuarios como actualizaciones de progreso se queda en silencio entre llamadas a herramientas hasta que establece un valor de display que devuelva el texto.

Nuevo modelo

El "adaptive thinking" (pensamiento adaptativo) está siempre activado, y el parámetro "effort" (esfuerzo) controla la profundidad del pensamiento; su valor predeterminado en este modelo es medium. Para conocer la "context window" (ventana de contexto), los límites de salida, la fecha de corte de conocimiento y los precios, consulta la página del modelo Claude Opus 5.5; para ver todos los modelos actuales, consulta la descripción general de los modelos.

Cambios incompatibles

El pensamiento no se puede desactivar

En Claude Opus 5, el pensamiento está activado de forma predeterminada y se acepta thinking: {"type": "disabled"} con un esfuerzo high o inferior. En Claude Opus 5.5, el pensamiento está siempre activado: una solicitud que establece thinking: {"type": "disabled"}, o un presupuesto manual con thinking: {"type": "enabled", "budget_tokens": N}, devuelve un error 400 invalid_request_error. Omite el campo thinking o envía thinking: {"type": "adaptive"}, que es equivalente. No interviene ningún encabezado beta.

Los mensajes de error son:

"thinking.type.disabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

"thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

El parámetro de esfuerzo es el control de la profundidad del pensamiento, la latencia y el costo: redúcelo donde antes desactivabas el pensamiento; Optimización de costo e inteligencia incluye resultados medidos para elegir un nivel. Como cada respuesta puede comenzar con uno o más bloques thinking (devueltos con un campo thinking vacío con el valor predeterminado display: "omitted"), selecciona los bloques de contenido por su campo type en lugar de por su posición, y devuelve los bloques thinking sin modificar en los bucles de uso de herramientas. El código que ya se ejecuta en Claude Opus 5 con el pensamiento activado no necesita cambios. Consulta Pensamiento y el antes y después de la guía de migración.

El uso forzado de herramientas no es compatible

Claude Opus 5.5 no admite el "forced tool use" (uso forzado de herramientas). Establecer tool_choice en {"type": "any"} o {"type": "tool", "name": "..."} devuelve un error 400 invalid_request_error:

tool_choice: type "tool" and "any" are not supported for this model.

Se admiten tool_choice: {"type": "auto"} (el valor predeterminado) y {"type": "none"}, y la misma validación se aplica al endpoint de conteo de tokens. Para obtener JSON válido según el esquema, mantén tool_choice: {"type": "auto"} y establece strict: true con el uso estricto de herramientas, o traslada el esquema a salidas estructuradas. Para que el modelo llame a una herramienta en lugar de responder con texto, indica en el prompt cuándo se aplica la herramienta. La guía de migración muestra el antes y después.

Los bloques de pensamiento están vinculados al modelo y a la conversación

Cada bloque de pensamiento registra qué modelo lo produjo, y cada modelo lee sus propios bloques y solo los de algunos otros modelos. Claude Opus 5.5 lee bloques de pensamiento de Claude Opus 5 y de modelos Opus, Sonnet y Haiku anteriores, pero no de los modelos Claude Fable ni Claude Mythos. En la API de Claude, Claude Fable 5.1 y Claude Mythos 5.1 leen bloques de pensamiento de Claude Opus 5.5; ningún otro modelo lo hace. Una conversación que pasa de Claude Opus 5 a Claude Opus 5.5, o de Claude Opus 5.5 a Claude Fable 5.1 o Claude Mythos 5.1 en la API de Claude, conserva su razonamiento. Una que pasa de Claude Opus 5.5 a cualquier modelo distinto de esos dos, o que llega a él desde un modelo Claude Fable o Claude Mythos, ejecuta los turnos posteriores al cambio sin el razonamiento del modelo anterior. Cuando una solicitud incluye un bloque que el modelo de destino no puede leer, la API lo descarta antes de que el modelo lo vea: la solicitud se completa correctamente y los bloques descartados no se facturan. Con el encabezado beta thinking-binding-controls-2026-08-01, el descarte se informa en un arreglo input_transformations de nivel superior. Consulta Cambiar de modelo a mitad de conversación.

La API también comprueba si algo anterior a un bloque de pensamiento de Claude Opus 5.5 (la indicación del sistema system, las tools o un mensaje anterior) ha cambiado desde que se produjo el bloque. Al igual que en Claude Fable 5.1, aplica esa verificación de forma predeterminada para las cuentas creadas a partir del 31 de agosto de 2026, 00:00 UTC, en la API de Claude y en las plataformas en la nube. En esas cuentas, una solicitud que reenvía un bloque después de un cambio de ese tipo devuelve un error 400. Para descartar los bloques afectados en su lugar, envía el encabezado beta thinking-binding-controls-2026-08-01 y establece thinking.block_binding.prefix_mismatch_behavior en "drop_block". En las cuentas más antiguas, establecer ese campo en cualquiera de los dos valores hace que la solicitud opte por la aplicación de la verificación. Mantén la conversación en modo de solo anexar para que la cuestión nunca se plantee: cambia las instrucciones o las herramientas con mensajes del sistema a mitad de la conversación en lugar de con ediciones. Consulta Pensamiento preservado y la nota sobre este cambio de la guía de migración.

La herramienta de uso de computadora computer_20251124 no es compatible en la API de Claude ni en Google Cloud

Claude Opus 5 acepta el uso de computadora de dos formas: como el conjunto de herramientas computer_toolset_20260801 y, con el encabezado beta computer-use-2025-11-24, como la herramienta anterior computer_20251124. En la API de Claude y Google Cloud, Claude Opus 5.5 solo admite el conjunto de herramientas: una solicitud que declara una herramienta computer_20251124 devuelve un error 400 invalid_request_error. El mensaje nombra el tipo rechazado y luego enumera los tipos de herramientas que el modelo sí acepta (entre ellos computer_toolset_20260801) después de Did you mean one of; comienza así:

'claude-opus-5-5' does not support tool types: computer_20251124.

Para migrar una integración existente en la API de Claude o Google Cloud, sigue Migrar desde computer_20251124: elimina el encabezado beta, reemplaza la entrada de tools por {"type": "computer_toolset_20260801"} y actualiza tu bucle de agente para los bloques tool_use de los miembros, las acciones por lotes y toolset_name en los resultados. En Amazon Bedrock, la herramienta anterior computer_20251124 sigue funcionando en Claude Opus 5.5 igual que en Claude Opus 5, por lo que no se necesita ningún cambio allí. Para otras plataformas, consulta la sección Compatibilidad de la herramienta de uso de computadora. Las integraciones que ya usan el conjunto de herramientas, y la herramienta de uso del navegador, no necesitan cambios. La guía de migración muestra la solicitud antes y después.

Compatibilidad de funciones

Claude Opus 5.5 admite el esfuerzo por mensaje (beta), los mensajes del sistema a mitad de la conversación, los presupuestos de tarea, el "prompt caching" (almacenamiento en caché de prompts) con una longitud mínima de prompt almacenable en caché de 512 tokens, el procesamiento por lotes, la Files API, la compatibilidad con PDF, la visión y las herramientas del lado del servidor y del lado del cliente. En la API de Claude y Google Cloud, el uso de computadora requiere el conjunto de herramientas computer_toolset_20260801 (consulta el cambio incompatible). Consulta la página de cada función para conocer la disponibilidad por modelo.

Modo rápido

El modo rápido (vista previa de investigación) está disponible para Claude Opus 5.5 solo en la API de Claude; no está disponible en Amazon Bedrock, Claude Platform on AWS, Google Cloud ni Microsoft Foundry. Establece speed: "fast" con el encabezado beta fast-mode-2026-02-01. Consulta Modo rápido para conocer el acceso, los modelos compatibles y los precios.

Definir herramientas en un mensaje (beta)

Con el encabezado beta inline-tools-2026-09-15, un bloque tool_addition en un mensaje del sistema a mitad de la conversación puede contener una definición completa de herramienta en lugar de una referencia, de modo que puedes agregar una herramienta, cambiar su esquema o pasar una herramienta del servidor a una versión más reciente a mitad de la conversación sin editar tools y sin perder la caché de prompts. Esto funciona en todos los modelos que admiten cambios de herramientas a mitad de la conversación, incluido Claude Opus 5.5. Consulta Definir herramientas en un mensaje.

Compactación bajo demanda (beta)

Con el encabezado beta compact-2026-09-04, una solicitud que envía el parámetro de nivel superior compaction devuelve un bloque compaction firmado que resume toda la conversación, y que luego envías en primer lugar en sustitución de los mensajes resumidos. Está disponible en los modelos que admiten compactación, incluido Claude Opus 5.5. Tú eliges cuándo compactar, la solicitud puede ejecutarse en segundo plano y los bloques de pensamiento de los turnos que conservas pueden seguir siendo válidos después del reemplazo (en las condiciones descritas en Compactación y pensamiento preservado), lo cual es importante en Claude Opus 5.5 porque sus bloques de pensamiento están vinculados a la conversación. Consulta Compactación bajo demanda para conocer la disponibilidad por plataforma y el flujo completo de la solicitud.

Diferencias de comportamiento

Claude Opus 5.5 se diferencia de Claude Opus 5 en varios aspectos que se manifiestan sin ningún cambio de código. Cada uno tiene orientación en Cómo escribir prompts para Claude Opus 5.5:

• El esfuerzo predeterminado es medium. Una solicitud que omite effort se ejecuta con medium; en Claude Opus 5 se ejecutaba con high. Establece effort de forma explícita y vuelve a ejecutar tu barrido; consulta Calibra el esfuerzo.
• Más pensamiento por turno con un nivel de esfuerzo dado. Con la misma configuración de esfuerzo, el modelo tiende a pensar más por turno que Claude Opus 5, sobre todo con xhigh y max. Vuelve a ejecutar tu barrido de esfuerzo en lugar de trasladar una configuración, y deja margen en max_tokens para el pensamiento. Consulta Calibra el esfuerzo.
• El texto entre llamadas a herramientas se devuelve en bloques de pensamiento. Las notas breves que el modelo escribe entre llamadas a herramientas llegan como bloques thinking de actualización de progreso en lugar de bloques text, por lo que con el valor predeterminado display: "omitted" una aplicación que las envía por streaming a sus usuarios se queda en silencio entre llamadas a herramientas, sin ningún error. La guía de migración incluye la solución para recibirlas, y Actualizaciones de progreso para el usuario explica cómo pedir más.
• Más categorías de salvaguardas. El modelo ejecuta un clasificador de seguridad de biología además del de ciberseguridad, y las solicitudes que lo presionan para reproducir su razonamiento interno en el texto de la respuesta pueden rechazarse con la categoría reasoning_extraction. Consulta Rechazos y fallback y Rechazos de salvaguardas.
• Lectura más precisa de gráficos, diagramas y capturas de pantalla. El modelo lee valores de gráficos densos y de elementos visuales que dependen del diseño con mucha más precisión sin herramientas, por lo que es posible que ya no se necesiten las soluciones alternativas de visión en el prompt creadas para modelos anteriores; las herramientas de imagen siguen aportando precisión en las entradas más densas. Consulta Herramientas para entradas visuales complejas.

Si tu integración con Claude Opus 5 se ejecutaba con el pensamiento desactivado, consulta Prompts escritos para el pensamiento desactivado junto con el cambio incompatible. Para conocer las mejoras de capacidad en programación agéntica y revisión de código, trabajo de conocimiento, comunicación, entradas visuales y uso de computadora, consulta Capacidades relevantes para el prompting.

Rechazos y fallback

Claude Opus 5.5 incluye clasificadores de seguridad, y se aplica todo lo descrito en Rechazos y fallback. Una solicitud rechazada devuelve HTTP 200 con stop_reason: "refusal" y un objeto stop_details que nombra el área de la política, así que gestiona los rechazos y configura el fallback: reintenta en otro modelo con el fallback del lado del servidor (fallbacks: "default", en beta, reintenta en el modelo que Anthropic recomienda para esa categoría), el middleware del SDK o tu propio reintento.

Precios

Claude Opus 5.5 cuesta $4 USD por millón de tokens de entrada y $20 USD por millón de tokens de salida, por debajo de los $5 y $25 de Claude Opus 5, con escrituras en caché de 5 minutos a $5, escrituras en caché de 1 hora a $8 y lecturas de caché a $0.20 por millón de tokens (0.05x el precio base de entrada). El procesamiento por lotes cuesta la mitad: $2 y $10. Consulta Precios para conocer la residencia de datos y los precios de las herramientas.

Disponibilidad

Claude Opus 5.5 está disponible en:

• API de Claude: todos los clientes, como claude-opus-5-5.
• AWS: Claude en Amazon Bedrock, como anthropic.claude-opus-5-5, y Claude Platform on AWS, como claude-opus-5-5.
• Google Cloud: Claude en Google Cloud, como claude-opus-5-5.
• Microsoft Foundry: Claude en Microsoft Foundry, como claude-opus-5-5.

Migrar desde Claude Opus 5

Actualiza tu ID de modelo:

model = "claude-opus-5"  # Before
model = "claude-opus-5-5"  # After

Luego elimina cualquier configuración thinking: {"type": "disabled"} o thinking: {"type": "enabled", ...} y elige un nivel de esfuerzo en su lugar. Reemplaza los tipos any y tool de tool_choice por auto junto con el uso estricto de herramientas. Si usas la herramienta de uso de computadora computer_20251124 en la API de Claude o Google Cloud, migra al conjunto de herramientas. Si tu interfaz muestra el texto entre llamadas a herramientas, establece también thinking.display; consulta El texto entre llamadas a herramientas se devuelve en bloques de pensamiento. Consulta la guía de migración para obtener instrucciones paso a paso desde Claude Opus 5 y modelos anteriores, y la lista de verificación completa.

Próximos pasos