Cada sesión larga de Claude Code termina igual: pierdes horas de progreso y empiezas desde cero.
La solución no es un modelo más inteligente, es un sistema que el equipo de Claude Code usa internamente y para el que nunca escribieron una guía.
La mayoría de los desarrolladores no lo tienen y no saben que existe.
Aquí está el sistema completo 👇
🧠Antes de sumergirnos, comparto notas diarias sobre IA y vibe coding en mi canal de Telegram:https://t.me/zodchixquant
Qué significa realmente la ingeniería de contexto
Claude lee miles de líneas en cada sesión. La mayor parte es ruido, y el 5% que importa se entierra a la hora dos.
Ahí es cuando Claude empieza a inventar funciones y corregir errores que nunca escribiste. La solución no es un modelo más grande, es controlar lo que entra en la sesión.
Estos son los 6 patrones que el equipo de Claude Code usa en su propio monorepo.
Patrón 1: CLAUDE.md en capas (Pasos 1-3)
Un solo CLAUDE.md no es suficiente. El equipo de Claude Code usa tres capas, cada una centrada en un aspecto diferente.
Paso 1: CLAUDE.md raíz con reglas generales del proyecto
Coloca un CLAUDE.md en la raíz de tu repositorio. Mantenlo por debajo de 100 líneas. Debe responder cuatro preguntas que Claude tiene en cada solicitud:
1# Proyecto: [nombre]23## Stack4- Runtime: Node 22, TypeScript 5.55- Framework: Next.js 15, React 196- Database: Postgres 16, Drizzle ORM7- Testing: Vitest, Playwright89## Convenciones10- Imports: rutas absolutas desde `@/` únicamente11- Componentes: archivos en kebab-case, exports en PascalCase12- Tests: colocalizados como `[archivo].test.ts`13- Commits: conventional commits, sin co-author footer1415## No tocar16- `infra/terraform/` (gestionado por operaciones)17- `migrations/` (generado, nunca editado a mano)18- `vendor/` (dependencias comprometidas)1920## Valores por defecto21- Ejecutar `npm test` antes de declarar una tarea como completa22- Verificar tipos con `tsc --noEmit` en cada edición23- Formatear con Prettier al guardar
Paso 2: CLAUDE.md en subdirectorios para contexto específico del módulo
Agrega CLAUDE.md en cualquier carpeta donde las reglas cambien. Claude lee el más cercano cuando trabaja en esa carpeta, además del raíz.
Ejemplo, src/auth/CLAUDE.md:
1# Módulo de autenticación23Este módulo gestiona la gestión de sesiones y los flujos OAuth.45## Reglas6- Nunca registrar tokens, ni siquiera truncados7- Todas las lecturas de sesión pasan por `getSession()`, nunca cookies en bruto8- Los nuevos proveedores requieren una revisión de seguridad antes de fusionar910## Archivos para leer primero11- `session.ts` para el contrato12- `providers/index.ts` para el patrón de registro
Paso 3: CLAUDE.md personal en ~/.claude/CLAUDE.md
Esta es tu capa de preferencias global. Vive fuera de cualquier repositorio, se aplica en todas partes.
1## Mis preferencias - Explica lo que vas a hacer antes de hacerlo en ediciones multiarchivo - Cuestiona si mi solicitud parece que va a romper algo - Prefiere composición sobre herencia - Trabajo en zsh en macOS
Las tres capas se apilan: preferencias globales + reglas del proyecto + reglas del módulo. Claude las lee todas en cada solicitud sin tener que volver a subirlas a través de tu contexto.
Patrón 2: Referencias quirúrgicas a archivos (Pasos 4-5)
El comportamiento predeterminado de "deja que Claude averigüe qué archivos importan" es la forma más lenta y tonta de usar el contexto.
Paso 4:@archivo referencias con autocompletado
Cuando escribes @ en una solicitud, Claude abre un selector difuso de archivos. Úsalo en lugar de describir archivos en prosa.
Malo: "mira el código de autenticación de usuario y el helper de sesión"
Bueno: "mira
@src/auth /session.ts y
@src/auth /providers/google.ts, corrige la renovación del token"
Las referencias quirúrgicas cargan exactamente esos archivos. Las descripciones en prosa obligan a Claude a buscar, leer 4-5 archivos candidatos y elegir mal la mitad de las veces.
Paso 5: /focus para limitar el alcance de un flujo de trabajo completo
Para tareas más largas, limita toda la sesión de Claude a carpetas específicas:
1/focus src/auth src/api/auth-routes
Ahora cada búsqueda, grep y lectura opera solo dentro de esas dos carpetas.
Reduce el uso de contexto entre un 60-80% en tareas enfocadas, y Claude deja de "ayudar" leyendo archivos no relacionados para contexto que no necesita.
Ejecuta /focus clear para restablecer.
Patrón 3: Compactar y continuar (Pasos 6-8)
Las sesiones largas alcanzan el límite de contexto y fallan. El truco no es evitar sesiones largas, es ejecutarlas mediante compactación controlada.
Paso 6: Supervisa el uso de contexto con /stats
Ejecuta /stats periódicamente.
Cuando estés por encima del 70% de uso de contexto, estás en la zona de peligro. Por encima del 85%, Claude empieza a descartar mensajes antiguos sin avisarte.
Paso 7: /compact con instrucciones de preservación
/compact solo resume la conversación. Con instrucciones, le dices a Claude qué preservar textualmente:
1/compact preserve: plan de tarea actual, todas las decisiones sobre la refactorización de autenticación, el resultado de la prueba fallida del paso 3
Paso 8: /resume para sesiones que abarcan varios días
Si una tarea abarca varios días, termina cada sesión con /compact preserve: ... y comienza la siguiente con:
1claude --resume [id-de-sesión]
O simplemente claude --continue para la sesión más reciente. Retoma exactamente donde lo dejaste con el estado compactado intacto.
Patrón 4: Lectura primero, plan después (Pasos 9-10)
La mayor fuga de contexto es que Claude edite archivos antes de entenderlos. El modo plan lo obliga a leer primero, escribir después.
Paso 9: Activa el modo plan en cada tarea arriesgada
Presiona Shift+Tab para entrar en modo plan antes de cualquier tarea que toque más de un archivo.
En modo plan, Claude solo puede leer. Explica lo que haría, lista cada archivo que planea tocar y muestra los cambios propuestos. No se ejecuta nada hasta que tú apruebes.
Los ahorros son reales: una lectura, una edición, en lugar de leer 8, editar 3 mal, revertir, releer, editar de nuevo.
Paso 10: Bloquea el modo plan para rutas sensibles mediante hooks
Haz obligatorio el modo plan para áreas arriesgadas. En .claude/settings.json:
1{2 "hooks": {3 "PreToolUse": [4 {5 "matcher": "Edit(src/auth/**)|Edit(migrations/**)",6 "hooks": [7 {8 "type": "command",9 "command": "claude-require-plan-mode"10 }11 ]12 }13 ]14 }15}
Cualquier intento de edición en src/auth/*\ o migrations/\\* activa un requisito de modo plan. Claude no puede evitarlo.
Patrón 5: Aislamiento de contexto de subagentes (Pasos 11-13)
Los subagentes son la forma más limpia de mantener tu contexto principal pequeño. Cada subagente se ejecuta en su propia ventana, por lo que la sesión principal nunca ve el ruido.
Paso 11: Diseña subagentes con una superficie de herramientas mínima
Restringe las herramientas a lo que necesita el trabajo.
Un revisor de código no necesita Write ni Edit.
Un actualizador de documentación no necesita Bash. Menos superficie, menos contexto quemado en documentación y descripciones de herramientas irrelevantes.
1---2name: revisor-de-código3description: Revisar cambios de código en busca de errores y problemas de seguridad4tools: Read, Grep, Glob5model: sonnet6---
Paso 12: Pasa solo las referencias a archivos que el agente necesita
No digas "revisa los cambios recientes". Di "revisa @src/auth/session.ts y @src/auth/providers/google.ts."
El subagente lee solo esos, no su mejor suposición de lo que significa "reciente".
Paso 13: Usa modelos más baratos para subagentes
Configura el modelo por agente según la tarea.
Sonnet para tareas de revisión y pruebas, Haiku para actualizaciones de documentación y linters, Opus solo para auditorías de arquitectura o seguridad donde importa el razonamiento profundo.
Configúralo globalmente si es necesario:
1export CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-4-6"
Subagentes más baratos = más llamadas a subagentes por dólar = más aislamiento = contexto principal más pequeño.
El iniciador de ingeniería de contexto de 30 minutos
10 minutos: escribe un CLAUDE.md raíz ajustado con stack, convenciones, lista de no tocar y valores por defecto.
5 minutos: agrega CLAUDE.md en subdirectorios en tus 2-3 módulos más editados.
5 minutos: coloca un CLAUDE.md personal en ~/.claude/CLAUDE.md con tus preferencias.
5 minutos: construye una habilidad en .claude/skills/ para el flujo de trabajo que haces con más frecuencia.
5 minutos: graba el reflejo de Shift+Tab y comienza cada tarea multiarchivo en modo plan.
¡Hecho!
Tu próxima sesión usará entre un 50-70% menos de contexto para la misma cantidad de trabajo. Para la sesión 5, los patrones se vuelven reflejos y dejas de alcanzar el límite por completo.
El contexto no es algo que Claude gestione por ti. Es algo que tú ingenieras.
Ahora tienes el sistema.
¡Gracias por leer!
Comparto notas diarias sobre IA, finanzas y vibe coding en mi canal de Telegram: https://t.me/zodchixquant
