Qué significa el HTTP 429 cuando tu agente de programación con IA choca contra un muro

Pocas cosas detienen el impulso como un agente que se para en mitad de una tarea con un 429 en rojo. Parece un fallo, pero no lo es — es el proveedor diciendo ahora no, y saber exactamente qué significa eso te dice qué hacer a continuación. Los límites de tasa son la fontanería de toda configuración de programación con IA, y los agentes los superan mucho más a menudo que los usuarios de chat, por razones estructurales que conviene entender antes de que seas tú quien esté mirando el error.

Qué dice realmente un 429

HTTP 429 Too Many Requests significa que el servidor recibió y entendió tu solicitud pero se niega a procesarla — se ha superado una cuota. Crucialmente, es temporal por diseño: la respuesta suele incluir una pista Retry-After que indica cuándo volver a intentarlo. Eso lo separa de sus vecinos de la familia de errores. Un 401 o 403 indica autenticación o permisos, que reintentar no arreglará; un 402 apunta a la facturación; un 5xx es problema del propio proveedor. Un 429 es tu problema, y tiene solución.

Por qué los agentes chocan con los límites más que el chat

Un intercambio de chat son una o dos peticiones. Un turno de agente son decenas: leer archivos, buscar, editar, ejecutar tests, reaccionar a la salida — cada paso es una nueva llamada a la API que lleva un contexto cada vez mayor. Hay tres techos distintos que importan: peticiones por minuto, tokens por minuto y conexiones concurrentes. Los agentes suelen agotar primero los tokens por minuto, porque cada sola llamada envía miles de tokens de contexto junto con ella. Los planes de suscripción añaden encima límites de uso justo — cuotas diarias o semanales — y esos pueden aparecer como avisos de uso en lugar de respuestas 429 limpias, lo cual confunde a la gente la primera vez.

Primera respuesta: retrocede correctamente

Respeta el encabezado Retry-After cuando esté presente; si no, reintenta con retroceso exponencial más jitter — espera un segundo, luego dos, luego cuatro, luego ocho. Martillear con reintentos empeora las cosas: las peticiones repetidas pueden alargar las ventanas de limitación, y las tormentas de reintentos manuales desde varios paneles abiertos multiplican un problema pequeño hasta convertirlo en grande. Averigua también qué límite se disparó. La cuota propia de tu cuenta se comporta muy distinto de la congestión del lado del proveedor, y distinguirlas te ahorra una hora culpándote a ti mismo por la hora punta de otro.

Arreglos estructurales: necesitar menos, repartirlo

Los arreglos duraderos reducen la demanda en lugar de esquivarla. Recorta el contexto: señalarle al agente los tres archivos relevantes es mejor que pegar medio repositorio. Ejecuta una tarea larga en lugar de seis sesiones en paralelo cuando estés cerca del techo. Agrupa ediciones relacionadas en un solo turno bien especificado en lugar de gotear instrucciones. Empuja los trabajos masivos nocturnos a horas valle. Divide el pipeline para que un modelo más barato se encargue de los pasos rutinarios y la capacidad premium se reserve para las decisiones. Si ya saltas entre proveedores, una comparación de costes entre agentes de programación también sirve como un mapa aproximado de precios y capacidades, y saber en qué se diferencian Claude, GPT y Gemini para programar te ayuda a elegir un segundo proveedor sensato antes de que lo necesites urgentemente.

Cuando los 429 no paran de ocurrir

Una ráfaga ocasional en horas punta es el clima de un día; un patrón diario persistente es el clima. Si estás chocando con los límites cada día, has superado el plan o al proveedor — aumenta la cuota, pásate a un nivel superior, o enruta algunas cargas de trabajo a otro sitio de forma permanente. Rastrea qué tareas lo activan: si siempre son los trabajos gigantes de refactorización, eso es un problema de tamaño de contexto disfrazado de límite de tasa, y reducir lo que envías arreglará más que mejorar de plan.

El ángulo de meshcode

Como meshcode permite que cada panel apunte a su propio backend, un 429 en un proveedor se convierte en una decisión de enrutamiento en lugar de una parada: mueve la tarea atascada a otro modelo, mantén todo lo demás funcionando, y vuelve a cambiar cuando la ventana se libere. Trae tus propias claves y el plan de respaldo es tuyo para configurarlo, no de la plataforma.

👉 Descarga meshcode — Mac, Windows