Memilih akun untuk skrip

ccam pick mencetak nama akun yang sudah login dengan ruang terbanyak, agar skrip bisa menjalankan Claude Code dengannya. Worker yang dimulai pada waktu yang sama masing-masing mendapat akun berbeda selama masih cukup akun yang punya ruang, sehingga sekumpulan tugas claude -p tersebar ke akun-akun Anda alih-alih menghabiskan satu akun.

Penggunaan

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"
}

Kode keluar: 0 dengan nama di output standar, 75 (EX_TEMPFAIL) jika tidak ada akun yang punya ruang atau tidak ada yang sudah login, 1 untuk galat lain seperti flag yang salah.

Opsi

Cara kerjanya

1. ccam membuat daftar akun yang sudah login (akun kunci API tidak punya batas dan tidak diikutkan).
2. ccam mengambil kunci (~/.local/state/ccam/picks.lock), sehingga pemilihan yang berjalan bersamaan dilakukan satu per satu.
3. ccam menanyakan penggunaan semua akun sekaligus, dengan cara yang sama seperti ccam usage, memakai cache 60 detik.
4. Akun yang dipilih dalam 2 menit terakhir (~/.local/state/ccam/picks/<name>) dikeluarkan lebih dulu, lalu aturan pemilihan ccam next --auto memilih di antara sisanya: akun di bawah auto_max_usage lebih dulu, menurut strategi, dan tidak pernah akun yang sudah 100%.
5. Jika setiap akun yang punya ruang baru saja dipilih, aturan itu memilih lagi di antara semuanya, sehingga worker keempat pada tiga akun berbagi satu akun.
6. Pilihan dicatat dan kunci dilepas, lalu nama akun dicetak.

Jendela 2 menit itu penting karena penggunaan tugas baru butuh waktu untuk muncul di angka: tanpa jendela itu, lima worker yang dimulai bersamaan akan melihat akun yang sama sebagai akun dengan ruang terbanyak.

Keamanan dan kasus khusus

• ccam pick hanya membaca penggunaan dan menulis waktu pemilihan; ia tidak pernah memperbarui atau membaca token lebih dari yang dilakukan ccam usage.
• Pemilihan tidak memesan akun. Dua skrip tetap bisa dimulai di akun yang sama setelah 2 menit; gunakan --fallback untuk pulih saat akun itu mencapai batasnya.
• Menunggu dengan --wait tidak memegang kunci, sehingga pemilihan lain tetap berjalan sementara itu.
• ccam pick mengabaikan ccam folder: ia memilih hanya berdasarkan penggunaan.

Terkait

• Beralih ke akun berikutnya
• Jalankan ulang saat batas tercapai
• Batas penggunaan
• Akun kunci API