HolyClaude: Contêiner Docker para Claude Code com Interface de Navegador e Chromium Headless

HolyClaude é um contêiner Docker que empacota o Claude Code CLI oficial da Anthropic com uma interface baseada em navegador e Chromium headless para tarefas de automação de navegador. O projeto aborda o desafio de executar o Claude Code remotamente em um servidor com funcionalidade completa de navegador.

Principais Recursos e Configuração

O contêiner inclui o Claude Code CLI real da Anthropic, não um wrapper ou proxy. A autenticação funciona com contas da Anthropic da mesma forma que a versão desktop, suportando planos Pro, planos Max e chaves de API. As credenciais são armazenadas em uma pasta montada por bind na máquina host, com o contêiner acessando-as apenas como o próprio Claude Code faria.

Capacidades de Automação de Navegador

O trabalho de implementação mais complexo envolveu configurar o Chromium para funcionar corretamente no Docker. O contêiner vem com Chromium headless e Playwright pré-configurados, eliminando os desafios típicos de configuração com limites de memória compartilhada, xvfb e flags de sandbox. Isso permite que o Claude tire capturas de tela, execute testes de navegador ou extraia conteúdo diretamente de dentro do contêiner.

Ferramentas Adicionais

• Gemini CLI
• OpenAI Codex
• Cursor
• Taskmaster AI

Essas ferramentas permitem que desenvolvedores comparem diferentes modelos de IA na mesma base de código sem configurações de ambiente separadas.

Casos de Uso Práticos

O criador usa o HolyClaude principalmente para:

• Sessões de longa duração em bases de código remotas
• Tarefas de automação de navegador
• Iniciar uma segunda IA para verificar novamente o trabalho do Claude

Configuração e Detalhes Técnicos

A configuração é simples: docker compose up seguido de abrir localhost:3001. O projeto é gratuito e de código aberto sob a licença MIT.

Limitações e Considerações

• A interface web (cloudcli) é de terceiros, não desenvolvida pela Anthropic
• O tamanho total da imagem é aproximadamente 4GB devido ao Chromium e ferramentas
• Uma versão slim de 2GB está disponível sem o navegador
• Sem HTTPS integrado (requer proxy reverso para exposição externa)
• Não é um produto oficial da Anthropic (pode precisar de atualizações se houver mudanças upstream)

Esse tipo de abordagem conteinerizada é útil para desenvolvedores que desejam executar assistentes de codificação com IA em ambientes controlados ou em servidores remotos, mantendo capacidades de automação de navegador que normalmente são desafiadoras de configurar em ambientes conteinerizados.