Errore di limite di frequenza di Claude: cosa significa "Errore API: limite di frequenza raggiunto" e come risolverlo

I messaggi esatti e il significato di ciascuno

• API Error: 429 {"type":"rate_limit_error", ...} / "limite di frequenza raggiunto" — hai superato il limite di richieste, token o concorrenza per l'intervallo di tempo. Attendi retry-after.
• rate limit reached for <model> con una nota relativa al modello — i limiti sono specifici per modello; cambiare livello con /model spesso funziona immediatamente.
• "Hai raggiunto il limite di utilizzo" / "il limite si reimposta alle …" — non è un limite di frequenza: è il tetto di utilizzo su finestra mobile dell'abbonamento Pro/Max. Attendi la reimpostazione oppure usa una chiave API.
• 529 overloaded_error — è un problema di capacità, non dipende da te. Riprova aumentando progressivamente l'attesa; la guida agli errori spiega come.
• 400 … tool use concurrency — troppe chiamate agli strumenti in parallelo nello stesso turno; non è un 429, ma compare nelle stesse sessioni.

Limiti di frequenza di Claude: i tre tetti

Anthropic applica limiti alle richieste al minuto (RPM), ai token di input e output al minuto (ITPM/OTPM) e alle richieste simultanee in corso, per modello e per organizzazione, in base al livello di utilizzo — il livello aumenta automaticamente con la crescita della spesa cumulativa. I gateway applicano limiti equivalenti propri per account. I valori sono pubblicati nella documentazione di Anthropic e mostrati nella tua console; quelli che contano per Claude Code sono la concorrenza e OTPM, perché una sessione di un agente è un flusso di richieste lunghe, parallele e con molto output.

Perché Claude Code raggiunge il limite mentre un client di chat non lo fa

Un client di chat invia una richiesta alla volta. Claude Code trasmette ogni turno in streaming (occupando uno slot di concorrenza per tutta la sua durata), esegue sottoagenti in parallelo (ciascuno occupa un altro slot) e reinvia l'intera conversazione a ogni turno (i token al minuto aumentano con la durata della sessione). Dieci sottoagenti su un repository di grandi dimensioni equivalgono a dieci flussi simultanei e centinaia di migliaia di token al minuto — è questo il 429.

Soluzioni, in ordine di efficacia più frequente

• 1. Lascia che riprovi. Claude Code rispetta retry-after; la maggior parte degli errori 429 si risolve in pochi secondi.
• 2. Esegui meno sottoagenti in parallelo; svolgi le attività pesanti in sequenza invece di distribuirle contemporaneamente.
• 3. /compact — un contesto più piccolo significa meno token per turno, ed è così che puoi agire sui TPM.
• 4. Cambia livello con /model per l'attività corrente; i limiti sono specifici per modello.
• 5. Sposta il lavoro in background su Haiku; mantieni Sonnet/Opus per il ciclo principale.
• 6. Chiedi un limite più elevato: su Anthropic, tramite il livello di spesa o una richiesta al reparto vendite; su questo gateway, invia un'e-mail all'assistenza indicando il tuo account e il carico di lavoro — i nuovi account iniziano con limiti di concorrenza prudenti proprio per evitare che un singolo agente fuori controllo esaurisca le risorse condivise, e questi vengono aumentati su richiesta.

/compact focus on the current task
/model claude-sonnet-5
# in scripts: cap the loop and let retries happen
claude -p "..." --max-turns 20

Limiti di frequenza su questo gateway

Le richieste vengono addebitate sul tuo saldo o su un piano a tariffa fissa; i limiti di frequenza sono per account e indipendenti dal prezzo. Il gateway riunisce diversi account dei fornitori a monte, quindi un 429 specifico per modello su un account provoca il passaggio a un altro account con capacità disponibile, invece di essere mostrato all'utente — uno dei motivi per cui le sessioni qui incontrano meno errori 429 rispetto all'uso di una singola chiave della console. La concorrenza è il limite che hai più probabilità di raggiungere; scrivi all'assistenza indicando il numero di agenti che esegui in parallelo e verrà adeguato.

Tutti i piani illimitati →

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Domande frequenti

AI Prime Tech è un gateway API indipendente e non è affiliato ad Anthropic, né approvato o sponsorizzato da Anthropic. «Claude» e «Claude Code» sono marchi di Anthropic. Le funzionalità di Claude Code descritte qui rispecchiano la documentazione pubblica di Anthropic al momento della stesura e cambiano frequentemente; i prezzi e gli elenchi dei modelli presenti in questa pagina vengono letti dalle impostazioni attuali di questo gateway.