claude-rotate: Un proxy para varias cuentas Claude Max

Volver
Kevin Riedl

10 min de lectura · 4 sept 2026
Última revisión

Siguiente
Se crea en tu dispositivo, sin conectar con Instagram. Copiamos el enlace para su sticker de enlace.

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ónMejor opciónPor qué
Una persona posee varias cuentas Claude de pago y trabaja en varios dispositivos privadosInicio de sesión nativo de Claude CodeCompara el uso incluido y los créditos antes de contratar más suscripciones.
Una cuenta alcanza el límite solo de vez en cuandoEspera, cambia de modelo o activa usage creditsUn proxy añade trabajo operativo y de seguridad sin crear cuota.
Varios empleados o clientes necesitan capacidad compartidaUsa Team, Enterprise o acceso API medidoLas 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 contractualUsa un gateway de producción y un plan comercialclaude-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

  1. Cada cliente Claude Code apunta ANTHROPIC_BASE_URL al proxy y se autentica con una clave interna distinta para ese dispositivo.
  2. El proxy sustituye la clave por el setup token de la cuenta de pago activa y reenvía la petición a Anthropic.
  3. Lee las cabeceras anthropic-ratelimit-unified-* de las respuestas y guarda el uso observado de las ventanas de cinco horas y semanal.
  4. 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.
  5. 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ónEsfuerzo operativoIdeal paraTrade-off principal
Esperar o reducir usoBajoLímites ocasionalesEl trabajo se pausa o cambia la calidad del modelo.
Usage creditsBajoOverflow personal imprevisibleGasto variable a precio API.
API directa más gateway de producciónAltoEquipos, productos y automatización gobernadaCoste medido e ingeniería de plataforma.
Team o EnterpriseMedioUsuarios gestionados y controles organizativosHay 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.

Preguntas frecuentes

¿Qué es claude-rotate?
claude-rotate es un proxy self-hosted con licencia MIT para un propietario con varias suscripciones Claude de pago. Los clientes Claude Code se conectan a un endpoint privado que selecciona cuenta según telemetría de cuota y registra uso por dispositivo.
¿claude-rotate ofrece uso ilimitado de Claude Max?
No. Cada cuenta conserva los límites de sesión, semana, modelo y demás límites de Anthropic. El proxy solo usa otra cuenta de pago apta cuando la activa deja de ser utilizable.
¿Puedo usar claude-rotate para mi equipo o SaaS?
Anthropic prohíbe enrutar credenciales de consumo de otros usuarios y recopilar o intermediar sus tokens de sesión. Usa autenticación API admitida en pasarelas de producto y Team o Enterprise para gestionar el acceso del personal.
¿Por qué consume-first en vez de round robin?
Consume-first prioriza la cuota semanal utilizable que antes se reinicia. Reduce la posibilidad de que caduque capacidad pagada, mientras cooldown e histéresis evitan cambios innecesarios.
¿El equivalente de precio API es igual a la cuota Claude Max?
No. Estima el precio de lista API de los tokens registrados. La cuota de suscripción es otro sistema interno de Anthropic. Para enrutar se usa la telemetría de cuota devuelta.

Ayuda para IA en producción

Si estás construyendo un producto de IA y te preocupan el coste de inferencia, la arquitectura o la preparación para producción, Wavect ayuda a fundadores a convertir prototipos de IA en sistemas fiables.

Ruta de servicio:

Tu bandeja, sin ruido

Sigue el trabajo que te importa

Recibe un correo breve cuando publiquemos algo nuevo. Sigue todo el blog o solo los temas que te interesan.

¿Qué quieres recibir?
Elige tus temas

Gratis, doble opt-in y sin píxeles de seguimiento.

Volver
Kevin Riedl

10 min de lectura · 4 sept 2026
Última revisión

Siguiente

Recibe la próxima nota de campo sobre IA y agentes

Un correo breve cuando publiquemos. Sin píxeles de seguimiento ni contenido de relleno.

Gratis, doble opt-in y sin píxeles de seguimiento.