TL;DR En la máquina que ejecuta el job,
claude auth status | jq -r .loginExpiresAtte da el día en que acaba el login guardado; cuenta con que puede acabar hasta tres días antes. Para lo que corre sin nadie delante, genera un token de un año conclaude setup-token, ponlo enCLAUDE_CODE_OAUTH_TOKENy apunta la fecha, porque esa Claude Code no la enseña.
Failed to authenticate: this login reached its time limit and cannot be renewed es lo que imprime un claude -p el día que el login de claude.ai que guardaste con /login o claude auth login llega a su límite. Ese límite se fija al iniciar sesión y no se mueve aunque uses Claude Code a diario. En tu terminal te avisa tres días antes; un script, un cron o un paso de CI no ve ese aviso y falla sin que nadie lo vea.
Por qué caduca aunque lo uses cada día
Un login de claude.ai guarda dos tokens. El de acceso dura poco y Claude Code lo renueva solo con el de refresco. El de refresco trae su propia fecha de fin, y en el binario de la v2.1.327 cada renovación se queda con la más temprana de las dos fechas: renovar nunca la alarga. Solo un inicio de sesión nuevo empieza otra cuenta atrás. Desde la v2.1.318, Claude Code te enseña esa fecha en cuatro sitios:
| Dónde | Cuándo | Qué ves |
|---|---|---|
claude auth status |
Siempre | El campo loginExpiresAt |
claude -p --output-format json o stream-json |
En cada resultado | El campo credential_expires_at, y ningún aviso |
claude -p con salida de texto |
Desde 10 días antes | Un aviso de una línea en stderr |
| Sesión interactiva | Desde 3 días antes | Your login expires in 3 days · run /login to renew |
El hueco está en la segunda fila: un job que lee JSON nunca recibe el aviso. Tiene que leer el campo él mismo.
Lo que ves el día que falla
En claude -p y en el Agent SDK, desde la v2.1.318:
Failed to authenticate: this login reached its time limit and cannot be renewed. Run `claude auth login` to sign in again, or use `claude setup-token` and set CLAUDE_CODE_OAUTH_TOKEN for unattended jobs
En una sesión interactiva, Login reached its time limit · Please run /login. Antes de la v2.1.318 los dos decían otra cosa, y es lo que todavía encuentras en los issues:
Failed to authenticate: OAuth session expired and could not be refreshed
El código de error estructurado es authentication_failed en los dos casos. Hay una excepción: si además tienes un perfil de ant auth login, el job no falla, cambia de credencial y lo factura a la organización de ese perfil. Lo avisa en stderr con Warning: the claude.ai login on this machine has ended. This run uses the sign-in from ant auth login instead, and its usage is billed to <organización>.
Cómo ver la fecha antes
1. Pregunta a claude auth status en la máquina del job
Con el mismo usuario y el mismo CLAUDE_CONFIG_DIR que el job: un cron que corre como otro usuario lee otro login. El campo configDirectory te dice cuál está leyendo. Esto devuelve la v2.1.327 en una máquina que se autentica con un token y no con un login guardado:
$ claude auth status | jq '{authMethod, configDirectory, loginExpiresAt}'
{
"authMethod": "oauth_token",
"configDirectory": "/root/.claude",
"loginExpiresAt": null
}
null quiere decir que no hay un login guardado que caduque. Con uno, authMethod es claude.ai y loginExpiresAt lleva la fecha en ISO, por ejemplo "2026-11-25T09:12:44.000Z". claude auth status --text la da como un margen. Montada con las cadenas de la v2.1.327:
Sign-in ends: between 2026-11-22 and 2026-11-25 (2026-11-25T09:12:44.000Z)
El margen son los tres días anteriores a la fecha, y Claude Code cuenta siempre desde el primero. Ya dentro del margen cambia a Sign-in ends: any day now, by ..., y pasada la fecha, a Sign-in may have ended: between ....
2. Léela del resultado de claude -p
Si tu job ya usa --output-format json, la tienes en cada ejecución:
claude -p "$PROMPT" --output-format json | jq -r '.credential_expires_at // empty'
Probado en la v2.1.327: con un token en vez de un login guardado, el campo ni aparece en el JSON.
3. No tires el stderr
Con salida de texto, el aviso sale diez días antes. No lo mandes a /dev/null: si cron tiene el correo configurado, te envía la salida del job con el stderr incluido. Montado con las cadenas de la v2.1.327, para un login que acaba el 25:
Warning: this sign-in ends between 2026-11-22 and 2026-11-25 (in 4 days at the earliest). Renewing it does not move those dates. Run claude auth login before then, or use claude setup-token for unattended jobs.
4. Comprueba la fecha antes de lanzar el job
Para un job con JSON, que no recibe el aviso, estas líneas cuentan los días igual que Claude Code, desde el primer día del margen:
#!/usr/bin/env bash
# Días que quedan, como pronto, hasta que acabe el login guardado
dias=$(claude auth status | jq -r '.loginExpiresAt // empty
| sub("\\.[0-9]+Z$"; "Z") | fromdateiso8601
| ((. - 3*86400) / 86400 | floor) - (now / 86400 | floor)')
if [ -n "$dias" ] && [ "$dias" -lt 10 ]; then
echo "El login de Claude Code puede acabar en $dias días: ejecuta claude auth login" >&2
fi
Con la fecha del ejemplo imprime El login de Claude Code puede acabar en 4 días, la misma cuenta que el aviso. Con un token no imprime nada.
Cuándo pasarte a claude setup-token
Si el job corre sin nadie delante, no lo dejes en tu login. claude setup-token abre el mismo flujo del navegador que /login e imprime un token de un año que no guarda en ningún sitio: lo copias y lo pones en CLAUDE_CODE_OAUTH_TOKEN donde corra el job.
| Login guardado | Token de claude setup-token |
|
|---|---|---|
| Cuánto dura | Hasta un límite fijado al iniciar sesión | Un año |
| Dónde ves la fecha | loginExpiresAt, credential_expires_at, el aviso |
En ningún sitio: apúntala al crearlo |
| Al acabar | reached its time limit |
API Error: 401 OAuth token has expired |
| Remote Control y conectores de claude.ai | Sí | No: solo peticiones al modelo |
Tres cosas que se te escapan con el token:
- Claude Code no te enseña cuándo acaba.
claude auth statusdice"authMethod": "oauth_token"y"loginExpiresAt": null, como arriba. - Al caducar, Claude Code sigue enviando el valor de la variable y no salta a tu login guardado. Genera otro y reinicia.
--bareno lo lee. Si tu script arranca con--bare, autentícate conANTHROPIC_API_KEYo con unapiKeyHelper.
Necesita un plan Pro, Max, Ultra, Team o Enterprise. Si el job acaba en verde sin haber hecho nada, no es el login: es lo que lista permission_denials. Y si se queda parado esperando un permiso, denyInsteadOfPrompting lo deniega y sigue.
Documentación oficial: Renew an expiring login · Generate a long-lived token · Login expired
Requisitos
loginExpiresAt, credential_expires_at y el aviso en stderr necesitan Claude Code v2.1.318 o posterior. Probado en la v2.1.327 en Linux con un token: claude auth status, el JSON de claude -p y el script. Lo que solo enseña un login de claude.ai guardado (la fecha, el margen y los avisos) sale del binario de la v2.1.327 y de la documentación, con fechas de ejemplo.