Hay mucho ruido sobre IA y productividad para developers. La mayoría son demostraciones en proyectos vacíos o demos de 5 minutos. Este post es diferente: es el flujo exacto que yo uso en proyectos reales con tráfico real.

Stack base: Laravel 11 + Vue 3 + TypeScript + PostgreSQL. Deployment via Forge/DigitalOcean. Tests con Pest. Nada de toy projects.

Claude Code como driver, no como copiloto pasivo

La diferencia clave entre usar Claude Code bien y usarlo mal: yo dirijo, Claude ejecuta.

No es “sugiéreme código”. Es “abre este archivo, lee esta función, refactoriza esto respetando estos invariantes, escribe el test correspondiente, y dime si hay edge cases que no he considerado”.

Claude Code tiene acceso completo a mi codebase. Puede leer, editar, ejecutar comandos. Eso cambia completamente el juego respecto a un chat de navegador.

Mi flujo matutino

Cada mañana, antes de escribir una línea de código, abro Claude Code y ejecuto un audit rápido de lo que quedó pendiente ayer:

# Revisa los archivos modificados ayer y dame un resumen de qué está incompleto
# o tiene TODOs sin resolver

Claude lee el git log, los archivos modificados, los comentarios // TODO y me devuelve un resumen priorizado. Tarda menos de 30 segundos. Antes tardaba 10-15 minutos hacerlo manualmente.

Escritura de código: el patrón que funciona

Cuando empieza una feature nueva, mi prompt no es “escríbeme X”. Es:

1. Contexto: qué problema de negocio resuelve esto
2. Constraintts técnicos: qué partes del codebase no debe tocar, qué patrones seguimos
3. Output esperado: tests primero, luego implementación, luego migración si aplica

Ejemplo real de prompt para una feature de notificaciones:

“Lee app/Services/NotificationService.php y app/Models/User.php. Necesito añadir soporte para notificaciones por WhatsApp via Twilio. Sigue el mismo patrón de canales que usamos para email. Escribe el test Pest primero, luego la implementación. No toques el sistema de colas — ya está configurado correctamente.”

Con ese prompt, Claude Code produce código que encaja en la arquitectura existente, no código genérico que luego tengo que adaptar.

Code review aumentado

Esta es la parte donde más tiempo ahorro. Cuando acabo una feature, antes de abrir el PR:

# Revisa todos los cambios del branch actual vs main.
# Busca: problemas de seguridad, N+1 queries, variables sin usar,
# lógica que se podría simplificar, tests que faltan.
# Sé específico con línea y archivo.

Claude Code me devuelve una lista de issues reales, con línea y archivo. No es 100% infalible — yo sigo siendo el reviewer principal — pero captura el 70% de los problemas mecánicos antes de que lleguen al code review humano.

Refactoring con contexto completo

El refactoring es donde Claude Code brilla más. Puede leer 20 archivos a la vez y mantener coherencia en todos ellos.

Ejemplo: migré un sistema de permisos legacy (ACL custom) a Spatie Laravel Permission. Le di a Claude Code:

• El archivo de rutas con todos los can() calls
• Los modelos afectados
• Los tests existentes
• El README interno que explica el sistema actual

Y le pedí que planificara la migración paso a paso antes de ejecutar nada. Me dio un plan de 6 pasos, señaló 3 edge cases que yo no había visto, y luego ejecutó cada paso con mis confirmaciones.

La migración que estimé en 2 días tardó 4 horas.

Lo que NO delego a Claude Code

Esto es igual de importante:

• Decisiones de arquitectura: qué microservicio crear, cómo separar responsabilidades. Eso lo pienso yo.
• Juicios de negocio: qué feature priorizar, qué trade-off aceptar. Eso lo discuto con el cliente/equipo.
• Código de seguridad crítico: autenticación, autorización, pagos. Claude Code ayuda, pero yo reviso línea a línea.
• Merge final: siempre reviso el diff completo antes de mergear.

MCP servers: el siguiente nivel

Más allá de Claude Code puro, uso MCP servers para conectar Claude con mis herramientas:

• GitHub MCP: Claude puede leer issues, PRs, comentarios directamente
• Sentry MCP: “¿qué errores nuevos hay esta semana en producción?” — Claude los lee y sugiere fixes
• Database MCP (en dev/staging): queries exploratorias sin salir del contexto

Esto convierte a Claude en algo más que un editor inteligente: es un colaborador que entiende el contexto completo del proyecto.

Resultados medibles

Después de 8 meses usando este flujo en proyectos reales:

• Tiempo de code review: -60% (Claude captura los issues mecánicos)
• Tiempo de refactoring: -50% (contexto completo del codebase)
• Bugs en producción: -30% (audit matutino + review aumentado)
• Onboarding en nuevo codebase: de 2 semanas a 3 días

Estos son mis números, en mis proyectos. Tu mileage may vary, pero el orden de magnitud es el mismo para cualquier developer que lo use con disciplina.

Conclusión

Claude Code no es un atajo para escribir código más rápido. Es un multiplicador para developers que ya saben lo que hacen. La clave está en usarlo como driver, no como autocomplete glorificado.

Si trabajas con Laravel + Vue y quieres hablar de esto con más detalle, contáctame.