Límite de tokens en Bolt: qué hacer si tu proyecto es grande
Por qué Bolt.new dice que tu proyecto es demasiado grande, en qué se diferencian el contexto y los tokens, y cómo achicar el proyecto para seguir avanzando.
Read in English →
Cuando Bolt.new te avisa que el proyecto es demasiado grande, casi siempre significa que ya no cabe en la ventana de contexto del agente: los archivos y la conversación reciente que Bolt lee en cada prompt. Ese límite no es lo mismo que tu saldo de tokens ni que el tope de 100MB para publicar. Se resuelve dándole menos que leer: limpiar el contexto, borrar archivos que no se usan, partir los archivos muy largos y guardar las instrucciones fijas en el conocimiento del proyecto en vez del chat.
Aquí verás qué límite tocaste, por qué un proyecto crece más de la cuenta, los pasos de limpieza en el orden que más rinde y cuándo conviene seguir trabajando fuera de Bolt.
¿Qué límite alcancé?
Hay tres límites con avisos parecidos.
| Lo que ves | Qué significa | Qué hacer primero |
|---|---|---|
| Un aviso de que el prompt es muy largo o el proyecto supera el tamaño admitido | Ventana de contexto: proyecto más chat reciente no caben de una vez | Limpiar el contexto y achicar el proyecto |
| Se acaba tu saldo de tokens, o llegas al tope diario del plan Free | Asignación de tokens: cuánto trabajo del agente incluye tu plan | Esperar el reinicio, cambiar de plan o editar a mano |
Project is too large to deploy. The maximum allowed size is 100MB. | Publicación: el peso total de tus archivos | Sacar imágenes y videos a un almacenamiento externo |
Esta guía trata los dos primeros. El tercero lo vemos en error al publicar Bolt en Netlify.
¿Por qué el proyecto ya no cabe en el contexto?
La documentación de tokens de Bolt explica que la mayor parte del consumo viene de que el agente lee, entiende y sincroniza los archivos del proyecto. El contexto crece con el proyecto, no solo con tus mensajes. Lo que más pesa:
- Archivos larguísimos. Un componente de 2.000 líneas se lee entero cada vez que Bolt lo toca.
- Notas en Markdown que Bolt escribió para sí mismo. Mientras construye puede ir dejando archivos
.md, y los vuelve a leer en cada prompt. - Código muerto. Versiones viejas de componentes, páginas que nadie usa, pruebas abandonadas.
- Un historial de chat eterno. Cada "arréglalo" queda en la conversación.
- Archivos adjuntos y conectores. Lo que subes al chat suma contexto aunque no se guarde en el proyecto.
¿Cómo achico el proyecto para que Bolt siga funcionando?
Sigue este orden; los primeros pasos son rápidos y no cuestan nada.
1. Guarda una copia
Descarga el proyecto (clic en el título y luego Download) o confirma que está sincronizado con GitHub. El historial de versiones de Bolt recupera el código, pero una copia local te deja rescatar un archivo suelto si la limpieza se pasa de la raya.
2. Limpia el contexto
Escribe /clear en el chat y elige Clear context. Bolt conserva tus archivos pero olvida la conversación y lee el código desde cero. Hazlo al terminar una función, no a mitad de camino.
3. Saca las instrucciones fijas del chat
Lo que repites en cada prompt ("usamos el login de Supabase", "no toques la página de precios") va en Project settings > Knowledge o en un archivo agents.md, que Bolt detecta solo. El conocimiento sobrevive a un /clear; el chat no.
4. Borra lo que la app ya no usa
Pídele a Bolt: Remove any unused files and components from this project. Para las notas que dejó: Look at the number of .md files in this project and keep only the ones that have necessary project context. Si te manejas con la terminal, la guía de contexto de Bolt sugiere correr esto en la terminal de la vista de código, que no gasta tokens:
npx knip --production --fix --allow-remove-filesAdemás, npx depcheck muestra paquetes instalados que ya nadie importa y npm dedupe elimina copias duplicadas.
5. Parte los archivos más largos
Primero pide la lista sin cambiar nada: List every file over 700 lines with its path and line count, longest first. Don't change anything yet. Después refactoriza un archivo por prompt, dejando el original como enrutador para que no se rompan los imports, y prueba la app después de cada uno.
6. Acota lo que Bolt mira
En la vista de código, clic derecho sobre un archivo y Target file para que Bolt se concentre en él, o Lock file / Lock all para que no lo toque. Un prompt corto y concreto ("cambia el formato de fecha en InvoiceTable.tsx") lee mucho menos que "arregla la página de facturas".
¿Cómo hago rendir mis tokens?
Hay acciones que gastan tokens y otras que no. Según la documentación de Bolt, son gratis:
- Editar el código tú mismo en la vista de código y correr comandos en su terminal.
- Los botones Publish y Update (pedirle a Bolt en el chat que publique sí gasta).
- Volver a una versión anterior desde el historial de versiones.
- El botón Run security audit del menú Publish, en los planes de pago.
Otros ahorros: usa el modo Plan para pensar el problema antes de construir, elige el agente Standard para lo cotidiano y Max solo para refactorizaciones complejas, y deja de presionar Attempt fix después del segundo intento fallido. Mejor pide que agregue registros (logs) en la parte rota, reproduce el error y pega la salida de la consola.
A octubre de 2026, el centro de ayuda de Bolt indica que el plan Free tiene una asignación mensual más un tope diario de 300K tokens, y que en los planes de pago los tokens se reinician en la fecha de renovación y los que sobran se acumulan hasta dos meses mientras la suscripción siga activa. Los planes cambian: revisa tu saldo en My Subscription antes de encarar un cambio grande.
¿Cuándo conviene trabajar fuera de Bolt?
Si después de limpiar el proyecto sigue sin caber, la app simplemente creció más de lo que un agente puede tener en la cabeza de una vez. No es un fracaso, es una etapa. Opciones:
- Usar Bolt para cambios chicos y hacer lo grande en un editor de código. Con GitHub conectado, Bolt trae cada 30 segundos lo que cambies afuera, así que conviven bien mientras no edites en los dos lados al mismo tiempo. Lo explicamos en descargar el código de Bolt y correrlo en local.
- Trabajar con un agente que lee archivos según los necesita, como Cursor o Claude Code, sobre el código descargado. Los comparamos en Claude Code o Cursor sin saber programar.
- Ordenar primero. La lógica duplicada y los archivos gigantes son lo que llena el contexto. En la deuda técnica del vibe coding explicamos cómo distinguir qué vale la pena limpiar.
Respuestas rápidas
¿Limpiar el contexto borra mi código? No. Los archivos quedan igual; Bolt solo olvida la conversación reciente y la historia de cómo cambió el código.
¿Si cambio a un plan más caro se arregla? No por sí solo. Más tokens no hacen el proyecto más chico; lo que lo vuelve a meter en el contexto es la limpieza.
¿Es seguro correr Knip? Borra archivos que considera sin uso, así que descarga una copia antes y prueba la app después. El historial de versiones también te permite volver.
¿Por qué Bolt empeoró a medida que crecía el proyecto? Con el contexto casi lleno, el agente tiene menos margen para razonar y puede perder instrucciones viejas. Repite lo importante o déjalo en el conocimiento del proyecto.
¿Atascado entre un contexto lleno y una app a medias?
Si la limpieza no alcanza, la revisión gratuita te muestra lo que se ve desde afuera, y nuestro servicio para arreglar apps de Bolt empieza con un ingeniero senior que revisa el código y deja por escrito qué arreglar, cada punto con precio cerrado. Si prefieres seguir construyendo con un desarrollador a tu lado, mira los precios o cuéntanos de tu proyecto.
