클로드 코드 컨테이너는 클로드 코드를 위한 제로-설정 도커 격리 환경을 제공합니다.

Claude Code Container(ccc)는 Claude Code를 위한 제로 설정 Docker 격리를 제공하는 무료 오픈소스 도구입니다. 이 도구는 Claude Code 자체를 사용하여 구축되었으며, 홈 디렉토리 삭제, 데이터베이스 파일 초기화, 민감한 파일 무단 읽기와 같은 문제를 일으킨 Claude Code의 --dangerouslySkipPermissions 플래그로 인한 보안 문제를 해결합니다.

설치 및 기본 사용법

설치는 단일 명령어만 필요합니다: npm install -g claude-code-container. 설치 후 claude-code 대신 ccc를 사용할 수 있습니다.

주요 기능

• 경로 해시로 이름이 지정된 프로젝트별 컨테이너를 생성하여 --continue 및 --resume이 올바르게 작동하도록 보장
• 호스트 환경 변수, 로케일 및 시간대를 자동으로 전달
• SSH 키와 SSH 에이전트를 마운트(추가 설정 없이 git push 작동)
• Claude가 컨테이너 내부에서 호스트의 개발 서버를 localhost:3000, :8080 등으로 접근할 수 있도록 투명한 로컬호스트 프록시 제공
• 이미지 지원을 포함한 Claude 세션에서 클립보드 기능 유지
• 프로젝트별 Node/Python/Java/Go 버전을 위한 mise 통합 포함
• 마지막 세션이 종료되면 컨테이너 자동 중지
• 사전 구성된 Chromium + chrome-devtools MCP: Claude가 브라우저를 열고, 페이지를 탐색하고, 스크린샷을 찍고, JavaScript를 실행하며, 웹 앱과 자율적으로 상호작용 가능

기술 구현

투명한 로컬호스트 프록시는 Linux에서는 iptables를, macOS/Windows에서는 사용자 공간 프록시를 사용합니다(Docker Desktop은 --network host를 지원하지 않으므로), 자동으로 host.docker.internal로 폴백됩니다.

해결하는 문제

이 도구는 기존 접근 방식의 한계를 해결합니다: 프로젝트별 Dockerfile은 인프라 유지 관리가 필요하고, devcontainers는 복잡한 구성과 느린 설정을 가지며, 수동 docker run은 환경 변수 전달, SSH 키 가용성, 클립보드 기능 및 로컬호스트 접근을 깨뜨립니다.