스크립트용 계정 고르기

ccam pick은 로그인된 계정 중 여유가 가장 많은 계정의 이름을 출력하므로, 스크립트가 그 계정으로 Claude Code를 시작할 수 있습니다. 여유 있는 계정이 충분하면 동시에 시작한 워커는 저마다 다른 계정을 받으므로, claude -p 작업 묶음이 한 계정을 다 써 버리지 않고 여러 계정에 나뉩니다.

사용법

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

종료 코드: 표준 출력에 이름을 내보내면 0, 여유 있는 계정이 없거나 로그인된 계정이 없으면 75(EX_TEMPFAIL), 잘못된 플래그 같은 그 밖의 오류는 1입니다.

옵션

동작 방식

1. ccam이 로그인된 계정 목록을 만듭니다(API 키 계정은 한도가 없으므로 뺍니다).
2. 잠금(~/.local/state/ccam/picks.lock)을 잡으므로, 동시에 실행된 선택은 하나씩 차례로 처리됩니다.
3. ccam usage와 같은 방식으로, 60초 캐시를 쓰며 모든 계정의 사용량을 한꺼번에 조회합니다.
4. 최근 2분 안에 선택된 계정(~/.local/state/ccam/picks/<name>)을 먼저 빼고, 나머지 중에서 ccam next --auto의 선택 규칙으로 고릅니다. auto_max_usage 미만인 계정을 먼저, 전략에 따라 고르며, 100%인 계정은 절대 고르지 않습니다.
5. 여유 있는 계정이 모두 최근에 선택되었다면 규칙이 그 전체 중에서 다시 고르므로, 계정이 셋일 때 네 번째 워커는 한 계정을 함께 씁니다.
6. 선택을 기록하고 잠금을 푼 다음 이름을 출력합니다.

2분이라는 구간이 중요한 이유는 새 작업의 사용량이 수치에 나타나기까지 시간이 걸리기 때문입니다. 이 구간이 없으면 함께 시작한 워커 다섯 개가 모두 같은 계정을 여유가 가장 많은 계정으로 보게 됩니다.

안전장치와 예외 상황

• ccam pick은 사용량을 읽고 선택 시각을 기록할 뿐입니다. ccam usage가 하는 것 이상으로 토큰을 갱신하거나 읽지 않습니다.
• 선택했다고 계정이 예약되지는 않습니다. 2분이 지나면 두 스크립트가 같은 계정에서 시작할 수도 있으니, 그 계정이 한도에 도달했을 때 복구하려면 --fallback을 쓰세요.
• --wait로 기다리는 동안에는 잠금을 잡지 않으므로, 그사이 다른 선택도 계속 진행됩니다.
• ccam pick은 ccam folder를 무시하고 사용량만으로 고릅니다.

관련 문서

• 다음 계정으로 전환
• 한도에서 다시 실행
• 사용량 한도
• API 키 계정