Documentazione

Limiti di utilizzo e cambio di account

Ultimo aggiornamento: 19 ottobre 2026
Verificato con ccam 0.6.0 e Claude Code 2.1.302

Questa pagina è stata tradotta automaticamente dall'inglese. Le correzioni sono benvenute. Modifica questa pagina su GitHub

In questa pagina

ccam usage mostra quanta parte dei limiti su 5 ore e settimanali ha usato ogni account. ccam next --auto apre l'account con più margine, e --continue porta con sé la conversazione corrente.

$ ccam usage
 Account     5-hour        Resets    Weekly        Resets    As of
 1 personal  ██████░░  72% 1h 40m    ███░░░░░  41% 3d 6h     just now
 2 work      █░░░░░░░   8% 4h 12m    ██░░░░░░  19% 5d 2h     just now
 3 side      ████████ 100% 22m       █████░░░  68% 1d 9h     12m ago (cached)
→ Most headroom: work   (open it with ccam next --auto)

Le colonne sono: account, utilizzo su 5 ore, tempo mancante all'azzeramento, utilizzo settimanale, tempo mancante all'azzeramento e quanto sono recenti i dati.

Da dove vengono i numeri

ccam interroga l'endpoint di utilizzo di Anthropic per tutti gli account contemporaneamente, usando il login di ciascun account. Attende al massimo 3 secondi per account e mostra ogni account appena risponde.

Questo endpoint non è documentato pubblicamente e potrebbe cambiare. Quando una richiesta non va a buon fine, ccam mostra gli ultimi numeri noti e li segna come presi dalla cache. Una finestra che si è azzerata dopo il salvataggio di quei numeri mostra 0%. ccam doctor ti avvisa se il formato della risposta è cambiato.

I numeri ottenuti meno di 60 secondi prima vengono riutilizzati. Opzioni:

Opzione Effetto
--watch [seconds] Aggiorna di continuo, ogni 60 secondi per impostazione predefinita
--json Output leggibile da una macchina
-v Mostra anche i limiti settimanali specifici per modello e da dove viene ogni numero
--no-cache Chiede sempre di nuovo
--source cache Non chiede mai; mostra solo i numeri salvati

Login scaduti

Quando il token di accesso di un account è scaduto, ccam non lo rinnova, perché rinnovarlo mentre una sessione di Claude Code usa lo stesso login potrebbe disconnettere quella sessione. Avvia l'account una volta con ccam <name> e sarà Claude Code a rinnovarlo.

ccam usage --refresh rinnova da solo i token scaduti, ma solo per gli account che non sono in esecuzione. Non rinnova mai i login salvati nel Portachiavi di macOS o in una cartella ~/.claude importata.

Utilizzo nella riga di stato

ccam statusline install

Claude Code mostra quindi il nome dell'account e il suo utilizzo nella riga di stato, per esempio [work] · Opus · 5h 24% · 7d 41%. Se hai già un comando per la riga di stato, ccam lo mantiene e mette davanti il nome dell'account. La riga di stato salva anche i propri numeri, che ccam usage usa quando l'endpoint non risponde.

Cambiare account

ccam next             # the account after the one you used last
ccam next --auto      # the account with the lowest 5-hour usage
ccam next --continue  # the next account that shares your conversation history

ccam next salta gli account che non hanno effettuato il login, e --auto salta gli account al 100%. Per continuare una conversazione, entrambi gli account devono condividere la cronologia delle conversazioni; vedi condivisione.

La guida al flusso di lavoro per i limiti di utilizzo illustra un esempio completo.