claudehost
Gateway autoalojado que convierte una suscripción de Claude Code en API compatible con OpenAI mediante LiteLLM y claudebox, permitiendo compartir costes fijos entre equipos.
Ficha actualizada 22 sept 2026, 16:33 · upstream 22 sept 2026, 16:25 · release sin release detectada
Qué es claudehost
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este proyecto transforma una suscripción de Claude Code en un endpoint API compatible con OpenAI para chat completions y sesiones agentic. Utiliza una arquitectura basada en Docker Compose donde LiteLLM actúa como gateway principal (puerto 4000), gestionando claves virtuales y seguimiento de gastos, mientras que claudebox ejecuta la CLI de Claude Code internamente (puerto 8080) para procesar las solicitudes reales. La solución permite a cualquier herramienta que hable la API OpenAI utilizar el modelo sin distinguir entre suscripción o API key.
- Compartir una suscripción mensual de Claude Pro/Max entre múltiples desarrolladores en lugar de pagar por tokens individuales.
- Integrar capacidades agentic de edición de código real (lectura, escritura, ejecución de tests) en pipelines CI/CD o IDEs.
- Actuar como proxy para herramientas existentes que requieren la API OpenAI pero que desean usar una cuota fija de suscripción.
- Monitorear el consumo de tokens por desarrollador mediante el dashboard y las claves virtuales generadas por LiteLLM.
- Proveer un endpoint único para chat completions estándar sin necesidad de configurar directamente la CLI de Anthropic.
- Arquitectura contenerizada con Docker Compose que expone solo el puerto del gateway (4000) al exterior.
- Control de costes basado en suscripción plana, evitando facturas escalables por token para equipos grandes.
- Soporte nativo para sesiones agentic mediante headers específicos (X-Aicodebox-Workspace) para acceso a repositorios locales.
- Tracking de gasto y generación de claves virtuales gestionado por LiteLLM con persistencia en PostgreSQL.
- Integración directa con la CLI oficial de Claude Code sin necesidad de reescribir el backend del modelo.
- Riesgo de seguridad elevado: claudebox ejecuta comandos arbitrarios con bypassPermissions y sudo sin contraseña, requiriendo auditoría del código fuente.
- Uso compartido de límites de capacidad (rate limits) de la suscripción entre todos los usuarios conectados al gateway.
- Términos de servicio de Anthropic para planes de consumo no están diseñados para reventa o uso corporativo masivo vía API.
- Dependencia de submódulos Git (claudebox) que deben inicializarse correctamente para funcionar el backend.
- No incluye auditoría de seguridad independiente; es un proyecto de un solo mantenedor sin revisión externa.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Desplegar detrás de TLS y restringir el acceso al puerto 4000 a la red interna o VPN. Generar claves SSH para repositorios privados en el directorio ssh/claudebox antes del arranque. Revisar siempre el código fuente de claudebox (submódulo) por permisos elevados. Configurar LITELLM_MASTER_KEY con seguridad adecuada y usar env vars para credenciales sensibles.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.