scripts के लिए अकाउंट चुनना

ccam pick सबसे ज़्यादा गुंजाइश वाले लॉगिन किए हुए अकाउंट का नाम प्रिंट करता है, ताकि कोई script उससे Claude Code शुरू कर सके। जब तक गुंजाइश वाले अकाउंट काफ़ी हों, एक ही समय पर शुरू हुए हर worker को अलग अकाउंट मिलता है, इसलिए claude -p jobs का एक batch किसी एक अकाउंट को ख़ाली करने के बजाय आपके अकाउंट्स में बँट जाता है।

उपयोग

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

Exit codes: standard output पर नाम के साथ 0, जब किसी अकाउंट में गुंजाइश न हो या कोई लॉगिन न हो तो 75 (EX_TEMPFAIL), और ग़लत flag जैसी दूसरी त्रुटियों के लिए 1।

विकल्प

यह कैसे काम करता है

1. ccam लॉगिन किए हुए अकाउंट्स की सूची बनाता है (API key अकाउंट्स की कोई सीमा नहीं होती, इसलिए वे छोड़ दिए जाते हैं)।
2. यह एक lock (~/.local/state/ccam/picks.lock) लेता है, ताकि एक साथ चल रहे picks एक के बाद एक हों।
3. यह हर अकाउंट का उपयोग एक साथ पूछता है, उसी तरह जैसे ccam usage करता है, 60 सेकंड के cache के साथ।
4. पिछले 2 मिनट में चुने गए अकाउंट (~/.local/state/ccam/picks/<name>) पहले छोड़ दिए जाते हैं, और बाक़ी में से ccam next --auto के चुनाव के नियम चुनते हैं: पहले auto_max_usage से नीचे वाले, strategy के हिसाब से, और 100% वाला अकाउंट कभी नहीं।
5. अगर गुंजाइश वाला हर अकाउंट हाल ही में चुना गया हो, तो नियम फिर से उन सब में से चुनते हैं, इसलिए तीन अकाउंट्स पर चौथा worker किसी एक को साझा करता है।
6. चुनाव दर्ज होता है और lock छोड़ा जाता है, फिर नाम प्रिंट होता है।

2 मिनट की विंडो इसलिए ज़रूरी है क्योंकि नए job का उपयोग संख्याओं में दिखने में कुछ समय लगता है: इसके बिना, एक साथ शुरू हुए पाँच workers सभी एक ही अकाउंट को सबसे ज़्यादा गुंजाइश वाला मानते।

सुरक्षा और विशेष स्थितियाँ

• ccam pick केवल उपयोग पढ़ता है और चुनाव का समय लिखता है; यह ccam usage जितना करता है उससे ज़्यादा tokens कभी renew नहीं करता और न पढ़ता है।
• चुनाव अकाउंट को आरक्षित नहीं करता। 2 मिनट बाद दो scripts फिर भी एक ही अकाउंट पर शुरू हो सकती हैं; जब वह अकाउंट अपनी सीमा तक पहुँचे तो सँभलने के लिए --fallback इस्तेमाल करें।
• --wait से इंतज़ार करते समय कोई lock नहीं रखा जाता, इसलिए इस बीच दूसरे picks चलते रहते हैं।
• ccam pick ccam folder को नज़रअंदाज़ करता है: यह केवल उपयोग के हिसाब से चुनता है।

संबंधित

• अगले अकाउंट पर स्विच करना
• सीमा पर फिर से चलाना
• उपयोग सीमाएँ
• API key अकाउंट