Revisa todo el proyecto
Escríbelo en Claude Code, dentro de la carpeta de tu proyecto./claude-api prompt-audit
Guía gratisIA cada semana
Limpia tus prompts para Opus 5.5
Muchas instrucciones que escribimos para modelos antiguos hoy hacen que Claude trabaje de más. Un comando de Claude Code las encuentra y te propone cómo dejarlas. Aquí tienes el comando, cómo usarlo y la lista de frases que ya sobran.
Necesitas Claude Code v2.1.221 o posterior. Para ver tu versión: claude --version · para actualizar desde la terminal: claude update
El comando
Solo tus archivos de instrucciones
Si no programas y solo quieres revisar tu CLAUDE.md, tus skills y tus reglas. Necesita Claude Code v2.1.283 o posterior./doctor prompt-audit
Los dos vienen incluidos en Claude Code: no hay que instalar nada. Forman parte del skill oficial /claude-api de Anthropic.
Qué hace exactamente
- Lee todo lo que le llega a Claude como texto: tu
CLAUDE.md, skills, reglas, comandos, subagentes, prompts de sistema y descripciones de herramientas. - Busca tres tipos de problema: instrucciones escritas para modelos antiguos, datos que ya no son ciertos (rutas o comandos que ya no existen) y archivos que se contradicen entre sí.
- Te entrega dos cosas: un informe con cada hallazgo (archivo y línea, por qué sobra y su nivel de confianza) y una propuesta de cambios.
- No toca nada si no se lo pides. Solo propone. Tú decides qué se aplica.
- No va de acortar por acortar: si tus instrucciones están bien, te dirá que no hay nada que cambiar.
Paso a paso
- Actualiza Claude CodeComprueba tu versión con
claude --version. Si es antigua, ejecutaclaude update. - Abre Claude Code en la carpeta de tu proyectoRevisa lo que hay en la carpeta donde lo abres. Si quieres revisar solo una parte, dilo en el mismo mensaje, por ejemplo
/doctor prompt-audit .claude/skills/mi-skill. - Escribe el comando y esperaTrabaja solo, sin hacerte preguntas. Al principio del informe te dice qué ha revisado y para qué modelo.
- Lee el informe empezando por arribaVa ordenado por confianza: primero lo que está documentado por Anthropic, al final lo dudoso.
- Pide que aplique lo que te convenzaPor ejemplo, con esta frase:
Aplica los cambios de confianza alta que has propuesto y déjame el resto para revisarlo yo.
- Comprueba que todo sigue funcionandoAnthropic lo dice claro: quitar una instrucción es una hipótesis. Prueba tus tareas de siempre. Si algo empeora, vuelve a poner esa instrucción en versión corta, no la larga de antes.
- Repítelo con cada modelo nuevoLo que hoy es necesario puede sobrar con el siguiente modelo.
Las frases que ya sobran
Sacadas del artículo de Anthropic sobre costes, de su guía de prompts para Opus 5.5 y de la propia lista que usa el comando. Los ejemplos están traducidos.
-
Rituales de verificación
«Verifica dos veces antes de responder.» «Revisa tu trabajo dos veces.»
Quítalas.
En la prueba de Anthropic hacían que Claude repitiera búsquedas que ya había hecho, y eso se paga.
-
Empujones de exhaustividad
«Sé lo más exhaustivo posible.» «No seas perezoso. No pares antes de tiempo.»
Quítalas.
Los modelos actuales ya son proactivos. Con estas frases hacen trabajo extra que nadie ha pedido.
-
Reglas en mayúsculas
«CRÍTICO: SIEMPRE DEBES usar esta herramienta…» «IMPORTANTE: NUNCA…» (varias veces)
«Usa esta herramienta cuando…». Deja solo una o dos reglas de verdad, en tono normal y con su porqué.
Los modelos nuevos siguen las instrucciones al pie de la letra, y los gritos hacen que exageren.
-
«Piensa paso a paso»
«Piensa paso a paso.» «Piensa detenidamente antes de responder.» «Usa un borrador para pensar.»
Quítalas y controla cuánto piensa con el nivel de esfuerzo (en Claude Code,
/effort).Opus 5.5 siempre piensa. Anthropic probó a quitar «piensa antes de responder» en un chat y las respuestas empezaron antes, sin perder calidad.
-
«Planifica antes de actuar»
«Antes de nada, haz un plan detallado.»
Quítala.
Ya planifica sin que se lo digas, y esta frase le hace planificar de más.
-
«Muestra tu razonamiento»
«Escribe todo tu razonamiento en la respuesta.»
Quítala. Si usas la API, lee el resumen del pensamiento que te devuelve.
En Opus 5.5, pedirle que copie su razonamiento en la respuesta puede hacer que rechace la petición.
-
Peticiones con «si es posible»
«Intenta incluir un resumen si es posible.» (cuando el resumen es obligatorio)
«Incluye un resumen.»
Ahora se lo toma al pie de la letra: si dices «si es posible», entiende que puede no hacerlo.
-
Límites con número
«Responde en menos de 120 palabras.» «Resume tu progreso cada 3 pasos.»
«Respuestas al grano que contesten solo a lo que se pregunta.»
Los modelos actuales ya informan cuando toca, y un tope de palabras les quita espacio en los problemas difíciles.
-
Listas de prohibiciones de estilo
«No empieces con "¡Claro!".» «Nunca uses viñetas.» «No uses negritas.»
Di en una línea cómo quieres que escriba.
Se escribieron contra manías de modelos antiguos. Prohibir un fallo que ya no comete puede empujarle hacia él.
-
Ejemplos viejos y reglas que chocan
Un único ejemplo «perfecto» escrito para otro modelo. Dos archivos que dicen cosas distintas sobre lo mismo.
Varios ejemplos distintos (o ninguno) y cada regla en un solo sitio.
Claude copia la forma de los ejemplos, y si dos reglas se contradicen no sabe cuál vale.
El dato oficial
−9 % de coste
En una prueba de Anthropic con un asistente de atención al cliente, pasar de Opus 4.8 a Opus 5.5 ya bajó el coste un 18 %. Después pasaron /claude-api prompt-audit y el coste bajó un 9 % más, con unos 2 puntos más de acierto. Mismo modelo; solo cambiaron los prompts.
Lo que encontró: rituales de verificación que repetían búsquedas de pedidos y frases de «sé exhaustivo» que lanzaban consultas innecesarias. En tu caso el ahorro puede ser distinto.