Claude Opus 4.8: fin del modo rápido y migración a Opus 5.5

El modo rápido de Claude Opus 4.8 está obsoleto. Migra las solicitudes que combinan claude-opus-4-8 y speed: "fast" a claude-opus-5-5 antes del 30 de noviembre de 2026. Tras su retirada, esa combinación devolverá un error sin pasar automáticamente a la velocidad estándar.

Anthropic anunció la fecha en sus notas de la versión del 30 de octubre. La versión v2.1.316 de Claude Code confirma expresamente que no habrá una transición automática a la velocidad estándar.

El cambio retira una opción de velocidad. A fecha de 2026-11-02, la tabla del ciclo de vida de los modelos sigue mostrando claude-opus-4-8 como Active. La fecha de retirada del modelo es tentativa: no antes del 28 de mayo de 2027. Si necesitas conservarlo, elimina el ajuste de modo rápido y valida las solicitudes a velocidad estándar.

Los pasos siguientes se centran en la API Messages directa de Anthropic. También cubren los ajustes que deben revisar los usuarios de Claude Code.

1. Localiza las solicitudes afectadas en el código y la configuración desplegada

Busca por separado los ajustes de modelo y velocidad, y después identifica dónde los combina la aplicación. Pueden proceder de distintos archivos, variables de entorno o reglas de una pasarela.

Con ripgrep instalado, ejecuta esta búsqueda desde la raíz del repositorio en Bash:

rg -l --hidden --no-ignore \
  -g '!.git' \
  -g '!node_modules' \
  -g '!.venv' \
  -e 'claude-opus-4-8' \
  -e 'fast-mode-2026-02-01' \
  -e 'fastMode' \
  -e 'speed' .

El comando muestra nombres de archivo, no el contenido de la configuración. Incluye archivos ocultos e ignorados, que pueden contener ajustes locales. Revisa cada coincidencia: un ajuste genérico llamado speed puede tener otra función.

Comprueba también la configuración que está fuera del repositorio:

Variables del despliegue y ajustes de los trabajos de CI.
Modelos predeterminados de los agentes y listas de modelos alternativos.
Correspondencias de modelos y transformaciones de solicitudes en la pasarela.
Ajustes de usuario, de proyecto y administrados de Claude Code.

Confirma que la solicitud final enviada contiene tanto el identificador antiguo del modelo como speed: "fast". Un informe de uso que solo identifica el modelo no permite saber si la solicitud utilizó el modo rápido.

Para cada servicio afectado, registra su responsable, el origen de la configuración, el modelo, la velocidad solicitada y la opción de reversión. No incluyas credenciales ni contenido de los prompts en ese registro.

2. Cambia el modelo y revisa los ajustes incompatibles

Para Opus 5.5, conserva speed: "fast" y elimina el valor beta que solo se utilizaba para el modo rápido. La documentación de las funciones de Opus 5.5 indica expresamente que este modelo no necesita esa cabecera beta.

Si anthropic-beta contiene varios valores de funciones, elimina únicamente fast-mode-2026-02-01. Conserva los valores que necesiten otras funciones.

Revisa estos ajustes antes de enviar una carga de trabajo existente al nuevo modelo:

Ajuste o comportamiento	Acción para Opus 5.5
`model`	Establece `claude-opus-5-5`.
`speed`	Conserva `"fast"` cuando necesites el modo rápido.
`thinking`	Omítelo o usa `{"type":"adaptive"}`. Se rechazan la desactivación del razonamiento y los presupuestos manuales con `enabled`.
`tool_choice`	Usa `{"type":"auto"}` o `{"type":"none"}`. Se rechazan la selección forzada con `any` y la selección de una herramienta concreta con `tool`.
`temperature`, `top_p`, `top_k`	Omítelos.
Inicio predefinido de la respuesta del asistente	Elimina el mensaje parcial del asistente que utilizabas para iniciar la siguiente respuesta.
Procesamiento de la respuesta	Selecciona los bloques de texto por `type`; no supongas que `content[0].text` contiene la respuesta.

Estas comprobaciones proceden de la guía de migración a Opus 5.5. Algunas restricciones ya se aplican a modelos anteriores. Aun así, el código compartido que construye las solicitudes puede volver a introducir esos parámetros durante la migración.

Si la aplicación exige llamar a una herramienta concreta, sustituir la selección forzada por auto cambia ese comportamiento. Actualiza la validación de la aplicación y prueba ese caso antes del despliegue.

Opus 5.5 siempre activa el razonamiento adaptativo. Revisa max_tokens, porque el razonamiento y el texto visible comparten ese límite. Usa output_config.effort para controlar la profundidad del razonamiento.

En los ciclos de llamadas a herramientas, conserva completos los mensajes del asistente, incluidos los bloques de razonamiento, al devolver los resultados. Filtrar el texto para mostrarlo no debe modificar la conversación que vuelves a enviar. Si la aplicación reescribe el historial o utiliza herramientas para controlar el equipo, revisa también las comprobaciones específicas de la guía de migración.

3. Envía una solicitud y verifica la velocidad de la respuesta

Comprueba usage.speed en una respuesta correcta antes de trasladar tráfico de producción. El campo de la solicitud indica lo que pediste; el de la respuesta indica lo que se ejecutó.

Necesitas Bash, jq y una versión de curl compatible con --fail-with-body. Usa una clave de la API directa de Claude con acceso al modo rápido. A fecha de 2026-11-02, Opus 5.5 tiene límites predeterminados de modo rápido en los niveles Start, Build y Scale. Las organizaciones del nivel Evaluation deben pasar a uno de esos niveles.

Este ejemplo utiliza el formato actual de las solicitudes de Messages API. Envía una solicitud sin transmisión en flujo, guarda la respuesta, la comprueba y muestra el texto:

read -rs ANTHROPIC_API_KEY && export ANTHROPIC_API_KEY

curl --silent --show-error --fail-with-body \
  --max-time 600 \
  --dump-header fast-headers.txt \
  --output fast-response.json \
  https://api.anthropic.com/v1/messages \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -H "Content-Type: application/json" \
  --data '{
    "model": "claude-opus-5-5",
    "max_tokens": 4096,
    "speed": "fast",
    "stream": false,
    "output_config": {"effort": "low"},
    "messages": [
      {
        "role": "user",
        "content": "Explain a cache hit in one sentence."
      }
    ]
  }' &&
jq -e '
  .type == "message"
  and .model == "claude-opus-5-5"
  and .usage.speed == "fast"
  and .stop_reason == "end_turn"
  and any(
    .content[]?;
    .type == "text" and (.text | length > 0)
  )
' fast-response.json &&
jq -r '.content[] | select(.type == "text") | .text' fast-response.json

La comprobación debería mostrar true, seguido de la respuesta del modelo. Es una condición de aceptación, no el registro de una ejecución realizada.

Los operadores && impiden que una solicitud fallida llegue a las comprobaciones de éxito. El límite 4096 y el esfuerzo low son elecciones para esta pequeña prueba. No son requisitos del modo rápido.

El ejemplo usa anthropic-version: 2026-10-21. Revisa la migración de versión de la API antes de cambiar esa cabecera en una integración existente.

Si curl falla, revisa el error y el cuerpo de la nueva respuesta guardada. Si la solicitud funciona pero la validación falla, inspecciona model, usage.speed, stop_reason y content.

Una respuesta puede usar el modo rápido y aun así alcanzar max_tokens. Consulta la guía de motivos de finalización y ajusta después el límite de salida o el esfuerzo. Si falta el dato de velocidad o contiene "standard", la respuesta no supera esta comprobación del modo rápido.

A fecha de 2026-11-02, BetterToken incluye tanto claude-opus-4-8 como claude-opus-5-5 en su lista de modelos. Su referencia de Messages documenta https://www.bettertoken.ai/v1/messages. Antes de migrar por esa vía, confirma que transmite el ajuste de modo rápido, devuelve usage.speed y aplica la facturación esperada. Utiliza su autenticación documentada: la presencia de un modelo en la lista no demuestra que admita el modo rápido.

4. Separa los errores de capacidad de los errores de migración

Planifica la concurrencia con los límites específicos del modo rápido. La capacidad de Opus a velocidad estándar no describe la disponible para el modo rápido.

La documentación de límites remite a la página de límites de tu organización en Console para consultar los valores reales. No supongas que la configuración de concurrencia de Opus 4.8 sirve sin cambios para Opus 5.5.

Busca anthropic-fast-input-tokens-remaining y anthropic-fast-output-tokens-remaining en las cabeceras de respuesta guardadas. Ayudan a distinguir la presión sobre el límite de tokens de entrada de la del límite de salida.

Define una respuesta explícita para cada fallo:

429 del modo rápido con retry-after: espera el tiempo indicado o vuelve a intentarlo sin speed: "fast" si aceptas la velocidad estándar.
429 causado por un límite de gasto: resuelve ese límite. Cambiar la velocidad no recupera un presupuesto agotado.
Sobrecarga 529: limita los reintentos y aumenta la espera entre ellos. No supongas que otra velocidad funcionará.
Parámetro no válido o combinación retirada de Opus 4.8 con modo rápido: corrige la solicitud. Enviarla repetidamente no completa la migración.

Anthropic documenta el paso a velocidad estándar controlado por la aplicación ante errores de límite del modo rápido. Si eliges esa opción, verifica que la respuesta del nuevo intento indique "standard".

Siempre que sea posible, controla los reintentos en una sola capa. Un bucle externo añadido a los reintentos del SDK puede multiplicar las solicitudes y las demoras. La guía sobre tratamiento seguro de Retry-After y espera exponencial explica esa implementación.

5. Compara el mismo volumen de tokens

Opus 5.5 tiene tarifas publicadas de modo rápido inferiores a las de Opus 4.8. Aun así, cuesta más por token que Opus 5.5 a velocidad estándar.

Estas son las tarifas de la API directa de Claude en USD, a fecha de 2026-11-02. MTok significa un millón de tokens.

Configuración	Entrada por MTok	Salida por MTok
Opus 4.8, modo rápido	$10	$50
Opus 5.5, modo rápido	$8	$40
Opus 5.5, velocidad estándar	$4	$20

Las tarifas del modo rápido proceden de la tabla de precios de Anthropic. Las tarifas estándar también aparecen en la página del modelo Opus 5.5.

Para una carga estimada de 1 MTok de entrada y 0.2 MTok de salida total, los cargos por tokens serían:

Opus 4.8 fast:     1 × $10 + 0.2 × $50 = $20
Opus 5.5 fast:     1 ×  $8 + 0.2 × $40 = $16
Opus 5.5 standard: 1 ×  $4 + 0.2 × $20 =  $8

Fast-to-fast reduction at fixed token usage:
($20 - $16) / $20 = 20%

La estimación supone una entrada sin caché, sin herramientas de servidor de pago y sin recargo por residencia de datos. Excluye impuestos, créditos y descuentos específicos de cada cuenta. Los ajustes por caché y residencia necesitan un cálculo separado.

El resultado del 20% corresponde a un consumo fijo de tokens. No demuestra que completar tu tarea cueste un 20% menos. Los tokens de razonamiento de Opus 5.5 se facturan como salida, incluido el razonamiento que no se muestra. Por tanto, una tarea que antes se ejecutaba sin razonamiento puede generar un total distinto de tokens de salida.

Mide los resultados aceptados, los cargos por tokens, los reintentos y el tiempo transcurrido en tareas representativas. Conserva el modo rápido donde una generación más veloz mejore de forma relevante la experiencia del usuario. Prueba primero la velocidad estándar para trabajos en segundo plano cuyo tiempo dependa principalmente de herramientas o servicios externos.

6. Actualiza el modelo y el ajuste de modo rápido en Claude Code

Selecciona Opus 5.5 de forma explícita y después comprueba el interruptor del modo rápido. Actualizar Claude Code no demuestra que haya cambiado una selección de modelo guardada.

La documentación de configuración de modelos exige Claude Code v2.1.280 o posterior para Opus 5.5.

Si utilizaste el instalador nativo, ejecuta lo siguiente en Bash:

claude update
claude --version
claude

Si instalaste Claude Code mediante un gestor de paquetes, usa su comando de actualización indicado en la documentación de instalación.

Dentro de la sesión interactiva de Claude Code, ejecuta:

/model claude-opus-5-5
/fast
/status

En /fast, pulsa Space si necesitas cambiar el interruptor y después Enter para confirmar. El estado activado documentado muestra Fast mode ON y el icono ↯. Usa /status para comprobar el modelo seleccionado.

Revisa las selecciones de modelo en ~/.claude/settings.json, .claude/settings.json y .claude/settings.local.json. Comprueba también ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, las opciones de inicio y los ajustes administrados. Modifica las claves existentes sin sustituir todo el archivo de configuración.

Reinicia una vez y comprueba de nuevo el modelo. Una sesión reanudada o una configuración con mayor prioridad puede conservar una selección anterior.

El comportamiento del modo rápido en Claude Code incluye el paso automático a velocidad estándar mientras espera la recuperación del límite del modo rápido. Ese comportamiento no anula el aviso de retirada de las solicitudes rápidas de Opus 4.8.

Si un límite de la cuenta bloquea el cambio, primero distingue los límites de suscripción de Claude Code de los errores 429 de la API.

7. Despliega con una opción de reversión válida

Traslada una pequeña parte del tráfico solo después de superar la comprobación de la solicitud y las pruebas de aceptación de tu aplicación.

Incluye una solicitud de texto normal, una interacción representativa con herramientas si tu aplicación las utiliza y una tarea cercana a tu límite habitual de salida. Compara los resultados útiles del nuevo modelo con los de la configuración actual. Vigila la verificación de velocidad, el número de errores, los cargos por tokens y el tiempo total de ejecución.

Mantén disponible una configuración a velocidad estándar que ya hayas validado para poder volver a ella. Después del 30 de noviembre, restaurar claude-opus-4-8 con speed: "fast" no será una vía de recuperación válida.

Completa la migración comprobando de nuevo las solicitudes de los servicios desplegados. Ninguna ruta de producción debe poder seguir construyendo la combinación retirada de modelo y velocidad.