# Ventana de contexto de Claude Code: guía práctica

URL: https://agentvera.dev/es/blog/claude-code-context-window/ · Publicado: 2026-10-23

Gestiona la ventana de contexto de Claude Code: qué la llena, cómo funcionan /context, /compact y /clear, el tamaño de CLAUDE.md, subagentes, coste de MCP y context rot.

**En resumen:**

- El contexto de Claude Code contiene el system prompt, los nombres de las herramientas, CLAUDE.md, cada mensaje, cada archivo leído y cada salida de comandos, y el rendimiento del modelo se degrada a medida que se llena.
- Ejecuta /context para ver qué lo ocupa, /compact con un foco para resumir una sesión larga sobre la misma tarea y /clear cuando cambies a un trabajo sin relación.
- Mantén CLAUDE.md por debajo de unas 200 líneas, pasa las instrucciones específicas de una tarea a skills y envía la investigación pesada a subagentes para que solo vuelva un resumen.

La ventana de contexto de Claude Code es todo lo que el modelo ve en un turno dado: el system prompt, los nombres de las herramientas, tu CLAUDE.md, cada mensaje, cada archivo que Claude leyó y cada salida de comandos de la sesión. Para gestionarla, comprueba qué contiene con `/context`, compacta las sesiones largas con `/compact` (o deja que lo haga el auto-compact), empieza el trabajo sin relación con `/clear`, mantén CLAUDE.md corto y envía la investigación pesada a subagentes para que solo vuelva su resumen. El resto de esta guía muestra cómo funciona cada una de estas cosas y cuándo recurrir a ella.

## Qué llena la ventana de contexto

Una [ventana de contexto](/es/glossary/context-window/ "Ventana de contexto") se mide en [tokens](/es/glossary/token/ "Token"), y en Claude Code se llena desde dos direcciones: lo que se carga antes de que escribas nada y lo que la sesión va acumulando mientras trabaja.

### Cargado al inicio

Según la documentación de Claude Code, esto está en el contexto antes de tu primer prompt:

- El system prompt y las herramientas integradas.
- Los archivos CLAUDE.md (del proyecto, del usuario y de cualquier carpeta superior) y la memoria automática. AGENTS.md puede cargarse en lugar de CLAUDE.md.
- Los nombres de las herramientas MCP y las instrucciones del servidor. Las definiciones completas de las herramientas se difieren por defecto y se cargan cuando se usa una herramienta.
- Las descripciones de las skills. El cuerpo de una skill solo se carga cuando se invoca.

Medimos esta base en [nuestro artículo sobre el uso de tokens](/es/blog/claude-code-token-usage/ "Reduce el uso de tokens de Claude Code un 61%"): unos 34,4k tokens en la primera petición con una configuración estándar, bajando a unos 13,3k con una ligera. Esa base se reenvía en cada turno.

### Añadido durante la sesión

De aquí viene la mayor parte del crecimiento:

| Fuente | Por qué crece rápido |
| --- | --- |
| Lecturas de archivos | Un archivo grande leído entero puede costar miles de tokens, y releerlo cuesta lo mismo otra vez |
| Salida de comandos | Las ejecuciones de tests, las compilaciones y los logs suelen ser largos y casi todo ruido |
| Tus mensajes y las respuestas de Claude | Cada turno permanece en el historial |
| Resultados de herramientas de servidores MCP | El resultado de una búsqueda o consulta entra en el contexto completo |
| Intentos fallidos | Los enfoques equivocados y tus correcciones se quedan hasta que limpias o compactas |

Una sola sesión de depuración o de exploración del código puede producir decenas de miles de tokens. Eso importa porque, como dice la documentación de Claude Code, el rendimiento de los LLM se degrada a medida que el contexto se llena: Claude puede empezar a olvidar instrucciones anteriores o a cometer más errores.

## ¿Qué tamaño tiene la ventana?

Depende del modelo. La documentación de configuración de modelos de Claude Code indica una ventana de contexto de 1M de tokens para los modelos recientes (los modelos Fable, Sonnet 5 y posteriores, Haiku 5.5 y Opus 4.7 y posteriores la usan por defecto). Opus 4.6 y Sonnet 4.6 llegan a 1M solo con su variante `[1m]`; si no, trabajan con un límite de 200K.

Una ventana más grande te da margen, no inmunidad. Una sesión con 600k tokens de exploración antigua sigue siendo más lenta, más cara por turno y más ruidosa que una que lleva solo lo que necesita la tarea actual.

## Lee el medidor: /context

Antes de cambiar nada, mira. `/context` muestra un desglose en vivo de lo que usa la ventana, agrupado por categorías, con sugerencias. También lista qué archivos CLAUDE.md y de memoria se cargaron, que es la forma más rápida de encontrar un archivo de instrucciones olvidado en una carpeta superior.

```text
/context
```

Algunos comandos relacionados ayudan aquí:

- `/memory` abre los archivos de memoria cargados para que puedas editarlos.
- `/mcp` lista los servidores conectados y te permite desactivar los que no uses.
- `/usage` muestra el uso de tokens de la sesión, incluida una línea del caché de prompts.

También puedes poner el uso de contexto en una línea de estado personalizada para verlo sin preguntar.

## Compactar: /compact y auto-compact

`/compact` sustituye la conversación hasta ahora por un resumen y sigue en la misma sesión. Claude Code también lo hace por su cuenta cuando te acercas al límite; eso es el auto-compact.

### Dirige el resumen

Un `/compact` a secas deja que Claude decida qué conservar. Obtienes mejores resultados si se lo indicas:

```text
/compact Focus on the API changes and the list of files we modified
```

Puedes hacerlo permanente con una sección `# Compact instructions` en CLAUDE.md, por ejemplo: «When compacting, always preserve the full list of modified files and any test commands».

Para compactar solo una parte de la conversación, pulsa `Esc` dos veces o ejecuta `/rewind`, elige un mensaje y selecciona **Summarize from here** o **Summarize up to here**.

### Fija cuándo se ejecuta el auto-compact

Por defecto, Claude Code compacta cuando la conversación llega al límite de contexto del modelo; los modelos que funcionan con una ventana nativa de 1M compactan un poco antes, hacia los 967K tokens. Si prefieres compactar antes, fija tu propia ventana:

```text
/autocompact 500k
/autocompact auto
```

El primero guarda una ventana de 500k para el modelo actual; el segundo vuelve al valor por defecto. El mismo ajuste existe como `autoCompactWindow` en `settings.json` y como variable de entorno `CLAUDE_CODE_AUTO_COMPACT_WINDOW` para scripts. Se aceptan valores de 100K a 1M.

### Qué sobrevive a la compactación

La documentación lista lo que se vuelve a poner tras un compact: el system prompt, el CLAUDE.md de la raíz del proyecto, las reglas sin ámbito, la memoria automática y el plan actual del modo plan. Los archivos modificados recientemente se releen, y los CLAUDE.md anidados y las reglas con ámbito de ruta se recargan cuando Claude vuelve a trabajar en esas carpetas. Lo que no sobrevive literalmente es la conversación en sí, así que una instrucción que solo escribiste en el chat puede perder detalle. Si importa, ponla en CLAUDE.md.

Un coste que conviene tener presente: `/compact` lee toda la conversación para resumirla, así que el propio compact es una petición grande.

## Empezar de cero: /clear

`/clear` vacía la conversación y no cuesta nada. Úsalo cuando pases a un trabajo sin relación. Las buenas prácticas de Claude Code mencionan dos patrones de fallo que arregla:

- **La sesión cajón de sastre.** Empiezas una tarea, preguntas algo sin relación y luego vuelves. El contexto está lleno de material irrelevante.
- **Corregir una y otra vez.** Tras dos correcciones fallidas sobre el mismo problema, el contexto está contaminado con enfoques fallidos. Limpia y escribe un primer prompt mejor que incluya lo que has aprendido.

Si quizá quieras recuperar la sesión, ponle nombre primero con `/rename` y luego `/clear`; `/resume` la devuelve más tarde. Para una pregunta rápida que no necesita quedarse en el historial, `/btw` responde sin añadirla a la conversación.

| Situación | Recurre a | Por qué |
| --- | --- | --- |
| Misma tarea, historial largo | `/compact <focus>` | Mantiene el hilo, elimina el grueso |
| Solo la parte inicial está obsoleta | `/rewind` → Summarize up to here | Conserva íntegros los turnos recientes |
| Cambio a un trabajo sin relación | `/clear` | Gratis, y no arrastra nada irrelevante |
| Dos correcciones no funcionaron | `/clear` + mejor prompt | Los intentos fallidos confunden a los siguientes |
| Pregunta puntual | `/btw` | Nunca entra en el historial |

## Mantén CLAUDE.md pequeño

CLAUDE.md se carga en cada sesión, así que cada línea se paga en cada turno. La documentación de Claude Code sugiere mantenerlo por debajo de unas 200 líneas y preguntarse, para cada línea, si quitarla causaría errores. Si no, córtala. Un archivo hinchado tiene un segundo coste además de los tokens: las reglas importantes se pierden en el ruido y Claude las ignora.

Qué hacer con el resto:

- Pasa las instrucciones específicas de un flujo (cómo publicar una versión, cómo escribir una migración) a skills. Solo sus descripciones cortas se cargan al inicio; el cuerpo se carga cuando se usa la skill.
- Enlaza a documentación detallada en lugar de pegarla.
- Borra todo lo que Claude ya hace bien sin que se lo digan, o conviértelo en un hook si debe ocurrir siempre.

Profundizamos en la estructura en [la guía de CLAUDE.md y AGENTS.md](/es/blog/claude-md-agents-md/ "Buenas prácticas de CLAUDE.md").

## Usa subagentes para mantener limpio el contexto principal

La investigación es el clásico asesino del contexto: para responder «¿cómo gestiona nuestra autenticación la renovación de tokens?», Claude puede leer veinte archivos. Un [subagente](/es/glossary/subagent/ "Subagente") se ejecuta en su propia ventana de contexto, hace esa lectura allí y devuelve solo un resumen a tu sesión principal.

```text
Use subagents to investigate how our authentication system handles token
refresh, and whether we have any existing OAuth utilities I should reuse.
```

Buenos candidatos para un subagente:

- Exploración del código antes de un cambio.
- Leer logs largos o la salida de tests para encontrar el único fallo que importa.
- Una revisión del diff en un contexto limpio, que además evita el sesgo hacia el código que la sesión principal acaba de escribir.

Los subagentes no son gratis. Gastan sus propios tokens, y la documentación de Claude Code señala que los equipos de agentes usan aproximadamente 7 veces más tokens que una sola sesión. La ventaja es calidad y foco en el hilo principal, no siempre una factura menor.

## Lo que cuestan los servidores MCP

El [Model Context Protocol](/es/blog/what-is-mcp-server/ "¿Qué es un servidor MCP?") solía ser uno de los mayores costes de arranque, porque se cargaba de entrada cada definición de herramienta de cada servidor. Claude Code ahora difiere por defecto las definiciones de herramientas (tool search), así que hasta que se usa una herramienta, solo su nombre y las instrucciones del servidor están en el contexto.

Eso cambia el consejo, pero no lo elimina:

- Desactiva con `/mcp` los servidores que no uses en este proyecto.
- Prefiere herramientas CLI como `gh`, `aws`, `gcloud` o `sentry-cli` cuando existan. La documentación las llama la forma más eficiente en contexto de llegar a servicios externos.
- Vigila los resultados de las herramientas, no solo las definiciones. Una consulta de base de datos o una instantánea de página devuelta por una herramienta MCP entra en el contexto completa.

## Señales de context rot

«Context rot» es el nombre informal de una sesión que ha empeorado en silencio porque su contexto está demasiado lleno o es demasiado ruidoso. Señales típicas:

- Claude olvida una regla que indicaste antes en la conversación, o una de CLAUDE.md.
- Vuelve a leer archivos que ya leyó, o pregunta por cosas que ya sabe.
- Repite un enfoque que ya rechazaste.
- Las respuestas se vuelven más vagas y las ediciones tocan el lugar equivocado.
- Cada turno parece más lento y el contador de tokens sube más rápido.

Cuando veas dos o más de estas, ejecuta `/context`. Si el grueso es la conversación, compacta con un foco; si la sesión ha divagado entre tareas, limpia. Ten en cuenta también que tras una pausa inactiva el caché de prompts caduca, así que el siguiente mensaje reprocesa todo el contexto a precio completo. Una sesión grande y mucho tiempo inactiva es un buen momento para compactar o limpiar antes de continuar.

## Hábitos que mantienen sanas las sesiones

- **Una tarea por sesión.** Ponle nombre, termínala, limpia.
- **Señala, no explores.** Referencia archivos con `@path` y nombra funciones en lugar de pedirle a Claude que «eche un vistazo».
- **Acota las investigaciones.** «Find where rate limits are enforced in `src/api`» es mejor que «investigate rate limiting». O pásalo a un subagente.
- **Recorta la salida de comandos.** Ejecuta tests individuales en lugar de toda la suite y filtra los logs antes de que Claude los lea.
- **Compacta con un foco, y pronto.** Un compact dirigido por ti, antes de que la ventana esté casi llena, suele conservar mejor los detalles correctos que uno automático en el límite.
- **Revisa CLAUDE.md como código.** Pódalo cuando Claude empiece a ignorar reglas.

## Dónde encaja AgentVera

AgentVera ejecuta Claude Code, Codex y otros agentes CLI lado a lado en una sola app de escritorio. No sustituye los hábitos anteriores, pero te quita parte del trabajo de contabilidad cuando ejecutas varios agentes a la vez. Todo esto está en la [página de ahorro de tokens](/es/features/token-savings/ "Ahorro de tokens"):

- **Tamaño del contexto en vivo en el panel** de cada agente, medido a partir del propio historial de la CLI, así que funciona más allá de Claude Code y Codex.
- **Auto-compact activado por defecto** con un umbral de 150k tokens, usando el comando propio de cada CLI (`/compact`, `/compress`, `/summarize`, `/smol`). Cámbialo en Settings → Token savings.
- **Perfiles de contexto** (Standard, Balanced, Lean) que reducen la base de arranque por agente.
- **Un guardián de lecturas**, además de [herramientas inteligentes](/es/features/smart-tools/ "Herramientas inteligentes") para Claude Code, que rechazan una relectura de un archivo sin cambios y entregan antes al agente un esquema de un archivo grande.
- **Un [mapa del proyecto](/es/features/project-map/ "Mapa del proyecto")** para que los agentes encuentren los archivos relevantes sin leerlos uno a uno.
- **El [gestor de MCP](/es/features/mcp-manager/ "Gestor de MCP")**, cuya prueba de conexión muestra un coste aproximado en tokens por herramienta.

Sigue valiendo la pena aprender `/context`, `/compact` y `/clear` por tu cuenta. Funcionan igual con o sin AgentVera.

## Preguntas frecuentes

**¿Cómo veo qué hay en la ventana de contexto de Claude Code?** Ejecuta /context. Muestra un desglose en vivo por categorías, como system prompt, herramientas, MCP, archivos de memoria y mensajes, junto con sugerencias, y lista qué archivos CLAUDE.md y de memoria se cargaron.

**¿Cuál es la diferencia entre /compact y /clear?** /compact sustituye la conversación por un resumen y sigue trabajando en la misma sesión. /clear empieza con una conversación vacía. Usa /compact cuando sigues en la misma tarea y /clear cuando cambias a un trabajo sin relación.

**¿Cuándo se ejecuta el auto-compact?** Por defecto, Claude Code compacta cuando la conversación se acerca al límite de contexto del modelo. Puedes fijar tu propia ventana con /autocompact, por ejemplo /autocompact 500k, y volver al valor por defecto con /autocompact auto.

**¿Cuánto debe medir CLAUDE.md?** La documentación de Claude Code sugiere mantenerlo por debajo de unas 200 líneas. Se carga en cada sesión, así que pasa a skills las instrucciones que solo importan para algunas tareas, porque se cargan bajo demanda.

**¿Los servidores MCP llenan la ventana de contexto?** Menos que antes. Las definiciones de herramientas se difieren por defecto, así que solo se cargan los nombres de las herramientas y las instrucciones del servidor hasta que se usa una herramienta. Los servidores sin uso siguen sumando algo de peso, así que desactiva los que no necesites con /mcp.

---

**Sobre AgentVera.** AgentVera es una app de escritorio para macOS, Windows y Linux, desarrollada por Solviera Teknoloji. Ejecuta 18 agentes de programación con IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) en paralelo, por proyecto, en terminales reales con las instalaciones y sesiones de CLI del propio usuario. El plan gratuito tiene agentes ilimitados. Descargar: https://agentvera.dev/es/download/ · Precios: https://agentvera.dev/es/pricing/