HolyClaude: Estación de Trabajo de Codificación IA con Un Solo Comando
HolyClaude: La Estación de Trabajo de Desarrollo IA Definitiva con Un Solo Comando
Deja de Configurar. Empieza a Construir.
Has pasado horas (o días) luchando con permisos de Docker, límites de memoria compartida de Chromium, cuelgues del instalador de Claude Code y errores de permisos denegados. HolyClaude resuelve cada uno de ellos.
Un comando te da: - ✅ CLI de Claude Code (funciona con tu suscripción Max/Pro existente) - ✅ Interfaz web CloudCLI (http://localhost:3001) - ✅ Chromium sin cabeza + Xvfb + Playwright (capturas de pantalla, pruebas, Lighthouse) - ✅ 7 CLIs de IA: Claude, Gemini, OpenAI Codex, Cursor, Junie, TaskMaster, OpenCode - ✅ Más de 50 herramientas de desarrollo: Node.js 22, Python 3, pnpm, git/gh, ripgrep, más de 100 paquetes npm/pip - ✅ Multi-arquitectura: AMD64 + ARM64 (Raspberry Pi, Apple Silicon, AWS Graviton)
mkdir holyclaude && cd holyclaude
# Copia docker-compose.yaml desde el repositorio
docker compose up -d
# Abre http://localhost:3001
Eso es todo. Tu autenticación de Anthropic funciona a través del flujo OAuth de la interfaz web. Sin costos extra. Licencia MIT. 1.7k estrellas en GitHub.
Por Qué Existe HolyClaude
Configuración manual = 2+ horas de dolor: - Chromium se cuelga (shm_size=64MB → corrección a 2GB) - Permiso denegado (desajuste PUID/PGID) - Instalador de Claude se cuelga (WORKDIR propiedad de root) - Bloqueos de SQLite en montajes NAS - Vigilantes de archivos rotos en comparticiones SMB
HolyClaude = 30 segundos de docker compose up. Cada caso límite manejado.
Qué Hay Dentro (Imagen Completa)
CLIs de IA (cambia con una tecla Tab): Claude, Gemini, Codex, Cursor, Junie, TaskMaster, OpenCode
Lenguajes y Herramientas de Construcción: - Node.js 22 + pnpm + TypeScript + Vite + esbuild - Python 3 + pandas/numpy + FastAPI + requests
Automatización de Navegador: Chromium + Xvfb(:99) + Playwright (preconfigurado)
Despliegue: Vercel, Netlify, Cloudflare Workers, Azure CLI
Procesamiento de Datos: Generación de PDF (7 bibliotecas), Excel/Word/PowerPoint, ffmpeg, pandoc
Sistema: git/gh, ripgrep/fd/fzf, tmux, htop, psql/redis-cli
Inicio Rápido (Listo para Copiar y Pegar)
Crea docker-compose.yaml:
services:
holyclaude:
image: coderluii/holyclaude:latest
container_name: holyclaude
restart: unless-stopped
shm_size: 2g
cap_add:
- SYS_ADMIN
- SYS_PTRACE
security_opt:
- seccomp=unconfined
ports:
- "3001:3001"
volumes:
- ./data/claude:/home/claude/.claude
- ./workspace:/workspace
environment:
- TZ=UTC
docker compose up -d
open http://localhost:3001 # Inicia sesión con Anthropic
Usa Tu Suscripción Existente
Claude Max/Pro: OAuth de interfaz web (igual que la app de escritorio) Clave API: Pégala en la configuración Sin costo extra - HolyClaude es OSS gratuito
Otros proveedores también funcionan:
- OpenAI/ChatGPT: codex login --device-auth
- Gemini: GEMINI_API_KEY
- Cursor: CURSOR_API_KEY
Soporte de Plataformas
| Plataforma | Estado | Notas |
|---|---|---|
| Linux amd64 | ✅ | Recomendado |
| Linux arm64 | ✅ | Pi 4+, Oracle Cloud |
| macOS | ✅ | Docker Desktop |
| Windows | ✅ | WSL2 + Docker |
| Synology/QNAP | ✅ | Listo para NAS |
Listo para Producción
- Persistencia:
./data/claude(credenciales),./workspace(código) - Supervisión de Procesos: s6-overlay (reinicio automático, apagado elegante)
- Actualizaciones:
docker compose pull && docker compose up -d - Permisos: Mapeo PUID/PGID
- Notificaciones: Discord/Telegram/Slack/Email (Apprise)
Imágenes Slim vs Completas
| Tag | Tamaño | Ideal para |
|---|---|---|
:latest |
Completa | Tiempo de espera cero |
:slim |
Ligera | VPS, ancho de banda medido |
Slim instala automáticamente paquetes faltantes. Completa tiene todo precompilado.
Creado por Usuarios Diarios
"Esto es lo que ejecuto todos los días en mi servidor." - CoderLuii
1.7k ⭐ 190 forks. Licencia MIT. Mantenido activamente.
Repositorio GitHub - Dale estrella, haz un fork, construye con él.
Deja de luchar con Docker. Empieza a enviar código.