Los mensajes exactos y qué significa cada uno
API Error: 429 {"type":"rate_limit_error", ...}/ «se ha alcanzado el límite de solicitudes» — has superado el límite de solicitudes, tokens o concurrencia del intervalo. Espera aretry-after.rate limit reached for <model>con una nota específica del modelo: los límites son por modelo; cambiar de nivel con/modelsuele funcionar de inmediato.- «Has alcanzado tu límite de uso» / «el límite se restablece a las …»: no es un límite de solicitudes, sino el límite de uso de la suscripción Pro/Max calculado sobre un intervalo móvil. Espera a que se restablezca o usa una clave de API.
529 overloaded_error— es un problema de capacidad, no tuyo. Reinténtalo con esperas progresivas; la guía de errores lo explica.400 … tool use concurrency— demasiadas llamadas a herramientas en paralelo en un turno; no es un 429, pero aparece en las mismas sesiones.
Límites de solicitudes de Claude: los tres topes
Anthropic aplica límites de solicitudes por minuto (RPM), tokens de entrada y salida por minuto (ITPM/OTPM) y solicitudes simultáneas en curso, por modelo y por organización, ajustados según el nivel de uso; el nivel aumenta automáticamente a medida que crece tu gasto acumulado. Las pasarelas aplican sus propios límites equivalentes por cuenta. Las cifras se publican en la documentación de Anthropic y se muestran en tu consola; las que importan para Claude Code son la concurrencia y OTPM, porque una sesión de agente es una sucesión de solicitudes largas, paralelas y con mucho contenido de salida.
Por qué Claude Code alcanza el límite cuando un cliente de chat no lo hace
Un cliente de chat envía una solicitud a la vez. Claude Code transmite cada turno en streaming (ocupando una plaza de concurrencia durante toda su duración), ejecuta subagentes en paralelo (cada uno ocupa otra plaza) y reenvía toda la conversación en cada turno (los tokens por minuto aumentan con la duración de la sesión). Diez subagentes en un repositorio grande equivalen a diez transmisiones simultáneas y cientos de miles de tokens por minuto: eso es el 429.
Soluciones, ordenadas por la frecuencia con la que funcionan
- 1. Deja que lo reintente. Claude Code respeta
retry-after; la mayoría de los errores 429 desaparecen en segundos. - 2. Ejecuta menos subagentes en paralelo; realiza las tareas pesadas de forma secuencial en lugar de distribuirlas en paralelo.
- 3.
/compact— un contexto más pequeño implica menos tokens por turno, lo que permite reducir los TPM. - 4. Cambia de nivel con
/modelpara la tarea actual; los límites son por modelo. - 5. Traslada el trabajo en segundo plano a Haiku; reserva Sonnet/Opus para el ciclo principal.
- 6. Solicita un límite más alto: en Anthropic, mediante el nivel de gasto o una solicitud al equipo de ventas; en esta pasarela, envía un correo a soporte con tu cuenta y la carga de trabajo. Las cuentas nuevas empiezan con límites de concurrencia conservadores precisamente para que un agente fuera de control no pueda agotar los recursos compartidos, y estos se aumentan previa solicitud.
/compact focus on the current task
/model claude-sonnet-5
# in scripts: cap the loop and let retries happen
claude -p "..." --max-turns 20Límites de solicitudes en esta pasarela
Las solicitudes se facturan con cargo a tu saldo o a un plan de tarifa fija; los límites de solicitudes son por cuenta e independientes del precio. La pasarela agrupa varias cuentas de proveedores, de modo que un 429 por modelo en una cuenta provoca el cambio a otra con capacidad disponible en lugar de mostrar el error; esta es una de las razones por las que las sesiones aquí reciben menos errores 429 que con una única clave de consola. La concurrencia es el límite que más probablemente alcanzarás; escribe a soporte indicando el número de agentes que ejecutas en paralelo y se ajustará.
| Plan | Duración | Precio |
|---|---|---|
| Uso ilimitado durante 1 hora | 1 hora | $1 |
| Uso ilimitado durante 24 horas | 24 horas | $10 |
| Uso ilimitado durante 1 semana | 1 semana | $49 |
| Uso ilimitado durante 15 días | 15 días | $89 |
Pruébalo gratis primero
Las cuentas nuevas reciben $5 de crédito gratuito para la API con el código CLAUDECODE — suficiente para una tarde de Claude Code con Sonnet — y después créditos por 7.69231× su valor nominal.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_keyPreguntas frecuentes
¿Qué significa «Error de API: se ha alcanzado el límite de solicitudes» en Claude Code?
Un HTTP 429: has superado el límite de solicitudes, tokens o solicitudes simultáneas por minuto para ese modelo. Claude Code espera el tiempo indicado por retry-after y vuelve a intentarlo; si persiste, reduce los subagentes en paralelo y usa /compact.
¿Cuáles son los límites de solicitudes de Claude?
Solicitudes por minuto, tokens de entrada/salida por minuto y solicitudes simultáneas, por modelo, ajustados según el nivel de uso en Anthropic y por cuenta en una pasarela. Las sesiones de agentes alcanzan los límites de concurrencia y de tokens de salida.
¿Cómo consigo un límite de solicitudes más alto en Claude?
En Anthropic: aumenta el gasto (los niveles suben automáticamente) o contacta con ventas. En esta pasarela: envía un correo a soporte con tu carga de trabajo; la concurrencia se aumenta previa solicitud.
¿«Límite de uso alcanzado» es lo mismo que un límite de solicitudes?
No. Es el límite de la suscripción Pro/Max calculado sobre un intervalo móvil. Un límite de solicitudes se aplica por minuto y desaparece por sí solo; un límite de uso se restablece según su calendario.
Ejecuta Claude Code con la pasarela
Los mismos modelos, dos variables de entorno y créditos por 7.69231× su valor nominal, o un plan ilimitado de tarifa plana. Cuentas nuevas: $5 de crédito gratuito para la API con el código CLAUDECODE.
Obtener una clave de API Ver planes ilimitadosAI Prime Tech es una pasarela API independiente y no está afiliada a Anthropic, ni cuenta con su respaldo o patrocinio. «Claude» y «Claude Code» son marcas comerciales de Anthropic. Las funciones de Claude Code descritas aquí se basan en la documentación pública de Anthropic en el momento de la redacción y cambian con frecuencia; los precios y las listas de modelos de esta página se obtienen de la configuración actual de esta pasarela.