docker-claudebox
Herramienta de contenedorización para Claude Code que ofrece múltiples interfaces (HTTP API, MCP, CLI, Telegram) sobre una base aicodebox. Incluye variantes minimal y full-toolchain con hardening de seguridad nativo.
Ficha actualizada 23 sept 2026, 20:21 · upstream 23 sept 2026, 20:00 · release v2.4.5
Qué es docker-claudebox
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio proporciona un entorno aislado en Docker para ejecutar Anthropic's Claude Code, construido sobre la imagen base `psyb0t/aicodebox`. La solución ofrece dos variantes principales: una imagen minimalista que instala las herramientas necesarias a la primera ejecución y una variante full-toolchain con Go, Python y Node.js preinstalados. El proyecto implementa un wrapper llamado `claudebox` para gestionar sesiones persistentes, recuperación automática de estado y gestión de claves SSH dentro del contenedor.
La arquitectura prioriza la seguridad mediante hardening nativo, como la eliminación de capacidades Linux por defecto (`--cap-drop=ALL`) y la restricción de privilegios. Soporta múltiples modos de operación unificados: CLI interactiva, API REST para gestión de workspaces, endpoint compatible con OpenAI, servidor MCP para agentes externos, bot Telegram y programador de tareas (Cron). El despliegue requiere Docker instalado en el host y configuración opcional de variables de entorno para autenticación.
- Automatización de tareas de desarrollo mediante CLI programática o API REST en pipelines CI/CD
- Integración con otros agentes de IA a través del protocolo MCP (Model Context Protocol)
- Despliegue de bots conversacionales en Telegram para gestión de código y shell access
- Orquestación de tareas periódicas usando el scheduler Cron integrado con historial de actividad
- Entorno aislado para pruebas de seguridad o análisis de código sin riesgo al host
- Hardening de seguridad por defecto: drop capabilities, no-new-privileges y limitación de recursos (RAM/CPU)
- Soporte nativo para Docker-in-Docker y gestión de sesiones persistentes con recuperación automática
- Múltiples interfaces unificadas en una sola imagen (API, MCP, CLI, Telegram, Cron)
- Gestión de workspaces aislados para despliegues multi-tenant con tracking de estado busy/idle
- La CLI de Claude Code se instala dinámicamente en la primera ejecución en la variante minimal (requiere conexión a npm)
- No incluye herramientas de desarrollo preinstaladas en la variante `latest` (Go, Python libs, kubectl, etc.)
- Requiere configuración manual de variables de entorno para autenticación (API keys o OAuth tokens)
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.
Usar flags recomendados: --cap-drop=ALL --cap-add=NET_BIND_SERVICE --memory=2g --cpus=2. Elegir imagen 'latest-full' si se requieren herramientas preinstaladas. Configurar ANTHROPIC_API_KEY o CLAUDE_CODE_OAUTH_TOKEN en el host. Montar directorios de trabajo y persistir ~/.claude y ~/.ssh/claudebox.
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.