← Claude Code Hub
Nov 18, 2026 · 7 min de lectura ✦ Tip #275

Login de Claude Code caducado en claude -p: no se evita, pero se ve venir

El login de Claude Code caduca en una fecha fija que renovarlo no mueve. Cómo verla antes de que falle un cron o un paso de CI con claude -p, y cuándo pasar el job a un token de un año.

Login de Claude Code caducado en claude -p: sin mirar la fecha, el job de cron falla con reached its time limit; con claude auth status ves loginExpiresAt antes, y para lo desatendido usas claude setup-token

TL;DR En la máquina que ejecuta el job, claude auth status | jq -r .loginExpiresAt te 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 con claude setup-token, ponlo en CLAUDE_CODE_OAUTH_TOKEN y 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 status dice "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.
  • --bare no lo lee. Si tu script arranca con --bare, autentícate con ANTHROPIC_API_KEY o con un apiKeyHelper.

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.

¿Te ha servido? Haz que wmedia.es te salga antes en Google.

Añadir wmedia.es como fuente preferida en Google
GUÍA GRATUITA

Aprueba menos, pero mejor.

A los diez minutos ya le das a «sí» sin leer. Eso no es revisar, es rezar. La guía de 10 páginas con las cinco palancas, en orden de riesgo.

  • 1. Reglas la primera que coincide gana
  • 2. Modo un dial, no un interruptor
  • 3. Auto mode un clasificador aprueba por ti
  • 4. Sandbox una valla del sistema operativo
  • 5. Bypass solo dentro de un contenedor
¿Eres desarrollador/a Web profesional?

Recibirás la guía por email · Te unes a la newsletter Gravitas · Cancela cuando quieras

de 10
#

Wmedia · 10 páginas
GUÍA GRATUITA · 10 páginas · 5 palancas

Aprueba menos, pero mejor.

A los diez minutos ya le das a «sí» sin leer. Eso no es revisar, es rezar. La guía de 10 páginas con las cinco palancas, en orden de riesgo.

¿Eres desarrollador/a Web profesional? · Cancela cuando quieras
Cómo trabajo con IA

Mi flujo de trabajo con Claude Code.

Las skills, agentes e instrucciones que uso como Software Engineer profesional. Se llama Craft y es un plugin que puedes instalarte.

Ver las skills

¿Harto de aprobar permisos sin leer?