Laravel

Claude Code en un proyecto Laravel real: flujo completo

Autorangel cruz
Publicado
Lectura4 min de lectura
Claude Code en un proyecto Laravel real: flujo completo

Usar Claude Code en un proyecto Laravel no es solo "pedirle cosas": con un par de piezas configuradas, el agente escribe código Laravel idiomático, en la versión correcta y con tests, en vez de PHP genérico alucinado. Este es el flujo que uso, de principio a fin. Forma parte de la guía IA para desarrolladores Laravel.

1. Dale contexto: Laravel Boost

El primer paso es que el agente conozca tu app y las últimas features del framework. Eso lo resuelve Laravel Boost, el servidor MCP oficial:

composer require laravel/boost --dev
php artisan boost:install

Con esto, Claude Code puede leer tu esquema, tus modelos Eloquent, tus logs y consultar los +17.000 fragmentos de documentación de Laravel. El resultado práctico: menos métodos inventados y menos tiempo limpiando el diff.

2. Fija las reglas: tu CLAUDE.md

Boost genera un CLAUDE.md inicial, pero conviene afinarlo con lo que es propio de tu proyecto: comandos, convenciones y reglas "siempre/nunca". Lo cuento a fondo en qué poner en tu CLAUDE.md. Para un proyecto Laravel, ejemplos útiles:

  • "Corre php artisan test antes de dar por terminado un cambio."
  • "Los tests van en Pest, no PHPUnit."
  • "Usa Form Requests para validación, no validación inline en controllers."
  • "Sigue el estilo de Pint (vendor/bin/pint)."

Con Boost además tienes skills que se cargan bajo demanda (por ejemplo pest-testing o livewire-development) según lo que detecta en tu composer.json.

3. Trabaja en plan mode

Para cualquier tarea no trivial, entra en plan mode (Shift+Tab) antes de que toque código. Claude explora el proyecto (con las tools de Boost) y propone un plan que tú apruebas. Esto evita rehacer trabajo caro cuando la dirección inicial era equivocada.

Ejemplo de pedido:

Añade un endpoint para crear facturas: migración, modelo Invoice,
Form Request de validación, controller de API y tests Pest de feature.
Sigue las convenciones del proyecto.

Con Boost, el agente sabe qué versión de Laravel usas, mira el esquema existente y genera código acorde, no un tutorial genérico de internet.

4. Verifica: los tests son el contrato

El agente puede escribir los tests, pero el valor está en ejecutarlos. Pídele que corra php artisan test y arregle lo que falle. Cuando los tests pasan, tienes una señal real de que el cambio funciona, no una promesa. Si además le das objetivos de verificación en el prompt (casos concretos, salida esperada), el agente cierra el ciclo solo.

5. Delega lo ruidoso en subagentes

En tareas grandes, deja que un subagente haga la exploración o la revisión en su propio contexto y te devuelva solo el resumen. Así tu conversación principal no se llena de logs y salidas de tests, lo que además reduce tokens.

El flujo, resumido

  1. Boost para el contexto de tu app + docs actualizadas.
  2. CLAUDE.md con las convenciones del proyecto.
  3. Plan mode antes de codear.
  4. Tests Pest como verificación.
  5. Subagentes para lo verboso.

Con eso, Claude Code deja de ser un autocompletado glorificado y pasa a trabajar como un dev que conoce tu proyecto Laravel.

Preguntas frecuentes

¿Qué necesito para usar Claude Code en Laravel?

Claude Code instalado y, muy recomendable, Laravel Boost (composer require laravel/boost --dev + php artisan boost:install) para darle contexto de tu app y documentación actualizada.

¿Claude Code escribe tests para Laravel?

Sí. Con Boost y un CLAUDE.md que fije Pest como convención, genera tests de feature y unitarios. Lo importante es pedirle que los ejecute (php artisan test) y corrija los que fallen.

¿Por qué mi agente escribe Laravel desactualizado sin Boost?

Porque los LLM se entrenan con datos viejos y no conocen las features recientes. Boost le pasa documentación actualizada y contexto de tu proyecto, así usa las APIs correctas de tu versión.

¿Claude Code o Cursor para Laravel?

Ambos funcionan y ambos soportan Boost vía MCP. Es cuestión de flujo: Claude Code delega tareas completas desde la terminal; Cursor asiste mientras editas. Lo comparo en detalle en el post de Claude Code vs Cursor.