Claude Code

Hola, bienvenido. Empezamos un nuevo curso en CursosDesarrolloWeb.es y en este curso vamos a aprender a trabajar con Claude Code en un proyecto Laravel real, desde la instalación hasta los subagentes, los hooks y los workflows. La idea es que el agente trabaje bien y que tú sigas teniendo el control en todo momento.

Estoy seguro de que has visto un montón de demos y de hilos en los que alguien le pide una feature a Claude Code, se va a por un café y vuelve con todo hecho. Queda muy bien, pero cuando lo llevas a un proyecto de verdad aparecen los problemas: cambios que parecen correctos y no lo están, un .env que el agente lee sin que nadie se lo pida y un test que se arregla cambiando la aserción. Y la configuración que evita todo eso, con permisos, memoria y hooks, está repartida en decenas de páginas de documentación en inglés que cambian cada semana. Eso es justo lo que quiero cubrir en este curso: usar Claude Code desde cero, pero como se tiene que hacer de verdad.

Claude Code es un agente que trabaja dentro de tu proyecto: lee el código, edita archivos, ejecuta comandos, mira el resultado y corrige. ¿Y qué necesita un agente así para hacer un buen trabajo? Pues lo mismo que necesita un compañero que se incorpora al equipo: contexto sobre el proyecto, límites claros sobre lo que puede tocar, una forma de comprobar que lo que ha hecho funciona y alguien que revise antes de dar el trabajo por bueno.

Por eso el curso sigue una rutina concreta, que vamos a repetir una y otra vez hasta que la hagas sin pensar: dar contexto, pedir un plan cuando hay riesgo, ejecutar con permisos claros, verificar con tests y análisis estático, y automatizar poco a poco lo que se repite. Es una forma de trabajar que puedes aplicar en tu día a día desde el minuto cero.

Todo lo vamos a hacer en la terminal. Claude Code también funciona en el IDE, en la aplicación de escritorio, en la web y en el móvil, y veremos cuándo encaja cada una, pero la terminal es donde se ve el ciclo completo: qué comando se ejecuta, qué archivo cambia, qué test falla y qué diff queda.

Al ser un curso escrito, cada comando lo tienes en la lección con su botón de copiar, y cada archivo del proyecto aparece completo, con lo que cambia resaltado, para que nunca tengas que adivinar dónde va un fragmento. Lo que vive fuera del proyecto, como ~/.claude/, va señalado aparte.

Empezamos con un proyecto Laravel con Sail y un circuito de calidad completo con Pint, Larastan, Rector y Pest, que será nuestro semáforo durante todo el curso: si pasa, seguimos, y si falla, investigamos antes de acumular deuda.

Después configuramos bien los permisos, entendiendo el modo con el que arranca hoy Claude Code, que es auto mode, y cuándo te conviene pasar al modo manual para revisar cada acción. Veremos también qué hace de verdad una regla deny y dónde entra el sandbox cuando esa regla no llega.

La memoria del proyecto la montamos con un CLAUDE.md corto y útil, rules que solo se cargan cuando Claude toca los modelos o los tests, y la auto memory, que es lo que Claude aprende solo de tus correcciones.

Escribimos skills para las tareas repetitivas, como la QA del proyecto o los mensajes de commit, y hooks que se ejecutan en el momento justo. Uno de seguridad bloquea comandos destructivos antes de que pasen, y otros formatean, analizan y lanzan los tests después de cada cambio.

Vamos a conectar Laravel Boost como servidor MCP, probar la aplicación en el navegador e instalar plugins con criterio, incluidos los de seguridad, sin meter en tu máquina cualquier cosa que encuentres por ahí.

Con esa base ya podemos crear subagentes especializados en auditar endpoints, escribir tests y revisar rendimiento y migraciones, trabajar varias tareas a la vez con worktrees y sesiones en segundo plano, y orquestar tareas grandes con los dynamic workflows sabiendo en todo momento cuánto cuestan.

Y para terminar, vamos a sacar Claude Code de la sesión interactiva: usarlo en scripts y en CI con claude -p, dejarlo trabajando solo con /loop y /goal, y revisar pull requests con GitHub Actions.

Una parte del curso va de dinero, porque es donde más dudas hay. Veremos qué modelo usar según la tarea, qué es el effort, cómo se llena la ventana de contexto y qué te da cada plan. Los nombres de los modelos cambian cada pocos meses, así que lo que te llevas es el criterio: qué familia usar según el riesgo de lo que tienes delante, cuándo merece la pena subir y cuándo solo estás gastando más.

Sobre qué plan elegir te voy a dar mi opinión, y te la daré como lo que es, mi opinión basada en cómo trabajo yo: Pro como mínimo, y Max si vas a estar sesiones largas o con varios agentes a la vez.

Trabajamos con Claude Code 2.1.283, Laravel 13 con PHP 8.5 sobre Laravel Sail 1.68, Pest 5.2, Larastan 3.12, Rector 2.6, Laravel Pint 1.32 y Laravel Boost 2.10. Claude Code publica versiones nuevas casi a diario, así que cuando una función necesita una versión mínima te lo indico en la lección, y cuando algo siga en fase de prueba también lo verás dicho.

La idea es que cuando termines tengas claude-tasks con un .claude/ completo que entiendes pieza a pieza: sabrás por qué existe cada permiso, cada rule, cada skill, cada hook y cada agente, y sabrás llevar esa misma configuración a tus propios proyectos en una tarde. Lo aprendes una vez y lo utilizas siempre, y además del proyecto te llevas la rutina de trabajo que hemos repetido durante todo el curso.

La documentación oficial de Claude Code es buena, es gratis y siempre va a estar más al día que cualquier curso, así que te voy a enlazar a ella cada vez que haga falta. Lo que no te da es el orden ni el criterio, porque son decenas de páginas que cambian cada semana sin un proyecto Laravel delante que te diga qué merece la pena configurar primero. Eso es lo que hace este curso: un solo proyecto, de principio a fin, con cada decisión explicada y con Sail, Pest, Pint y Larastan en el circuito.

Hay cosas que se quedan fuera, y prefiero decírtelo desde el principio.

No vamos a ver Spec-Driven Development a fondo. Tienes una lección que recorre el ciclo completo con Claude Code sobre una feature pequeña, y si quieres profundizar tienes en la plataforma el curso Spec-Driven Development en Laravel con IA↗ (se abre en una pestaña nueva).

Tampoco vamos a enseñar Laravel Boost como sistema propio. Lo instalamos como servidor MCP y te explico en qué se diferencian sus rules de las de Claude Code, pero en el curso trabajamos con las de Claude Code. Si quieres Boost a fondo, tienes el curso Laravel Boost 2.0↗ (se abre en una pestaña nueva).

Y no vamos a ver el Agent SDK en Python o TypeScript, ni los proveedores cloud como Amazon Bedrock, Google Cloud o Microsoft Foundry, ni las funciones que siguen en fase experimental, como los equipos de agentes o el control del escritorio. Las nombraré cuando tenga sentido, pero no vamos a construir nada sobre lo que puede cambiar mañana.

Este curso es para ti si ya trabajas con Laravel y quieres que Claude Code sea una herramienta más de tu trabajo profesional, integrada en tu forma de desarrollar y sin dejarle el control. Necesitas manejarte con Laravel, Sail y Docker, Git y la terminal en tu día a día. Si trabajas en Windows y no tienes claro cómo montar WSL2 con Sail, te recomiendo que antes pases por el curso WSL 2 en Windows con Laravel Sail↗ (se abre en una pestaña nueva).

Para seguirlo necesitas una cuenta de Claude con acceso a Claude Code. El plan gratuito no lo incluye, así que hace falta Pro, Max, Team o Enterprise, o una cuenta de la Console de Anthropic si prefieres pagar por uso.

Claude Code hace el trabajo mecánico y te ayuda a razonar, pero la responsabilidad sigue siendo tuya: tú decides qué problema merece la pena, qué riesgo aceptas, qué puede ejecutar y cuándo un cambio está listo. No es magia, es algo que tenemos que dominar, y este curso está pensado para que lo domines sin que te explote la cabeza.

Así que, si te interesa, te espero dentro del curso. Espero que te haya gustado esta introducción y nos vemos dentro. Un saludo.