Conceptos básicos de gestión de contexto

10 ejemplos para empezar con la gestión de contexto de Claude Code: 7 básicos y 3 intermedios.

Prerrequisitos

Claude Code CLI instalado y ejecutándose dentro de un directorio de proyecto (un repositorio git no es necesario, pero se recomienda).
No hay paquetes adicionales que instalar: CLAUDE.md es solo un archivo markdown, y /init, @mentions, /compact, y /clear están integrados en Claude Code.

Ejemplos básicos

1. Generar un CLAUDE.md de inicio con /init

Ejecuta /init dentro de un proyecto nuevo o existente para que Claude Code redacte un CLAUDE.md inicial.

cd mi-proyecto
claude
# dentro de la sesión de Claude Code:
/init

Claude Code escanea el proyecto (archivos de paquetes, estructura de carpetas, documentación existente) y escribe una primera versión de CLAUDE.md.
El archivo generado es un punto de partida, no un documento finalizado; léelo siempre y corrige cualquier error u omisión.
Ejecutar /init de nuevo en un proyecto que ya tiene un CLAUDE.md lo actualizará en lugar de empezar desde cero.

Relacionado: Puesta en marcha de un nuevo proyecto con /init - un tutorial completo de este comando.

2. Escribir un CLAUDE.md mínimo a mano

Un archivo CLAUDE.md no necesita sintaxis especial; es markdown que Claude Code lee automáticamente al inicio de cada sesión.

# Proyecto: Servicio de Pedidos
 
- Idioma: TypeScript, modo estricto.
- Las pruebas se encuentran en `__tests__/`, reflejando la estructura de origen.
- Nunca edites archivos bajo `generated/`; se reconstruyen con `npm run codegen`.

Coloca este archivo en la raíz de tu proyecto como CLAUDE.md.
Cada punto debe ser una regla concreta y verificable, no una preferencia vaga.
Confírmalo en el control de versiones para que todo el equipo comparta la misma memoria del proyecto.

Relacionado: Qué hace realmente CLAUDE.md - por qué este archivo es importante.

3. Apuntar Claude Code a un archivo con @mentions

Usa @ seguido de una ruta para referenciar un archivo exacto en lugar de describirlo con texto.

# en un prompt de Claude Code:
Corrige el error en @src/utils/formatDate.ts donde no se aplican las zonas horarias.

@mentions evita la conjetura de Claude Code al buscar el archivo correcto; lo nombras directamente.
Funcionan para cualquier archivo del proyecto, no solo código fuente; también archivos de configuración y documentación.
El uso excesivo de @mentions para archivos grandes puede inflar rápidamente la ventana de contexto, ya que se carga el contenido completo del archivo.

Relacionado: Referenciar archivos específicos con @mentions - patrones más profundos para esto.

4. Liberar espacio a mitad de sesión con /compact

Cuando una conversación larga empieza a sentirse lenta o la ventana de contexto se está llenando, condénsalo en lugar de perderlo todo.

# dentro de una sesión de Claude Code:
/compact

/compact resume la conversación hasta el momento, conservando las partes relevantes y descartando el resto.
Úsalo cuando quieras seguir trabajando en la misma tarea pero la sesión haya acumulado mucho ir y venir exploratorio.
No es sin pérdidas; detalles anteriores muy específicos pueden suavizarse en el resumen.

Relacionado: Por qué existen /compact y /clear - cuándo usar cada uno.

5. Empezar de nuevo limpiamente con /clear

Cuando una conversación se ha desviado o el contexto se ha vuelto obsoleto, límpiala y empieza de nuevo.

# dentro de una sesión de Claude Code:
/clear

/clear descarta por completo el historial de la conversación; CLAUDE.md se recarga fresco al inicio de la nueva sesión.
Úsalo al cambiar a una tarea no relacionada, en lugar de arrastrar historial irrelevante.
A diferencia de /compact, nada de la conversación anterior se mantiene.

Relacionado: Por qué existen /compact y /clear - la comparación completa.

6. Añadir una regla a nivel de proyecto que Claude Code nunca debe romper

Las reglas concretas y no negociables pertenecen a CLAUDE.md como declaraciones explícitas, no como convenciones implícitas.

## Reglas estrictas
 
- Nunca confirmes directamente en `main`; abre siempre una pull request.
- Nunca modifiques `.env.production`; pregunta primero al usuario.
- Ejecuta siempre `npm test` antes de declarar una tarea como finalizada.

Una sección dedicada de "Reglas estrictas" hace que los puntos no negociables sean fáciles de escanear frente a preferencias generales de estilo.
Empareja reglas críticas con una comprobación realmente forzada (CI, un hook de pre-commit); CLAUDE.md es una guía que el agente lee, no una barrera técnica estricta.
Mantén la lista corta; un puñado de reglas verdaderamente estrictas es más probable que se sigan que cincuenta de ellas.

Relacionado: Escribir un archivo CLAUDE.md que realmente se siga - el patrón completo.

7. Referenciar varios archivos relacionados a la vez

Los @mentions se pueden encadenar cuando una tarea abarca genuinamente varios archivos.

# en un prompt de Claude Code:
Compara @src/api/userController.ts con @src/api/orderController.ts
y haz que el manejo de errores sea consistente entre ellos.

Encadenar unos pocos @mentions dirigidos es mucho más barato en contexto que pedirle a Claude Code que busque en toda la base de código.
Limita la lista a los archivos que realmente importan para la tarea; cada mención añade su contenido completo al contexto.
Para una carpeta entera de archivos relacionados, describir el patrón con texto suele ser más barato que mencionar cada archivo individualmente.

Relacionado: Referenciar archivos específicos con @mentions - más sobre el alcance de las menciones.

Ejemplos intermedios

8. Superponer un CLAUDE.md anidado para una subcarpeta

Una subcarpeta puede tener su propio CLAUDE.md que añade reglas encima del archivo raíz, con un alcance solo para esa parte de la base de código.

<!-- backend/CLAUDE.md -->
# Reglas específicas del backend
 
- Todas las consultas a la base de datos pasan por la capa `repositories/`; nunca consultes directamente desde un manejador de rutas.
- Usa esquemas `zod` para validar toda entrada externa antes de que llegue a la lógica de negocio.

El CLAUDE.md raíz sigue aplicándose en todas partes; este archivo solo añade detalles relevantes para backend/.
Los archivos anidados son útiles una vez que un proyecto tiene áreas genuinamente distintas (frontend vs backend, paquetes en un monorepo).
Mantén las reglas anidadas no contradictorias con el archivo raíz; la guía conflictiva obliga al agente a adivinar cuál prevalece.

Relacionado: Archivos CLAUDE.md anidados y cómo funciona la herencia de alcance - la mecánica completa.

9. Diagnosticar una sesión que se ha vuelto lenta

Antes de recurrir a /compact o /clear, averigua qué está consumiendo realmente el contexto.

# algunas preguntas para responder antes de decidir qué hacer:
# - ¿He @mencionado archivos muy grandes repetidamente?
# - ¿La conversación ha realizado muchas búsquedas exploratorias con salida detallada?
# - ¿Es el propio CLAUDE.md inusualmente largo?

Archivos grandes leídos en su totalidad, @mentions excesivos y salida detallada de herramientas son los culpables habituales de la hinchazón del contexto.
/compact es la opción correcta cuando la tarea aún está en curso y quieres continuar.
/clear es la opción correcta cuando estás cambiando de tarea por completo y el historial antiguo ya no es relevante.

Relacionado: Auditar qué está consumiendo tu ventana de contexto de Claude Code - un flujo de trabajo de auditoría completo.

10. Combinar CLAUDE.md, @mentions y /clear en una tarea

Un flujo de trabajo realista encadena las tres herramientas en lugar de depender solo de una.

# CLAUDE.md ya documenta las convenciones del proyecto, así que:
Refactoriza @src/services/payment.ts para usar el patrón de reintentos
descrito en CLAUDE.md bajo "Manejo de errores".
 
# ...más tarde, una vez que esa tarea esté hecha y fusionada:
/clear
# inicia la siguiente tarea, no relacionada, con una sesión limpia

CLAUDE.md proporciona las convenciones permanentes, @mentions limita la solicitud al archivo exacto, y /clear restablece una vez que la tarea se completa.
Esta combinación mantiene cada sesión enfocada: memoria amplia del proyecto más un alcance de tarea ajustado y actual.
Evita que una sesión larga acumule varias tareas no relacionadas; es lo que hace más probables la hinchazón del contexto y las respuestas confusas.

Relacionado: Mejores prácticas de gestión de contexto - patrones que unen todo esto.

Versiones de Stack: Escrito contra la línea de modelos de Claude actual a partir de ~junio de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (el predeterminado) y Claude Haiku 4.5. Los nombres de los modelos, precios y características del producto cambian rápidamente; verifica los detalles actuales en platform.claude.com/docs antes de confiar en ellos.

Conceptos básicos de gestión de contexto

10 ejemplos para empezar con la gestión de contexto de Claude Code: 7 básicos y 3 intermedios.

Prerrequisitos

Claude Code CLI instalado y ejecutándose dentro de un directorio de proyecto (un repositorio git no es necesario, pero se recomienda).
No hay paquetes adicionales que instalar: CLAUDE.md es solo un archivo markdown, y /init, @mentions, /compact, y /clear están integrados en Claude Code.

Ejemplos básicos

1. Generar un CLAUDE.md de inicio con /init

Ejecuta /init dentro de un proyecto nuevo o existente para que Claude Code redacte un CLAUDE.md inicial.

cd mi-proyecto
claude
# dentro de la sesión de Claude Code:
/init

Claude Code escanea el proyecto (archivos de paquetes, estructura de carpetas, documentación existente) y escribe una primera versión de CLAUDE.md.
El archivo generado es un punto de partida, no un documento finalizado; léelo siempre y corrige cualquier error u omisión.
Ejecutar /init de nuevo en un proyecto que ya tiene un CLAUDE.md lo actualizará en lugar de empezar desde cero.

Relacionado: Puesta en marcha de un nuevo proyecto con /init - un tutorial completo de este comando.

2. Escribir un CLAUDE.md mínimo a mano

Un archivo CLAUDE.md no necesita sintaxis especial; es markdown que Claude Code lee automáticamente al inicio de cada sesión.

# Proyecto: Servicio de Pedidos
 
- Idioma: TypeScript, modo estricto.
- Las pruebas se encuentran en `__tests__/`, reflejando la estructura de origen.
- Nunca edites archivos bajo `generated/`; se reconstruyen con `npm run codegen`.

Coloca este archivo en la raíz de tu proyecto como CLAUDE.md.
Cada punto debe ser una regla concreta y verificable, no una preferencia vaga.
Confírmalo en el control de versiones para que todo el equipo comparta la misma memoria del proyecto.

Relacionado: Qué hace realmente CLAUDE.md - por qué este archivo es importante.

3. Apuntar Claude Code a un archivo con @mentions

Usa @ seguido de una ruta para referenciar un archivo exacto en lugar de describirlo con texto.

# en un prompt de Claude Code:
Corrige el error en @src/utils/formatDate.ts donde no se aplican las zonas horarias.

@mentions evita la conjetura de Claude Code al buscar el archivo correcto; lo nombras directamente.
Funcionan para cualquier archivo del proyecto, no solo código fuente; también archivos de configuración y documentación.
El uso excesivo de @mentions para archivos grandes puede inflar rápidamente la ventana de contexto, ya que se carga el contenido completo del archivo.

Relacionado: Referenciar archivos específicos con @mentions - patrones más profundos para esto.

4. Liberar espacio a mitad de sesión con /compact

Cuando una conversación larga empieza a sentirse lenta o la ventana de contexto se está llenando, condénsalo en lugar de perderlo todo.

# dentro de una sesión de Claude Code:
/compact

/compact resume la conversación hasta el momento, conservando las partes relevantes y descartando el resto.
Úsalo cuando quieras seguir trabajando en la misma tarea pero la sesión haya acumulado mucho ir y venir exploratorio.
No es sin pérdidas; detalles anteriores muy específicos pueden suavizarse en el resumen.

Relacionado: Por qué existen /compact y /clear - cuándo usar cada uno.

5. Empezar de nuevo limpiamente con /clear

Cuando una conversación se ha desviado o el contexto se ha vuelto obsoleto, límpiala y empieza de nuevo.

# dentro de una sesión de Claude Code:
/clear

/clear descarta por completo el historial de la conversación; CLAUDE.md se recarga fresco al inicio de la nueva sesión.
Úsalo al cambiar a una tarea no relacionada, en lugar de arrastrar historial irrelevante.
A diferencia de /compact, nada de la conversación anterior se mantiene.

Relacionado: Por qué existen /compact y /clear - la comparación completa.

6. Añadir una regla a nivel de proyecto que Claude Code nunca debe romper

Las reglas concretas y no negociables pertenecen a CLAUDE.md como declaraciones explícitas, no como convenciones implícitas.

## Reglas estrictas
 
- Nunca confirmes directamente en `main`; abre siempre una pull request.
- Nunca modifiques `.env.production`; pregunta primero al usuario.
- Ejecuta siempre `npm test` antes de declarar una tarea como finalizada.

Una sección dedicada de "Reglas estrictas" hace que los puntos no negociables sean fáciles de escanear frente a preferencias generales de estilo.
Empareja reglas críticas con una comprobación realmente forzada (CI, un hook de pre-commit); CLAUDE.md es una guía que el agente lee, no una barrera técnica estricta.
Mantén la lista corta; un puñado de reglas verdaderamente estrictas es más probable que se sigan que cincuenta de ellas.

Relacionado: Escribir un archivo CLAUDE.md que realmente se siga - el patrón completo.

7. Referenciar varios archivos relacionados a la vez

Los @mentions se pueden encadenar cuando una tarea abarca genuinamente varios archivos.

# en un prompt de Claude Code:
Compara @src/api/userController.ts con @src/api/orderController.ts
y haz que el manejo de errores sea consistente entre ellos.

Encadenar unos pocos @mentions dirigidos es mucho más barato en contexto que pedirle a Claude Code que busque en toda la base de código.
Limita la lista a los archivos que realmente importan para la tarea; cada mención añade su contenido completo al contexto.
Para una carpeta entera de archivos relacionados, describir el patrón con texto suele ser más barato que mencionar cada archivo individualmente.

Relacionado: Referenciar archivos específicos con @mentions - más sobre el alcance de las menciones.

Ejemplos intermedios

8. Superponer un CLAUDE.md anidado para una subcarpeta

Una subcarpeta puede tener su propio CLAUDE.md que añade reglas encima del archivo raíz, con un alcance solo para esa parte de la base de código.

<!-- backend/CLAUDE.md -->
# Reglas específicas del backend
 
- Todas las consultas a la base de datos pasan por la capa `repositories/`; nunca consultes directamente desde un manejador de rutas.
- Usa esquemas `zod` para validar toda entrada externa antes de que llegue a la lógica de negocio.

El CLAUDE.md raíz sigue aplicándose en todas partes; este archivo solo añade detalles relevantes para backend/.
Los archivos anidados son útiles una vez que un proyecto tiene áreas genuinamente distintas (frontend vs backend, paquetes en un monorepo).
Mantén las reglas anidadas no contradictorias con el archivo raíz; la guía conflictiva obliga al agente a adivinar cuál prevalece.

Relacionado: Archivos CLAUDE.md anidados y cómo funciona la herencia de alcance - la mecánica completa.

9. Diagnosticar una sesión que se ha vuelto lenta

Antes de recurrir a /compact o /clear, averigua qué está consumiendo realmente el contexto.

# algunas preguntas para responder antes de decidir qué hacer:
# - ¿He @mencionado archivos muy grandes repetidamente?
# - ¿La conversación ha realizado muchas búsquedas exploratorias con salida detallada?
# - ¿Es el propio CLAUDE.md inusualmente largo?

Archivos grandes leídos en su totalidad, @mentions excesivos y salida detallada de herramientas son los culpables habituales de la hinchazón del contexto.
/compact es la opción correcta cuando la tarea aún está en curso y quieres continuar.
/clear es la opción correcta cuando estás cambiando de tarea por completo y el historial antiguo ya no es relevante.

Relacionado: Auditar qué está consumiendo tu ventana de contexto de Claude Code - un flujo de trabajo de auditoría completo.

10. Combinar CLAUDE.md, @mentions y /clear en una tarea

Un flujo de trabajo realista encadena las tres herramientas en lugar de depender solo de una.

# CLAUDE.md ya documenta las convenciones del proyecto, así que:
Refactoriza @src/services/payment.ts para usar el patrón de reintentos
descrito en CLAUDE.md bajo "Manejo de errores".
 
# ...más tarde, una vez que esa tarea esté hecha y fusionada:
/clear
# inicia la siguiente tarea, no relacionada, con una sesión limpia

CLAUDE.md proporciona las convenciones permanentes, @mentions limita la solicitud al archivo exacto, y /clear restablece una vez que la tarea se completa.
Esta combinación mantiene cada sesión enfocada: memoria amplia del proyecto más un alcance de tarea ajustado y actual.
Evita que una sesión larga acumule varias tareas no relacionadas; es lo que hace más probables la hinchazón del contexto y las respuestas confusas.

Relacionado: Mejores prácticas de gestión de contexto - patrones que unen todo esto.

Versiones de Stack: Escrito contra la línea de modelos de Claude actual a partir de ~junio de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (el predeterminado) y Claude Haiku 4.5. Los nombres de los modelos, precios y características del producto cambian rápidamente; verifica los detalles actuales en platform.claude.com/docs antes de confiar en ellos.

Conceptos básicos de gestión de contexto

Buscar en la documentación

Conceptos básicos de gestión de contexto