Oficiales de Anthropic Guía paso a paso

Buenas prácticas de prompting para Claude según la guía oficial de Anthropic

Un resumen práctico en español de la guía oficial de Anthropic sobre cómo escribir prompts para los modelos actuales de Claude. Cubre los fundamentos, cómo trabajar con documentos largos, controlar el formato, conseguir que actúe en lugar de sugerir, gestionar el razonamiento y proteger las acciones irreversibles, con plantillas propias listas para usar.

Nivel
Principiante
Qué necesitas
Cualquier plan de Claude o acceso a la API; no necesitas conocimientos técnicos para los fundamentos.
Cuánto lleva
Unos 25 minutos de lectura; aplicarlo es inmediato

Herramientas que usa esta guía

01 Los fundamentos: claro, con motivo y con ejemplos

Anthropic propone imaginar a Claude como una persona muy capaz recién incorporada que no conoce tus normas ni tu contexto. La regla de oro: enseña tu prompt a un compañero que no sepa nada de la tarea; si él se perdería, Claude también.

01

Sé explícito

Si quieres algo ambicioso, pídelo. Los modelos actuales siguen las instrucciones con precisión y no adivinan que querías «ir más allá».

02

Explica el porqué

«No uses puntos suspensivos porque el texto lo leerá un sintetizador de voz» funciona mejor que «NUNCA uses puntos suspensivos». Claude generaliza a partir del motivo.

03

Da 3-5 ejemplos

Relevantes, variados y separados de las instrucciones con etiquetas como «example». Puedes pedirle que revise si tus ejemplos son suficientemente diversos.

04

Usa etiquetas XML

Separa instrucciones, contexto, ejemplos y datos con etiquetas descriptivas y coherentes. Reduce las malas interpretaciones.

05

Asigna un rol

Una sola frase en las instrucciones del sistema («Eres un asesor fiscal que explica a autónomos…») enfoca tono y criterio.

Prompt · Plantilla de prompt estructurado
<rol>Eres [ROL] y escribes para [PÚBLICO].</rol>

<contexto>[Situación, por qué lo necesito y para qué se usará el resultado]</contexto>

<instrucciones>
1. [Paso 1]
2. [Paso 2]
3. [Paso 3]
</instrucciones>

<ejemplos>
<example>[Ejemplo de resultado bueno]</example>
<example>[Otro ejemplo distinto]</example>
</ejemplos>

<formato>[Extensión, estructura y tono esperados]</formato>

02 Documentos largos: el material arriba, la pregunta abajo

Con entradas extensas (a partir de unos 20.000 tokens), coloca los documentos al principio y la pregunta e instrucciones al final. Según Anthropic, en sus pruebas esto puede mejorar la calidad de la respuesta hasta un 30 %, sobre todo con varios documentos. Envuelve cada documento en su etiqueta con el origen y, para tareas de análisis, pide que primero extraiga las citas relevantes y después responda basándose en ellas.

Prompt · Analizar varios documentos citando primero
<documentos>
<documento indice="1"><origen>[NOMBRE DEL ARCHIVO]</origen><contenido>[TEXTO]</contenido></documento>
<documento indice="2"><origen>[NOMBRE DEL ARCHIVO]</origen><contenido>[TEXTO]</contenido></documento>
</documentos>

Primero, copia dentro de <citas> los fragmentos literales de los documentos que sean relevantes para la pregunta, indicando de qué documento sale cada uno. Después, dentro de <respuesta>, responde basándote solo en esas citas. Si la información no está en los documentos, dilo.

Pregunta: [TU PREGUNTA]

03 Controlar el formato de la respuesta

  • ✓Di lo que quieres en lugar de lo que no quieres: «responde en párrafos de prosa» funciona mejor que «no uses markdown».
  • ✓Pide que escriba ciertas partes dentro de una etiqueta concreta para fijar el formato.
  • ✓Escribe tu prompt con el estilo que quieres recibir: un prompt lleno de viñetas invita a responder con viñetas.
  • ✓Si no quieres notación matemática tipo LaTeX, pídele texto plano para fórmulas.
  • ✓Los modelos más recientes ya formatean menos; un bloque largo contra las listas puede eliminar estructura que sí era necesaria.

04 Que actúe en lugar de sugerir

Si preguntas «¿puedes sugerir cambios en esta función?», Claude puede limitarse a sugerir. Si quieres que lo haga, dilo con un verbo de acción: «Cambia esta función para que…». También puedes fijar el comportamiento por defecto en las instrucciones del sistema, en un sentido u otro.

Quieres Indícalo así
Que actúe sin preguntar Cuando la intención sea razonablemente clara, aplica los cambios en lugar de proponerlos; si falta información, infiere la opción más útil
Que solo proponga No modifiques archivos hasta que te lo pida expresamente; por defecto, investiga y recomienda
Que vaya más rápido Si varias consultas o lecturas no dependen entre sí, hazlas en paralelo

05 Razonamiento: ni de menos ni de más

Los modelos actuales piensan y exploran por su cuenta, a veces más de lo necesario. Si tus prompts antiguos insistían en «sé exhaustivo» o «ante la duda, usa la herramienta», elimina esas frases: ahora provocan exceso. Si sigue explorando demasiado, baja el nivel de esfuerzo (effort) en lugar de añadir más texto.

Prompt · Bloque para evitar dar vueltas
Cuando decidas cómo abordar un problema, elige un enfoque y llévalo hasta el final. No reabras decisiones salvo que aparezca información nueva que las contradiga. Si dudas entre dos opciones, escoge una, aplícala y corrige después si falla.

06 Agentes: estado, seguridad y honestidad

  • ✓En tareas largas, guarda el progreso en archivos (notas de estado, lista de pruebas, git) para poder continuar en una ventana de contexto nueva.
  • ✓Pide soluciones generales, no apaños para que pasen las pruebas, y que avise si una prueba parece incorrecta.
  • ✓Exige que lea un archivo antes de opinar sobre él para reducir invenciones.
  • ✓Limita la creación de archivos temporales si no los necesitas.
Prompt · Bloque de reversibilidad para agentes
Antes de cada acción, valora si se puede deshacer y a quién afecta. Puedes hacer sin preguntar acciones locales y reversibles, como editar archivos o ejecutar pruebas. Pide confirmación antes de: borrar archivos, ramas o tablas; reescribir historial publicado; enviar mensajes, publicar o modificar sistemas compartidos. Si encuentras un obstáculo, no lo esquives desactivando comprobaciones de seguridad ni descartando archivos que no reconoces: explícame el problema.

Preguntas frecuentes

Claude trabaja muy bien en español. Escribe en el idioma en el que quieres la respuesta y sé explícito con la variante: «español de España, tuteando al lector».

Sí. No hay etiquetas mágicas: lo importante es usar nombres descriptivos y coherentes para separar instrucciones, contexto, ejemplos y datos.

Con los modelos actuales el razonamiento ya viene integrado. Es más útil indicar cuándo merece la pena pensar más y regular el esfuerzo que pedir un razonamiento genérico.

En las instrucciones de un proyecto de Claude, en tus preferencias de perfil, en el CLAUDE.md de Claude Code o en el prompt de sistema si usas la API.

Sobre el autor

Equipo editorial de appyweb

Marketing, SEO y desarrollo con IA

Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.

Sigue con estas guías

Guía paso a paso · Intermedio

Prompting 101: el método de Anthropic para escribir prompts que funcionan

El equipo de Anthropic enseña el prompting como una disciplina experimental: escribes, pruebas, lees la respuesta y corriges una cosa cada vez. Esta guía recoge los elementos de un buen prompt en el orden recomendado, un ejemplo que mejora versión a versión, el uso de etiquetas XML y los cambios que exigen los modelos actuales.

20 minutos de lectura y una hora para iterar tu primer prompt Leer la guía →
Guía paso a paso · Principiante

Prompt Improver: el plugin que detecta prompts vagos en Claude Code y pregunta antes de actuar

Prompt Improver es un plugin de código abierto para Claude Code que revisa cada petición antes de ejecutarla. Si está clara, la deja pasar; si es ambigua, investiga tu proyecto y te hace entre una y seis preguntas concretas. Útil para quien trabaja rápido, escribe instrucciones cortas y está cansado de corregir el primer intento.

Unos 5 minutos para instalarlo y probarlo con un par de peticiones. Leer la guía →
Guía paso a paso · Principiante

Cómo hablarle a Claude: la estructura de un buen prompt con ejemplos para tu negocio

Claude responde tan bien como entiende lo que le pides. Esta guía te da una estructura sencilla para cualquier petición importante (contexto, objetivo, formato, límites y ejemplos), te enseña a convertir prompts vagos en encargos claros y te deja plantillas en español para marketing, análisis de datos, ventas, atención al cliente y desarrollo.

15 minutos para leerla; el hábito se coge en una semana. Leer la guía →
Guía paso a paso · Principiante

Prompt Master: la skill que escribe prompts para cualquier IA

Prompt Master es una skill gratuita para Claude que transforma una petición vaga en un prompt preciso y adaptado a la herramienta de destino: un modelo de chat, un agente de código, un generador de imágenes o una automatización. Verás cómo instalarla en claude.ai o en Claude Code, cómo pedírselo bien y cuándo no compensa usarla.

Unos 10 minutos Leer la guía →
Guía paso a paso · Principiante

Niveles de esfuerzo en Claude: cuándo usar low, medium, high, xhigh y max

El esfuerzo regula cuánto razona Claude y cuántas comprobaciones hace antes de responder. Bien ajustado, ahorra uso y tiempo sin perder calidad; mal ajustado, gasta de más o se queda corto. Verás qué hace cada nivel, el valor por defecto de cada modelo, cómo cambiarlo y por qué el máximo casi nunca compensa.

10 minutos de lectura y 30 minutos si haces tu propia prueba Leer la guía →

¿Quieres llevar la IA a tu empresa sin pelearte con todo esto?

Diseñamos e implantamos agentes, automatizaciones y asistentes con IA a medida de tu negocio.

Ver nuestros servicios de IA

Cuéntanos tu proyecto. Te respondemos en 48 h.

Auditoría gratuita de IA, campañas, web y SEO, con prioridades y cifras reales de tu negocio.

✓ Sin compromiso ✓ Respuesta en 48 h laborables ✓ Un consultor senior, no un bot
WA WhatsApp