Novedades de Claude Sonnet 5.5

Claude Sonnet 5.5 ofrece la mejor combinación de velocidad e inteligencia. Cinco cambios incompatibles pueden afectar al código que ya se ejecuta en Claude Sonnet 5:

• Desactiva el pensamiento previo con between_tools.
• 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 del ordenador no son compatibles.
• La herramienta de asesor rechaza cuatro modelos como asesores: Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 y Claude Haiku 5.5.

Un cambio más altera la forma de la respuesta sin que falle ninguna solicitud: el texto entre llamadas a herramientas se devuelve en bloques thinking. Una aplicación que hace streaming de ese texto a sus usuarios se queda en silencio entre llamadas a herramientas hasta que establece un valor de display que devuelva el texto, o desactiva el pensamiento previo con between_tools.

Nuevo modelo

El “adaptive thinking” (pensamiento adaptativo) está activado de forma predeterminada, y el “effort parameter” (parámetro de esfuerzo) controla la profundidad del pensamiento. Su valor predeterminado en la API de Claude es high. El “tokenizer” (tokenizador) es el mismo que el de Claude Sonnet 5, por lo que el mismo texto produce los mismos recuentos de tokens. 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 Sonnet 5.5.

Para ver todos los modelos actuales, consulta Descripción general de los modelos.

Cambios incompatibles

Desactiva el pensamiento previo con between_tools

Para desactivar el “up-front thinking” (pensamiento previo) en Claude Sonnet 5.5, envía thinking: {"type": "between_tools"} en lugar de "disabled". Es la configuración de pensamiento más baja en este modelo. Está disponible en todas las plataformas que ofrecen Claude Sonnet 5.5. Las breves “progress updates” (actualizaciones de progreso) que el modelo escribe entre llamadas a herramientas se siguen devolviendo como bloques thinking con su texto de resumen. Devuelve esos bloques sin cambios junto con el resto del turno del asistente. Un bloque de actualización de progreso que devuelves le proporciona al modelo la nota completa que escribió, no el resumen. Si tus solicitudes no usan herramientas, la respuesta contiene solo texto, como ocurre con disabled en Claude Sonnet 5.

En Claude Sonnet 5.5, una solicitud que envía thinking: {"type": "disabled"} devuelve un error 400 invalid_request_error cuyo mensaje remite a between_tools.

between_tools se acepta con esfuerzo low, medium y high. Con esfuerzo xhigh o max, una solicitud con between_tools devuelve un error 400. Para ejecutar con xhigh o max, usa el pensamiento adaptativo: omite el campo thinking o envía thinking: {"type": "adaptive"}, que es equivalente. Con between_tools, el esfuerzo no puede cambiar a mitad de la conversación: un output_config.effort por mensaje que difiera del nivel vigente devuelve un error 400. Para variar el esfuerzo en cada turno, usa el pensamiento adaptativo.

between_tools no admite ningún otro campo: enviar display, budget_tokens o block_binding junto con él devuelve un error 400. Los presupuestos de pensamiento manuales (thinking: {"type": "enabled", "budget_tokens": N}) devuelven un error 400. Consulta Pensamiento y Desactiva el pensamiento inicial en la guía de migración.

El uso forzado de herramientas no es compatible

Claude Sonnet 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.

tool_choice: {"type": "auto"} (el valor predeterminado) y {"type": "none"} son compatibles. La misma comprobación se aplica al endpoint de conteo de tokens. Para obtener una entrada de herramienta válida 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 sección El uso forzado de herramientas no es compatible de la guía de migración muestra el antes y el 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. Una conversación que cambia de modelo conserva su razonamiento anterior solo si el modelo al que cambia puede leer los bloques de pensamiento del modelo anterior:

Cuando una solicitud lleva un bloque que el modelo de destino no puede leer, la API lo omite antes de que el modelo lo reciba. La solicitud se completa correctamente y los bloques omitidos no se facturan. Con el encabezado beta thinking-binding-controls-2026-08-01, la API informa la omisión en un arreglo input_transformations de nivel superior. Consulta Cambiar de modelo y volver. Para los cambios que no involucran a Claude Sonnet 5.5, consulta Qué cambios de modelo conservan el razonamiento en la API de Claude.

La API también verifica si algo anterior a un bloque de pensamiento de Claude Sonnet 5.5 ha cambiado desde que el modelo produjo el bloque. Esta verificación de prefijo abarca la indicación del sistema system, las tools y cada mensaje anterior. 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 ediciones.

No superar la “prefix check” (verificación de prefijo) puede o no dar lugar a un error 400. Para identificar y manejar ambos casos, consulta Verificaciones de prefijo en bloques de pensamiento.

La verificación de prefijo se ejecuta en la Claude API y en algunas plataformas en la nube.

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 del ordenador no son compatibles

Claude Sonnet 5.5 admite el “computer use” (uso del ordenador) a través del conjunto de herramientas computer_toolset_20260801. En Amazon Bedrock, Claude Sonnet 5.5 también acepta la herramienta computer_20251124 con el encabezado beta computer-use-2025-11-24. Claude Sonnet 5.5 devuelve un error 400 para cualquier versión de la herramienta de uso del ordenador 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 el modelo acepta. El mensaje comienza así:

'claude-sonnet-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, que muestra la solicitud antes y después. Omite 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.

Algunas combinaciones de la herramienta de asesor no son compatibles

La “advisor tool” (herramienta de asesor) está en beta. Un ejecutor Claude Sonnet 5.5 acepta solo estos asesores:

• Claude Mythos 5.2 y Claude Fable 5.2
• Claude Mythos 5.1 y Claude Fable 5.1
• Claude Mythos 5 y Claude Fable 5
• Claude Opus 5.5 y Claude Opus 5
• El propio Claude Sonnet 5.5

Los asesores Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 y Claude Haiku 5.5 funcionan con un ejecutor Claude Sonnet 5. Con un ejecutor Claude Sonnet 5.5, devuelven un error 400 invalid_request_error. Todos los asesores que Claude Sonnet 5.5 acepta devuelven su consejo cifrado, como un bloque advisor_redacted_result. Por lo tanto, tu cliente no puede leer el texto del consejo. Consulta Compatibilidad de modelos y Variantes de resultado de la herramienta de asesor.

Compatibilidad de funciones

Claude Sonnet 5.5 admite estas funciones:

• Esfuerzo por mensaje, que está en beta
• Mensajes del sistema a mitad de la conversación
• Cambios de herramientas a mitad de la conversación, que están en beta
• Almacenamiento en caché de prompts, con un prompt almacenable en caché mínimo de 512 tokens
• Procesamiento por lotes
• La Files API
• Compatibilidad con PDF
• Visión
• Herramientas del lado del servidor y del lado del cliente (consulta Uso de herramientas con Claude)

Claude Sonnet 5 no admite el esfuerzo por mensaje, los mensajes del sistema a mitad de la conversación ni los cambios de herramientas a mitad de la conversación. En Claude Sonnet 5, el prompt almacenable en caché mínimo es de 1,024 tokens. Consulta la página de cada función para conocer la disponibilidad por modelo.

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 los mensajes de esa solicitud. En solicitudes posteriores, el bloque va primero en messages, en sustitución de los mensajes que resume. Tú eliges cuándo compactar y qué turnos conservar después del bloque. En Claude Sonnet 5.5, los bloques de pensamiento de los turnos conservados pueden seguir siendo válidos después de la compactación. Para conocer las condiciones, consulta Compactación y pensamiento preservado. Consulta Compactación bajo demanda para conocer la disponibilidad por plataforma y el flujo completo de la solicitud.

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. 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. Consulta Definir herramientas en un mensaje.

Los bloques de pensamiento permanecen con la cuenta que los produjo

Los bloques de pensamiento que produce Claude Sonnet 5.5 solo funcionan en la cuenta que los produjo, o en una cuenta vinculada a ella. Cuando otra cuenta envía uno de estos bloques, la API omite el bloque antes de que el modelo lo reciba, y la solicitud se completa correctamente. Los bloques de Claude Haiku 5.5, Claude Fable 5.2 y Claude Mythos 5.2 siguen la misma regla.

En la Claude API y en Claude Models on Google Cloud (Google managed), puedes ver qué bloques se omitieron. Envía el encabezado beta thinking-binding-controls-2026-08-01 y la respuesta enumera cada bloque omitido en input_transformations con reason: "organization_binding_mismatch". Consulta Cuentas y plataformas en la nube.

Diferencias de comportamiento

Para obtener orientación sobre cada uno de los siguientes aspectos, consulta Cómo escribir prompts para Claude Sonnet 5.5. Claude Sonnet 5.5 difiere de Claude Sonnet 5 en estos aspectos, que se manifiestan sin ningún cambio de código:

• Los niveles de esfuerzo se han recalibrado. Un nivel de esfuerzo no produce la misma cantidad de pensamiento que en Claude Sonnet 5. Vuelve a ejecutar tu barrido de esfuerzo en lugar de trasladar una configuración. Comienza con high a menos que tu carga de trabajo sea agéntica o sensible a la latencia. Para la programación agéntica y el uso de herramientas en varios pasos, comienza con medium para tareas bien especificadas y pasa a high para las más difíciles o largas. Para chat y otros trabajos sensibles a la latencia, comienza con medium o low.
• El texto entre llamadas a herramientas se devuelve en bloques de pensamiento. Entre llamadas a herramientas, las notas de más de una o dos oraciones se devuelven como bloques thinking de actualización de progreso. Los comentarios más cortos siguen siendo text. Con el valor predeterminado display: "omitted", el texto de los bloques de actualización de progreso está vacío, por lo que una aplicación que transmite esas notas en streaming a sus usuarios se queda en silencio entre llamadas a herramientas, sin ningún error. Si desactivas el pensamiento previo con between_tools, el texto se devuelve. Para recibirlo, consulta El texto entre llamadas a herramientas se devuelve en bloques de pensamiento en la guía de migración.
• Categorías de salvaguardas. Las salvaguardas del modelo pueden rechazar una solicitud en cinco categorías de stop_details. "cyber" significa que la solicitud podría facilitar daños cibernéticos. "bio" significa que podría facilitar daños biológicos. "frontier_llm" significa que podría ayudar al desarrollo de modelos de IA competidores. "reasoning_extraction" significa que pide al modelo que reproduzca su razonamiento interno en el texto de la respuesta. "general_harms" significa que pertenece a otra área de la política de uso. Consulta Rechazos, respaldo y facturación.

Rechazos, respaldo y facturación

Todo lo descrito en Rechazos y respaldo se aplica a Claude Sonnet 5.5. Una solicitud rechazada devuelve HTTP 200 con stop_reason: "refusal" y un objeto stop_details que nombra el área de la política.

Gestiona los rechazos en tu código y configura el respaldo. Con el respaldo del lado del servidor (fallbacks: "default"), una solicitud rechazada en la categoría "cyber" o "frontier_llm" se vuelve a ejecutar en Claude Sonnet 5. Una solicitud rechazada en la categoría "bio", "reasoning_extraction" o "general_harms" no se reintenta. El respaldo del lado del servidor está en beta en la Claude API y en Claude Models on Google Cloud (Anthropic managed). También puedes usar el middleware del SDK o tu propio reintento.

Un rechazo que llega antes de cualquier salida se factura en algunas categorías de rechazo y no en otras. En cualquier caso, cuenta para tus límites de velocidad. Consulta Cómo se facturan los rechazos.

Precios

Claude Sonnet 5.5 tiene los mismos precios que Claude Sonnet 5, excepto las lecturas de la caché de prompts, que cuestan $0.10 USD por millón de tokens, la mitad de la tarifa de Claude Sonnet 5. Consulta Precios para ver la lista completa, la residencia de datos y los precios de las herramientas.

Disponibilidad

Claude Sonnet 5.5 está disponible en:

• Claude API: todos los clientes, como claude-sonnet-5-5
• AWS: Claude en Amazon Bedrock, como anthropic.claude-sonnet-5-5, y Claude Platform on AWS, como claude-sonnet-5-5
• Google Cloud: Claude Models on Google Cloud (Anthropic managed), como claude-sonnet-5-5, y Claude Models on Google Cloud (Google managed), como claude-sonnet-5-5
• Microsoft Foundry: Claude en Microsoft Foundry, como claude-sonnet-5-5

Migrar desde Claude Sonnet 5

Actualiza el ID de tu modelo:

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

Luego comprueba seis cosas:

1. Si tu código desactiva el pensamiento con disabled, envía between_tools en su lugar, con esfuerzo high o inferior.
2. Reemplaza los tipos de tool_choice any y tool por auto junto con el uso estricto de herramientas.
3. Mantén las conversaciones en modo de solo anexar. Una solicitud que reproduce un bloque de pensamiento de Claude Sonnet 5.5 después de una edición del historial anterior puede devolver un error 400. Consulta Los bloques de pensamiento están vinculados al modelo y a la conversación.
4. Si usas el uso del ordenador a través de computer_20251124, migra al conjunto de herramientas. En Amazon Bedrock, computer_20251124 también funciona.
5. Si usas la herramienta de asesor con un asesor Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 o Claude Haiku 5.5, cambia a un asesor que Claude Sonnet 5.5 acepte.
6. Si tu interfaz muestra el texto entre llamadas a herramientas, establece thinking.display cuando uses el pensamiento adaptativo. Con between_tools, el texto se devuelve sin él. Consulta El texto entre llamadas a herramientas se devuelve en bloques de pensamiento.

La Guía de migración a Claude Sonnet 5.5 tiene instrucciones paso a paso desde Claude Sonnet 5 y modelos anteriores, y la lista de verificación completa.

Próximos pasos