---
title: Novedades de Claude Opus 5.5
url: https://platform.claude.com/docs/es/models/opus-5-5/whats-new-opus-5-5
description: Resumen de los cambios incompatibles, la compatibilidad de funciones y las diferencias de comportamiento en 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](https://platform.claude.com/docs/es/models/opus-5-5/whats-new-opus-5-5#thinking-cant-be-disabled), [el uso forzado de herramientas devuelve un error](https://platform.claude.com/docs/es/models/opus-5-5/whats-new-opus-5-5#forced-tool-use-is-not-supported), [los bloques de pensamiento están vinculados al modelo y a la conversación](https://platform.claude.com/docs/es/models/opus-5-5/whats-new-opus-5-5#thinking-blocks-are-tied-to-the-model-that-produced-them) y, en la API de Claude y Google Cloud, [no se acepta la herramienta de uso de computadora anterior `computer_20251124`](https://platform.claude.com/docs/es/models/opus-5-5/whats-new-opus-5-5#computer-20251124-is-not-supported). 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`](https://platform.claude.com/docs/es/models/opus-5-5/whats-new-opus-5-5#text-between-tool-calls) 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
| Modelo | ID de la API de Claude | Descripción |
| --------------- | ---------------------- | ---------------------------------------------------------------------- |
| Claude Opus 5.5 | claude-opus-5-5 | Para programación agéntica de larga duración y trabajo de conocimiento |
El ["adaptive thinking" (pensamiento adaptativo)](https://platform.claude.com/docs/es/build-with-claude/thinking) está siempre activado, y el [parámetro "effort" (esfuerzo)](https://platform.claude.com/docs/es/build-with-claude/effort) 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](https://platform.claude.com/docs/es/models/opus-5-5/overview); para ver todos los modelos actuales, consulta la [descripción general de los modelos](https://platform.claude.com/docs/es/models/overview).
## 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:
```text wrap
"thinking.type.disabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.
```
```text wrap
"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](https://platform.claude.com/docs/es/build-with-claude/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](https://platform.claude.com/docs/es/about-claude/models/optimizing-for-cost-and-intelligence#tune-effort) 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](https://platform.claude.com/docs/es/build-with-claude/thinking) y el [antes y después](https://platform.claude.com/docs/es/models/opus-5-5/migration-guide#thinking-cant-be-disabled) 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`:
```text wrap
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](https://platform.claude.com/docs/es/build-with-claude/token-counting). 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](https://platform.claude.com/docs/es/agents-and-tools/tool-use/strict-tool-use), o traslada el esquema a [salidas estructuradas](https://platform.claude.com/docs/es/build-with-claude/structured-outputs). 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](https://platform.claude.com/docs/es/models/opus-5-5/migration-guide#forced-tool-use).
### 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 Google Cloud, 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 arreglo `input_transformations` de nivel superior. Consulta [Cambiar de modelo a mitad de la conversación](https://platform.claude.com/docs/es/build-with-claude/preserved-thinking#switching-models).
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 comprobació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 reproduce un bloque después de un cambio así 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 activa la comprobación para la solicitud. Mantén la conversación en modo de solo anexar para que la cuestión nunca surja: cambia las instrucciones o las herramientas con [mensajes del sistema a mitad de la conversación](https://platform.claude.com/docs/es/build-with-claude/mid-conversation-system-messages) en lugar de ediciones. Consulta [Pensamiento preservado](https://platform.claude.com/docs/es/build-with-claude/preserved-thinking) y la [nota sobre este cambio](https://platform.claude.com/docs/es/models/opus-5-5/migration-guide#thinking-blocks) 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](https://platform.claude.com/docs/es/agents-and-tools/tool-use/computer-use-tool) 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í:
```text wrap
'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`](https://platform.claude.com/docs/es/agents-and-tools/tool-use/computer-use-tool#migrate-from-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](https://platform.claude.com/docs/es/agents-and-tools/tool-use/computer-use-tool#compatibility) de la herramienta de uso de computadora. Las integraciones que ya usan el conjunto de herramientas, y la [herramienta de uso del navegador](https://platform.claude.com/docs/es/agents-and-tools/tool-use/browser-use-tool), no necesitan cambios. La guía de migración muestra la solicitud [antes y después](https://platform.claude.com/docs/es/models/opus-5-5/migration-guide#computer-use-toolset).
## Compatibilidad de funciones
Claude Opus 5.5 admite el [esfuerzo por mensaje](https://platform.claude.com/docs/es/build-with-claude/effort#change-effort-mid-conversation-beta) (beta), los [mensajes del sistema a mitad de la conversación](https://platform.claude.com/docs/es/build-with-claude/mid-conversation-system-messages), los [presupuestos de tarea](https://platform.claude.com/docs/es/build-with-claude/task-budgets), el ["prompt caching" (almacenamiento en caché de prompts)](https://platform.claude.com/docs/es/build-with-claude/prompt-caching) con una longitud mínima de prompt almacenable en caché de 512 tokens, el [procesamiento por lotes](https://platform.claude.com/docs/es/build-with-claude/batch-processing), la [Files API](https://platform.claude.com/docs/es/build-with-claude/files), la [compatibilidad con PDF](https://platform.claude.com/docs/es/build-with-claude/pdf-support), la [visión](https://platform.claude.com/docs/es/build-with-claude/vision) y las [herramientas](https://platform.claude.com/docs/es/agents-and-tools/tool-use/overview) 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](https://platform.claude.com/docs/es/models/opus-5-5/whats-new-opus-5-5#computer-20251124-is-not-supported)). Consulta la página de cada función para conocer la disponibilidad por modelo.
### Modo rápido
El [fast mode](https://platform.claude.com/docs/es/build-with-claude/fast-mode) (modo rápido) está disponible para Claude Opus 5.5 en la API de Claude y en [Claude en Microsoft Foundry](https://platform.claude.com/docs/es/build-with-claude/claude-in-microsoft-foundry) para implementaciones alojadas en Azure, pero no para implementaciones alojadas en Anthropic; no está disponible en Amazon Bedrock, Claude Platform on AWS ni Google Cloud. En la API de Claude, establece `speed: "fast"` en tu solicitud. Claude Opus 5.5 no necesita un encabezado beta. Consulta [Modo rápido](https://platform.claude.com/docs/es/build-with-claude/fast-mode) para conocer los modelos compatibles, los "rate limits" (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](https://platform.claude.com/docs/es/build-with-claude/mid-conversation-system-messages#define-tools-in-a-message-beta).
### 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](https://platform.claude.com/docs/es/build-with-claude/compaction-thinking-blocks#conditions-for-kept-thinking-to-stay-valid)), lo cual es importante en Claude Opus 5.5 porque sus [bloques de pensamiento están vinculados a la conversación](https://platform.claude.com/docs/es/models/opus-5-5/whats-new-opus-5-5#thinking-blocks-are-tied-to-the-model-that-produced-them). Consulta [Compactación bajo demanda](https://platform.claude.com/docs/es/build-with-claude/compaction-on-demand) 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](https://platform.claude.com/docs/es/build-with-claude/prompt-engineering/prompting-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](https://platform.claude.com/docs/es/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#calibrate-effort).
* **Más pensamiento por turno con un nivel de esfuerzo dado.** Con la misma configuración de [esfuerzo](https://platform.claude.com/docs/es/build-with-claude/effort), 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](https://platform.claude.com/docs/es/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#calibrate-effort).
* **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](https://platform.claude.com/docs/es/build-with-claude/thinking#progress-updates) 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](https://platform.claude.com/docs/es/models/opus-5-5/migration-guide#text-between-tool-calls) incluye la solución para recibirlas, y [Actualizaciones de progreso para el usuario](https://platform.claude.com/docs/es/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#user-facing-progress-updates) 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. Al igual que en Claude Opus 5, 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](https://platform.claude.com/docs/es/models/opus-5-5/whats-new-opus-5-5#refusals-and-fallback) y [Rechazos de salvaguardas](https://platform.claude.com/docs/es/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#safeguard-refusals).
* **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](https://platform.claude.com/docs/es/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#tools-for-complex-visual-inputs).
Si tu integración con Claude Opus 5 se ejecutaba con el pensamiento desactivado, consulta [Prompts escritos para el pensamiento desactivado](https://platform.claude.com/docs/es/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#prompts-written-for-thinking-disabled) junto con el [cambio incompatible](https://platform.claude.com/docs/es/models/opus-5-5/whats-new-opus-5-5#thinking-cant-be-disabled). 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](https://platform.claude.com/docs/es/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#capability-improvements).
## Rechazos y fallback
Claude Opus 5.5 incluye clasificadores de seguridad, y se aplica todo lo descrito en [Rechazos y fallback](https://platform.claude.com/docs/es/build-with-claude/refusals-and-fallback). Una solicitud rechazada devuelve HTTP 200 con `stop_reason: "refusal"` y un objeto [`stop_details`](https://platform.claude.com/docs/es/build-with-claude/refusals-and-fallback#refusal-response) 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](https://platform.claude.com/docs/es/build-with-claude/refusals-and-fallback#server-side-fallback) (`fallbacks: "default"`, en beta, reintenta en el modelo que Anthropic recomienda para esa categoría), el [middleware del SDK](https://platform.claude.com/docs/es/build-with-claude/refusals-and-fallback#client-side-fallback) 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](https://platform.claude.com/docs/es/build-with-claude/refusals-and-fallback#how-refusals-are-billed).
## 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](https://platform.claude.com/docs/es/build-with-claude/batch-processing) cuesta la mitad: $2 y $10. Consulta [Precios](https://platform.claude.com/docs/es/about-claude/pricing) 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](https://platform.claude.com/docs/es/build-with-claude/claude-in-amazon-bedrock), como `anthropic.claude-opus-5-5`, y [Claude Platform on AWS](https://platform.claude.com/docs/es/build-with-claude/claude-platform-on-aws), como `claude-opus-5-5`.
* **Google Cloud:** [Claude en Google Cloud](https://platform.claude.com/docs/es/build-with-claude/claude-on-vertex-ai), como `claude-opus-5-5`.
* **Microsoft Foundry:** [Claude en Microsoft Foundry](https://platform.claude.com/docs/es/build-with-claude/claude-in-microsoft-foundry), como `claude-opus-5-5`.
## Migrar desde Claude Opus 5
Actualiza tu ID de modelo:
```python Python
model = "claude-opus-5" # Before
model = "claude-opus-5-5" # After
```
```typescript TypeScript
let model = "claude-opus-5"; // Before
model = "claude-opus-5-5"; // After
```
```csharp C#
var model = Model.ClaudeOpus5; // Before
model = Model.ClaudeOpus5_5; // After
```
```go Go
model := anthropic.ModelClaudeOpus5 // Before
model = anthropic.ModelClaudeOpus5_5 // After
```
```java Java
Model model = Model.CLAUDE_OPUS_5; // Before
model = Model.CLAUDE_OPUS_5_5; // After
```
```php PHP
$model = Model::CLAUDE_OPUS_5; // Before
$model = Model::CLAUDE_OPUS_5_5; // After
```
```ruby Ruby
model = Anthropic::Model::CLAUDE_OPUS_5 # Before
model = Anthropic::Model::CLAUDE_OPUS_5_5 # After
```
Luego elimina cualquier configuración `thinking: {"type": "disabled"}` o `thinking: {"type": "enabled", ...}` y elige un nivel de [esfuerzo](https://platform.claude.com/docs/es/build-with-claude/effort) en su lugar. Reemplaza los tipos `any` y `tool` de `tool_choice` por `auto` junto con el [uso estricto de herramientas](https://platform.claude.com/docs/es/agents-and-tools/tool-use/strict-tool-use). Si usas el uso de computadora mediante `computer_20251124` en la API de Claude o Google Cloud, [migra al conjunto de herramientas](https://platform.claude.com/docs/es/agents-and-tools/tool-use/computer-use-tool#migrate-from-computer-20251124). 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](https://platform.claude.com/docs/es/models/opus-5-5/migration-guide#text-between-tool-calls). Consulta la [guía de migración](https://platform.claude.com/docs/es/models/opus-5-5/migration-guide) para obtener instrucciones paso a paso desde Claude Opus 5 y modelos anteriores, y la lista de verificación completa.
## Próximos pasos
Especificaciones completas y precios de todos los modelos Claude actuales.
Migra código de Claude Opus 5 y modelos anteriores a Claude Opus 5.5.
Diferencias de comportamiento y patrones de prompting específicos de Claude Opus 5.5.
Controla cuántos tokens usa Claude al responder, desde low hasta max.
Cómo funciona el pensamiento adaptativo y cómo se preservan los bloques de pensamiento.
Gestiona `stop_reason: "refusal"` y reintenta en otro modelo.