Índice
El error Prompt is too long de Claude Code indica que la entrada enviada supera el límite de la ventana de contexto. En la interfaz interactiva, la forma básica es una línea que empieza por Context limit reached, mientras que las formas largas que añaden la causa se muestran como Prompt is too long ·. La segunda mitad del mensaje cambia según la situación, y ahí se indica el siguiente paso. Compara el texto de tu pantalla con esta lista.
# Interfaz interactiva (normal)
Context limit reached · /compact or /clear to continue
# Interfaz interactiva (con la compactación automática desactivada)
Context limit reached · /compact or /clear to continue · auto-compact is off · /config to turn it on
# Interfaz interactiva (con la compactación desactivada por completo mediante DISABLE_COMPACT)
Context limit reached · /clear to continue
# Salida de -p y registro de la conversación
Prompt is too long
# Si la compactación automática falla por otro error
Prompt is too long · automatic compaction failed: <error subyacente>
# Conversación de un solo intercambio, sin historial que resumir
Prompt is too long · this conversation is a single exchange and cannot be compacted — …
Prompt is too long · the request is ~<N> tokens (limit <límite>) … A single-exchange conversation cannot be compacted; …
# A través de Amazon Bedrock
Input is too long for requested model.
# Si falla el propio /compact (sección 4)
Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.
# Cuerpo de la respuesta de la API (cifras de ejemplo)
prompt is too long: 209117 tokens > 200000 maximumLa entrada no incluye solo lo que acabas de escribir: también pueden contribuir el historial, los archivos leídos, los resultados de herramientas y las instrucciones. En el cuerpo de la API, 209117 tokens > 200000 maximum significa que la entrada de 209 117 tokens superó el límite de 200 000. La ventana de contexto abarca tanto la entrada como la salida generada para esta respuesta; este error significa que la entrada por sí sola ya supera el límite. La recuperación es distinta de la de un usage limit alcanzado por agotar la cuota del plan durante un periodo.
Usa /compact si el historial es largo, reduce la entrada si el primer mensaje es demasiado grande y resuelve primero cualquier causa indicada de fallo de compactación. Esas son las vías básicas de recuperación. La compactación automática está activada de forma predeterminada y normalmente evita este error. Cuando aun así aparece, la elección está entre estas tres vías. A partir de la documentación oficial de errores de Claude Code y las especificaciones de la API a 21 de septiembre de 2026, este artículo explica las causas, los pasos de recuperación y las condiciones de 200K y 1M. El uso directo de la API se trata por separado.
El mismo error de longitud puede exigir reducciones diferentes
Durante una conversación larga
Resume el historial anterior. Si la ventana vuelve a llenarse justo después de compactar, divide las lecturas grandes.
Entrada inicial demasiado grande
No hay una conversación anterior que resumir. Reduce primero el texto pegado, los adjuntos, las instrucciones y la carga de las herramientas.
Falla la propia compactación
Resuelve primero la causa indicada, como un fallo de autenticación o un modelo no disponible. Repetir la compactación no basta para corregirla.
Usa /context para ver el desglose de la ventana y /usage para el consumo durante un periodo o las cuotas del plan. Ambos implican tokens, pero miden cosas distintas.
1. Qué significa este error
La ventana de contexto limita cuánta información puede consultar y generar un modelo en una respuesta. Se mide en tokens, no en caracteres, e incluye la entrada, la salida de esta respuesta y los tokens de razonamiento. La entrada leída de la caché de la API sigue ocupando espacio. La caché cambia el precio o el procesamiento; no hace que esa entrada ocupe cero. Consulta la especificación de ventanas de contexto de Anthropic.
Dentro de ese límite, Prompt is too long aparece cuando la entrada enviada ya no cabe por sí sola en la ventana. Incluso una pregunta corta puede formar parte de una solicitud grande si va acompañada de historial o archivos. Por eso, acortar solo la última pregunta puede no ayudar. Para los fundamentos, consulta ¿Qué es una ventana de contexto?
Al acercarse al límite, Claude Code elimina resultados antiguos de herramientas y resume la conversación si hace falta. Si aun así se detiene, es por un texto enorme pegado, por tener desactivada la compactación automática o porque falló la propia compactación. Releer el mismo archivo enorme justo después del resumen también puede volver a llenar la ventana. La segunda mitad del mensaje del principio indica de cuál se trata: con automatic compaction failed:, la causa del fallo aparece a continuación; con single exchange, no hay historial que resumir; y con auto-compact is off, la compactación automática está desactivada.
2. ¿Qué llena la ventana de contexto?
Este desglose sigue la explicación del funcionamiento de Claude Code. El registro guardado de una conversación no es idéntico a lo que se envía actualmente al modelo. Eliminar resultados antiguos de herramientas o resumir modifica el contenido de la ventana activa.
| Componente | Qué entra en la ventana | Qué revisar |
|---|---|---|
| Historial de conversación | Intercambios enviados en la solicitud actual. La compactación sustituye algunas partes por un resumen | /compact para la misma tarea; /clear para otra tarea sin relación |
| Archivos y resultados de herramientas | Contenido de archivos leídos, resultados de búsquedas, salida de comandos y material similar | Acota búsquedas, lee solo las líneas pertinentes o delega la investigación detallada a un subagente |
| MCP | Nombres de herramientas e instrucciones del servidor. Por defecto, Tool Search carga las definiciones detalladas cuando hacen falta | Comprueba la carga real con /context y desactiva servidores no utilizados mediante /mcp |
| CLAUDE.md y memoria | Instrucciones aplicables y memoria cargada. No todos los archivos de memoria automática están siempre presentes | Mantén breves las reglas permanentes y separa las explicaciones que solo requieren tareas concretas |
| Skills | Normalmente, descripciones al inicio y cuerpos al utilizarlas. Los ajustes también pueden aplazar las descripciones | Revisa candidatas innecesarias para invocación automática y cuerpos de skills demasiado largos |
| Instrucciones del sistema | Instrucciones de funcionamiento aportadas por Claude Code o el entorno de conexión | Empieza por las instrucciones, los adjuntos y las herramientas que controlas |
Por defecto, Tool Search carga las definiciones de herramientas MCP en el momento en que se necesitan. Al iniciar la sesión solo se cargan los nombres de las herramientas y las descripciones de los servidores, así que añadir servidores apenas afecta a la ventana. Las definiciones se cargan desde el principio si, por ejemplo, se establece ENABLE_TOOL_SEARCH=false, se especifica alwaysLoad en un servidor o se establece CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS, entre otros casos. Si usas una pasarela con ANTHROPIC_BASE_URL, desde la v2.1.304 Tool Search también está activo por defecto (todas las condiciones, en la tabla oficial de configuración de Tool Search). Mide la carga real con /context, no por el número de servidores.
Los subagentes investigan en una ventana independiente y pueden devolver resultados sin incorporar toda la salida intermedia de herramientas a la conversación principal. Sin embargo, el resumen o las conclusiones devueltos sí ocupan la ventana principal. Pedirles que reproduzcan toda la investigación reduce la ventaja. Especifica la salida necesaria, por ejemplo: «Devuelve solo archivos y líneas relevantes, conclusiones y preguntas sin resolver». Además, los subagentes heredan todas las definiciones de herramientas MCP de la sesión principal, por lo que la documentación oficial de errores recomienda desactivar los servidores MCP que no uses antes de iniciar subagentes. Los principios de diseño se explican en ingeniería de contexto.
Usa /context para la ocupación de la ventana actual y /usage para el consumo de tokens y el uso del plan. El coste que muestra este último es una estimación, no una factura definitiva. En entornos compatibles, /skill-doctor también permite examinar la carga de las skills. Si no lo encuentras, empieza por /context. Consulta los pasos de medición en ¿Qué está consumiendo tu contexto? y las condiciones de disponibilidad en la lista oficial de comandos.
3. Tamaños de contexto: 200K y 1M
200K significa 200 000 tokens; 1M, un millón. No obstante, la capacidad del modelo, la que Claude Code utiliza para tu conexión, el umbral de compactación automática y las condiciones de precio son cifras distintas. El modelo y la cuenta actuales se ven con /status, y las opciones disponibles, con /model.
Separa la capacidad de las condiciones de uso
Modelos como Sonnet 4.5. Claude Code también puede tratar un modelo compatible con 1M como de 200K debido a la conexión o a un ajuste que desactive 1M.
En la API de Anthropic figuran la familia Fable, Sonnet 5 o posterior y Opus 4.7 o posterior. Algunos usan 1M por defecto; no siempre es necesario añadir [1m].
Fuente: configuración de modelos y contexto ampliado de Anthropic. El momento en que comienza la compactación automática depende de los ajustes y del modelo.
En las suscripciones, los créditos de uso solo entran en juego con Opus 4.6 y Sonnet 4.6, que llegan a 1M mediante su variante [1m]. Opus 4.6 con 1M está incluido en Max, Team y Enterprise, pero en Pro requiere créditos de uso; Sonnet 4.6 con 1M requiere créditos de uso en todas las suscripciones. La familia Fable, Sonnet 5 o posterior (incluido el Sonnet 5.5 actual) y Opus 4.7 o posterior conectados directamente a la API de Anthropic se tratan de otra manera: 1M es el valor predeterminado en todos los planes, incluido Pro, sin créditos de uso adicionales ni selección de [1m]. Las pasarelas y los ajustes que desactivan 1M introducen excepciones; no decidas solo por el nombre del modelo.
«Precio estándar» para 1M significa que superar 200K no añade un recargo por token debido al contexto largo. No significa entrada adicional ilimitada por el mismo precio total. Procesar más tokens aumenta el consumo. Que 1M esté incluido en tu plan o se facture mediante créditos es otra cuestión distinta.
La relación entre caracteres y tokens también depende del modelo y del contenido. En lugar de suponer que cada modelo nuevo añade un porcentaje fijo, utiliza el recuento de tokens del modelo de destino al trabajar con la API. Algunas tareas requieren más ventana, pero eliminar primero registros irrelevantes e instrucciones duplicadas facilita valorar la capacidad necesaria.
4. Cómo recuperarse ahora
Elige la recuperación según lo ocurrido: un historial que crece o un archivo grande añadido a la entrada. Las siguientes opciones están ordenadas por prioridad.
Pasos para liberar espacio en la ventana
/compact Céntrate en el fallo de autenticación. Así reduces la carga conservando el contexto./context; después, desactiva servidores MCP innecesarios y acorta CLAUDE.md. Separa los procedimientos detallados para leerlos solo cuando hagan falta./model para seleccionar un modelo con contexto 1M. Haz primero la limpieza de los pasos 1–4. No desactives la compactación automática; conserva su activación predeterminada.Usa 1 para un historial largo y 2 para una tarea nueva sin relación. Ante una entrada inicial demasiado grande, usa 3 y 4. Si se indica una causa del fallo de compactación, corrígela primero.
Si /compact falla con Error during compaction: Conversation too long, es que no queda espacio suficiente para el resumen generado. Con el cuadro de entrada vacío, pulsa Esc dos veces (o usa /rewind) para abrir el menú de rebobinado y elige un mensaje anterior a la entrada grande para rebobinar la conversación. Para rebobinar solo la conversación y dejar el código como está, elige Restore conversation. Después, vuelve a compactar; si sigue sin haber suficiente espacio, usa /clear y empieza con una entrada menor. La conversación anterior queda guardada y puedes volver a abrirla con /resume. Las opciones del menú se describen en la explicación oficial del rebobinado.
En cambio, si a automatic compaction failed: le sigue un fallo de autenticación o un modelo no disponible, resuelve esa causa antes de intentar liberar la ventana. Hasta entonces, /compact también fallará con el mismo error. Si /compact responde Not enough messages to compact., la conversación es de un solo intercambio y no hay nada anterior que resumir. Ejecuta /clear y vuelve a enviar con menos texto pegado o adjuntos más pequeños. Si la ventana se llena justo después de compactar, limita los registros o archivos grandes recientes a las partes necesarias.
Si llamas directamente a la API
/compact y /clear son operaciones de Claude Code, no comandos de control enviados a la Messages API. Si la entrada por sí sola supera la ventana, la API devuelve un error 400 invalid_request_error («prompt is too long»). Revisa los messages, system, tools y adjuntos que envías, y estima la entrada con la API de recuento de tokens del modelo de destino. Reduce la propia solicitud: resume historial antiguo, limita documentos a las secciones relevantes o elimina definiciones innecesarias. Evita recortes que rompan la correspondencia entre llamadas a herramientas y resultados. También existe compactación del lado de la API para conversaciones largas, pero sus modelos compatibles y ajustes son independientes de los comandos de Claude Code.
Tras recuperarte, comprueba que una solicitud pequeña obtenga respuesta y reincorpora gradualmente la información necesaria. Reenviar la misma entrada enorme y esperar no aumenta la capacidad. Para la limpieza habitual, consulta cómo ahorrar tokens en Claude Code.
5. Distinguir errores parecidos
Una entrada excesiva, un límite de salida configurado, alcanzar la ventana durante la generación y el consumo durante un periodo son problemas diferentes. Distínguelos por el texto del error o el stop_reason de la API, no porque la respuesta parezca cortada.
| Síntoma | Significado | Respuesta principal |
|---|---|---|
| Prompt is too long / Context limit reached / N tokens > M maximum | Tema de este artículo: la entrada supera la ventana de contexto | /compact, /clear, delegar lecturas grandes a un subagente o usar un modelo 1M |
| La respuesta termina antes (stop_reason: max_tokens) | La salida alcanzó el ajuste max_tokens de la solicitud | En la API, revisar el ajuste de salida y el límite del modelo; o pedir que continúe |
| stop_reason: model_context_window_exceeded | La entrada más la salida alcanzó el límite de la ventana durante la generación | Reducir la entrada para dejar espacio a la salida |
| usage limit reached | Se agotó la cuota de uso del plan, algo independiente de la ventana de tokens | Esperar al restablecimiento; consulta cómo gestionar los límites de uso |
| Usage credits required for 1M context | Problema de acceso: el contexto 1M elegido no está incluido en tu plan; no es un exceso de entrada ni una cuota agotada | Activar créditos y reiniciar, o usar /model para volver a la ventana estándar |
Según la especificación de la API de Anthropic, Claude 4.5 y posteriores aceptan una solicitud si la entrada por sí sola cabe, aunque la entrada más el max_tokens solicitado supere la ventana. Alcanzar el límite durante la generación produce model_context_window_exceeded, así que una respuesta corta no demuestra por sí sola que se detuviera por max_tokens. Para otros problemas, consulta los errores habituales de Claude Code.
Relacionado: el síntoma de la aplicación Codex en el que el historial se ve pero falla el envío no es un problema de tamaño de entrada, sino del estado de la conversación, y se trata en Codex «thread not found»: pasos de diagnóstico y un caso de recuperación.
6. Lista de prevención
Antes de trabajar: inspecciona lo cargado con /context. Acota los documentos grandes con búsquedas o rangos de líneas en lugar de pegarlos completos. Al repartir la investigación, especifica también el alcance de las conclusiones que debe devolver el subagente.
Durante el trabajo: deja activada la compactación automática, como viene por defecto. Si la línea del error muestra auto-compact is off, vuelve a activarla en /config. Si la desactivaste con la variable de entorno DISABLE_AUTO_COMPACT, ese aviso no aparece, así que elimina esa configuración. Comprueba también si cada compactación va seguida de releer el mismo material. Compactar manualmente con más frecuencia no siempre es mejor: importan tanto cuándo ejecutar /compact como indicar qué decisiones conservar.
Entre tareas: antes de otra tarea sin relación, guarda la información necesaria en archivos y usa /clear para una conversación nueva. La anterior queda guardada, pero reanudar el mismo historial enorme para recuperarte puede reintroducir la causa. Conserva en las instrucciones permanentes de CLAUDE.md solo las reglas necesarias siempre.
Conexiones personalizadas: si utilizas una pasarela o un ID de modelo personalizado, comprueba que la ventana que asume Claude Code no difiera de la capacidad real de la conexión. Aumentar una cifra en la configuración no amplía la ventana real del modelo. Cómo ajustarla se explica en los ajustes oficiales para modelos personalizados.
Resumen
Prompt is too long significa que no cabe la entrada completa, incluidos historial y adjuntos, no solo la última frase escrita. Elige según la situación: /compact para un historial largo, reducir una entrada inicial excesiva o resolver la causa de un error de compactación.
La segunda mitad del mensaje de error (automatic compaction failed:, single exchange, auto-compact is off) indica en qué situación estás. Por defecto, las definiciones detalladas de MCP se cargan bajo demanda, así que mide la carga con /context y no por el número de servidores. Con 1M, la capacidad, el precio y el umbral de compactación automática dependen por separado del modelo, la conexión y el plan. Al usar directamente la API, revisa la solicitud enviada y el motivo de parada en lugar de los comandos de Claude Code.
Preguntas frecuentes
P. ¿«Prompt is too long» y «usage limit reached» son lo mismo?
R. No. El primero significa que la entrada supera el límite de contexto de una solicitud; el segundo se refiere a la cuota de uso del plan. Para una entrada excesiva, reduce lo que envías. /clear no restablece la cuota de tu plan.
P. ¿Por qué ocurre con la compactación automática activada?
R. Las causas son una entrada enorme, la falta de conversación anterior que resumir, un fallo de compactación o que la ventana se llene otra vez justo después de resumir. La segunda mitad del mensaje de error permite distinguirlas. Si tras automatic compaction failed: aparece una causa como un fallo de autenticación, resuélvela primero. Si aparece single exchange, ejecuta /clear y empieza con una entrada más pequeña.
P. /compact también falla con «Conversation too long».
R. No queda espacio suficiente para el resumen. Con el cuadro de entrada vacío, pulsa Esc dos veces para abrir el menú de rebobinado, rebobina la conversación hasta un mensaje anterior a la entrada grande y vuelve a intentarlo. Para conservar el código, elige Restore conversation. Si no libera suficiente espacio, registra lo importante y empieza con una entrada menor después de /clear.
P. ¿Cambiar a un modelo 1M lo solucionará?
R. Puede ayudar si la entrada necesaria cabe en la nueva ventana, pero la disponibilidad depende del modelo, la conexión y el plan. El precio estándar por token de 1M no significa el mismo coste total al procesar más. Reducir primero el historial innecesario y las salidas enormes facilita valorar la capacidad necesaria.
P. ¿Cómo veo qué está ocupando la ventana?
R. En Claude Code, consulta el desglose con /context. Es distinto del consumo acumulado o las cuotas del plan en /usage. Por defecto, las definiciones MCP se cargan bajo demanda, así que el número de conexiones no indica la carga. En la API, estima la solicitud con la API de recuento de tokens del modelo de destino.
