Cómo escribir un prompt eficaz para Claude: la guía práctica

Muchos consejos sobre Claude giran en torno a un truco: mete todo en etiquetas XML, porque lo entrenaron para eso. Es inexacto. La documentación de Anthropic precisa que no existen etiquetas canónicas con las que Claude haya sido entrenado de forma específica, y una de sus guías recientes explica que, en la mayoría de los casos, bastan títulos claros y frases explícitas.

Las etiquetas tienen su utilidad, ahora llegamos a ello. Pero si tu prompt da malos resultados, la causa rara vez está en su formato. Está en lo que olvidaste decir.

La prueba del compañero que llega esta mañana

Anthropic propone una imagen útil: trata a Claude como a un empleado brillante pero nuevo, que no conoce tus costumbres ni tu oficio. Y una prueba sencilla: enséñale tu prompt a un compañero que no sepa nada del tema. Si él no sabe qué hacer, Claude tampoco.

Imagina a la responsable de una asociación que escribe: «Resume este dossier de subvención». Un compañero preguntaría enseguida para quién, con qué fin y de qué extensión. Claude va a adivinar, y devolverá un resumen neutro que no le servirá a nadie en particular.

La versión corregida cabe en unas pocas líneas:

Vas a leer el dossier de subvención adjunto. Se presentará el martes ante nuestra junta directiva, formada por voluntarios que no han leído el dossier y que tienen cinco minutos para decidir si lo presentamos.

Redacta una nota de media página que les permita decidir:
- qué financiaría la subvención y por qué importe
- qué se compromete a hacer la asociación a cambio
- las condiciones que nos costaría cumplir
- los documentos que nos faltan, si falta alguno

Escribe con frases cortas, sin vocabulario administrativo. Si una información no aparece en el dossier, dilo en lugar de suponerla.

La junta directiva, el tiempo de lectura y la decisión que hay que tomar le dan a Claude todo lo que faltaba. Ahora puede ordenar el dossier según lo que importa a esos lectores.

Claude también tiende a ceñirse a lo que se le pide. Anthropic lo dice con claridad: si quieres que vaya más allá de lo estrictamente necesario, pídelo de forma explícita. Si quieres tres líneas alternativas o una crítica de tu plan, escríbelo. No cuentes con que lo haga por sí solo.

Explica por qué pides algo

Es uno de los reflejos más rentables con Claude. Una instrucción sola se aplica al pie de la letra. Una instrucción acompañada de su razón se aplica con criterio, incluso en los casos que no habías previsto.

Sin razón: «Nada de puntos suspensivos».

Con razón, siguiendo el modelo del ejemplo de Anthropic: «Este texto lo leerá en voz alta un sintetizador de voz, que no sabe pronunciar los puntos suspensivos».

En el segundo caso, Claude entiende la necesidad real y además puede evitar las abreviaturas, los símbolos o los paréntesis mal leídos, que tú no habías mencionado.

Un ejemplo de otro oficio. Una maestra de 5.º de primaria pide un texto de lectura. La instrucción «frases cortas» da frases entrecortadas. Si escribe «dos alumnos de mi clase son disléxicos y se desaniman con las frases de varias oraciones», Claude tiene con qué ajustar la sintaxis sin romper el ritmo de la historia.

Formula también tus instrucciones en positivo cuando sea posible. Anthropic recomienda describir lo que quieres en lugar de lo que rechazas: «Escribe en párrafos continuos» da una meta, mientras que «sin listas» solo suprime una opción. Cuando necesites una prohibición, consérvala, pero haz que le siga lo que hay que hacer en su lugar.

Cuándo son útiles las etiquetas XML y cuándo prescindir de ellas

Una etiqueta XML es una marca alrededor de un fragmento de texto: <notas> al principio, </notas> al final. Eliges los nombres que quieras, en español si lo prefieres. Las etiquetas sirven para una sola cosa: separar sin ambigüedad tus instrucciones del contenido que hay que procesar.

Para una pregunta sencilla, no las pongas. Para un texto corto que hay que reformular, basta un título o un salto de línea. Resultan útiles cuando tu prompt mezcla varios tipos de contenido, en particular cuando los documentos que hay que procesar contienen a su vez texto que parece una instrucción. Es el caso de un correo de cliente que dice «le ruego que responda antes del viernes»: no quieres que Claude tome esa frase por una instrucción dirigida a él.

Aquí tienes un caso en el que se justifican, para un miembro de la junta de una comunidad de propietarios que tiene que comparar presupuestos:

<contexto>
Soy miembro de la junta de una comunidad de propietarios de 24 viviendas. Tenemos que rehacer la impermeabilización de la cubierta plana. La votación será en la próxima junta general y los propietarios querrán entender la diferencia de precio.
</contexto>

<presupuestos>
<presupuesto_1 empresa="[NOMBRE 1]">
[PEGAR EL PRESUPUESTO]
</presupuesto_1>
<presupuesto_2 empresa="[NOMBRE 2]">
[PEGAR EL PRESUPUESTO]
</presupuesto_2>
<presupuesto_3 empresa="[NOMBRE 3]">
[PEGAR EL PRESUPUESTO]
</presupuesto_3>
</presupuestos>

<instrucciones>
1. Haz una tabla que compare lo que incluye realmente cada presupuesto: prestaciones, materiales, garantías, plazos, condiciones de pago.
2. Señala lo que figura en un presupuesto y falta en los demás, sin concluir que sea un olvido.
3. Enumera las preguntas que hay que hacer a cada empresa antes de la votación.
No recomiendes ninguna empresa. Si un elemento no está especificado en un presupuesto, escribe «no especificado».
</instrucciones>

Los datos van antes que las instrucciones, y el motivo está en la sección siguiente.

Con documentos largos, pon la petición al final

Para los contenidos largos, la documentación de Anthropic recomienda colocar los documentos arriba del prompt y la pregunta abajo, y etiquetar cada documento cuando hay varios, con su fuente. Una guía más general añade que conviene mantener la información más importante al principio o al final, y dividir las tareas grandes: el modelo trabaja mejor con un perímetro bien definido.

Tampoco lo pidas todo de golpe. Para un informe de 60 páginas, empieza por hacer extraer los pasajes que tocan tu pregunta, con su página o su sección, y después haz que Claude razone sobre esos extractos. Podrás controlar el primer paso, algo imposible si todo llega fundido en una síntesis. El artículo sobre los documentos largos detalla este trabajo en dos tiempos.

Claude también puede equivocarse con un documento que le has dado: atribuir mal una cifra, leer demasiado deprisa una tabla procedente de un PDF. Para todo lo que implique dinero o una decisión, pide la cita exacta del pasaje que justifica cada afirmación y compruébala en el original. Este reflejo vale para todos los asistentes, incluido este, y se explica en la guía para verificar una respuesta de la IA.

Muestra un ejemplo antes de añadir reglas

Anthropic clasifica los ejemplos entre los medios más fiables para orientar el formato, el tono y la estructura. Una de sus guías aconseja empezar con un solo ejemplo y añadir más si los resultados siguen siendo irregulares; su documentación técnica menciona más bien de tres a cinco ejemplos para los usos exigentes. Quédate con esto: empieza poco a poco y aumenta si hace falta.

Elige bien tus ejemplos, porque Claude les presta mucha atención y puede reproducir hasta sus defectos. Si tu ejemplo contiene una fórmula vacía, la encontrarás por todas partes. Varíalos también: con tres ejemplos que empiezan de la misma manera, obtendrás ese mismo comienzo en todos los textos.

Para un desarrollador que quiere comentarios de revisión de código regulares, el prompt combina por tanto formato, ejemplo y razón:

Haz la revisión del diff de abajo. Estoy solo en este proyecto y voy a corregir tus observaciones yo mismo esta noche: por eso quiero únicamente lo que puede romperse en producción, no cuestiones de gusto.

<diff>
[PEGAR EL DIFF]
</diff>

Para cada problema, usa este formato:

<ejemplo>
**Archivo:** carrito.py, línea 42
**Riesgo:** si el carrito está vacío, `precio_total` no está definido y la página falla.
**Escenario:** un cliente quita su último artículo y luego recarga la página.
**Corrección propuesta:** inicializar `precio_total = 0` antes del bucle.
</ejemplo>

Ordena los problemas del más grave al menos grave. Si no encuentras ninguno serio, dilo y para ahí: no inventes observaciones para rellenar. Señala lo que no has podido evaluar sin ver el resto del código.

La frase «dilo y para ahí» importa. Sin esa salida, cualquier asistente al que se le piden problemas tiende a encontrarlos.

Sobre los roles, el consejo de Anthropic es comedido: una frase puede bastar para orientar el tono, pero un rol muy pesado rara vez aporta algo y puede limitar la utilidad de la respuesta. A menudo es más eficaz precisar directamente el punto de vista esperado. «Analiza este presupuesto desde el punto de vista de una gerente prudente que rechaza cualquier descubierto» vale más que tres líneas sobre sus años de experiencia.

Guarda tus instrucciones en el lugar adecuado dentro de Claude

Los menús y los nombres evolucionan y dependen de tu plan, así que comprueba en la herramienta en el momento en que leas esto. Esta es la lógica general.

Para los skills, cuida la descripción más que todo lo demás: según la documentación de Anthropic, Claude solo lee el nombre y la descripción antes de decidir si carga el skill. «Ayuda con presupuestos» se activará mal. «Úsalo cuando te pida preparar o revisar un presupuesto de fontanería» se activará mucho mejor.

El mismo principio de alcance se aplica a tus instrucciones. El perfil recibe lo que es cierto siempre, un proyecto recibe lo que concierne a un expediente, un skill recibe lo que describe un procedimiento. Si lo metes todo en el perfil, tus conversaciones de cada día llevarán un peso innecesario. El artículo sobre las instrucciones del sistema te ayuda a hacer la selección.

La memoria se va llenando con el uso, y puedes consultarla y modificarla. Una conversación de incógnito no se usa para mejorar Claude, aunque ese ajuste esté activado en tus parámetros de privacidad: mira esas opciones antes de pegar nada sensible, y consulta las condiciones de tu plan.

Claude tampoco produce fotos ni ilustraciones como lo hacen los generadores de imágenes. Sabe crear esquemas, gráficos y elementos visuales interactivos, y sabe analizar las imágenes que le envías. Si lo que necesitas es una imagen, la comparativa ChatGPT, Claude o Gemini te orientará.

Hazle revisar tu prompt, no solo tu texto

Antes de lanzar un prompt importante, pídele a Claude que se ponga en el lugar de quien lo ejecuta. A menudo te ahorra varios intentos:

Aquí tienes un prompt que voy a usar con regularidad:

<prompt_a_revisar>
[PEGAR TU PROMPT]
</prompt_a_revisar>

No lo ejecutes. Dime:
1. Lo que habrías entendido mal o habrías tenido que suponer
2. La información que falta para hacer bien el trabajo
3. El caso real en el que este prompt daría el peor resultado
Después propón una versión corregida, señalando cada cambio y su razón.

Anthropic también ofrece herramientas de este tipo en su consola para desarrolladores, pero este prompt funciona en la aplicación normal. Aun así, lee sus sugerencias con ojo crítico: un prompt más largo no es necesariamente mejor, y tú conoces tu oficio mejor que él.

Prueba ahora mismo con el prompt que más usas. Añade una frase que explique para qué sirve el resultado y quién lo va a leer, y compara con tu versión habitual.