Scegliere un account per gli script

ccam pick stampa il nome dell'account con login che ha più margine, perché uno script ci avvii Claude Code. I worker avviati nello stesso momento ricevono ciascuno un account diverso finché ci sono abbastanza account con margine, così un gruppo di job claude -p si distribuisce sui tuoi account invece di esaurirne uno.

Utilizzo

ccam "$(ccam pick)" -p "fix the failing tests"
for task in parse lint docs; do
  ccam "$(ccam pick)" -p "do the $task task" > "$task.json" &
done; wait
ccam pick --json                      # the account and its usage
ccam pick --model opus                # also count the Opus weekly limit
ccam pick --max-usage 80 --strategy expiring
ccam pick --wait=2h                   # nobody has room: wait for a reset
ccam --fallback "$(ccam pick)" -p "…" # also switch if this account hits its limit mid-job

$ ccam pick --json
{
  "name": "work",
  "slot": 2,
  "email": "dev@company.com",
  "five_hour": { "percent": 12, "resets_at": "2026-10-20T15:10:00Z", "known": true },
  "weekly": { "percent": 41, "resets_at": "2026-10-24T09:00:00Z", "known": true },
  "source": "live"
}

Codici di uscita: 0 con un nome sullo standard output, 75 (EX_TEMPFAIL) quando nessun account ha margine o nessuno ha il login, 1 per gli altri errori, come un'opzione non valida.

Opzioni

Come funziona

1. ccam elenca gli account con login (gli account con chiave API non hanno limiti e vengono esclusi).
2. Acquisisce un lock (~/.local/state/ccam/picks.lock), così le scelte eseguite nello stesso momento avvengono una dopo l'altra.
3. Consulta l'utilizzo di tutti gli account contemporaneamente, come fa ccam usage, con la cache di 60 secondi.
4. Gli account scelti negli ultimi 2 minuti (~/.local/state/ccam/picks/<name>) vengono esclusi per primi, e le regole di scelta di ccam next --auto scelgono tra i restanti: prima quelli sotto auto_max_usage, secondo la strategia, mai un account al 100%.
5. Se ogni account con margine è stato scelto di recente, le regole scelgono di nuovo tra tutti, così un quarto worker su tre account ne condivide uno.
6. La scelta viene registrata e il lock rilasciato, poi viene stampato il nome.

La finestra di 2 minuti conta perché l'utilizzo di un nuovo job impiega un po' a comparire nei numeri: senza di essa, cinque worker avviati insieme vedrebbero tutti lo stesso account come quello con più margine.

Sicurezza e casi limite

• ccam pick legge solo l'utilizzo e scrive l'ora della scelta; non rinnova né legge mai i token oltre a quanto fa ccam usage.
• Una scelta non riserva l'account. Due script possono comunque partire sullo stesso account dopo 2 minuti; usa --fallback per recuperare quando quell'account raggiunge il limite.
• L'attesa con --wait non tiene alcun lock, quindi nel frattempo le altre scelte proseguono.
• ccam pick ignora ccam folder: sceglie solo in base all'utilizzo.

Pagine correlate

• Passare all'account successivo
• Rieseguire al limite
• Limiti di utilizzo
• Account con chiave API