Cómo cambiar Claude Code a Opus 5.5 y dejar el modelo fijado
Cambia Claude Code con el ID completo o el alias opus, corrige el 400 de un cliente antiguo, entiende el effort medium y verifica el fallback tras un rechazo.
Índice
Ejecutas /model, eliges Opus y Claude Code parece seguir usando otro modelo, o devuelve un 400 antes de responder. Para cambiar a Opus 5.5 de forma fiable, separa tres comprobaciones: el comando del modelo, la versión de Claude Code y cualquier fallback activado por un rechazo de seguridad.
Usa el ID completo cuando necesites una configuración reproducible. Utiliza el alias opus solo después de comprobar a qué modelo se resuelve. Ten en cuenta además que Opus 5.5 usa medium como esfuerzo predeterminado, en lugar del valor high de Opus 5.
Usa el ID completo para fijar Opus 5.5
El comando más explícito es:
/model claude-opus-5-5Anthropic documenta claude-opus-5-5 como un ID fijo, sin sufijo de fecha. Es la mejor opción para instrucciones de equipo, documentación de proyectos y proveedores personalizados, porque deja claro qué modelo debe solicitar cada cliente.
La alternativa corta es:
/model opusUsa el alias únicamente cuando Claude Code, o el servicio que hay detrás de tu Base URL, muestre que se resuelve a Opus 5.5. Es práctico para trabajar de forma interactiva, pero el ID completo resulta más fácil de auditar cuando una sesión o un gateway se comporta de manera inesperada.
| Objetivo | Opción recomendada | Motivo |
|---|---|---|
| Fijar el modelo exacto | /model claude-opus-5-5 | El ID solicitado queda explícito y es reproducible |
| Elegir rápidamente el Opus actual | /model opus | Es más corto, pero debes verificar el modelo resuelto |
| Diagnosticar un proveedor externo | Primero el ID completo | Distingue un problema de alias de la falta de disponibilidad |
Si ejecutas Claude Code mediante una Base URL compatible con Anthropic, como BetterToken, el uso de /model no cambia; confirma que el proveedor expone realmente claude-opus-5-5 antes de confiar en el resultado de un alias.
Actualiza Claude Code antes de cambiar
Un cliente anterior al lanzamiento del modelo puede rechazarlo aunque tu cuenta o proveedor ya lo admita. Actualiza primero:
claude updateDespués reinicia la sesión activa de Claude Code. Si utilizas la aplicación de escritorio de Claude, actualízala también y vuelve a ejecutar el comando con el ID completo.
Un issue de la comunidad registró un caso concreto el 22 de septiembre de 2026: Claude Code 2.1.257 fue rechazado con claude_code_version_too_old, y la respuesta exigía 2.1.280 o una versión posterior. Es un ejemplo útil de la barrera de versión, no un mínimo universal y permanente. Sigue el requisito que indique el error que recibas, ya que una versión futura puede elevarlo.
Cambia el modelo y verifica el resultado
Sigue este orden para que un fallo no oculte otro:
- Ejecuta
claude updatey reinicia Claude Code. - Escribe
/model claude-opus-5-5en la sesión donde vas a trabajar. - Comprueba la selección que Claude Code muestra después del comando. No des por hecho que funcionó solo porque aceptó la entrada.
- Antes de una tarea larga o costosa, abre de nuevo
/modely confirma la selección actual.
Si el ID completo funciona pero /model opus no selecciona lo esperado, mantén el ID completo. Eso apunta a la resolución del alias, no a una imposibilidad general de usar Opus 5.5.
Si ninguna opción funciona y utilizas un endpoint de terceros, revisa la disponibilidad y el mapeo del modelo en ese proveedor. El Claude API oficial puede admitir el ID estándar mientras que un gateway compatible mantiene otro catálogo o aún no ha activado el modelo.
El effort predeterminado es medium
Claude Opus 5.5 utiliza adaptive thinking de forma permanente y su effort documentado por defecto es medium. Opus 5 usaba high, de modo que el cambio puede alterar la latencia, el consumo de tokens y la profundidad de razonamiento aunque no modifiques ningún ajuste visible de Claude Code.
En el uso normal de Claude Code no hace falta inventar un nivel de effort para completar el cambio. Confirma primero el modelo y después evalúa si el comportamiento por defecto encaja con la tarea. Si tu cliente o gateway expone ese control, configúralo de forma deliberada en lugar de asumir el valor anterior.
Las integraciones personalizadas también deben respetar las reglas de petición de Opus 5.5. El modelo rechaza desactivar thinking o enviar un thinking budget manual. Si la selección funciona pero la primera petición devuelve 400, inspecciona las transformaciones del payload en el gateway en vez de repetir /model.
Un mensaje marcado puede seguir una ruta de fallback
Un rechazo de seguridad es distinto de la selección normal del modelo. En la capa API, Opus 5.5 puede responder con HTTP 200, stop_reason: "refusal" y un objeto stop_details. Si el cliente o el proveedor tiene fallback habilitado, esa petición concreta puede reintentarse con otro modelo.
Interprétalo como un fallback a nivel de petición, no como prueba de que cambió de forma permanente tu elección guardada en /model. Antes de continuar un trabajo importante, vuelve a abrir /model y verifica el modelo activo. Anthropic también indica que, al pasar de Opus 5.5 a la mayoría de los otros modelos, los turnos posteriores se ejecutan sin los thinking blocks anteriores de Opus 5.5; repite las restricciones esenciales en lugar de asumir que se conservó todo el razonamiento.
Sigue este orden:
- Lee el aviso de rechazo o de mensaje marcado; no reenvíes lo mismo sin cambios.
- Si la solicitud es legítima, elimina o reformula la parte que activó el clasificador.
- Comprueba si el cliente o el proveedor utilizó un modelo de fallback.
- Confirma otra vez Opus 5.5 antes de reanudar una tarea que dependa de un modelo fijo.
Resuelve los fallos más comunes
| Síntoma | Primera comprobación | Siguiente acción |
|---|---|---|
400 con claude_code_version_too_old | Versión de Claude Code o de la app | Ejecutar claude update, reiniciar y probar el ID completo |
| Opus 5.5 no aparece en la lista | Catálogo del cliente o proveedor desactualizado | Actualizar el cliente y revisar la disponibilidad del proveedor |
/model opus elige un modelo inesperado | Resolución del alias | Usar /model claude-opus-5-5 y comprobar la selección mostrada |
| Se acepta el ID, pero la primera petición da 400 | Payload ascendente incompatible | Revisar thinking desactivado/manual y reescrituras del gateway |
| Se marca un mensaje y responde otro modelo | Fallback por rechazo | Revisar el rechazo, verificar el modelo y repetir las restricciones clave |
| El cambio en mitad de una sesión pierde coherencia | Los thinking blocks pueden no transferirse | Confirmar el modelo y aportar el contexto necesario al nuevo turno |
Lista final antes de empezar
- Claude Code está actualizado y reiniciado.
/model claude-opus-5-5se acepta sin error de versión.- La selección mostrada se resuelve realmente a Opus 5.5.
- Esperas
mediumcomo effort predeterminado salvo configuración explícita. - Tras un mensaje marcado o rechazado, has comprobado si se utilizó un modelo de fallback.
Cuando se cumplen los cinco puntos, el ID completo es la forma más segura de mantener una sesión reproducible. El alias opus sigue siendo útil para cambios rápidos, pero debe verificarse y no darse por supuesto.
