Tu primer prompt con Claude Code en un proyecto Laravel

Hola, bienvenido. En las 2 lecciones anteriores vimos los modos de permiso y auto mode, y en esta lección vamos a abrir por fin Claude Code en claude-tasks para darle su primera tarea. No vamos a pedirle que cambie nada: vamos a pedirle contexto, que nos cuente qué archivos importan en el proyecto, y después le vamos a pedir que ejecute el circuito de calidad. Por el camino vamos a ver qué se ejecuta sin preguntarte, qué te pide permiso en el modo manual y cómo responder a cada aviso, incluido cómo añadirle un comentario a tu respuesta con Tab.

¿Por qué empezar pidiendo contexto y no una tarea real? Porque es la forma más barata de comprobar 2 cosas antes de que Claude toque tu código: que entiende el proyecto que tiene delante y que tú entiendes cómo se mueve dentro de él. Si en esta primera vuelta cita archivos que existen y explica bien para qué sirven, puedes confiar un poco más en lo que haga después. Si empieza a hablar de un dominio, de usuarios o de una arquitectura que no existe, lo has detectado sin que haya cambiado ni una línea, y lo paras antes de que se convierta en un problema.

Para seguir esta lección necesitas el proyecto que creamos en la lección Crear el proyecto Laravel con Sail para trabajar con Claude Code, con los contenedores de Sail levantados, y Claude Code instalado y con la sesión iniciada. Desde la raíz del proyecto, arrancamos Claude Code:

Como es la primera vez que lo abres en esta carpeta, Claude Code te pregunta si confías en ella, igual que vimos al iniciar sesión por primera vez. Aquí la respuesta es fácil, porque es tu proyecto y sabes lo que contiene: lo acabamos de crear nosotros y hemos quitado los CLAUDE.md y AGENTS.md del esqueleto.

Con la sesión abierta, mira la barra de estado, bajo el cuadro de texto: verás ⏵⏵ auto mode on, que es el modo con el que arranca hoy la sesión. Para esta primera tarea vamos a pasar al modo manual, así que pulsa Shift+Tab una vez. Desde auto mode, la primera pulsación te lleva al modo manual, y la barra tiene que mostrar ⏸ manual mode on.

¿Por qué en modo manual, si luego vamos a trabajar con auto mode? Porque en modo manual vas a ver cada acción que no sea una lectura antes de que ocurra, y en la primera sesión en un proyecto eso es justo lo que quieres: aprender qué comandos lanza Claude aquí, con qué herramientas y en qué orden. Cuando ya lo tengas claro, y cuando el proyecto tenga sus reglas y sus hooks, volverás a auto mode con la tranquilidad de saber qué está pasando por detrás.