,

Tu primera sesión con Claude Code y cómo escribir prompts

Tu primera sesión con Claude Code: preguntar, pedir un cambio, aprobarlo y hacer commit. Además, cómo escribir prompts que sí funcionan. Lección 2 del curso 🧭

Tu primera sesión con Claude Code y cómo escribir prompts

Curso de Claude Code · Lección 2 de 22 · Módulo 1: Empezar

La primera sesión con Claude Code es sencilla, pero lo que obtienes depende mucho de cómo pides las cosas. En esta lección haces un recorrido completo: preguntar por un proyecto, pedir un cambio pequeño, aprobarlo, guardarlo con git y aprender a escribir prompts específicos. Necesitas Claude Code instalado (lo vimos en la lección 1).

Antes de empezar

  • Claude Code instalado y con la sesión iniciada.
  • Un proyecto pequeño, de preferencia con git. Así puedes revisar cada cambio y deshacerlo si algo no te gusta. Si no tienes uno, crea una carpeta de práctica con un par de archivos.

Paso 1: abre Claude Code en tu proyecto

cd /ruta/a/tu/proyecto
claude

Arriba aparecen la versión, el modelo actual y la carpeta de trabajo. Escribe /help para ver los comandos disponibles o /resume para continuar una conversación anterior.

Paso 2: pregunta antes de pedir cambios

Claude lee los archivos que necesita mientras trabaja, así que no hace falta adjuntarle contexto. Empieza con preguntas como estas:

¿Qué hace este proyecto?
¿Qué tecnologías usa?
¿Dónde está el punto de entrada?
Explícame la estructura de carpetas

Es la forma más rápida de comprobar que Claude entendió tu código antes de dejarlo escribir en él.

Paso 3: haz tu primer cambio

Agrega una función hola mundo al archivo principal

Claude busca el archivo adecuado y te muestra el cambio. Si te pide aprobación, elige Yes después de leerlo.

El modo de permisos de la sesión define qué acciones puede hacer Claude sin preguntarte. Con Shift+Tab cambias de modo. Según tu plan y tu configuración, la sesión puede empezar pidiendo aprobación en cada edición (modo manual) o en modo auto, donde un clasificador revisa las acciones arriesgadas antes de ejecutarlas. Lee siempre lo que apruebas; los permisos tienen su propio módulo más adelante en el curso.

Paso 4: usa git en lenguaje natural

¿Qué archivos he cambiado?
Haz un commit con un mensaje descriptivo
Muéstrame los últimos 5 commits

Pide commits pequeños y frecuentes. Cada uno es un punto al que puedes volver si un cambio posterior sale mal.

Cómo pedir bien

La regla práctica es contarle a Claude lo que no puede ver por sí solo. Claude ya lee tu código; lo que no sabe es qué síntoma observas, qué decisión tomaste o cómo sabrás que el trabajo está terminado. Compara estos pares:

En vez de…Prueba con…
arregla el error del formularioel formulario de contacto da error 500 al enviarlo sin teléfono. Mira validar_contacto() en app/forms.py, escribe una prueba que lo reproduzca y luego corrígelo
mejora el diseñohaz que la tarjeta de producto en templates/producto.html se vea bien en móvil (390 px de ancho). Reutiliza las clases de estilos.css y no instales librerías

Un buen prompt nombra el archivo o la función, describe el síntoma y dice cómo se ve el resultado correcto. Si hay dos formas razonables de hacer algo y te importa una, dilo desde el principio.

Dale lo que ya tienes en vez de describirlo

  • Un archivo: escribe @ y la ruta para incluir su contenido en el mensaje.
  • Una imagen: pega la captura del diseño o del error en el prompt.
  • Una salida de comando: envíala desde tu terminal, por ejemplo cat error.log | claude -p "¿qué está pasando aquí?".

Dale una forma de comprobar su trabajo

Claude se detiene cuando el trabajo parece terminado. Si tiene algo que ejecutar y que responda pasa o falla, puede corregirse solo. Añade al final del prompt algo como ejecuta las pruebas al terminar y sigue hasta que pasen y pídele evidencia: el comando que ejecutó y su salida.

Cuando aún no sabes qué quieres

No tienes que resolverlo todo antes de escribir. Pídele que te entreviste:

Quiero agregar un límite de peticiones a la API pública, pero no lo he pensado bien. Entrevístame hasta que puedas escribir la especificación y guárdala en SPEC.md

Controla la sesión

  • Esc detiene a Claude en mitad de una acción y conserva lo hecho hasta ese punto, para que lo redirijas sin perder trabajo.
  • /rewind (o Esc dos veces con el prompt vacío) abre el menú para volver atrás el código, la conversación o ambos.
  • /clear empieza una conversación nueva.
  • /exit cierra la sesión.

Si has corregido lo mismo dos veces y sigue mal, una tercera corrección suele empeorar las cosas: es mejor usar /clear y escribir un prompt nuevo que incluya lo que aprendiste. Ten en cuenta que /rewind restaura los archivos que Claude editó con sus propias herramientas, pero no los cambios hechos solo por comandos de shell; funciona junto con git, no lo reemplaza.

Ejercicio de 20 a 30 minutos

  1. Abre un repositorio git pequeño con Claude Code.
  2. Haz tres preguntas sobre el proyecto y comprueba si las respuestas coinciden con lo que ves en los archivos.
  3. Pide un cambio acotado con este formato: archivo o función, síntoma o necesidad y resultado esperado.
  4. Lee el cambio que propone y apruébalo solo si lo entiendes.
  5. Pídele que ejecute las pruebas o que abra el archivo para confirmar el resultado.
  6. Pídele un commit con un mensaje descriptivo.

Resultado verificable: git log muestra tu commit y git diff HEAD~1 contiene solo el cambio que pediste.

Errores comunes

  • Prompts vagos: «arregla el bug» obliga a Claude a adivinar. Nombra el síntoma y el lugar.
  • Aprobar sin leer: el cambio es tuyo aunque lo escriba Claude. Revisa antes de aprobar.
  • Sesiones que mezclan temas: usa /clear entre tareas que no se relacionan.
  • Trabajar sin git: sin commits, deshacer depende solo de /rewind.

Qué sigue

Antes de pedirle cambios más grandes, conviene darle a Claude la memoria de tu proyecto. Eso lo vimos en CLAUDE.md: cómo escribirlo bien (lección 3). Después aprenderás a planificar con el modo plan antes de programar (lección 4).

Preguntas frecuentes

¿Claude puede romper mi proyecto?

Puede editar archivos y ejecutar comandos, por eso conviene trabajar con git, revisar lo que apruebas y conocer los permisos. Con commits pequeños, cualquier cambio se puede deshacer.

¿Cuánto contexto debo darle?

Solo lo que no pueda deducir leyendo el código: decisiones que no están en el repositorio, el síntoma exacto de un error o cómo comprobarás el resultado.

¿Puedo escribirle en español?

Sí. Escribe como le hablarías a un colega y describe qué quieres conseguir. Los comandos de la sesión, como /help o /clear, se escriben igual.

Fuentes

Última revisión: 12 de noviembre de 2026, con la documentación oficial de Claude Code. Los comandos proceden de esa documentación; esta lección se preparó con ayuda de IA (consulta cómo usamos la IA).