Gestión del contexto

/compact acepta argumentos

Muchos saben que /compact puede comprimir el contexto, pero pocos saben que acepta argumentos para especificar qué conservar:

/compact 保留所有关于数据库 schema 的讨论，以及当前的重构方案

De esta forma, la compresión priorizará el contenido que especificaste, evitando la pérdida de contexto crítico.

Escribe instrucciones de supervivencia de compactación en CLAUDE.md

Añade una sección ## Compact Instructions en tu CLAUDE.md para indicarle a Claude qué debe preservar durante la compactación:

## Compact Instructions
When summarizing, preserve all TypeScript type changes, error patterns encountered, and the current refactoring plan.

Así, incluso la compactación automática no perderá información crítica.

Evita que Claude abandone prematuramente por presupuesto de tokens

Añade esto en tu CLAUDE.md:

Your context window will be automatically compacted as it approaches its limit.
Never stop tasks early due to token budget concerns.
Always complete tasks fully, even if the end of your budget is approaching.

A veces Claude se detiene proactivamente cuando el contexto está casi lleno, diciendo "el contexto está casi lleno". Añadir esto evita que abandone prematuramente.

Protocolo Handoff: traspaso de sesión

Cuando el contexto está casi lleno pero la tarea no ha terminado, pídele a Claude que escriba un documento de traspaso:

把剩余的计划写到 HANDOFF.md 里，说明你尝试了什么、什么有效、什么没效。

Luego abre una nueva sesión y simplemente usa @HANDOFF.md para restaurar el contexto completo. Esto comprime más de 10K tokens de contexto a menos de 2K, mucho más preciso que /compact.

Compacta proactivamente al 70-80%

Un punto fácil de pasar por alto: cuando el contexto se acerca a su límite, Claude activa automáticamente la compactación. Pero cuando la compactación automática ocurre a mitad de una tarea, puede perder información crítica y degradar la calidad de las respuestas posteriores.

Un mejor enfoque es la gestión proactiva: ejecuta /compact manualmente cuando el contexto alcance el 70-80%; funciona mucho mejor que esperar la compactación automática. Ejecuta /clear inmediatamente después de completar una tarea; no dejes que el contexto crezca indefinidamente.

También puedes activar la compactación automática antes mediante una variable de entorno:

{
  "env": {
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50"
  }
}

/context: diagnóstico del contexto

¿No estás seguro de cuánto espacio queda en la ventana de contexto? /context te lo dirá:

• Qué herramientas o servicios MCP consumen más contexto
• Porcentaje de uso de la capacidad actual
• Sugerencias de optimización específicas

He descubierto que a veces solo tener ciertos servicios MCP registrados (sin siquiera usarlos) puede consumir más del 30% de la ventana de contexto. Usa /context para verificar; limpiar los MCP que no uses puede liberar bastante espacio.

Carga diferida automática de herramientas MCP

Cuando las definiciones de herramientas MCP superan el 10% del contexto, Claude Code activa automáticamente Tool Search, cargando un índice de búsqueda ligero en lugar de las definiciones completas de herramientas. Esto reduce el consumo de contexto MCP en más del 85% (por ejemplo, de 77K tokens a 8.7K). Esta función está activada por defecto y no requiere configuración manual.

Ten en cuenta: Tool Search solo es compatible con los modelos Sonnet 4+ y Opus 4+, no con Haiku. Si tu ANTHROPIC_BASE_URL apunta a un proxy no oficial, Tool Search se desactivará automáticamente (porque la mayoría de los proxies no reenvían los bloques tool_reference).

Si deseas personalizar el comportamiento, configúralo en settings.json:

{
  "env": {
    "ENABLE_TOOL_SEARCH": "auto:5"
  }
}

Valores de configuración soportados:

• Sin configurar: Activado por defecto
• true: Forzar activación (incluyendo escenarios de proxy no oficial)
• auto: Se activa cuando el contexto supera el 10% (equivalente al comportamiento predeterminado)
• auto:<N>: Umbral personalizado, por ejemplo, auto:5 significa activar al superar el 5%
• false: Desactivado, todas las herramientas MCP se precargan