Cómo encadenar el límite de Claude Code reemplazando el modelo y separando las credenciales

No es necesario trasladar todas las tareas a la API solo porque se haya alcanzado el límite en Claude Code. La situación cambia si primero se verifica, mediante /status, si la sesión actual consume el límite de la suscripción o si se factura con una clave de API. No se trata de eludir el límite, sino de reducir los cortes en el flujo de trabajo comprendiendo los límites por modelo y la prioridad de autenticación.

Los límites se calculan por separado en tres categorías

Los límites de uso de Claude Code se dividen en tres tipos, y cada uno se agota de forma independiente ¹.

• Límite de sesión: Es una restricción a corto plazo que se restablece cada 5 horas.
• Límite semanal total: Se calcula semanalmente sumando el uso de todos los modelos.
• Límite semanal por modelo: Se aplica un límite semanal adicional a los modelos de gama alta ¹.

Si no se conoce esta estructura, es difícil entender todas las situaciones bajo la única frase "el límite está lleno". Según observaciones de usuarios reales, se ha registrado un caso en la pantalla de un usuario del plan Max 5x donde el límite de sesión se mostraba al 4%, el límite semanal total al 69% y el límite semanal del modelo (Fable) al 89% ². Es decir, aunque el límite de un modelo específico esté casi agotado, puede quedar margen en el límite semanal total.

Además, el consumo realizado en el chat web, la aplicación de escritorio y Claude Code se suma al mismo límite ². Si se usa mucho Claude Chat, la cantidad restante disponible para escribir código también disminuye. Por el contrario, las tareas complejas que ejecutan varios subagentes pueden agotar primero el límite semanal antes de que la sesión de 5 horas se restablezca ¹.

Cuándo se puede continuar cambiando de modelo

Lo primero que se debe verificar al alcanzar un límite es "qué límite" se ha alcanzado.

Cuando se alcanza únicamente el límite por modelo

Si se ha alcanzado el límite semanal adicional que solo se aplica a los modelos de gama alta (Opus, Sonnet, Fable, etc.), es posible cambiar a un modelo de otra serie mediante el comando /model en la sesión de Claude Code y continuar trabajando de inmediato ¹. Como en el caso visto anteriormente, si el límite semanal del modelo está al 89% pero el límite semanal total está al 69%, se puede cambiar a otro modelo que aún tenga margen para continuar el trabajo dentro del límite total ².

No obstante, hay que tener en cuenta que, al estar la caché de prompts separada por modelo, la primera solicitud inmediatamente después del cambio volverá a leer el contenido de la conversación existente sin utilizar la caché. En sesiones de conversación largas, esto puede generar el costo de un procesamiento adicional ³.

Cuando se alcanza el límite de sesión o el límite semanal total

El límite de sesión y el límite semanal total son compartidos por todos los modelos. Por lo tanto, si se alcanzan estas dos restricciones, el bloqueo del trabajo se mantiene incluso al cambiar a un modelo más ligero ¹. Sin embargo, utilizar un modelo más ligero de lo habitual puede ralentizar la velocidad a la que se agota el límite.

Los 'créditos de uso' son una conversión a pago por uso, no un reinicio

Para continuar trabajando en los segmentos de límite de sesión o semanal donde el cambio de modelo no resuelve el problema, se puede utilizar la función de 'créditos de uso'.

Esta función puede inducir a error por su nombre, pero no reinicializa un límite que ya se ha completado. Según la explicación de la asistencia al cliente de Anthropic, los créditos de uso permiten "continuar trabajando cambiando al precio de pago por uso tras haber alcanzado el límite de uso del plan" ³. Es decir, es un interruptor que cambia el método de facturación al estándar de la API de pago por uso en lugar de bloquear el acceso.

Utilizar la función de reanudación automática

También se puede esperar sin usar créditos. Desde la versión v2.1.234 de Claude Code, la función que espera hasta la hora de restablecimiento para reanudar el trabajo automáticamente está activada por defecto ³.

• Si se mantiene la sesión abierta, aparece un mensaje como Usage limit reached · continuing automatically at 3:45pm en la parte inferior, y el trabajo detenido se retoma automáticamente a la hora de restablecimiento.
• Si el equipo ha estado dormido durante más de 30 minutos, se debe pulsar la tecla Enter para reanudarlo.
• La reanudación automática no funciona si quedan más de 24 horas para el restablecimiento, como en el caso de los límites semanales, o si se ejecuta en segundo plano ³.

Al activar los créditos de uso, se generan cargos aparte de la cuota de suscripción. Dado que Claude Code envía el historial completo de la conversación en cada solicitud, el costo en tokens puede aumentar cuanto más larga sea la conversación. Se recomienda configurar previamente los límites de gasto mensual (spend limits) para evitar gastos inesperados ³.

La prioridad de autenticación de 7 pasos determina la ruta de facturación

En entornos donde se utilizan tanto suscripciones como claves de API, es frecuente que la ruta de facturación se establezca en la API sin querer. Claude Code no cambia la ruta automáticamente, sino que selecciona la credencial con la prioridad más alta entre las configuradas.

Según la documentación de autenticación actualizada a 10 de octubre de 2026, la prioridad es la siguiente ⁴.

Si ANTHROPIC_API_KEY (paso 3) permanece en las variables de entorno y se ha iniciado sesión en la suscripción (paso 7) a través de /login, la solicitud se procesa con la clave de API.

• Modo interactivo: Claude Code pregunta una vez si desea utilizar la clave de API, y si se aprueba, esa elección se recuerda ⁴.
• Modo no interactivo (claude -p, CI, etc.): Utiliza siempre la clave de API sin proceso de confirmación ⁴.

Al conversar en un portátil se utiliza la suscripción, pero los scripts de automatización en segundo plano generan cargos por la API, generando costes. Para verificar qué credenciales está utilizando la sesión actual, basta con introducir /status en Claude Code. Si existen tanto información de inicio de sesión como una clave de API, la que no se está utilizando actualmente se mostrará como "no activo" ⁴.

Ejecutar scripts también dentro del límite de la suscripción: setup-token

Si se desea procesar tareas automatizadas dentro del límite de la suscripción sin costes de API, se puede utilizar claude setup-token. Este comando genera un token OAuth para la autenticación de la suscripción, y el token generado solo se muestra en pantalla, no se guarda.

# 1. 토큰 발급 후 복사
claude setup-token

# 2. 환경 변수에 저장하고, 기존 API 키는 삭제하여 우선순위 충돌 방지
export CLAUDE_CODE_OAUTH_TOKEN="복사한_토큰"
unset ANTHROPIC_API_KEY

# 3. 구독 한도로 실행 확인
claude -p "테스트 실패 원인을 요약해 줘"

Aquí es importante unset ANTHROPIC_API_KEY. Dado que la prioridad de CLAUDE_CODE_OAUTH_TOKEN (paso 3) es más alta que la de ANTHROPIC_API_KEY (paso 5), se seguirán facturando los cargos por API si la clave de API permanece activa ⁴.

Configuración de separación de modelos mediante proxy

Al margen de la gestión de límites, si se desea asignar modelos distintos según el tipo de tarea, se puede utilizar un proxy como LiteLLM. Si se configura ANTHROPIC_BASE_URL de Claude Code con la dirección del servidor proxy e introduce la clave virtual obtenida en ANTHROPIC_AUTH_TOKEN, las solicitudes pasarán por el proxy ⁵⁶.

Con este método es posible configurar que los modelos costosos (como Opus) pasen directamente a la API original, mientras que las rutas de los modelos económicos (como Haiku) se mapean a modelos alternativos como DeepSeek ⁷⁵. Así se pueden mantener las funciones de subagente internas de Claude Code y operar de modo que solo las conversaciones principales costosas utilicen los modelos de gama alta ⁷. No obstante, en el caso de utilizar un proxy, dado que ANTHROPIC_AUTH_TOKEN tiene prioridad de nivel 2, es necesario aclarar que los cargos se facturan al operador del gateway y no a la suscripción ⁴.

Conclusión: Comience verificando la ruta actual con /status

La gestión de límites en Claude Code no es simplemente regular el volumen de uso, sino un asunto de controlar con qué credenciales se envían las solicitudes. Si se alcanza el límite de un modelo específico, es posible cambiar a otro modelo mediante /model. En el caso de un límite de sesión o semanal, es necesario cambiar al pago por uso mediante créditos o esperar a la reanudación automática.

Lo primero que se debe hacer es abrir /status para verificar si el método de autenticación actual es una suscripción o una clave de API. Si la facturación está yendo a la API contrariamente a la intención, rastree si se están inyectando claves a través de las variables de entorno del shell, el archivo .env o settings.json.