HolyClaude: Claude 코드용 Docker 컨테이너, 브라우저 UI 및 헤드리스 크롬 포함

HolyClaude는 Anthropic의 공식 Claude Code CLI를 브라우저 기반 인터페이스와 브라우저 자동화 작업을 위한 헤드리스 크로미움과 함께 패키징한 Docker 컨테이너입니다. 이 프로젝트는 서버에서 완전한 브라우저 기능을 갖춘 Claude Code를 원격으로 실행하는 과제를 해결합니다.

주요 기능 및 설정

이 컨테이너에는 래퍼나 프록시가 아닌 Anthropic의 실제 Claude Code CLI가 포함되어 있습니다. 인증은 데스크톱 버전과 동일하게 Anthropic 계정으로 작동하며 Pro 플랜, Max 플랜 및 API 키를 지원합니다. 자격 증명은 호스트 머신의 바인드 마운트 폴더에 저장되며, 컨테이너는 Claude Code 자체가 접근하는 방식으로만 이에 접근합니다.

브라우저 자동화 기능

가장 복잡한 구현 작업은 크로미움이 Docker에서 제대로 실행되도록 구성하는 것이었습니다. 이 컨테이너는 헤드리스 크로미움과 Playwright가 사전 구성된 상태로 제공되어 공유 메모리 제한, xvfb 및 샌드박스 플래그와 같은 일반적인 설정 문제를 제거합니다. 이를 통해 Claude가 컨테이너 내에서 직접 스크린샷을 찍거나, 브라우저 테스트를 실행하거나, 콘텐츠를 스크랩할 수 있습니다.

추가 도구

• Gemini CLI
• OpenAI Codex
• Cursor
• Taskmaster AI

이러한 도구를 통해 개발자는 별도의 환경 설정 없이 동일한 코드베이스에서 다양한 AI 모델을 비교할 수 있습니다.

실용적인 사용 사례

제작자는 HolyClaude를 주로 다음과 같은 용도로 사용합니다:

• 원격 코드베이스에서의 장기 실행 세션
• 브라우저 자동화 작업
• Claude의 작업을 다시 확인하기 위한 두 번째 AI 실행

설정 및 기술적 세부 사항

설정은 간단합니다: docker compose up을 실행한 후 localhost:3001을 엽니다. 이 프로젝트는 MIT 라이선스 하에 무료 오픈소스입니다.

제한 사항 및 고려 사항

• 웹 UI(cloudcli)는 Anthropic이 개발한 것이 아닌 타사 제품입니다
• 크로미움과 도구로 인해 전체 이미지 크기는 약 4GB입니다
• 브라우저 없이 2GB의 슬림 버전을 사용할 수 있습니다
• 내장 HTTPS가 없습니다(외부 노출을 위해 리버스 프록시가 필요함)
• 공식 Anthropic 제품이 아닙니다(업스트림 변경 시 업데이트가 필요할 수 있음)

이러한 컨테이너화 접근 방식은 일반적으로 컨테이너화된 설정에서 구성하기 어려운 브라우저 자동화 기능을 유지하면서 제어된 환경이나 원격 서버에서 AI 코딩 어시스턴트를 실행하려는 개발자에게 유용합니다.