¡Llega Claude Opus 5.5! Nuevo modelo por defecto de Claude Code y precio un 20% más bajo - Qué cambia respecto a Opus 5 y qué ajustes revisar ya 🚀

¡Hola! Soy Mojangcam 😎

Hace un par de días (el 22 de septiembre), Anthropic lanzó oficialmente Claude Opus 5.5. Es el primero de la nueva "familia 5.5", y ese mismo día salió Claude Code v2.1.280, que cambió el modelo por defecto de Opus 5 a Opus 5.5. La gama cambió justo un día después de que publicara mi guía sobre cómo cambiar de modelo y ajustar el effort, así que hoy, como continuación, te resumo solo qué cambió y qué tienes que tocar en tu configuración.

Esto es lo que vamos a ver:

• Los cambios clave de Opus 5.5 — rendimiento, velocidad y precio (comparado con Opus 5 en una tabla)
• Cómo cambió el modelo por defecto en Claude Code v2.1.280 + cómo comprobarlo en tu sesión
• Qué revisar en settings.json y en el effort al pasar de Opus 5 a 5.5
• 4 cambios que rompen la compatibilidad si usas la API directamente
• Cómo usarlo en GitHub Copilot y cómo elegir modelo hasta que salgan Sonnet 5.5 y Haiku 5.5

Para ir al grano: "más inteligente y, encima, más barato". Según la explicación oficial, rinde al nivel de Fable 5.1 y, frente a Opus 5, el precio por token baja un 20% y el coste real por tarea, alrededor de un 40%. Si usas un plan de suscripción, también lo vas a notar, porque suben los límites 🙌

📌 Lo que necesitas

• Claude Code v2.1.280 o superior (a 2026-09-25, la última en npm es v2.1.281) — Opus 5.5 se reconoce a partir de v2.1.280
• Una suscripción a Claude (Pro, Max, Team, Enterprise) o una clave de la API de Anthropic
• Si quieres seguir el ejemplo de la API: Python 3.10+, pip install anthropic python-dotenv (probado con anthropic 1.8.0 / python-dotenv 1.2.3)

Empecemos actualizando la versión.

claude update
claude --version

💬 Si tienes una versión anterior a v2.1.280, Opus 5.5 ni siquiera aparece en la lista de /model, o al escribir claude-opus-5-5 sale "does not support this model". Lo primero es actualizar.

🧩 ¿Qué cambia en Opus 5.5?

Según el anuncio oficial y la documentación del modelo, así queda frente a Opus 5.

Vamos punto por punto 💡

• Rendimiento: en los benchmarks propios de Anthropic es el número 1 en programación agéntica, uso del ordenador y trabajo del conocimiento. En Terminal-Bench 4.0 saca un 66.4% (Opus 5: 52.3%, Fable 5.1: 55.8%), en FrontierCode un 54.4% (Opus 5: 48.0%) y en OSWorld 2.0 un 81.8% (Opus 5: 74.0%). Eso sí, la propia documentación oficial dice que "a este nivel, las diferencias en los benchmarks no reflejan bien la diferencia que se nota en la práctica", así que, más que los números, quédate con "nivel Fable 5.1 a precio de Opus".
• Coste 40% ↓: además de que el precio por token baja un 20%, termina la misma tarea con menos tokens y menos pasos, así que el coste por tarea cae alrededor de un 40%. El caso oficial: en una auditoría de una base de código de 200 mil líneas, Opus 5 tardó más de 20 horas y gastó 2.5 veces más tokens, mientras que Opus 5.5 la terminó en menos de 3 horas.
• Lectura de caché a $0.20: esto pesa más de lo que parece. En tareas agénticas con conversaciones largas, como las de Claude Code, la mayor parte del coste es lectura de caché. Si eso baja un 60%, cuanto más larga sea la sesión, más ahorras.
• Cambia su forma de escribir: la queja típica sobre Opus 5 era que "habla demasiado y se enrolla", pero 5.5 escribe corto y con lo importante al principio. Muchos de los primeros testers comentan que los mensajes de commit, las descripciones de PR y los comentarios de código son claramente más concisos.
• Modo rápido: en la API de Claude también se abrió el fast mode (vista previa de investigación), con hasta 2.5 veces más velocidad. Eso sí, cuesta el doble, $8 / $40, así que es una opción para activar "solo cuando hay prisa".
• Límites de suscripción más altos: subieron los límites de uso de 5 horas de Pro, Max, Team y Enterprise (por puestos), y llegó una función para guardar un reinicio del límite y usarlo cuando quieras.
• Salvaguardas: como sus capacidades en ciberseguridad y biología son de nivel Fable 5.1, lleva clasificadores de seguridad del mismo nivel. Las solicitudes clasificadas como ciberseguridad se ejecutan con Opus 4.8, y las de biología, con Opus 5. En el desarrollo normal casi no afecta, pero en bases de código de CTF o de investigación de seguridad puede que veas un aviso de cambio de modelo.

Además, Sonnet 5.5 y Haiku 5.5 están anunciados para "dentro de unas semanas". Por ahora, solo Opus está en 5.5.

📌 Paso 1 - Comprueba qué cambió en Claude Code

Del changelog de v2.1.280, lo que nos importa son justo tres líneas.

1. El alias opus apunta a Opus 5.5 — si escribes /model opus, ahora se activa 5.5
2. El modelo por defecto de Pro y Team Standard pasa de Sonnet a Opus — ahora el default de todos los planes (Pro, Max, Team, Enterprise y API) es Opus 5.5
3. Los niveles guardados antes de que /effort se guardara por modelo no se aplican a Opus 5.5 — el modelo nuevo empieza con su propio valor por defecto (medium)

Abre una sesión y compruébalo así.

/status

Si en la cabecera o en la pantalla de /status aparece Opus 5.5, listo. Si quieres ver exactamente a qué apunta cada alias, escribe /model y abre el selector.

💡 Atención si tienes el plan Pro. Las sesiones que hasta ayer usaban Sonnet 5 usan desde hoy Opus 5.5. Es más listo, pero gasta el límite más rápido que Sonnet. Si no quieres gastar tanto, baja con /model sonnet o usa opusplan (Opus para diseñar y Sonnet para implementar). Y si notas que "hoy responde algo distinto", lo más probable es que sea por el cambio de modelo.

📌 Paso 2 - Revisa settings.json al pasar de Opus 5 a 5.5

Si dejas tu archivo de configuración tal cual, puede desajustarse en tres sitios. Abre la configuración de usuario (~/.claude/settings.json, en Windows C:\Users\<계정>\.claude\settings.json) y vamos a verla juntos.

Copia y pega sin miedo 👇 (versión ajustada para Opus 5.5)

{
  "model": "opus",
  "effortLevel": "high",
  "modelSettings": {
    "claude-opus-5-5": { "effortLevel": "medium" },
    "claude-opus-5": { "effortLevel": "medium" }
  },
  "fallbackModel": ["claude-opus-5", "claude-sonnet-5"]
}

Vamos punto por punto 💡

• model: si dejas el alias opus, pasas a 5.5 automáticamente. Al revés, si quieres quedarte en Opus 5 por ahora, fija el ID oficial claude-opus-5. Los alias siguen a cada versión nueva que sale
• modelSettings: el effort guardado se registra por ID oficial, así que el medium que pusiste en claude-opus-5 no se aplica a 5.5. Tienes que añadir una entrada claude-opus-5-5 aparte para 5.5. El ejemplo de arriba pone los dos en medium
• effortLevel: es el valor por defecto para los modelos que no tienen un nivel guardado. Pero el effortLevel de primer nivel del archivo de configuración de usuario no se aplica a Opus 5.5. Esta clave es el formato antiguo, de antes de que /effort guardara por modelo, así que solo sigue afectando a modelos anteriores como Opus 5 o Fable 5.1. (El effortLevel de primer nivel en la configuración de proyecto, local o administrada, o el que pasas con --settings, se aplica a todos los modelos.) Si te lías, lo más seguro es indicarlo en modelSettings
• fallbackModel: lista de modelos que se prueban si el modelo principal está saturado (máximo 3). Opus 5.5 acaba de salir y puede tener mucho tráfico, así que poner claude-opus-5 en primer lugar es lo que menos diferencia de calidad da

Y hay una cosa más sobre el effort. El effort por defecto de Opus 5.5 es medium, pero con el mismo nivel tiende a pensar más a fondo que Opus 5 (según la documentación oficial). O sea, si pones high en 5.5 con la misma idea con la que usabas high en Opus 5, puede gastar más tokens. La recomendación oficial es "no traigas tu configuración anterior tal cual: vuelve a empezar con medium y súbelo solo cuando haga falta". Yo pienso usarlo unos días en medium y luego decidir.

/effort medium

💡 En el selector de /model, Enter guarda (se mantiene en la siguiente sesión) y s es solo para esta sesión — esa regla no cambia.

También puedes fijar el alias con una variable de entorno. Sirve cuando en un equipo necesitas una política como "mantener Opus 5 hasta validarlo".

# Windows PowerShell — solo vale en esta ventana de terminal
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5"
claude

# macOS / Linux
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5
claude

• ANTHROPIC_DEFAULT_OPUS_MODEL: fija (pin) la versión exacta a la que apunta el alias opus. Con esto, /model opus, opusplan y default usan el modelo que pongas aquí

📌 Paso 3 - Si usas la API directamente: 4 cambios que rompen la compatibilidad

Si solo usas Claude Code, puedes saltarte este paso. Si llamas a la API directamente desde Python, hay cuatro puntos donde cambiar solo el ID del modelo puede darte un error 400.

1. No se puede desactivar thinking — thinking: {"type": "disabled"} o enabled con budget_tokens explícito dan 400. Quita el campo thinking o déjalo en {"type": "adaptive"}, y regula la profundidad con effort
2. No se puede forzar la llamada a herramientas — los tipos any y tool de tool_choice dan 400. Cámbialo a auto (por defecto) + strict: true, y si quieres que use una herramienta sí o sí, dilo en el prompt
3. Los bloques thinking quedan ligados al modelo y a la conversación — si pasas una conversación de Opus 5 a 5.5, el razonamiento se mantiene, pero si bajas de 5.5 a algo como Sonnet 5, se descarta el razonamiento anterior (la solicitud sí funciona). En cuentas creadas después del 2026-08-31, reenviar con cambios en el system prompt o en las herramientas que van antes de un bloque thinking da 400
4. No se admite la herramienta antigua de uso del ordenador computer_20251124 (API de Claude y Google Cloud) — migra a computer_toolset_20260801

Y aunque no es un error, el texto corto entre llamadas a herramientas llega como bloque thinking, no como text. Si tu app mostraba el progreso en pantalla, de repente se quedará callada, así que revisa el ajuste thinking.display.

Este es un ejemplo mínimo de migración. La clave y el nombre del modelo se leen de .env. Copia y pega sin miedo 👇

# anthropic 1.8.0 / python-dotenv 1.2.3 / Python 3.10+
from dotenv import load_dotenv
import os
from anthropic import Anthropic

load_dotenv()
api_key = os.getenv("ANTHROPIC_API_KEY")
model = os.getenv("CLAUDE_MODEL", "claude-opus-5-5")  # .env: CLAUDE_MODEL=claude-opus-5-5

client = Anthropic(api_key=api_key)

response = client.messages.create(
    model=model,
    max_tokens=4096,
    # se omite el campo thinking (en Opus 5.5, adaptive está siempre activado)
    # se omite tool_choice = auto
    messages=[{"role": "user", "content": "Escribe una función en Python que cuente los archivos .txt de una carpeta"}],
)

# Elige los bloques de la respuesta por type, no por posición (puede venir antes un bloque thinking)
for block in response.content:
    if block.type == "text":
        print(block.text)

El archivo .env queda así. ¡No olvides añadir .env a .gitignore!

ANTHROPIC_API_KEY=여기에_키
CLAUDE_MODEL=claude-opus-5-5

Vamos punto por punto 💡

• load_dotenv(): lee el .env de la misma carpeta y lo carga como variables de entorno. No escribir claves ni nombres de modelo en el código es la costumbre básica de este blog
• CLAUDE_MODEL: si también sacas el nombre del modelo a una variable de entorno, cambias entre Opus 5 y 5.5 con una sola línea de .env, sin tocar el código
• Comprobar block.type: Opus 5.5 puede poner un bloque thinking al principio de la respuesta (con la configuración por defecto, vacío), así que sacarlo por posición, como content[0].text, falla. Filtra por type
• effort: si hace falta, súbelo con algo como output_config={"effort": "high"}. Por defecto es medium

💬 La serie de integración con LLM de este blog (bot de Discord #9, automatización #5) usa un LLM local (LM Studio), así que estos cambios no le afectan. Solo aplican si usas una API de pago.

🛠️ Usarlo en GitHub Copilot y en la nube

Fuera de Claude Code también se abrió el mismo día.

• GitHub Copilot: desde el 22 de septiembre, Opus 5.5 aparece en el selector de modelos de Copilot Pro+, Max, Business y Enterprise. Con la facturación por uso, se cobra al precio de lista del proveedor. En las primeras pruebas de GitHub, resolvió más tareas de terminal que Opus 5 con menos de la mitad de pasos
• AWS, Google Cloud y Microsoft Foundry: disponible desde el día del lanzamiento. El ID del modelo es anthropic.claude-opus-5-5 solo en Bedrock; en los demás, claude-opus-5-5
• Ojo con los alias de Claude Code: en Bedrock y Google Cloud opus también apunta a 5.5, pero en Microsoft Foundry opus todavía es Opus 4.6. En Foundry tienes que indicar el ID oficial directamente

💡 ¿Qué modelo elegir ahora? (hasta que salga Sonnet 5.5)

Por tipo de tarea, queda así.

Entre Opus 5 y 5.5 no hay nada que pensar. Al mismo precio 5.5 ya sería mejor, y encima es más barato. La única razón para quedarse en Opus 5 es algo como "el equipo aún no lo ha validado". El verdadero dilema es si seguir usando Fable 5.1; como el anuncio oficial deja claro que está "al nivel de Fable 5.1 en la mayoría de las tareas", a tu bolsillo le conviene dejar Fable solo para los problemas que Opus 5.5 no resuelve ni con xhigh.

📌 Errores y fallos frecuentes

1. Opus 5.5 no aparece en la lista de /model / al escribir claude-opus-5-5 sale "does not support this model"

• Causa: tu Claude Code es anterior a v2.1.280
• Solución: claude update y reinicia. Si usas un gateway de empresa, el gateway tiene que estar configurado para servir claude-opus-5-5

2. Tras actualizar, con el plan Pro el límite se acaba enseguida

• Causa: desde v2.1.280, el modelo por defecto de Pro pasó de Sonnet 5 a Opus 5.5
• Solución: para tareas ligeras, baja con /model sonnet o usa opusplan. Si quieres Sonnet por defecto, pon "model": "sonnet" en settings.json

3. Guardé /effort medium, pero en 5.5 aparece otro nivel

• Causa: el effort se guarda por ID oficial. Lo que guardaste en claude-opus-5 no pasa a 5.5
• Solución: con Opus 5.5 activo, vuelve a guardar /effort medium, o añade una entrada claude-opus-5-5 en modelSettings

4. En la API: "thinking.type.disabled" is not supported for this model (400)

• Causa: en Opus 5.5 no se puede desactivar thinking
• Solución: borra el parámetro thinking → en su lugar, baja output_config.effort a low

5. En la API: tool_choice: type "tool" and "any" are not supported for this model (400)

• Causa: no se admite forzar la llamada a herramientas
• Solución: pon tool_choice en auto y, para forzar el esquema, usa strict: true o structured outputs

6. response.content[0].text da AttributeError en la respuesta

• Causa: el primer bloque puede ser thinking (vacío)
• Solución: filtra por type, como en for block in response.content: if block.type == "text"

7. En una base de código de investigación de seguridad, la sesión cambia de repente a Opus 4.8

• Causa: el clasificador de seguridad de Opus 5.5 lo detecta como ciberseguridad → pasa a Opus 4.8 como alternativa (lo de biología, a Opus 5)
• Solución: es el comportamiento normal. Si prefieres que te lo confirme cada vez, desactiva Switch models when a message is flagged en /config

🙌 Para terminar

Resumiendo lo de hoy:

• Opus 5.5 = rendimiento de nivel Fable 5.1 a $4 / $20. Frente a Opus 5: precio por token 20% ↓, lectura de caché 60% ↓, coste real por tarea 40% ↓, salida 30% ↑
• Desde Claude Code v2.1.280, opus y default apuntan a Opus 5.5. En Pro, el modelo por defecto ahora también es Opus, así que recalibra cómo gastas el límite
• Tienes que añadir una entrada claude-opus-5-5 en modelSettings de settings.json para que el effort se aplique. El effort por defecto es medium; no traigas tal cual tu costumbre de usar high
• Al llamar a la API directamente, desactivar thinking, forzar tool_choice y la herramienta computer antigua dan error 400. Elige los bloques de la respuesta por type
• Sonnet 5.5 y Haiku 5.5 están anunciados para dentro de unas semanas. Cuando salgan, lo resumiré en otro artículo

La próxima entrega será la #32 de la serie Crear un bot de Discord, y también estoy preparando un resumen de novedades para el lanzamiento oficial de Python 3.15 el 1 de octubre. ¡No te lo pierdas! 🙌

¿Ya te pasaste a Opus 5.5? ¿Qué tal lo notas? Sobre todo, si me cuentas en los comentarios si el effort medium te basta, lo tendré en cuenta en el próximo artículo.

📚 Artículos relacionados

• Guía completa para cambiar de modelo y ajustar el effort en Claude Code - Cómo elegir entre Opus 5 / Sonnet 5 / Fable 5.1
• ¡Llega Claude Opus 5! Nuevo modelo por defecto de Claude Code - Guía de /model y /effort
• Llega Claude Sonnet 5 - Nuevo modelo por defecto de Claude Code, qué cambia y cómo usarlo
• Introducción a Claude Code - ¡De la instalación a la primera ejecución! Guía completa del agente de IA para programar en la terminal
• Cómo escribir buenos prompts para programar con IA - Guía práctica de vibe coding
• Comparativa de herramientas gratuitas de IA para programar 2026 - Claude Code vs Cursor vs Copilot