DEV Community

Cover image for Cómo usar Claude Opus 5 en Claude Code
Roobia
Roobia

Posted on • Originally published at apidog.com

Cómo usar Claude Opus 5 en Claude Code

Claude Opus 5 llegó el 24 de julio de 2026 y estuvo disponible en Claude Code desde el primer día. Para suscriptores Max, es el modelo predeterminado; para usuarios Pro, es el modelo más potente disponible. Con una clave API, cuesta $5 por millón de tokens de entrada y $25 por millón de tokens de salida, igual que Opus 4.8.

Prueba Apidog hoy

La configuración que funcionaba bien con modelos anteriores puede aumentar innecesariamente el costo con Opus 5. Este modelo verifica su trabajo por iniciativa propia, genera respuestas más extensas y recurre a subagentes con más frecuencia que Opus 4.8. Si tu CLAUDE.md también le pide verificar, explicar y delegar constantemente, esos comportamientos se amplifican.

Esta guía explica cómo seleccionar el modelo, ajustar el esfuerzo y actualizar tus prompts el primer día. También muestra cómo usar Apidog para validar la API que Claude Code acaba de implementar. Para más contexto, consulta el resumen de Claude Opus 5 y el anuncio de Claude Opus 5 de Anthropic.

¿Qué cambia según el nivel de suscripción?

El acceso a Opus 5 depende de tu plan y del entorno donde lo uses.

Suscriptores Max: Opus 5 se convierte en el modelo predeterminado. No necesitas cambiar nada, pero sí conviene revisar las reglas heredadas de tu proyecto: tus expectativas sobre costo, verbosidad y delegación probablemente estaban calibradas para otro modelo.

Selector de modelo de Claude Opus 5

Suscriptores Pro: Opus 5 es el modelo de mayor rendimiento disponible en este nivel. Esto cambia el techo de capacidad disponible para tareas complejas de codificación, refactorización y trabajo agéntico.

Usuarios de clave API: Opus 5 está disponible en la API de Claude, Amazon Bedrock (anthropic.claude-opus-5), Google Cloud, Microsoft Foundry y GitHub Copilot. El precio es de $5 por millón de tokens de entrada y $25 por millón de salida, sin cambios frente a Opus 4.8 y la mitad de los $10/$50 de Fable 5. Consulta el desglose de precios de Opus 5 para ver tarifas de caché y procesamiento por lotes.

Precios de Claude Opus 5

Opus 5 tiene una fecha de corte de conocimiento de mayo de 2026. Fable 5 y Sonnet 5 se detienen en enero de 2026. Para flujos de trabajo que dependen de SDKs, APIs y librerías recientes, esos meses adicionales pueden ser relevantes.

Seleccionar Opus 5 en Claude Code

Dentro de una sesión de Claude Code, abre el selector de modelos:

/model
Enter fullscreen mode Exit fullscreen mode

Elige Claude Opus 5 en la lista.

También puedes configurarlo directamente con el ID del modelo:

/model claude-opus-5
Enter fullscreen mode Exit fullscreen mode

Usa exactamente claude-opus-5 para configuraciones, automatizaciones y reglas de proyecto. No requiere sufijo de fecha ni versión.

La documentación de modelos de Anthropic enumera los IDs específicos para plataformas como Bedrock y Google Cloud.

Opus 5 ofrece hasta 1M de tokens de contexto por defecto y como máximo, sin encabezado beta ni recargo de contexto largo. La salida máxima en la API de Mensajes es de 128k tokens. Aun así, evita enviar el repositorio completo en cada turno: tener capacidad no elimina el costo ni mejora automáticamente la precisión.

Para otros comandos útiles, consulta la hoja de trucos de Claude Code.

Cómo se comporta el esfuerzo

El esfuerzo se configura mediante output_config.effort en la API. Los niveles disponibles son:

low
medium
high
xhigh
max
Enter fullscreen mode Exit fullscreen mode

Las interfaces visuales suelen exponer estos valores como un selector de esfuerzo.

1. El valor predeterminado es high

Si no indicas ningún nivel, Opus 5 usa:

{
  "output_config": {
    "effort": "high"
  }
}
Enter fullscreen mode Exit fullscreen mode

No asumas que el comportamiento predeterminado es medium o adaptativo.

2. No reutilices tus valores de Opus 4.8

Anthropic recomienda reevaluar los niveles de esfuerzo para Opus 5. En particular, low y medium son más capaces que en modelos Opus anteriores.

Una forma práctica de migrar es ejecutar el mismo conjunto de tareas con varios niveles:

low     → tareas simples, cambios localizados, clasificación
medium  → edición estándar, bugs conocidos, tareas repetibles
high    → valor predeterminado para trabajo complejo
xhigh   → codificación y flujos agénticos exigentes
max     → evaluación específica cuando el costo no sea la prioridad
Enter fullscreen mode Exit fullscreen mode

Para trabajo de codificación y tareas agénticas, Anthropic sigue recomendando comenzar con xhigh.

3. Evita combinar pensamiento desactivado con xhigh o max

Esta combinación devuelve un error 400:

{
  "thinking": {
    "type": "disabled"
  },
  "output_config": {
    "effort": "xhigh"
  }
}
Enter fullscreen mode Exit fullscreen mode

El error también ocurre con max.

La solución es una de estas dos:

  • Mantener el pensamiento activado.
  • Limitar el esfuerzo a high o menos.

En Claude Code interactivo normalmente no verás este error porque la herramienta prepara la solicitud. Es más probable encontrarlo al usar el SDK o automatizar llamadas a la API.

Además, Anthropic recomienda mantener el pensamiento activado. Con el pensamiento desactivado pueden aparecer llamadas a herramientas escritas como texto plano que no llegan a ejecutarse, así como etiquetas XML internas visibles en la salida. Controla el costo bajando el esfuerzo, no desactivando el pensamiento.

La guía de parámetros de esfuerzo explica cómo evaluar los niveles, y la guía de migración desde Opus 4.8 cubre otros cambios relevantes.

Cuatro ediciones de prompts para hacer el primer día

Estas actualizaciones reducen sobreverificación, delegación innecesaria y respuestas demasiado largas. Hazlas en el CLAUDE.md global y en los archivos de proyecto.

La referencia principal es la guía de prompts de Opus 5 de Anthropic.

1. Elimina instrucciones de verificación redundantes

Busca reglas como estas:

  • “Siempre verifica tu trabajo dos veces”.
  • “Verifica el cambio antes de reportar”.
  • “Confirma que las pruebas pasen y luego confirma de nuevo”.

Elimínalas si no añaden una comprobación externa concreta.

Opus 5 ya verifica su trabajo sin necesitar esa instrucción. Si también le pides repetir verificaciones, puede releer archivos, volver a ejecutar comprobaciones y gastar tokens confirmando resultados ya validados.

En tu CLAUDE.md, busca términos como:

verificar
doble verificación
confirmar
revisar dos veces
Enter fullscreen mode Exit fullscreen mode

Conserva únicamente las reglas que indiquen una acción verificable y externa, por ejemplo: “Ejecuta pnpm test antes de finalizar”.

2. Limita la creación de subagentes

Opus 5 delega con más facilidad que Opus 4.8. Esto puede acelerar investigaciones paralelas, pero también aumentar el consumo de tokens.

Añade límites explícitos a las instrucciones del proyecto:

## Delegación

No generes subagentes para tareas que se puedan terminar en una sola pasada.
Usa como máximo dos subagentes en paralelo. Si una tarea parece necesitar
más, describe la división y pregunta antes de generar más.
Enter fullscreen mode Exit fullscreen mode

El objetivo no es bloquear la delegación, sino exigir que sea proporcional al problema. Si necesitas configurar subagentes de forma intencional, consulta la guía para crear subagentes de Claude Code.

3. Pide concisión de forma explícita

Opus 5 suele producir respuestas, resúmenes y documentos más largos que Opus 4.8.

Bajar el esfuerzo no reduce necesariamente la longitud de la salida visible. El esfuerzo controla la profundidad del razonamiento, no el número de palabras de la respuesta final.

Define el formato de salida en tus instrucciones:

## Estilo de respuesta

Reporta los resultados en menos de 150 palabras a menos que pida detalles.
No resumas lo que acabas de hacer si puedo ver el diff.
Omite el preámbulo. Ve directo a la respuesta.
Enter fullscreen mode Exit fullscreen mode

Puedes adaptar el límite según tu flujo:

Para cambios de código:
- Indica archivos modificados.
- Explica riesgos o decisiones en un máximo de 5 viñetas.
- No incluyas un resumen narrativo del diff.
Enter fullscreen mode Exit fullscreen mode

4. Restringe el alcance de tareas específicas

Opus 5 puede ampliar el alcance de una tarea si detecta problemas relacionados. Esto es útil en refactorizaciones, pero no en correcciones pequeñas o cambios sensibles.

Usa límites explícitos:

Arregla la verificación de nulos en parseConfig y no cambies nada más.
Enter fullscreen mode Exit fullscreen mode

En lugar de:

Arregla la verificación de nulos en parseConfig.
Enter fullscreen mode Exit fullscreen mode

El primer prompt define tanto el cambio esperado como el límite de intervención. Para más ejemplos reutilizables, consulta la guía de prompts para Opus 5.

Crea una API y deja que Opus 5 la pruebe

Claude Code puede generar rutas, controladores y validaciones, pero no puede asumir que un endpoint en ejecución cumple el contrato. La validación externa sigue siendo necesaria.

Un flujo práctico es:

  1. Diseña endpoints y esquemas de solicitud y respuesta en Apidog.
  2. Configura un servidor mock con respuestas realistas.
  3. Conecta el servidor Apidog MCP para que Opus 5 consulte la especificación real.
  4. Pide a Claude Code que implemente la ruta según ese contrato.
  5. Ejecuta el escenario de prueba cuando termine.

Por ejemplo:

apidog run --access-token $APIDOG_TOKEN \
  --project-id $PROJECT_ID \
  --test-scenario "user-signup-flow"
Enter fullscreen mode Exit fullscreen mode

Las aserciones fallidas vuelven como salida que el modelo puede leer y corregir. Esto crea un bucle de validación basado en el comportamiento real de la API, no solo en el razonamiento interno del modelo.

También puedes usar Apidog al integrar la API de Claude directamente en tu aplicación:

  • Enviar solicitudes a claude-opus-5.
  • Inspeccionar eventos de streaming SSE.
  • Revisar cargas útiles de llamadas a herramientas.
  • Guardar la clave API como variable de entorno.
  • Comparar el mismo prompt con distintos niveles de esfuerzo.
  • Inspeccionar el bloque usage para confirmar aciertos de caché.

Descarga Apidog para configurar el proyecto localmente.

El límite honesto

Opus 5 no es el modelo más alto de toda la pila de Claude.

Fable 5 mantiene la designación de Anthropic como “el más capaz ampliamente lanzado”. Opus 5 también queda por detrás de Mythos 5 en explotación de ciberseguridad e investigación de biología autónoma, según las afirmaciones de Anthropic.

Si tu carga de trabajo está en esas áreas, Opus 5 no es necesariamente el modelo adecuado. Consulta el explicador de modelos de clase Mythos para entender ese nivel de capacidad.

Sobre benchmarks, Anthropic informa que Opus 5:

  • Más que duplica la puntuación de Frontier-Bench v0.1 de Opus 4.8.
  • Obtiene aproximadamente tres veces la puntuación del siguiente mejor modelo en ARC-AGI 3.
  • Se acerca a 0.5% del pico de CursorBench 3.2 de Fable 5 a la mitad del precio.

Son métricas proporcionadas por el proveedor. Al 25 de julio de 2026, no habían sido reproducidas de forma independiente. Úsalas como motivo para ejecutar tu propia evaluación, no como resultado definitivo.

Cuándo usar otra cosa

Usa Opus 5 para la mayoría del trabajo en Claude Code:

  • Codificación agéntica.
  • Refactorizaciones de varios archivos.
  • Tareas largas con lectura de comandos y salida de herramientas.
  • Problemas que requieren varios ciclos de implementación y prueba.

Considera otro modelo cuando:

  • El volumen sea alto y el costo sea el factor principal.
  • Sonnet 5 pueda resolver edición estándar a menor precio.
  • El problema pertenezca al territorio de Fable 5 o Mythos 5.

El cambio de modelo es un solo comando:

/model claude-sonnet-5
Enter fullscreen mode Exit fullscreen mode

Para tareas económicas.

/model claude-opus-5
Enter fullscreen mode Exit fullscreen mode

Para tareas complejas.

Si ya usaste Sonnet 5 en Claude Code o Fable 5 en Claude Code, el flujo de trabajo será familiar.

Consejos prácticos

  • Audita primero CLAUDE.md. Elimina instrucciones de verificación redundantes, añade límites de longitud y restringe la delegación.
  • Reevalúa el esfuerzo. Los valores que usabas en Opus 4.8 no son una referencia fiable para Opus 5.
  • Mantén el pensamiento activado. Ajusta el costo mediante effort, no mediante thinking: disabled.
  • Delimita el contexto. Un millón de tokens es capacidad disponible, no una razón para enviar todo el repositorio en cada turno.
  • Verifica externamente. Una prueba fallida contra un contrato real aporta más señal que una autoevaluación del modelo.

Preguntas frecuentes

¿Está Claude Opus 5 disponible en Claude Code?

Sí, desde su lanzamiento el 24 de julio de 2026. Selecciónalo con /model o usa directamente:

/model claude-opus-5
Enter fullscreen mode Exit fullscreen mode

Es el modelo predeterminado para suscriptores Max y el modelo de mayor rendimiento para suscriptores Pro.

¿Necesito cambiar mi CLAUDE.md?

Probablemente. Anthropic indica que las instrucciones heredadas de verificación pueden causar sobreverificación en Opus 5. Elimina las reglas redundantes, añade límites de concisión y define cuántos subagentes puede crear.

¿Por qué reducir el esfuerzo no hizo las respuestas más cortas?

Porque el esfuerzo controla la profundidad del pensamiento, no la longitud de la respuesta visible. Si quieres una salida corta, indícalo explícitamente en el prompt o en CLAUDE.md.

¿Qué causa un error 400 al configurar el esfuerzo en xhigh?

Combinar:

{
  "thinking": {
    "type": "disabled"
  },
  "output_config": {
    "effort": "xhigh"
  }
}
Enter fullscreen mode Exit fullscreen mode

devuelve un error 400 en Opus 5. Activa el pensamiento o limita el esfuerzo a high. Consulta la guía de migración para más cambios desde Opus 4.8.

¿Puedo usar Opus 5 en Claude Code con un plan gratuito?

Opus 5 está disponible mediante suscripciones Pro y Max, además de la API. Pro ofrece acceso al modelo como opción superior de ese nivel, mientras que Max lo usa como predeterminado. Consulta la guía de acceso gratuito a Opus 5 para conocer las rutas disponibles y las opciones de pago más económicas.

Top comments (0)