Cómo escribir prompts para Claude Code sin saber programar

Claude Code es un asistente de Anthropic que trabaja directamente en tu computadora: lee y escribe archivos, ejecuta comandos y puede construir un proyecto entero. Eso lo hace muy potente y también cambia la forma de pedirle las cosas. No es un chat que te devuelve texto: es alguien que va a tocar tus archivos.

Esta guía es para personas que no programan (o programan poco) y quieren sacarle provecho sin perderse.

Lo que Claude Code necesita saber

El estado del proyecto

¿Es un proyecto nuevo o ya existe? ¿Qué hay en la carpeta? Si no lo sabes, pídele que lo averigüe: «Primero explora la carpeta y resume qué encuentras antes de cambiar nada».

Qué quieres lograr, en términos de resultado

No hace falta que sepas qué tecnología usar. Describe lo que tiene que pasar: «Cuando alguien toque el botón, que se abra WhatsApp con un mensaje ya escrito». Si tienes preferencias técnicas (que sea gratis de publicar, que no use frameworks), dilas como restricciones.

Tu nivel

«No sé programar» es un dato valiosísimo. Cambia cómo te explica las cosas y qué te pide que hagas a mano.

Pide un plan antes del código

Para cualquier cosa que no sea un cambio chico, la frase más útil es:

Primero propón un plan y espera mi aprobación antes de editar archivos.

Así puedes corregir el rumbo antes de que haya diez archivos creados. Claude Code además tiene un modo plan pensado para esto: investiga y propone sin modificar nada.

Di cómo verificar

Una tarea está terminada cuando se comprueba, no cuando la IA dice que terminó. Pide la verificación de forma concreta:

• «Ejecuta el proyecto y confirma que abre sin errores.»
• «Corre los tests y muéstrame el resultado.»
• «Dime qué tengo que hacer yo para verlo funcionando en el navegador.»

Marca lo que no hay que tocar

Si ya hay partes que funcionan, dilo: «No cambies el formulario de contacto, funciona bien». Y pide confirmación antes de acciones que no se pueden deshacer: borrar archivos, publicar el sitio, subir cambios a un repositorio.

Cuando algo falla

«No funciona, arréglalo» obliga a Claude Code a adivinar. Dale tres datos:

Qué esperaba: al tocar "Enviar", ver el mensaje de gracias.
Qué pasa: la página se recarga y no aparece nada.
Error (copiado de la consola): Uncaught TypeError: form is null

Reglas que repites siempre: CLAUDE.md

Si en cada sesión le aclaras lo mismo («explícame en español simple», «no instales nada sin preguntar»), guárdalo en un archivo CLAUDE.md en la carpeta del proyecto. Claude Code lo lee al empezar y no tienes que repetirlo.

Una plantilla para empezar

<contexto>
[Qué proyecto es, si es nuevo o existe, tu nivel técnico.]
</contexto>

<tarea>
[Qué tiene que existir o funcionar al final.]
</tarea>

<restricciones>
[Qué no tocar, preferencias técnicas, presupuesto.]
</restricciones>

<forma_de_trabajo>
1. Explora el proyecto y resume lo que encuentras.
2. Propón un plan y espera mi aprobación.
3. Haz cambios pequeños y verifica cada paso.
4. Pide confirmación antes de borrar, publicar o hacer push.
</forma_de_trabajo>

<criterios_de_exito>
[Cómo vas a comprobar que quedó bien.]
</criterios_de_exito>

Si eliges «Claude Code» como destino en el coach, el prompt sale con esta forma de trabajo incluida. Para ver un caso completo, mira el ejemplo de la peluquería en antes y después.