Novedades de Claude Opus 5.5

Claude Opus 5.5 está diseñado para 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 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 Claude API y Claude Models on Google Cloud (Google managed), no se acepta la herramienta de uso de computadora anterior computer_20251124. Los tres primeros también se aplican en 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 transmite ese texto a sus usuarios como actualizaciones de progreso 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 effort es el control de la profundidad del pensamiento, la latencia y el costo: redúcelo donde antes desactivabas el pensamiento; Optimizar el costo y la inteligencia tiene 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 del pensamiento en 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, de modelos anteriores Opus, Sonnet y Haiku y, en la Claude API y 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 Claude API, 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 Claude API, 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 la 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. 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 con ediciones. Una solicitud que reproduce un bloque después de un cambio así y deja thinking.block_binding.prefix_mismatch_behavior sin establecer recibe un error 400 en las cuentas creadas el 31 de agosto de 2026 a las 00:00 UTC o después. 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 en su lugar los bloques afectados, 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.

La herramienta de uso de computadora computer_20251124 no es compatible en la Claude API ni en Claude Models on Google Cloud (Google managed)

Claude Opus 5 acepta el uso de computadora tanto como el conjunto de herramientas computer_toolset_20260801 como, con el encabezado beta computer-use-2025-11-24, como la herramienta anterior computer_20251124. En la Claude API y Claude Models on Google Cloud (Google managed), 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 Claude Models on Google Cloud (Google managed), 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 effort 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 por 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. En la Claude API y Claude Models on Google Cloud (Google managed), el uso de computadora requiere el conjunto de herramientas computer_toolset_20260801 (consulta el cambio incompatible del uso de computadora). 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 in 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. Así puedes agregar una herramienta, cambiar su esquema o actualizar 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 primero en lugar de los mensajes resumidos. Está disponible en los modelos que admiten 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 difiere 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 transmite a sus usuarios 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 dependientes del diseño con mucha más precisión sin herramientas, por lo que las soluciones alternativas de visión en el prompt creadas para modelos anteriores podrían dejar de ser necesarias; las herramientas de imagen todavía aportan 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 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. Que un rechazo que llega antes de cualquier salida se facture o no depende de su categoría de rechazo, y cuenta para tus “rate limits” (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, menos que 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 los precios de residencia de datos y de herramientas.

Disponibilidad

Claude Opus 5.5 está disponible en:

• Claude API: todos los clientes, como claude-opus-5-5
• AWS: Claude in 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 in 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 en su lugar un nivel de effort. Reemplaza los tipos any y tool de tool_choice por auto junto con el uso estricto de herramientas. Si usas el uso de computadora mediante computer_20251124 en la Claude API o Claude Models on Google Cloud (Google managed), pasa 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