HolyCode: 지속적인 AI 코딩 에이전트 환경을 위한 Docker 컨테이너

HolyCode는 환경 전환 문제를 해결하기 위해 Claude Code로 구축된 Docker 컨테이너입니다. 개발자는 전체 환경을 재구축하지 않고도 어디서나 실행할 수 있는 하나의 Docker 설정을 갖기 위해 이를 만들었습니다.

Claude Code 사용 방법

• Docker/런타임 아키텍처를 빠르게 반복
• 브라우저/컨테이너 문제 디버깅 (Chromium + Xvfb + Playwright 흐름)
• 재구축이 반복 가능하도록 시작 및 복구 흐름 개선
• 예측 가능한 설정을 위한 문서 및 문제 해결 단계 정제

기능

• 세션, 설정, 플러그인을 지속적 저장소에 유지하여 재구축 시 진행 상황이 삭제되지 않음
• 에이전트 워크플로우를 위해 사전 연결된 브라우저 도구 제공
• 일상 사용을 위한 안정성 기본값 사용 (shm_size: 2g, 권한 매핑, 프로세스 감독)
• OpenCode를 통해 Claude, OpenAI, Gemini 및 기타 제공업체 워크플로우 지원

빠른 시작

docker-compose.yml 파일 생성:

services:
  holycode:
    image: coderluii/holycode:latest
    restart: unless-stopped
    shm_size: 2g
    ports:
      - "4096:4096"
    volumes:
      - ./data/opencode:/home/opencode
      - ./workspace:/workspace
    environment:
      - PUID=1000
      - PGID=1000
      - ANTHROPIC_API_KEY=your-key-here

그런 다음 실행:

docker compose up -d

http://localhost:4096을 열어 환경에 접속하세요.

컨테이너는 Docker Hub에서 coderluii/holycode:latest로 이용 가능하며 소스는 GitHub에 있습니다. 개발자는 후속 댓글에서 정확한 백업/복원 및 업그레이드/롤백 절차를 공유할 수 있다고 언급했습니다.