Gestión de contexto en Claude Code: /context, /compact, CLAUDE.md y Obsidian

Empiezas una sesión de Claude Code con una petición clara. Una hora después, Claude vuelve a leer archivos que ya había revisado, olvida una decisión tomada veinte mensajes atrás o aplica una instrucción antigua en vez de la corrección más reciente. Si estás empezando, es fácil pensar que el modelo se ha vuelto menos capaz de repente.

Lo más habitual es que la ventana de contexto esté saturada. La conversación, el contenido de los archivos, la salida de los comandos, las instrucciones del proyecto, las herramientas y las propias respuestas de Claude compiten por un espacio de trabajo limitado. Cuando ese espacio se llena de investigación descartada y registros extensos, los datos importantes pierden protagonismo.

Gestionar el contexto no consiste solo en ahorrar tokens. Consiste en decidir qué necesita Claude para la tarea actual, qué debe guardarse como regla duradera, qué puede resumirse y cuándo conviene terminar la conversación. Esta guía propone una rutina concreta, incluso si todavía no tienes claro qué son los tokens, la memoria del proyecto o las sesiones guardadas.

Ideas clave

• Ejecuta /context para ver qué ocupa la ventana actual antes de atribuir los fallos a la longitud de la sesión.
• Usa /compact cuando la tarea sigue siendo la misma, pero la conversación ya es demasiado grande. Añade una instrucción de enfoque para proteger las decisiones importantes.
• Usa /clear al pasar a una tarea distinta. La conversación anterior queda guardada y puede reanudarse; la nueva empieza sin historial conversacional y vuelve a cargar la memoria del proyecto.
• Usa /memory para revisar y editar instrucciones persistentes y la memoria automática. Para comprobar qué archivos de memoria se cargaron realmente, usa /context.
• Usa /usage para consultar coste de la sesión, límites del plan y actividad. /cost es un alias de /usage; /stats también lo es y abre la pestaña Stats.
• Antes de compactar o entregar el trabajo a otra sesión, deja un recibo breve con decisiones, archivos, pruebas y siguiente paso.

La ventana de contexto es la mesa de trabajo de Claude

La ventana de contexto contiene la información que Claude puede considerar en el turno actual. Conviene imaginarla como una mesa de trabajo, no como un archivo permanente. En una mesa ordenada hay una tarea, dos archivos relevantes, un mensaje de error breve y los criterios de aceptación. En una mesa saturada hay enfoques abandonados, compilaciones completas, preguntas laterales, lecturas duplicadas y reglas contradictorias.

El espacio se consume desde más lugares que el chat visible:

Qué ocupa contexto	Cómo genera ruido	Hábito recomendado
Historial de conversación	Conserva preguntas laterales y decisiones sustituidas	Separa tareas distintas y registra la decisión vigente
Lecturas de archivos	Carga directorios completos o archivos generados muy grandes	Busca primero y lee solo archivos o rangos relevantes
Resultados de herramientas	Acumula registros y pruebas repetidas	Conserva la primera causa y el resultado final
CLAUDE.md y reglas	Carga instrucciones amplias, duplicadas o incompatibles	Mantén breves las reglas permanentes y limita las específicas por ruta
Skills y descripciones de herramientas	Las capacidades activas también ocupan contexto inicial	Activa únicamente lo necesario para el trabajo

Claude Code puede compactar automáticamente cuando la ventana se aproxima al límite. Eso evita que la sesión se detenga sin más, pero el resumen automático también debe decidir qué conservar. Una compactación manual y enfocada antes de cambiar de fase ofrece un resultado más predecible.

Qué hace realmente cada comando

Los comandos se parecen, pero resuelven problemas diferentes. Escríbelos al principio de un mensaje dentro de una sesión interactiva de Claude Code.

flowchart TD
  A["Ejecutar /context"] --> B{"¿Sigue siendo la misma tarea?"}
  B -->|Sí| C["Usar /compact con instrucciones"]
  B -->|No| D["Registrar el estado y usar /clear"]

/context: inspeccionar la ventana actual

/context muestra el uso actual del contexto mediante una cuadrícula de colores e incluye recomendaciones para herramientas pesadas, exceso de memoria y avisos de capacidad. /context all amplía el desglose por elemento.

/context
/context all

Úsalo al comenzar una tarea larga para obtener una referencia, después de una investigación grande para medir cuánto añadió y antes de /compact para decidir qué debe destacar el resumen. Es un diagnóstico: consultar la cuadrícula no borra nada.

/compact [instrucciones]: resumir y continuar

/compact sustituye el historial de la conversación por un resumen estructurado, de modo que puedas continuar la misma tarea con más espacio. El texto opcional indica al proceso de resumen qué información debe priorizar.

/compact conserva el contrato de API aceptado, los archivos modificados, la prueba que falla, los comandos ejecutados y el siguiente paso

Úsalo cuando el objetivo no ha cambiado. Por ejemplo, sigues corrigiendo el mismo error de autenticación, pero la fase de diagnóstico produjo una conversación muy larga. No esperes que el resumen conserve cada frase: las reglas críticas ya deberían estar en CLAUDE.md, en una especificación o en una nota de entrega.

/clear [nombre]: iniciar otra conversación

/clear inicia una conversación nueva con el contexto conversacional vacío. Puedes asignar un nombre a la conversación anterior. Claude Code mantiene la memoria del proyecto, y la conversación previa permanece guardada para recuperarla con /resume.

/clear correccion-auth-terminada

Úsalo cuando la siguiente petición tiene otro objetivo, otros archivos u otro historial de decisiones. Una regla útil: si un compañero entendería mejor la nueva tarea sin leer la conversación anterior, crea ese límite con /clear.

El trabajo anterior no se elimina. Las sesiones interactivas se guardan de forma continua y pueden abrirse con /resume, claude --resume o claude --continue para la sesión más reciente del directorio.

/memory: revisar instrucciones persistentes

/memory enumera las ubicaciones de CLAUDE.md y CLAUDE.local.md, permite abrir o crear esos archivos, muestra entradas de memoria automática y permite activarla o desactivarla. Responde a la pregunta: «¿Dónde debería vivir esta información reutilizable?»

/memory

No demuestra que todos los archivos enumerados estén activos en el contexto actual. Para eso, ejecuta /context y revisa la sección de archivos de memoria. El CLAUDE.md del proyecto puede compartirse y versionarse; la memoria automática es información local asociada al repositorio y compartida entre sus worktrees, pero no entre máquinas.

/usage, /cost y /stats: consultar consumo, no contexto

/usage muestra el coste de la sesión, los límites de uso del plan y estadísticas de actividad. En los planes compatibles también desglosa el uso de skills, subagentes, plugins y servidores MCP. /cost es un alias de /usage. /stats también es un alias y abre la pestaña Stats.

/usage
/cost
/stats

Estos comandos no responden a la misma pregunta que /context. El uso informa sobre consumo y límites; el contexto indica qué ocupa ahora el área de trabajo del modelo. Compactar o limpiar una conversación no revierte el consumo ya realizado.

Define el presupuesto de contexto antes de empezar

No abras una tarea grande con «lee todo el repositorio y arréglalo». Entrega un resumen corto con objetivo, alcance, exclusiones, criterio de finalización y comandos de verificación. Así, las primeras lecturas tienen intención y la compactación posterior dispone de una estructura estable.

## Resumen de la tarea
- Objetivo: corregir el bucle de redirección de sesiones caducadas.
- Incluye: src/auth/ y tests/auth/session.test.ts
- Excluye: rediseño de interfaz y migración del proveedor de identidad
- Terminado cuando: una sesión caducada redirige una sola vez a /login y pasa la prueba de regresión
- Verificar con: npm test -- tests/auth/session.test.ts
- Requiere aprobación humana: cambiar la duración de la cookie o el comportamiento de la API pública

Busca de forma limitada antes de cargar archivos. Estos comandos se pueden pegar en una terminal y adaptar al repositorio:

rg -n "expired session|redirect loop|set-cookie" src tests
git diff --stat
git status --short
npm test -- tests/auth/session.test.ts

El orden importa. rg localiza los archivos probables; git diff --stat y git status muestran trabajo existente que no debe sobrescribirse; la prueba enfocada define una meta medible. Claude recibe pocos artefactos relevantes en lugar de una instantánea completa del repositorio.

Deja un recibo antes de compactar

Antes de /compact, /clear o de transferir la tarea a otra sesión, escribe un recibo breve. No es una copia del chat, sino el estado mínimo necesario para continuar sin repetir el diagnóstico.

## Recibo de entrega
- Objetivo:
- Diagnóstico actual:
- Decisiones ya aceptadas:
- Archivos modificados:
- Comandos ejecutados y resultados:
- Cambios del usuario sin commit que deben conservarse:
- Riesgo pendiente:
- Siguiente paso:

Guárdalo en un documento del proyecto cuando deba compartirse o pega la versión completada como instrucción de enfoque para /compact. Registra resultados, no todo el log. «La prueba falla en session.test.ts:84 porque se emiten dos redirecciones» permite continuar; doscientas líneas repetidas de stack trace no.

Qué sobrevive a la compactación

No toda la información se comporta igual después de /compact. El resultado depende de cómo entró cada instrucción en el contexto:

Mecanismo	Comportamiento después de /compact
Prompt del sistema y estilo de salida	Permanecen sin cambios porque no forman parte del historial conversacional
CLAUDE.md de la raíz y reglas sin alcance	Se vuelven a inyectar desde disco
Memoria automática	Se vuelve a inyectar desde disco
Reglas con frontmatter paths:	No reaparecen hasta que Claude lee un archivo coincidente
CLAUDE.md anidado en un subdirectorio	No reaparece hasta leer un archivo de ese subdirectorio
Contenido de skills invocadas	Se vuelve a inyectar dentro de los límites documentados por skill y totales
Hooks	Siguen ejecutándose como código; no son contexto conversacional

La información más frágil es la que solo apareció en el chat. Puede quedar representada en el resumen, pero se pueden perder detalles. Si Claude debe respetar siempre una regla, colócala en el CLAUDE.md de la raíz o en otro archivo persistente adecuado. Si solo se aplica a un directorio, mantenla acotada y recuerda que volverá a cargarse cuando se lea un archivo coincidente.

También puedes orientar la compactación desde CLAUDE.md:

# CLAUDE.md

## Compact instructions
- Preserve the current objective, accepted decisions, and out-of-scope areas.
- Preserve changed files, verification commands, test results, and blockers.
- Keep only log lines that explain the root cause.
- Preserve uncommitted user changes and the next safe action.

Mantén este bloque corto. CLAUDE.md consume contexto al inicio de cada conversación; convertirlo en un manual completo recrea el problema que pretendía resolver.

Qué decide la persona y qué puede hacer el agente

Claude puede buscar, resumir, probar y proponer. Una persona sigue siendo responsable de las decisiones cuyas consecuencias no pueden deducirse con seguridad del repositorio.

Claude Code puede asumir	Una persona debe decidir
Localizar archivos relevantes y reducir un log a la causa principal	Objetivo de negocio y compromisos aceptables
Informar de presión de contexto y sugerir una compactación	Si dos tareas están realmente relacionadas
Redactar un recibo basado en trabajo observado	Operaciones destructivas, credenciales y cambios en producción
Ejecutar verificaciones previamente acordadas	Cambios en seguridad, comportamiento público o retención de datos
Actualizar una regla documentada después de una aprobación explícita	Resolver requisitos contradictorios entre responsables

No pidas al agente que decida qué información no puede perderse y dejes esa decisión dentro de la misma conversación saturada. La persona identifica las restricciones duraderas; el agente las registra en la ubicación acordada y comprueba que se cargan.

Cuatro casos de uso prácticos

Caso 1: refactorización de autenticación en varios archivos

Situación: la investigación toca middleware, cookies, pruebas de integración y configuración de despliegue. Leer todo junto dificulta la implementación.

Tarea del agente: mapear el flujo con búsquedas, resumir la documentación y conservar en el contexto principal solo el contrato aceptado, los archivos objetivo y el resultado de la prueba enfocada.

Decisión humana: aprobar cambios en la duración de cookies, cierre de sesión y garantías de compatibilidad, porque son decisiones de producto y seguridad.

Secuencia: empieza con el resumen de tarea, ejecuta /context después del diagnóstico, registra el diseño aceptado y usa /compact focus on the accepted auth contract and regression test antes de editar.

Caso 2: depurar un despliegue fallido

Situación: varios reintentos producen logs casi idénticos y la única línea útil queda enterrada entre instalaciones y advertencias.

Tarea del agente: comparar intentos, aislar el primer error causal, registrar el entorno y el comando exacto que falla, y eliminar las salidas duplicadas del resumen de trabajo.

Decisión humana: aprobar cambios de credenciales, configuración del proveedor o rollback. El agente puede diagnosticar, pero no debe ampliar permisos ni cambiar políticas de producción por su cuenta.

Secuencia: conserva el comando fallido y la línea causal en el recibo. Compacta si el incidente continúa; limpia la conversación solo cuando el despliegue esté verificado o al pasar a otra funcionalidad.

Caso 3: producir y revisar un artículo técnico

Situación: fuentes, reglas editoriales, verificación de código, traducciones y revisión visual saturan rápidamente la conversación de redacción.

Tarea del agente: guardar las fuentes en una nota de investigación, las reglas duraderas en CLAUDE.md y el texto final en MDX. Debe devolver hechos confirmados, verificar código y enlaces y no inventar experiencias ni resultados.

Decisión humana: elegir audiencia, promesa comercial y llamada a la acción principal.

Secuencia: separa investigación y redacción, compacta alrededor del esquema aprobado y registra slug, idiomas, archivos, controles y estado de despliegue.

Caso 4: pasar de un bug a una funcionalidad nueva

Situación: el bug ya está corregido, pero en la misma terminal se solicita una función de panel sin relación.

Tarea del agente: informar del diff final y de las pruebas y proponer un límite limpio entre tareas.

Decisión humana: confirmar que no queda trabajo del bug que pertenezca a la tarea siguiente.

Secuencia: registra la sesión terminada, ejecuta /clear bug-fix-complete y abre la función con un resumen nuevo. Si más tarde necesitas un detalle, usa /resume en vez de arrastrar todo el historial.

Errores frecuentes y cómo corregirlos

Error 1: considerar /compact una memoria perfecta

El resumen es selectivo y una restricción mencionada una sola vez puede desaparecer. Corrección: guarda reglas duraderas en CLAUDE.md o en una especificación y añade decisiones aceptadas al recibo antes de compactar.

Error 2: usar /clear mientras la tarea sigue activa

Al limpiar demasiado pronto se pierde el conjunto de trabajo conversacional y hay que reconstruir el diagnóstico. Corrección: si el objetivo y la prueba de aceptación no han cambiado, compacta con instrucciones de enfoque; limpia cuando exista un límite real.

Error 3: suponer que /memory confirma lo que se cargó

/memory sirve para explorar y editar información persistente. Las reglas por ruta o los archivos anidados pueden no estar activos. Corrección: compruébalo con /context y lee un archivo coincidente si necesitas reactivar una regla acotada tras la compactación.

Error 4: poner controles obligatorios solo en CLAUDE.md

CLAUDE.md ofrece orientación contextual, no una barrera de seguridad rígida. Corrección: usa permisos y hooks para bloquear o validar acciones; reserva CLAUDE.md para convenciones breves del flujo de trabajo.

Error 5: usar la memoria automática como documentación del equipo

La memoria automática es local a la máquina. Se comparte entre worktrees del mismo repositorio, pero no llega automáticamente a otros equipos. Corrección: mueve las convenciones compartidas a CLAUDE.md, reglas o documentación versionada.

Error 6: confundir uso con contexto disponible

/usage puede mostrar coste y límites mientras /context indica una ventana llena o vacía. Corrección: usa /context para decidir si acotar, delegar, compactar o limpiar; usa /usage para vigilar consumo y límites del plan.

Dónde encajan Obsidian y los archivos del proyecto

No todas las notas útiles deben cargarse siempre en Claude. Obsidian encaja mejor con investigaciones extensas, alternativas, actas e ideas futuras. El repositorio es mejor para instrucciones compartidas, especificaciones, entregas y trabajo publicado.

Ubicación	Contenido adecuado
CLAUDE.md del proyecto	Reglas cortas necesarias en la mayoría de sesiones
.claude/rules/	Instrucciones aplicables a un tipo de archivo o ruta
Documentos del proyecto	Decisiones, especificaciones y recibos compartidos
Obsidian	Investigación extensa, hipótesis, fuentes e ideas pendientes
Memoria automática	Preferencias locales y hallazgos recurrentes

Para ampliar esta separación, consulta la guía de buenas prácticas de CLAUDE.md, la guía de optimización de tokens y la integración de Claude Code con Obsidian.

Una rutina sencilla para cada sesión

1. Definir: escribe objetivo, alcance, exclusiones, prueba final y aprobaciones humanas.
2. Acotar: busca primero y carga solo los archivos y resultados necesarios para la siguiente decisión.
3. Inspeccionar: ejecuta /context después de una investigación grande o cuando Claude empiece a repetir trabajo.
4. Registrar: anota decisiones, archivos modificados, verificaciones y siguiente paso.
5. Elegir: usa /compact para la misma tarea, /clear para otra tarea y /resume para volver a un trabajo guardado.

Para reutilizar este proceso sin redactar cada plantilla desde cero, consulta la guía práctica de prompts para Claude Code.

Referencias oficiales

• Explorar la ventana de contexto
• Referencia de comandos
• Cómo recuerda Claude tu proyecto
• Gestionar sesiones

Lo que verificamos

Para esta revisión contrastamos los nombres de los comandos y sus alias actuales con la referencia oficial: /cost y /stats redirigen a /usage, y /stats abre la pestaña Stats. También comprobamos en la tabla oficial de la ventana de contexto qué instrucciones se vuelven a inyectar después de una compactación y cuáles esperan hasta que se lea un archivo coincidente. Por último, confirmamos en la documentación de sesiones que /clear inicia una conversación nueva sin borrar la anterior y que el trabajo guardado se puede recuperar con los comandos de reanudación. Los fragmentos de terminal y los recibos de Markdown de este artículo son plantillas listas para copiar; debes adaptar las rutas y las pruebas a tu repositorio.