🎯 Escribir buenos encargos (prompts)
En este libro no programas: le encargas a Claude Code lo que quieres. La calidad de lo que recibes depende, sobre todo, de cómo escribes ese encargo. Este capítulo te enseña a pedir bien para obtener resultados que funcionan a la primera.
🎯 Objetivos de aprendizaje
- Qué es un prompt y por qué es la herramienta más importante del libro.
- La receta de cuatro partes de un buen encargo.
- Cómo corregir el rumbo cuando el resultado no es el que esperabas.
Qué es un prompt
🧠 En cristiano: prompt (encargo). Un prompt es simplemente el mensaje que le escribes a la IA. No es magia ni un lenguaje secreto: es una instrucción en tu idioma. La diferencia entre un mal resultado y uno excelente suele estar en unas pocas frases mejor escritas.
💡 Idea clave. Piensa en Claude Code como en un ayudante muy capaz pero recién llegado: hace exactamente lo que le pides, pero no adivina lo que tienes en la cabeza. Cuanto más claro y concreto seas, mejor trabaja.
La receta de un buen encargo
Un encargo sólido tiene cuatro partes. Las has visto ya en cada capítulo:
- Qué quieres construir (el objetivo). “Crea una app web de chat con mis PDF.”
- Con qué herramientas (el contexto). “Usa Ollama con qwen3:4b y nomic-embed-text.”
- Cómo debe comportarse (los detalles que importan). “Debe citar el archivo y la página; interfaz mínima.”
- Qué esperas de vuelta (el formato). “Hazlo paso a paso y escríbeme un README.”
Compara dos encargos
Flojo: “hazme un chatbot”.
Bueno: “Crea una app web local de chat que responda sobre los PDF de la carpeta docs/, usando Ollama con qwen3:4b, citando la página de cada respuesta, con una interfaz sencilla y un README que explique cómo arrancarla”.
El segundo produce algo utilizable; el primero, adivinanzas.
Bueno: “Crea una app web local de chat que responda sobre los PDF de la carpeta docs/, usando Ollama con qwen3:4b, citando la página de cada respuesta, con una interfaz sencilla y un README que explique cómo arrancarla”.
El segundo produce algo utilizable; el primero, adivinanzas.
Trucos que marcan la diferencia
- Pide que lo haga paso a paso y que te explique lo que crea. Aprendes y controlas.
- Da ejemplos de lo que quieres (“que la factura tenga este aspecto...”).
- Fija límites: “no uses servicios de pago”, “que funcione sin conexión”.
- Pide una cosa cada vez. Es mejor construir por partes que soltar un encargo gigante.
- Pídele que pregunte si algo no está claro: “si te falta información, pregúntame antes de empezar”.
Cuando el resultado no es el que querías
No pasa nada: se corrige hablando. En vez de empezar de cero, ajusta:
⌨️ Terminal
No es lo que buscaba: el botón debería estar arriba y en azul. Cámbialo y deja el resto igual.
⌨️ Terminal
Me sale este error al arrancar: [pega aquí el error tal cual]. ¿Qué es y cómo lo arreglo?
💡 Idea clave. Corregir es parte normal del proceso, no un fallo tuyo. Los mejores resultados salen de una conversación de ida y vuelta, no de un único encargo perfecto.
✅ Comprueba que funciona. Un buen encargo se nota: si Claude Code empieza a construir lo que tenías en mente sin que tengas que repetírselo tres veces, lo escribiste bien.
💾 Guardar y reabrir el proyecto.
Guarda tus mejores encargos en un archivo de notas (por ejemplo
mis-prompts.txt). Reutilizarlos y adaptarlos te ahorra tiempo en cada proyecto nuevo. Los prompts buenos son, en la práctica, tus plantillas de trabajo.Reto para practicar
Coge cualquier proyecto de este libro y, antes de mirar el encargo que proponemos, escribe tú el tuyo con la receta de cuatro partes. Luego compáralos: verás qué detalles añadir la próxima vez.