Elegir una cuenta para scripts

ccam pick imprime el nombre de la cuenta con sesión iniciada que tiene más margen, para que un script inicie Claude Code con ella. Los workers iniciados a la vez reciben cada uno una cuenta distinta mientras haya suficientes cuentas con margen, así que un lote de trabajos claude -p se reparte entre tus cuentas en lugar de agotar una sola.

Uso

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

Códigos de salida: 0 con un nombre en la salida estándar, 75 (EX_TEMPFAIL) cuando ninguna cuenta tiene margen o ninguna tiene sesión iniciada, 1 para otros errores, como una opción incorrecta.

Opciones

Cómo funciona

1. ccam lista las cuentas con sesión iniciada (las cuentas con clave de API no tienen límites y quedan fuera).
2. Toma un bloqueo (~/.local/state/ccam/picks.lock), así que las elecciones que se ejecutan a la vez ocurren una tras otra.
3. Consulta el uso de todas las cuentas a la vez, igual que ccam usage, con la caché de 60 segundos.
4. Las cuentas elegidas en los últimos 2 minutos (~/.local/state/ccam/picks/<name>) se dejan fuera primero, y las reglas de elección de ccam next --auto eligen entre las demás: primero por debajo de auto_max_usage, según la estrategia, nunca una cuenta al 100 %.
5. Si todas las cuentas con margen se eligieron hace poco, las reglas vuelven a elegir entre todas, así que un cuarto worker con tres cuentas comparte una.
6. La elección se registra y se libera el bloqueo; después se imprime el nombre.

La ventana de 2 minutos importa porque el uso de un trabajo nuevo tarda un rato en aparecer en las cifras: sin ella, cinco workers iniciados a la vez verían todos la misma cuenta como la de más margen.

Seguridad y casos límite

• ccam pick solo lee el uso y escribe la hora de la elección; nunca renueva ni lee tokens más allá de lo que hace ccam usage.
• Una elección no reserva la cuenta. Dos scripts pueden seguir iniciándose en la misma cuenta pasados 2 minutos; usa --fallback para recuperarte cuando esa cuenta llegue a su límite.
• Esperar con --wait no mantiene ningún bloqueo, así que otras elecciones siguen mientras tanto.
• ccam pick ignora ccam folder: elige solo por uso.

Relacionado

• Cambiar a la siguiente cuenta
• Volver a ejecutar al llegar al límite
• Límites de uso
• Cuentas con clave de API