---
title: "Claude Code en un proyecto Laravel real: flujo completo"
excerpt: "Cómo usar Claude Code en un proyecto Laravel de verdad: configurar Boost y el CLAUDE.md, trabajar en plan mode y dejar que el agente escriba código idiomático con tests Pest."
date: "2026-07-03T11:00:00.000Z"
category: "Laravel"
tech_article: true
author:
  name: "angel cruz"
  picture: "https://angelcruzdevcdn.nyc3.cdn.digitaloceanspaces.com/images/me/angel-cruz.png"
ogImage:
  url: "/images/open-graph/laravel-opengraph-image.png"
seo_title: "Claude Code en Laravel: flujo de trabajo real (guía)"
seo_description: "Guía práctica para usar Claude Code en un proyecto Laravel: instalar Boost, configurar el CLAUDE.md, plan mode, código idiomático y tests con Pest."
---

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](/post/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](/post/mcp-para-laravel), el servidor MCP oficial:

```shell
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](/post/claude-md-buenas-practicas). 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:

```text
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](/post/subagentes-claude-code) 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](/post/optimizar-claude-code-reducir-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](/post/mcp-para-laravel) (`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.

---

## Sitemap

Índice completo del sitio: [/sitemap.md](https://www.angelcruz.dev/sitemap.md)

Canónico HTML: [https://www.angelcruz.dev/post/claude-code-proyecto-laravel](https://www.angelcruz.dev/post/claude-code-proyecto-laravel)