Prompt engineering en Claude Code: qué funciona de verdad
El prompt engineering en Claude Code es el arte de formular bien la instrucción: ser específico, dar el objetivo en lugar de los pasos, y dejar que el modelo proponga la estrategia. Pero hay una verdad incómoda que conviene decir de entrada: con los modelos actuales, el prompt es la pieza menos crítica. Lo que más determina el resultado no es cómo formulas la instrucción, sino qué información tiene el modelo enfrente antes de procesarla.
La reformulación honesta: mejorar tus prompts ayuda, pero rinde poco si el modelo no tiene el contexto correcto. El salto de calidad está en la ingeniería de contexto, no en frases más ingeniosas. Este artículo cubre las dos cosas, en orden de impacto real.
Las técnicas de prompt que sí importan
Dentro de lo que es el prompt en sí, esto es lo que mueve la aguja en Claude Code:
- Da el objetivo, no los pasos (Goal In, Strategy Out). Describe el resultado que quieres y deja que el modelo proponga cómo llegar. Microgestionar cada paso suele empeorar el plan.
- Sé específico y concreto. "Arregla el bug de formateo de fechas en
utils/dates.ts, el comportamiento esperado es X" funciona mejor que "mejora el manejo de fechas". - Usa el modo plan para tareas grandes. Pedir un plan antes de ejecutar es más efectivo que un prompt perfecto: revisas la dirección antes de que toque el código.
- Sube el razonamiento cuando hace falta. Escribe
ultrathinken el prompt para forzar razonamiento intensivo en decisiones difíciles. - Da ejemplos. Mostrar un caso de output bien hecho orienta más que describirlo con palabras.
Por qué el contexto pesa más que el prompt
Verás a alguien resolver con un solo prompt lo que a ti te cuesta. Usas el mismo modelo. La diferencia casi nunca es el prompt: es que su modelo tenía enfrente los archivos correctos, las convenciones del proyecto y las restricciones que el tuyo no veía.
La regla que lo resume: si el plan es bueno, el código va a ser bueno. Y un buen plan depende del contexto, no de la elegancia de la frase. Por eso la disciplina que de verdad escala no es el prompt engineering, sino la ingeniería de contexto: decidir qué información entra al modelo, en qué orden y con qué detalle.
Las reglas de oro (prompt + contexto)
Estas reglas guían tanto el prompt como el contexto, y verás repetirse en todo workflow serio:
| Regla | Qué significa |
|---|---|
| Goal In, Strategy Out | Da el objetivo; deja que el modelo proponga la estrategia. |
| Signal to Noise | Maximiza la información útil; minimiza el ruido. |
| Golden Window | El inicio de sesión es el momento de máxima precisión; aprovéchalo. |
| Progressive Disclosure | Revela el contexto justo cuando se necesita, no todo de golpe. |
| Boxing the Agent In | Restringe el espacio de acción del agente para ganar precisión. |
| Lidiar con la adulación | El modelo tiende a darte la razón; pide crítica explícita. |
Combinar modelos: prompting de otra escala
Una técnica avanzada que va más allá del prompt individual: usar dos agentes con modelos distintos en un ciclo implementador-crítico. Un modelo implementa, otro (con entrenamiento distinto) critica el diff y encuentra lo que el primero pasó por alto. La diferencia de perspectiva hace más que cualquier prompt afinado sobre un solo modelo.
Preguntas frecuentes
¿Qué es el prompt engineering en Claude Code?
Es formular bien la instrucción que le das al agente: ser específico, dar el objetivo en lugar de los pasos y dejar que proponga la estrategia. Importa, pero con los modelos actuales es la pieza menos crítica: lo que más decide el resultado es el contexto que tiene el modelo antes de procesar el prompt.
¿Qué es más importante, el prompt o el contexto?
El contexto. Con la generación actual de modelos, el cuello de botella raramente es cómo formulas la instrucción, sino qué información tiene el modelo disponible: los archivos correctos, las convenciones del proyecto, las restricciones no escritas. Esa disciplina es la ingeniería de contexto.
¿Cómo escribo mejores prompts para Claude Code?
Da el objetivo en lugar de microgestionar los pasos, sé concreto (nombra archivos y comportamiento esperado), usa el modo plan en tareas grandes, da ejemplos del output que buscas y escribe ultrathink cuando una decisión necesita más razonamiento.
¿Qué hace ultrathink en un prompt de Claude Code?
Fuerza un razonamiento más intensivo para esa respuesta concreta, sin cambiar de modelo. Es útil en decisiones difíciles donde la profundidad del pensamiento importa más que la velocidad.
Recursos relacionados
- Ingeniería de contexto en Claude Code: la disciplina que de verdad escala los resultados.
- Modo plan: planificar antes de ejecutar, más efectivo que un prompt perfecto.
- Cómo dominar Claude Code: la guía completa.
Tu siguiente paso
Las reglas de oro de prompt y context engineering están en la Cheat Sheet de Claude Code: una hoja imprimible, en español.
Descargar la Cheat Sheet gratis
Es el resumen de Ship with Claude Code, la guía de Takren (14 módulos, 190 capítulos, actualizaciones gratuitas).