Aprendizajes en producción
CLAUDE CODE:
MEJORES PRÁCTICAS.
Todo lo que aprendí construyendo a Claudia, la IA que opera este sitio en tiempo real. No teoría — esto es lo que funciona en producción.
El Contexto
NO ES UNA guía.
SON aprendizajes reales.
Estas prácticas vienen de combinar el repo de referencia de la comunidad (8.2k estrellas en GitHub) con lo que aprendí operando este sitio con Claudia — un agente real en producción.
Claudia opera
Este sitio corre en producción con un agente de IA
Probado en código real
Cada práctica fue validada en un proyecto Next.js + WordPress
Actualizado 2026
Incorpora las últimas funciones: Equipos de Agentes, Modo Voz, Modo Planificación
LAS PRÁCTICAS
23 PRÁCTICAS.
6 CATEGORÍAS.
CLAUDE.md: máximo 150 líneas
Humanlayer recomienda apuntar a 60 líneas. Más contexto no es mejor contexto — es ruido que degrada las respuestas.
CLAUDE.md por subdirectorio
En monorepos, cada módulo puede tener su propio CLAUDE.md. Claude los carga por jerarquía: ancestro → descendiente.
Compact manual al 50%
No esperes a que Claude compacte solo. Al llegar al 50% de contexto, haz /compact manualmente para evitar la "zona de agente tonto".
Status line para contexto visible
Instala el plugin de status line para ver el consumo de contexto en tiempo real y activar compactación rápida desde la UI.
Comandos > Agentes para tus flujos de trabajo
Para tus propios flujos, prefiere Comandos (.claude/commands/) sobre Agentes. Son más predecibles y fáciles de mantener.
Agentes específicos, habilidades reutilizables
Evita agentes genéricos tipo "ingeniero de QA". Crea agentes con contexto específico (ej: blog-writer) y habilidades (Skills) que se reusen entre ellos.
Siempre empieza en Plan Mode
Antes de cualquier implementación, activa Plan Mode. Claude explora el codebase, diseña el approach y pide tu aprobación antes de tocar código.
Git Worktrees para trabajo paralelo
Con Agent Teams y git worktrees cada agente trabaja en su propia copia aislada del repo. Ideal para tareas grandes sin conflictos.
Wildcards en lugar de skip-permissions
En vez de --dangerously-skip-all-permissions, configura permisos precisos: Bash(npm run *) o Edit(/docs/**). Más seguro y auditable.
Sandbox Mode para reducir prompts
Activa /sandbox para aislar archivos y red. Reduce la cantidad de confirmaciones manuales sin comprometer la seguridad del sistema.
Credenciales fuera del repo
Nunca pongas API keys, passwords ni tokens en archivos que Claude pueda leer y commit. Usa .gitignore y variables de entorno.
Commit al terminar cada tarea
No acumules cambios. Hacer commit inmediatamente después de cada tarea completada da contexto de progreso y facilita el rollback.
Actualiza Claude Code diario
Claude Code lanza features nuevos constantemente. Revisa el changelog al iniciar cada sesión — las mejoras son significativas semana a semana.
Nombra y reanuda sesiones
Usa /rename para organizar sesiones importantes. Con /resume puedes continuar cualquier sesión desde donde la dejaste, incluso desde otro dispositivo.
Voz para prompts largos
El modo Voice de Claude Code (o Wispr Flow como alternativa) multiplica la velocidad al dictar instrucciones complejas en vez de escribirlas.
Tareas en segundo plano para registros completos
Corre tareas largas en segundo plano para capturar registros completos. Claude puede leer todo el resultado y diagnosticar sin truncamiento.
Capturas de pantalla al reportar errores
Cuando algo falla visualmente, toma una captura de pantalla y adjúntala. Claude procesa imágenes y diagnostica problemas de interfaz mucho más rápido.
MCP de browser para consola
Con MCPs de Playwright o Chrome DevTools, Claude puede observar errores de consola directamente — sin que tengas que copiar y pegar los logs.
QA con otro modelo
Para revisar planes o validar código generado, usa un modelo diferente (ej: GPT-4o) como revisor. El cambio de perspectiva detecta errores que Claude pasa por alto.
Build de Producción vs Local
Lo que compila en tu máquina puede fallar en Vercel. Usa "as unknown as Type" para silenciar linters agresivos en inicializaciones complejas (ej: Stripe) sin romper la seguridad de tipos.
Serialización de Datos en React
Nunca pases objetos complejos (como Date) directamente a componentes hijos en Next.js 15. Formatea siempre a string en la capa de datos para evitar errores de prerenderizado.
Arquitectura de Rutas SEO
Prefiere rutas descriptivas ([slug]/[dia-slug]) sobre estructuras genéricas. Mejora el SEO y evita conflictos de renderizado al dar a Next.js rutas únicas y claras.
Git: Cuidado con los archivos ignorados
Si una carpeta no aparece en producción, revisa el .gitignore de niveles superiores. Usa "git add -f" para forzar la inclusión de archivos de contenido críticos que Git esté omitiendo por error.
Ve a Claudia
en acción.
Claudia es el ejemplo vivo de estas prácticas aplicadas. Gestiona contenido, SEO y código en este sitio — 24/7, sin vacaciones.
¿Quieres implementarlo
en tu empresa?
No necesitas ser desarrollador. Como consultor NoCode, te ayudo a construir e implementar agentes de IA con las herramientas correctas para tu negocio.
SIGUIENTE PASO
APRENDER ES UNA COSA.
construirlo es otra.
En Mi Primer Empleado de IA construyes tu propio agente en 3 semanas — con estas prácticas, con Claude Code, y con acompañamiento real.