TL;DR Junto a Opus 5, Anthropic publicó una guía de prompting específica del modelo. Lo interesante es que la mitad de los consejos son cosas que hay que quitar, no añadir: las instrucciones de verificación, las de revisar dos veces y el effort heredado de Opus 4.8. Aquí van los ocho, traducidos a lo que tocas en Claude Code.
Todo el mundo leyó la nota de lanzamiento. Casi nadie leyó la otra página que Anthropic publicó el mismo día: la guía de prompting de Opus 5. Y es la que de verdad cambia cómo lo usas, porque no es una lista de buenas prácticas genéricas. Es una lista de comportamientos que cambiaron respecto a Opus 4.8, con lo que hay que hacer en cada uno.
Si lo que quieres es saber si Opus 5 te ha llegado ya (versión mínima, alias, plan), eso está en el tip del lanzamiento. Esto es lo siguiente: qué hacer distinto una vez lo tienes delante.
1. Dale la tarea entera de golpe, y acota el alcance
Opus 5 rinde mejor cuando le das la especificación completa desde el principio y lo dejas correr, en vez de irle dando pasos. Termina tareas enteras en lugar de dejar stubs. El contrapeso: también amplía tareas por su cuenta, añadiendo pasos que no pediste. Las dos cosas se resuelven con el mismo prompt.
Entrega lo que se ha pedido, con el alcance que se ha pedido. Toma tú las
decisiones de rutina y pregunta solo cuando dos lecturas del encargo lleven a
trabajos distintos. Si el encargo parece equivocado, dilo en una frase y sigue
adelante con lo pedido.
Para la parte de escribir bien ese encargo, las cinco reglas de prompt que sigue Anthropic siguen valiendo igual.
2. Borra las instrucciones de verificación
Esta es la que más gente tiene escrita y la más contraintuitiva. La guía no lo insinúa, lo ordena: si tu prompt (o tu CLAUDE.md) pide un paso de verificación final o usar un subagente para verificar, elimínalo. Provoca sobre-verificación y quitarlo reduce tokens desperdiciados sin pérdida de calidad.
grep -rns -i "verif\|double-check\|revisa dos veces" \
~/.claude/CLAUDE.md ./CLAUDE.md ./.claude/agents/ ./.claude/skills/
Los agentes y las skills son el escondite favorito: se escribieron una vez, funcionan, y nadie los vuelve a abrir. Si tu CLAUDE.md no lo has tocado en meses, este es buen momento.
3. Tampoco le pidas que se revise dos veces
Misma familia: "revisa tu respuesta", "verifica antes de responder". Opus 5 caza y corrige sus propios errores sin que se lo digas, así que la instrucción no añade un control, duplica el que ya existe.
Lo que sí conviene decirle es cuándo callarse esas correcciones, porque las narra más que los modelos anteriores: corrige una afirmación anterior solo cuando el error cambie el código, las conclusiones o las decisiones del usuario.
4. Ponle tope a la delegación en subagentes
Opus 5 coordina equipos de subagentes bastante bien, y precisamente por eso delega con más facilidad. Sale a cuenta en trabajo grande de verdad y multiplica coste y tiempo en el resto.
Delega en un subagente solo para tareas grandes, genuinamente independientes y
paralelizables. No delegues trabajo que puedas terminar en unas pocas llamadas
a herramientas, ni uses subagentes para verificar tu propio trabajo. Si uno
basta, usa uno.
Vale también dentro de cada agente propio en .claude/agents/. Y si lo tuyo son los workflows con cientos de agentes, ahí el tope lo pone el script, no el modelo.
5. Usa low y medium con generosidad
Cambio de recomendación respecto a Opus 4.7 y 4.8, donde lo aconsejado era empezar en xhigh para código. En Opus 5 se empieza en high (el default) y se usan low y medium con generosidad como control principal de coste y latencia. xhigh queda para el trabajo exigente.
Y ojo, porque Opus 5 no te resetea el effort al estrenarlo: el nivel que fijaras hace meses sigue puesto. Si lo tienes clavado en settings.json o en la variable de entorno, ahí es donde toca revisarlo.
6. La brevedad hay que pedirla aparte
Opus 5 responde más largo que los Opus anteriores, y aquí está el matiz que rompe la intuición: el effort controla cuánto piensa, no cuánto dice. Bajarlo reduce el razonamiento sin acortar de forma fiable lo que ves en pantalla.
Respuestas centradas, breves y concretas. Advertencias y matices, cortos. El
grueso de la respuesta va a lo que se ha preguntado. Ajusta la longitud de los
documentos que escribas a lo que pide la tarea, sin secciones de relleno.
Los archivos que escribe a disco (informes, resúmenes, documentación) también salen más largos, de ahí la segunda frase. En un CLAUDE.md largo, repite la versión corta cerca del final.
7. En review, no le digas "solo lo grave"
Opus 5 revisa código con mucha precisión y encuentra bugs reales a buen ritmo. Pero sigue las instrucciones al pie de la letra: si tu prompt de revisión dice "reporta solo lo de severidad alta" o "sé conservador", reporta menos. La guía recomienda pedirle todo y filtrar en un paso aparte.
Encaja directo con /code-review en local, donde además la precisión aguanta bien en effort bajo: una pasada rápida al escribir, una más profunda antes del PR.
8. Si apagaste el thinking, míralo antes que nada
La guía cierra con los artefactos que aparecen con el thinking desactivado (llamadas a herramientas escritas como texto plano, etiquetas XML internas coladas en la respuesta). En Claude Code eso te toca solo si en su día pusiste MAX_THINKING_TOKENS=0 en tu settings.json. Y si es tu caso, hay algo más urgente que los artefactos:
$ MAX_THINKING_TOKENS=0 claude -p "hola" --model opus --effort xhigh
API Error: 400 output_config.effort 'xhigh' is not supported when
thinking is disabled on this model. Use effort 'high' or below, or
enable thinking.
En Opus 5 el thinking no se puede desactivar por encima de high, así que esa combinación no degrada, revienta. Con high o por debajo responde con normalidad, y el mismo combo en Opus 4.8 funciona sin error. El consejo de fondo es el mismo en los dos casos: deja el thinking encendido y controla el gasto bajando el effort, porque pensar en low rinde mejor que no pensar a coste parecido.
Referencia
| Consejo | Con Opus 4.8 | Con Opus 5 |
|---|---|---|
| Especificación completa por delante | Ayudaba | Rinde mejor si además lo dejas correr |
| "Verifica al final" | Útil | Sobra: sobre-verificación |
| "Revisa dos veces" | Útil | Sobra: ya se corrige solo |
| Delegación en subagentes | Poco frecuente | Delega más solo, ponle tope |
| Effort de partida | xhigh para código |
high, con low y medium a menudo |
| Longitud de la respuesta | El effort la acortaba | Se pide aparte |
| "Solo severidad alta" en review | Filtraba | Reporta menos de lo que ve |
MAX_THINKING_TOKENS=0 + xhigh |
Funciona | Error 400 en cada petición |
Documentación oficial: Prompting Claude Opus 5 · Effort
Requisitos
- Claude Code con Opus 5 activo (
/model opus), que pide v2.1.219 o superior. Comprobado en la v2.1.220. - Con Opus 4.8 o anterior no cambies nada: los consejos de arriba describen comportamientos que solo trae Opus 5.