CoderLuii/HolyClaude

HolyClaude – Docker 컨테이너 내 빠른 AI 개발 워크스테이션

무엇인가요 – HolyClaude는 공식 Claude Code CLI(Anthropic의 코딩 어시스턴트)와 풀스택 개발 환경을 함께 묶은 즉시 사용 가능한 Docker 이미지입니다:

• Claude와 상호작용하기 위한 웹 UI(CloudCLI)
• 스크린샷 및 UI 테스트용 헤드리스 Chromium + Xvfb + Playwright
• 8개의 AI-CLI 도구(Claude, OpenAI Codex, Gemini, Cursor, TaskMaster, Junie, OpenCode, Pi) 사전 설치
• Node 26, Python, Git, 데이터베이스 클라이언트 등 50개 이상의 일반적인 개발 유틸리티
• s6-overlay를 통한 프로세스 감시
• amd64 & arm64 다중 아키텍처 이미지 및 저디스크 환경용 슬림 버전

전체 스택은 컨테이너화되어 있어, "Claude 설치, Chromium 수정, Xvfb 설정, 권한 설정" 등의 번거로운 과정에서 벗어날 수 있습니다. 단지 docker compose up만 하면 기존 Anthropic 구독(Max/Pro) 또는 API 키와 호환되는 항상 실행 중인 Linux 워크스테이션이 즉시 준비됩니다.

---

빠른 시작 (30초)

mkdir holyclaude && cd holyclaude
cat > docker-compose.yaml <<'EOF'
services:
  holyclaude:
    image: coderluii/holyclaude:latest
    container_name: holyclaude
    restart: unless-stopped
    shm_size: 2g
    ports:
      - "127.0.0.1:3001:3001"
    volumes:
      - ./data/claude:/home/claude/.claude   # 인증 정보 및 Claude 메모리 지속 저장
      - ./workspace:/workspace               # 당신의 코드
    environment:
      - TZ=UTC
EOF

docker compose up -d

http://localhost:3001을 열고 CloudCLI 계정을 생성한 후 Anthropic 자격 증명으로 로그인하면 Claude와 함께 바로 코드 작성이 가능합니다.

---

왜 HolyClaude를 사용해야 할까요?

기능	HolyClaude	수동 설정
Claude Code	사전 설치되어 즉시 사용 가능	설치, 설치기 디버깅, 권한 수정 필요
웹 UI	CloudCLI가 함께 제공되어 별도 설정 불필요	직접 UI를 찾아 설정해야 함
헤드리스 브라우저	Chromium + Xvfb + Playwright, shm = 2GB	각 구성 요소를 개별 설치하고 공유 메모리 및 샌드박스 설정 조정 필요
AI CLIs	Claude, Codex, Gemini 등 8개의 프로바이더 준비 완료	각 CLI를 별도로 설치해야 함
개발 도구	Node, Python, Git, DB 클라이언트 등	수동 apt/npm/pip 설치 필요
프로세스 감시	s6-overlay가 자동 재시작	자체 supervisord 설정 작성 필요
지속성	./data/claude를 바인드 마운트하면 재빌드 후에도 인증 정보 및 Claude 메모리 유지
다중 아키텍처	amd64 & arm64 이미지 제공 – Raspberry Pi, NAS, 클라우드 VM에서 작동
업데이트	docker compose pull && docker compose up -d	수십 개의 도구를 수동으로 업데이트해야 함

요약하면, HolyClaude는 "내 머신에서는 작동한다"는 번거로움을 제거하고 재현 가능한 항상 실행 중인 AI 개발 환경을 제공합니다.

---

이미지 버전

태그	내용	사용 시기
latest (풀)	모든 도구 사전 설치 – Claude 명령어 실행 시 대기 없음
slim	핵심 런타임만 포함 – 필요한 도구는 필요 시 설치 – 다운로드 크기 작음
X.Y.Z / X.Y.Z-slim	프로덕션 안정성을 위해 고정된 릴리스

두 버전 모두 amd64 및 arm64 지원; 크기는 Docker Hub에 표시됨.

---

인증 및 비용

• Claude Max/Pro – CloudCLI UI(OAuth)로 로그인 – Anthropic에 이미 지불하는 금액과 동일하게 지불.
• Anthropic API 키 – UI에 키를 붙여넣기 – 일반적인 사용 기반 청구 방식.
• 자격 증명 리레이 없음: 컨테이너는 파일, 바인드 마운트 또는 환경 변수에서 키를 읽고 프로바이더에 직접 연결.
• 다른 AI CLI(Gemini, OpenAI Codex, Cursor 등)도 각각의 API 키로 동일하게 작동.

---

확장 및 사용자 정의

• 완전한 compose 템플릿(README 참조)은 Next.js, Vite, Cloudflare Workers, SSH 등 여러 옵션 포트를 노출하고 .env로 경로를 재정의 가능.
• 원격 접근 – 포트 노출 대신 Tailscale 또는 Cloudflare Tunnel을 통해 보안적인 외부 접근을 권장.
• Ollama – 로컬 LLM을 HolyClaude와 함께 실행하는 방법에 대한 섹션 제공.
• 로컬 빌드 – 커스텀 툴체인 필요 시 소스에서 이미지 재빌드 가능.

---

알려진 제한 및 로드맵

• Kubernetes 지원은 "곧 출시 예정" (Helm 차트 계획 중).
• 현재 릴리스(v1.6.4)에는 커스텀 FFmpeg 빌드 및 기타 번들된 바이너리의 알려진 CVE에 대한 "수용 가능한 위험" 보안 매니페스트 포함.
• 향후 작업: 더 강화된 컨테이너 하드닝, 선택적 GPU 지원, K8s용 Helm 차트.

---

도움 받기

• GitHub에서 이슈 열기.
• X(구 Twitter) @CoderLuii에서 커뮤니티 참여.
• 유용하다고 느끼시면 PayPal 또는 Buy Me A Coffee로 기부하기.

---

결론: HolyClaude는 공식 오픈소스 프로젝트로, 완전한 Claude 기반 AI 개발 워크스테이션을 단일 Docker 이미지로 패키지화하여 설정 시간을 극도로 단축하고 일반적인 Docker 관련 문제를 제거합니다.