Inicio/Cómo escribir buenos prompts

Cómo escribir buenos prompts

La calidad de lo que te da Claude Code depende mucho de cómo se lo pidas. No hace falta saber "hablar técnico": solo ser claro. Aquí tienes los 7 principios y ejemplos reales antes/después.

1. Sé específico, no genérico

"Arregla esto" obliga a Claude a adivinar. Cuanto más contexto des, menos adivina y mejor acierta.

Poco claro

Arregla mi código

Mucho mejor

El botón de 'Enviar' en login.html no hace nada al pulsarlo. Debería mostrar un mensaje de error si el campo email está vacío. Investiga por qué no funciona y arréglalo.

2. Di tu nivel y pide explicaciones

Claude se adapta a ti. Si le dices que estás empezando, te explicará las cosas en lugar de soltar código sin más.

Poco claro

Haz una API REST con autenticación JWT

Mucho mejor

Estoy empezando a programar. Ayúdame a crear una API sencilla con login. Explícame cada paso con palabras normales antes de escribir el código, y dime qué es 'JWT' cuando lo uses.

3. Pide ver antes de actuar

Para tareas que cambian archivos o pueden tener consecuencias, pide el plan primero. Así aprendes y evitas sustos.

Plantilla segura
Antes de hacer ningún cambio, explícame tu plan paso a paso y espera mi aprobación. Solo entonces empieza.

4. Da contexto: pega errores, datos y ejemplos

No describas el error con tus palabras: pégalo entero. No expliques cómo son tus datos: enséñale el archivo.

Poco claro

Me da un error al ejecutar el programa

Mucho mejor

Al ejecutar "python app.py" me sale este error: Traceback (most recent call last): File "app.py", line 12, in <module> print(precio * cantidad) TypeError: can't multiply sequence by non-int ¿Qué significa y cómo lo arreglo?

5. Divide las tareas grandes

En lugar de pedir todo de golpe, ve por partes. Claude trabaja mejor y tú entiendes lo que va pasando.

Poco claro

Hazme una tienda online completa con carrito, pagos, usuarios y panel de administración

Mucho mejor

Vamos a hacer una tienda online paso a paso. Empecemos solo por la página que muestra la lista de productos. Cuando funcione, seguimos con el carrito.

6. Describe el resultado que quieres, no la solución técnica

No tienes que saber cómo se hace. Describe qué quieres conseguir y deja que Claude proponga el cómo.

Poco claro

Usa un useEffect con un debounce y memoización

Mucho mejor

Quiero que cuando el usuario escriba en el buscador, los resultados se filtren solos sin tener que pulsar un botón, pero que no vaya lento aunque escriba rápido.

7. Pide que te corrija y te enseñe

Claude Code no es solo para que haga el trabajo: úsalo para mejorar tú.

Modo aprendizaje
Cuando termines, dime: ¿qué he hecho yo mal o de forma poco eficiente? ¿Qué debería aprender para hacer esto mejor la próxima vez por mi cuenta?

Plantillas listas para usar

Copia, rellena los corchetes y pega:

Para crear algo nuevo

Escribe esto a Claude Code
Quiero crear [qué quieres]. Lo usaré para [para qué sirve]. Soy [tu nivel: principiante/intermedio]. Usa [tecnología, o "lo que recomiendes"]. Explícame los pasos importantes mientras lo haces.

Para arreglar algo

Escribe esto a Claude Code
Tengo este problema: [qué pasa]. Esperaba que pasara: [qué debería pasar]. Lo que veo: [qué ves, pega errores]. Investiga la causa, arréglalo y explícame qué estaba mal.

Para entender algo

Escribe esto a Claude Code
Explícame [el concepto o el archivo] como si tuviera poca experiencia. Usa una analogía sencilla y un ejemplo pequeño. Luego dime para qué se usa en la práctica.

Para mejorar lo que ya tienes

Escribe esto a Claude Code
Revisa [archivo o carpeta]. Dime qué se puede mejorar en cuanto a claridad, errores potenciales y buenas prácticas. Aplica las mejoras importantes y explícame por qué.
El mejor consejo de todos: habla con Claude Code como hablarías con un compañero de trabajo paciente. No necesitas comandos mágicos ni vocabulario técnico. La claridad gana siempre.

Errores comunes al empezar

  • Aceptar cambios sin leerlos. Claude muestra un diff antes de editar. Léelo: así aprendes y detectas si algo no es lo que querías.
  • No dar contexto del proyecto. Si tienes un CLAUDE.md (ver Configuración), Claude entiende mucho mejor tu proyecto desde el primer mensaje.
  • Rendirse al primer intento. Si la respuesta no es lo que querías, no empieces de cero: dile "casi, pero quería que además..."y refina.
  • Pedir demasiado de una vez. Tareas enormes en un solo prompt salen peor. Divide y vencerás.
← Recetas prácticasComandos →