Claude Code Prompt is too long: qué significa y 6 soluciones fáciles (probadas)

Respuesta corta: Claude Code Prompt is too long significa que la petición supera la ventana de contexto del modelo. La petición no es solo tu conversación: también incluye el prompt de sistema, las definiciones de herramientas y tu CLAUDE.md. En una sesión interactiva lo normal es ver Context limit reached · /compact or /clear to continue. Prueba primero /compact. Si no basta, usa /context para ver qué ocupa la ventana, desactiva los servidores MCP que no uses, recorta CLAUDE.md o haz /clear y vuelve a enviar con menos texto pegado. Si usas un gateway o un modelo que no es de Anthropic, comprueba que Claude Code conoce su ventana real. Probamos las variantes principales en Claude Code 2.1.312 contra una API simulada local; abajo están las salidas. Los textos y soluciones siguen la referencia oficial de errores de Claude Code, revisada el 29 de octubre de 2026.

Qué versión de Claude Code Prompt is too long te salió

El error de la API es Prompt is too long, y así aparece en la salida de -p y en el historial. En la sesión interactiva verás una de estas:

Context limit reached · /compact or /clear to continue
Context limit reached · /compact or /clear to continue · auto-compact is off · /config to turn it on
Prompt is too long · automatic compaction failed: <error de fondo>

La segunda indica que desactivaste la compactación automática. La tercera indica que la compactación falló y te dice por qué. Si la conversación tiene un solo intercambio, no hay nada anterior que resumir, así que Claude Code te dice qué llena la petición: tu propio contenido, o el prompt de sistema, las herramientas y los adjuntos. En Amazon Bedrock el mismo caso aparece como Input is too long for requested model. y se trata igual.

Nuestra prueba: el mismo 400, dos mensajes distintos

Con una clave de prueba no podemos llenar una ventana real de 1M tokens, así que apuntamos Claude Code 2.1.312 a un servidor simulado local con ANTHROPIC_BASE_URL. El simulador siempre responde con el 400 de la API prompt is too long: 215000 tokens > 200000 maximum. Esos números los puso nuestro simulador; no son de un modelo real.

• Pasamos un log de 1.040.001 bytes por tubería a claude -p "summarize this log". Respuesta: Prompt is too long · the request is ~215000 tokens (limit 200000) 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). Es decir, sobra contenido tuyo.
• Con un simple claude -p hi, el mismo 400 dio: Prompt is too long · the request is ~215000 tokens (limit 200000) but this conversation is only ~2464 tokens — the rest is system prompt, tool definitions, and attachment content. A single-exchange conversation cannot be compacted; reduce attached files/tools or start with less context. Aquí la conversación ocupa solo 2464 tokens y el resto lo añade Claude Code.

La segunda mitad del mensaje ya te dice dónde recortar. Un detalle de la prueba: al pasar el log de 1 MB como argumento en lugar de por tubería, la shell devolvió Argument list too long. Ese límite es del sistema, no de Claude Code.

Cómo solucionar Claude Code Prompt is too long

Sigue este orden:

• /compact resume los turnos anteriores y libera espacio. Si responde Not enough messages to compact., la conversación tiene un solo intercambio: haz /clear y vuelve a enviar con menos texto o adjuntos más pequeños.
• /context muestra el reparto entre prompt de sistema, herramientas, archivos de memoria y mensajes. En nuestra instalación limpia marcó Tokens: 2.1k / 1m (0%), con unos 2k de skills integradas. Un proyecto real con varios MCP y un CLAUDE.md largo ocupa bastante más.
• /mcp disable quita de cada petición las herramientas de un servidor MCP que no usas. Si instalaste varios de los mejores MCP para Claude Code, desactiva los que no necesites en este proyecto.
• Recorta CLAUDE.md. Mueve las instrucciones poco usadas a reglas por ruta, que solo se cargan cuando hacen falta.
• Vuelve a activar la compactación automática si la apagaste en /config o con DISABLE_AUTO_COMPACT. Viene activada por defecto y normalmente evita este error.
• Actualiza Claude Code (claude update). La documentación cita casos corregidos: detener a Claude mientras compactaba (corregido en v2.1.304) y, en v2.1.305, este error podía tapar otro 400 o 422 de la API (corregido en v2.1.306).

Gateways y modelos de otros proveedores: indica la ventana real

Cuando Claude Code no reconoce un ID de modelo, supone una ventana de 200K. Lo probamos con ANTHROPIC_MODEL=my-gateway-model y al arrancar apareció este aviso:

Claude Code doesn't recognize the model "my-gateway-model", so it assumes a context window of 200k tokens. Update Claude Code, or see https://code.claude.com/docs/en/model-config#correct-the-window-for-a-gateway-or-custom-model-id to set the window.

/context mostró Tokens: 2.1k / 200k (1%). Tras export CLAUDE_CODE_MAX_CONTEXT_TOKENS=128000 el aviso desapareció y /context pasó a / 128k. Usa el valor que indique tu proveedor; 128000 era solo nuestro valor de prueba. La documentación de configuración de modelos también explica modelOverrides y el sufijo [1m]. Esto aplica si usas otro modelo, como en nuestra guía de Claude Code con DeepSeek.

Casos reales en GitHub

• Issue #103279: en la extensión de VS Code 2.1.301 con un modelo de 1M de contexto, dos sesiones largas nunca se compactaron solas, llegaron a unos 976.000 tokens y desde ahí cada turno falló con Prompt is too long hasta hacer /clear. Sesiones anteriores en la misma máquina se habían compactado entre unos 967.000 y 971.000 tokens. Sigue abierto.
• Issue #101897: con un modelo autoalojado de 262.144 tokens de ventana, el error «maximum context length» en formato OpenAI no activó la compactación tras actualizar a 2.1.296. Según quien lo reporta, volver a 2.1.269 lo resolvió.

Para otros fallos, consulta nuestra guía de errores de Claude Code.

Preguntas frecuentes

¿Claude Code Prompt is too long es lo mismo que agotar la cuota?

No. Este error mide el tamaño de una sola petición. La cuota mide tu uso en 5 horas o en la semana; lo explicamos en cuota de Claude.

¿Qué hago si /compact dice Not enough messages to compact?

La conversación tiene un solo intercambio y no hay nada que resumir. Haz /clear y envía algo más pequeño.

¿Request too large (max 32MB) es el mismo error?

No. Ese se refiere al tamaño bruto de la petición, por encima de 32MB, normalmente por mucho texto pegado, resultados de herramientas o adjuntos. Prompt is too long se mide en tokens.

¿Un plan superior lo arregla?

No por sí solo. El límite es la ventana de contexto del modelo. Lo que ayuda es compactar, recortar contexto o elegir un modelo con ventana mayor.