Novedades de Claude Opus 5.5

Claude Opus 5.5 está diseñado para trabajo agéntico de programación y de conocimiento de larga duración, con un precio de $4 / $20 USD por millón de tokens de entrada / salida. Cuatro cambios incompatibles pueden afectar 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.
• Algunas versiones de la herramienta de uso de computadora no son compatibles.

Los tres primeros también se aplican en Claude Fable 5.1. Un cambio adicional 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 pensamiento adaptativo siempre está activado, y el parámetro effort controla la profundidad del pensamiento; su valor predeterminado en este modelo es medium. Para conocer la 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 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 thinking: {"type": "disabled"} se acepta con un esfuerzo high o inferior. En Claude Opus 5.5, el pensamiento siempre está 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 effort 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 para el pensamiento de la guía de migración.

El uso forzado de herramientas no es compatible

Claude Opus 5.5 no admite el uso forzado de herramientas. tool_choice establecido 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.

tool_choice: {"type": "auto"} (el valor predeterminado) y {"type": "none"} son compatibles, 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 para la elección de herramientas.

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, de modelos Opus, Sonnet y Haiku anteriores y, en la API de Claude y en Claude Models on Google Cloud (Google managed), de Claude Sonnet 5.5 y Claude Haiku 5.5, 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 array input_transformations de nivel superior. Consulta Cambiar de modelo a mitad de la conversación.

La API también verifica 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. Mantén la conversación en modo de solo anexar: cambia las instrucciones o las herramientas con mensajes del sistema a mitad de la conversación en lugar de editarlas. Una solicitud que reenvía un bloque después de un cambio de ese tipo y deja thinking.block_binding.prefix_mismatch_behavior sin establecer recibe un error 400 en las cuentas creadas a partir del 31 de agosto de 2026, 00:00 UTC. Esto se aplica en la API de Claude y en las plataformas en la nube. En las cuentas creadas antes de esa fecha, la solicitud recibe el error solo cuando establece el campo en "error". Para descartar los bloques afectados en su lugar, envía el encabezado beta thinking-binding-controls-2026-08-01 y establece el campo en "drop_block". Consulta Pensamiento preservado y la nota sobre los bloques de pensamiento de la guía de migración.

Algunas versiones de la herramienta de uso de computadora no son compatibles

Claude Opus 5.5 admite el uso de computadora a través del conjunto de herramientas computer_toolset_20260801. En Amazon Bedrock, Claude Opus 5.5 también acepta la herramienta computer_20251124 con el encabezado beta computer-use-2025-11-24. Claude Opus 5.5 devuelve un error 400 para cualquier versión de la herramienta de uso de computadora que no acepte, como computer_20251124 en la Claude API. El mensaje invalid_request_error de la Claude API nombra el tipo rechazado y, después de Did you mean one of, enumera los tipos de herramienta que acepta el modelo. El mensaje comienza así:

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

Las integraciones que usan el conjunto de herramientas no necesitan ningún cambio. Para migrar una integración de computer_20251124 al conjunto de herramientas, sigue Migrar desde computer_20251124. Elimina el encabezado beta y reemplaza la entrada de tools por {"type": "computer_toolset_20260801"}. Luego actualiza tu bucle de agente para los bloques tool_use de miembros, las acciones por lotes y toolset_name en los resultados. La guía de migración muestra la solicitud antes y después.

Compatibilidad de funciones

Claude Opus 5.5 admite esfuerzo por mensaje (beta), mensajes del sistema a mitad de la conversación, presupuestos de tareas, almacenamiento en caché de prompts con un mínimo de 512 tokens para un prompt almacenable en caché, procesamiento por lotes, la Files API, compatibilidad con PDF, visión y herramientas del lado del servidor y del lado del cliente. Consulta la página de cada función para conocer la disponibilidad por modelo.

Modo rápido

El modo rápido está disponible para Claude Opus 5.5 en la Claude API, en Claude Models on Google Cloud (Anthropic managed) y en Claude en Microsoft Foundry para implementaciones alojadas en Azure. En la Claude API y en Claude Models on Google Cloud (Anthropic managed), establece speed: "fast" en tu solicitud. Claude Opus 5.5 no necesita un encabezado beta. Consulta Modo rápido para conocer los modelos compatibles, los límites de velocidad 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 compaction de nivel superior devuelve un bloque compaction firmado que resume toda la conversación, el cual luego envías en primer lugar en sustitución de los mensajes resumidos. Está disponible en los modelos que admiten la compactación, incluido Claude Opus 5.5. Tú eliges cuándo compactar, y la solicitud puede ejecutarse en segundo plano. En las condiciones descritas en Compactación y pensamiento preservado, los bloques de pensamiento de los turnos que conservas pueden seguir siendo válidos después del reemplazo. Esto 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 Prompting de Claude Opus 5.5:

• El esfuerzo predeterminado es medium. Una solicitud que omite effort se ejecuta en medium; en Claude Opus 5 se ejecutaba en high. Establece effort explícitamente 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 en xhigh y max. Vuelve a ejecutar tu barrido de esfuerzo en lugar de trasladar una configuración, y deja espacio 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 transmite a sus usuarios se queda en silencio entre llamadas a herramientas, sin ningún error. La guía de migración explica cómo recibir el texto entre llamadas a herramientas, y Actualizaciones de progreso para el usuario explica cómo pedir más de ellas.
• Más categorías de salvaguardas. El modelo ejecuta un clasificador de seguridad de biología además del de ciberseguridad. Al igual que en Claude Opus 5, las solicitudes que lo presionan para reproducir su razonamiento interno en el texto de la respuesta podrían rechazarse con la categoría reasoning_extraction. Consulta Rechazos y fallback en Claude Opus 5.5 y Rechazos por salvaguardas.
• Lectura más precisa de gráficos, diagramas y capturas de pantalla. El modelo lee valores de gráficos densos y 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 El pensamiento no se puede desactivar. 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 un 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. Que un rechazo que llega antes de cualquier salida se facture depende de su categoría de rechazo, y cuenta para tus límites de velocidad en cualquier caso; consulta Cómo se facturan los rechazos.

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 USD de Claude Opus 5, con escrituras en caché de 5 minutos a $5 USD, escrituras en caché de 1 hora a $8 USD y lecturas de caché a $0.20 USD por millón de tokens (0.05x el precio base de entrada). El procesamiento por lotes cuesta la mitad: $2 y $10 USD. Consulta Precios para conocer la residencia de datos y los precios de las herramientas.

Disponibilidad

Claude Opus 5.5 está disponible en:

• Claude API: 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 Models on Google Cloud (Anthropic managed), como claude-opus-5-5, y Claude Models on Google Cloud (Google managed), como claude-opus-5-5
• Microsoft Foundry: Claude en Microsoft Foundry, como claude-opus-5-5

Migrar desde Claude Opus 5

Actualiza el ID de tu 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 en su lugar un nivel de esfuerzo. Reemplaza los tipos any y tool de tool_choice por auto junto con el uso estricto de herramientas. Si usas el uso de computadora a través de computer_20251124, migra al conjunto de herramientas. En Amazon Bedrock, computer_20251124 también funciona. 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 ver instrucciones paso a paso desde Claude Opus 5 y modelos anteriores, así como la lista de verificación completa.

Próximos pasos