En este artículo
claude-rotate: Un proxy para varias cuentas Claude Max
claude-rotate coloca un endpoint privado delante de varias cuentas Claude Max o Pro que ya posees y mueve el tráfico de Claude Code cuando la cuenta activa se queda sin cuota utilizable. Evita el ciclo de logout, login en el navegador y reinicio del terminal en portátiles, workstations y pods de agentes personales. El repositorio open source de claude-rotate tiene licencia MIT y es deliberadamente pequeño: un proceso proxy en Python, un archivo de configuración, estado y logs en JSON, sin base de datos.
Una pasarela puede registrar el consumo de varios dispositivos y también obtiene acceso a las credenciales y al tráfico. La documentación de Anthropic determina qué aplicaciones pueden gestionarlo.
Para decidir la compra, consulta la comparativa de costes Claude Code vs OpenCode. Para un gateway que atienda a una empresa y no a un solo propietario, empieza por la comparativa de gateways LLM para producción.
¿Qué forma de acceso a Claude Code encaja con tu trabajo?
| Tu situación | Mejor opción | Por qué |
|---|---|---|
| Una persona posee varias cuentas Claude de pago y trabaja en varios dispositivos privados | Inicio de sesión nativo de Claude Code | Compara el uso incluido y los créditos antes de contratar más suscripciones. |
| Una cuenta alcanza el límite solo de vez en cuando | Espera, cambia de modelo o activa usage credits | Un proxy añade trabajo operativo y de seguridad sin crear cuota. |
| Varios empleados o clientes necesitan capacidad compartida | Usa Team, Enterprise o acceso API medido | Las credenciales de consumo son una frontera incorrecta para identidad, gobierno y facturación. |
| Necesitas presupuestos por usuario, SSO, exportación de auditoría o soporte contractual | Usa un gateway de producción y un plan comercial | claude-rotate tiene analítica por dispositivo, no un plano de control enterprise. |
Por qué tres suscripciones Claude Max pueden detener una sesión
Las suscripciones separadas no forman un único pool. Cada login conserva su cupo y sus relojes de reset. La documentación actual del plan Max de Anthropic dice que el uso de sesión se reinicia cada cinco horas, mientras que el límite semanal se restablece a una hora fija asignada a la cuenta. También pueden existir límites semanales, mensuales, por modelo o por función. Una flota activa de agentes de IA puede agotar la cuenta conectada en todas las máquinas mientras queda cupo pagado sin usar en otra.
La rotación manual funciona, pero es incómoda. Interrumpes la tarea, cierras sesión, completas OAuth en el navegador con otra cuenta, verificas la identidad y repites en cada máquina. Con Macs remotos, trabajos personales similares a CI y loops largos, la interrupción suele consumir más atención que el login.
Cómo funciona claude-rotate
- Cada cliente Claude Code apunta
ANTHROPIC_BASE_URLal proxy y se autentica con una clave interna distinta para ese dispositivo. - El proxy sustituye la clave por el setup token de la cuenta de pago activa y reenvía la petición a Anthropic.
- Lee las cabeceras
anthropic-ratelimit-unified-*de las respuestas y guarda el uso observado de las ventanas de cinco horas y semanal. - Cuando se agota la cuota activa, una única decisión sincronizada selecciona la siguiente cuenta utilizable. Un límite breve de ráfaga espera y reintenta en la misma cuenta para conservar la caché caliente.
- El panel agrupa el audit log por dispositivo, modelo y cuenta. El equivalente en precio API es una estimación, no la contabilidad interna de la suscripción.
Anthropic documenta oficialmente las dos piezas que permiten la conexión. Su guía de autenticación de Claude Code explica ANTHROPIC_BASE_URL para un endpoint personalizado y claude setup-token para obtener un token OAuth de suscripción de larga duración en scripts o CI. No documenta ni aprueba el pooling de varias cuentas. La diferencia importa.
Consume-first protege la capacidad pagada que antes caduca
Round robin parece justo, pero ignora el reset. Imagina que la cuenta A conserva un 15 por ciento y se reinicia esta noche, mientras B conserva un 70 por ciento y se reinicia dentro de seis días. Enviar la próxima petición a B puede hacer que el resto de A caduque sin uso. La estrategia consume-first prioriza la ventana semanal utilizable que antes se reinicia. En otras palabras, gasta primero la capacidad más perecedera.
El proxy también separa el agotamiento de cuota de un límite corto de ráfaga. Un rechazo por cuota puede justificar cambiar de cuenta. Un 429 por minuto con retry-after debería pausar y reintentar en la misma cuenta. Rotar solo desplazaría la ráfaga y perdería la localidad del prompt cache. Umbrales, cooldown e histéresis reducen cambios innecesarios antes de un rechazo duro.
Qué demuestran los 101 checks y qué no
El test runner del repositorio declara 101 checks offline sobre lógica de rotación, analítica, comportamiento del proxy HTTP y escenarios de estrés. Los resultados publicados con upstream simulado incluyen 300 peticiones simultáneas atendidas, 50 streams SSE retransmitidos byte a byte y un fallo de cuota con 100 peticiones en curso que provocó exactamente un cambio de cuenta. Un lock serializa la decisión de failover para que la flota no recorra todas las cuentas a la vez.
El mantenedor publica resultados de un único proceso con un servicio de origen simulado. El ensayo mide el comportamiento y la sobrecarga de la pasarela. La fiabilidad en producción, la latencia del proveedor y el comportamiento con credenciales actuales quedan fuera del ensayo publicado.
Política vigente de credenciales de Anthropic
La documentación legal y de cumplimiento de Claude Code reserva OAuth de suscripción para el uso normal en las aplicaciones nativas de Anthropic. Los desarrolladores no pueden recopilar, guardar ni intermediar credenciales o tokens de sesión de Claude.ai, ni enrutar credenciales de consumo para otros usuarios. La sección 3 de los términos de consumo exige por regla general una clave API de Anthropic para el acceso automatizado, salvo autorización expresa, y prohíbe eludir medidas de protección. Usa el inicio de sesión nativo para Claude Code interactivo y claves API admitidas para tareas desatendidas o pasarelas de producto.
Alternativas más seguras cuando el límite es el problema
La documentación de créditos de uso de Anthropic cubre Pro, Max y Ultra. Si activas los créditos, tras agotar el uso incluido se aplican las tarifas estándar de API hasta alcanzar el tope mensual o agotar el saldo con recarga automática desactivada. Max y Ultra tienen un límite semanal separado para Fable. Los créditos API mensuales de planes elegibles son un saldo independiente. Según Anthropic, la mayoría de los créditos comprados desde el 7 de diciembre de 2026 caducan al cabo de doce meses, según las condiciones locales.
| Opción | Esfuerzo operativo | Ideal para | Trade-off principal |
|---|---|---|---|
| Esperar o reducir uso | Bajo | Límites ocasionales | El trabajo se pausa o cambia la calidad del modelo. |
| Usage credits | Bajo | Overflow personal imprevisible | Gasto variable a precio API. |
| API directa más gateway de producción | Alto | Equipos, productos y automatización gobernada | Coste medido e ingeniería de plataforma. |
| Team o Enterprise | Medio | Usuarios gestionados y controles organizativos | Hay que verificar contrato, seats y economía de uso. |
Conclusión
claude-rotate muestra cómo una pasarela puede centralizar la telemetría de cuota. Esa arquitectura también concentra credenciales y crea un punto de fallo. Para uso personal adicional, activa créditos con un límite mensual. Para cargas de una organización, usa una cuenta comercial o una pasarela con acceso API admitido.
