TL;DR Lee lo que hay detrás del
·. Si dicesingle exchange, no hay nada que resumir:/cleary empieza con menos (archivos más pequeños, menos texto pegado). Si diceautomatic compaction failed, el motivo está escrito ahí mismo. Si es el error a secas en mitad de una sesión larga, actualiza a la 2.1.288 o posterior.
"Prompt is too long" aparece cuando lo que Claude Code envía (la conversación, el system prompt, las herramientas y los adjuntos) no cabe en la ventana de contexto del modelo. Claude Code compacta solo antes de llegar a ese punto, así que ver el error significa que compactar no fue posible o no bastó. Lanzar /compact otra vez no arregla todos esos casos, y el propio mensaje te dice en cuál estás: la parte que importa está detrás del ·.
Resultado, dos de las variantes con el texto que imprime Claude Code 2.1.284 (los números son de ejemplo):
Prompt is too long · the request is ~1048000 tokens (limit 1000000) and this
conversation's own content is most of it. A single-exchange conversation cannot
be compacted; start with less content (smaller files or pasted text).
Context limit reached · /compact or /clear to continue · auto-compact is off · /config to turn it on
La primera te está diciendo que /compact no sirve. La segunda, que sí, y además por qué no se hizo solo.
Qué te dice cada variante
| Lo que ves detrás de "Prompt is too long" o "Context limit reached" | Qué pasó | Qué hacer |
|---|---|---|
· this conversation is a single exchange and cannot be compacted |
Un solo intercambio, y casi todo el peso es system prompt, herramientas o adjuntos | Reduce lo que carga cada petición: adjuntos, MCP, herramientas |
· the request is ~N tokens (limit M) and this conversation's own content is most of it |
Un solo intercambio con un archivo o un pegado enorme | /clear y empieza con menos: el fragmento que importa, no el archivo entero |
· ... but this conversation is only ~S tokens |
Un solo intercambio, y la conversación pesa poco frente al resto | Quita adjuntos o herramientas, o empieza con menos contexto |
· automatic compaction failed: <motivo> |
Claude Code intentó compactar y falló | Lee el motivo, que viene escrito (hasta 300 caracteres) |
Context limit reached · /compact or /clear to continue |
El contexto se llenó y la compactación sigue disponible | /compact, mejor con foco: /compact conserva solo el plan y el diff |
... · auto-compact is off · /config to turn it on |
Tienes el auto-compact desactivado | Actívalo en /config para que no vuelva a pasar |
Context limit reached · /clear to continue |
La compactación está desactivada del todo (DISABLE_COMPACT) |
/clear, o quita esa variable de entorno |
Hay dos mensajes más que salen al lanzar tú /compact, y también te ahorran insistir:
Not enough messages to compact.: la conversación tiene menos de dos mensajes que resumir. Pasa con el contexto lleno cuando lo llenó un único pegado.Conversation too long. Press esc twice to go up a few messages and try again.: el resumen no salió adelante con la conversación entera.EscEscabre el menú de rewind, vuelves unos mensajes atrás y repites.
Por qué antes /compact no lo arreglaba
Parte del problema eran bugs, corregidos en las últimas versiones. Según el changelog:
- 2.1.269: sesiones atascadas para siempre en "Prompt is too long" cuando el auto-compact no tenía ningún intercambio completo que resumir (sobre todo con el Agent SDK y prompts muy grandes).
- 2.1.274: sesiones movidas por hooks (por ejemplo un
/goalactivo) que acababan en el error en vez de compactar al desbordarse otra vez. - 2.1.281: un primer prompt enorme ahora se resume por separado en lugar de quedarse fuera del resumen.
- 2.1.284: si la petición compactada sigue siendo demasiado larga, Claude Code compacta una vez más, conservando menos de lo reciente. Antes el error se quedaba.
- 2.1.288: las conversaciones largas fallaban con el error en vez de auto-compactar cuando la última respuesta había informado de cero tokens de uso.
Si te pasa con una sesión larga normal y el mensaje no trae coletilla, lo primero es la versión.
Cómo salir
1. Lee la coletilla
Lo que hay detrás del · decide todo lo demás. Si no hay nada detrás, es el caso genérico: sigue con el paso 2.
2. Comprueba la versión y actualiza
claude --version
claude update
Por debajo de la 2.1.288 te faltan los arreglos de la lista anterior.
3. Si es un solo intercambio, empieza de nuevo con menos
/clear y vuelve a pedirlo con el fragmento que Claude necesita, no el archivo entero. Si lo que pesa es lo que carga cada petición, cuándo carga Claude Code cada feature te dice qué recortar.
4. Si vuelve después de un /clear, mira qué ocupa la ventana
/context
Si la fila Messages es la más grande, un archivo o una salida de herramienta la está llenando otra vez. Si lo que suman las demás filas es mayor, lo que carga al arrancar te deja sin sitio para trabajar. Cómo leer /context.
Para que no vuelva a pasarte: compacta tú en una pausa natural, con foco, en vez de esperar al límite. Qué se conserva al hacerlo está en qué sobrevive a un /compact; si quieres resumir solo el principio y dejar intacto lo reciente, Summarize up to here; y si sospechas que tu ventana de auto-compact no es la del modelo, quién la decide.
Docs oficiales: Error reference, Prompt is too long