Cómo usamos Claude Code para mantener un monorepo Nuxt 4 + Rust

Nuestro Stack y Por Qué Claude Code Encaja

En Open Soft, nuestro producto principal es un sitio web construido como monorepo: un frontend Nuxt 4 con TypeScript y una API backend Rust/Axum respaldada por PostgreSQL. El codebase abarca dos lenguajes, dos sistemas de build, contratos de datos compartidos, migraciones de base de datos, archivos i18n para 10 idiomas e infraestructura de despliegue.

Adoptamos Claude Code a mediados de 2025 y se ha convertido en nuestra herramienta de desarrollo más usada. No porque escriba código por nosotros — sino porque razona sobre todo nuestro codebase de formas que ninguna otra herramienta puede. Cuando le dices a Claude Code “añade un campo published_at a articles”, lee la migración Rust, actualiza las consultas SQL en el handler, modifica los tipos TypeScript en el frontend, ajusta el componente de página Nuxt, actualiza los 10 archivos de locale y ejecuta el build para verificar.

CLAUDE.md: Enseñando Convenciones al Agente

La base del uso efectivo de Claude Code es el archivo CLAUDE.md. Es un archivo de instrucciones a nivel de proyecto que Claude Code lee al inicio de cada sesión.

Nuestro CLAUDE.md incluye:

• Convenciones de commit: Cada commit debe empezar con TASK-XXX:
• Vista general de arquitectura: Estructura del monorepo
• Reglas de estilo de código: TypeScript strict, sin any, solo Composition API
• Reglas i18n: Los 10 locales deben estar sincronizados, claves ordenadas alfabéticamente
• Reglas de seguridad: Sin secretos en commits, SQL parametrizado

Claude Code sigue estas convenciones consistentemente. Esto elimina toda una categoría de feedback de revisión de código — violaciones de convenciones.

Refactoring Multi-Archivo: El Caso de Uso Estrella

Tarea: Añadir campos SEO al sistema de articles. Sin Claude Code: 10 pasos, 12+ archivos, 45-60 minutos. Con Claude Code: Un comando, 5 minutos, un bucle agéntico.

Escritura de Migraciones

Las migraciones de base de datos son particularmente adecuadas para Claude Code porque requieren entender el esquema actual, el estado final deseado y el camino de transformación seguro entre ambos.

Generación de Pruebas

Usamos Claude Code extensivamente para generar fixtures de prueba y datos SQL de semilla.

Revisión de Código con Claude Code

Antes de abrir un merge request, ejecutamos Claude Code como revisor. Captura aproximadamente el 30% de los problemas que de otro modo se encontrarían en la revisión humana.

Hooks: Automatizando Puertas de Calidad

Hook pre-commit: Ejecuta cargo fmt --check y cargo clippy. Hook post-edición: Verifica que los 10 archivos de locale tengan conjuntos de claves idénticos.

Servidores MCP: Extendiendo las Capacidades de Claude Code

1. Servidor MCP de base de datos: Permite consultar PostgreSQL directamente.
2. Servidor MCP de estado de despliegue: Conecta con el pipeline CI/CD.

Consejos para Codebases Grandes con 1M de Contexto

Deje que Claude Code explore. No intente preseleccionar archivos. Describa lo que quiere y deje que Claude Code use sus herramientas.

Use CLAUDE.md para contexto estable. Información que no cambia entre sesiones va en CLAUDE.md.

Divida mega-tareas en fases. Incluso con 1M de tokens, las tareas grandes se benefician de fases.

Confíe en el bucle agéntico. No interrumpa a mitad de ciclo.

Trampas y Soluciones

Trampa: Sobre-ingeniería. Solución: KISS en CLAUDE.md. Trampa: Contexto obsoleto en sesiones largas. Solución: Nueva sesión para cada tarea principal. Trampa: Cambios agresivos de archivos. Solución: Revise el diff cuidadosamente.

FAQ

¿Cuánto cuesta Claude Code para uso diario?

Para nuestro equipo de 4 desarrolladores, gastamos aproximadamente $200-300/mes. El plan Max a $20/mes por desarrollador es una alternativa más predecible.

¿Funciona Claude Code sin conexión?

No. Requiere conexión a internet.

¿Puede Claude Code romper nuestro build?

Sí, pero detecta la mayoría de los problemas. ~90% de builds exitosos al primer intento.

¿Es Claude Code adecuado para desarrolladores solo?

Absolutamente. Sirve como segundo par de ojos y multiplicador de fuerza.

Conclusión

Claude Code no es una varita mágica. Es un multiplicador de fuerza que sobresale en razonamiento cross-stack, aplicación de convenciones y cambios multi-archivo tediosos. La combinación de CLAUDE.md, hooks y servidores MCP lo convierte en la herramienta de desarrollo IA más capaz que hemos usado para trabajo en monorepo.

La perspectiva clave tras 9 meses de uso diario: Claude Code es más valioso no para escribir código nuevo, sino para mantener código existente — refactoring, migraciones, pruebas y revisiones.