Claude Code를 위한 보안 샌드박스 'Claude Cage' 공개

실용적 조언

Claude Code 사용 시 Docker를 통해 환경을 격리하면 SSH 키나 API 토큰 유출 위험을 줄일 수 있다.
claude.md 파일을 활용해 에이전트가 수행해서는 안 되는 파괴적 동작을 미리 정의해두는 것이 안전하다.

섹션별 상세

Claude Code의 기본 권한 문제점이 제기됐다. Claude Code는 실행 시 사용자의 셸 권한을 그대로 상속받기 때문에 ~/.ssh, ~/.aws, 브라우저 프로필, 다른 프로젝트의 .env 파일 등 시스템 전체의 민감한 데이터에 접근할 수 있는 위험이 존재한다.

Docker를 통한 워크스페이스 격리 방식을 도입했다. 'Claude Cage'는 Docker 컨테이너를 사용하여 Claude Code를 특정 워크스페이스 폴더 안에 가둔다. 컨테이너 내부에서는 지정된 코드 외에 호스트 머신의 개인 파일이나 자격 증명에 접근하는 것이 원천적으로 차단된다.

보안 규칙 및 설정을 통한 이중 제어를 구현했다. claude.md 파일을 통해 세션마다 보안 규칙을 로드하며, 여기에는 파일에 비밀번호 기록 금지, 강제 푸시(force-push) 금지, 파괴적인 명령 실행 전 확인 절차 등이 포함된다. 또한 settings.json을 통해 위험한 bash 패턴을 차단한다.

설치 편의성과 실용성을 확보했다. Docker가 설치되어 있다면 약 2분 내외로 설정을 완료할 수 있는 구조이다. 개발자는 이 도구를 제작하는 과정에서도 Claude Code를 활용하여 코드를 다듬고 기능을 완성했다.

용어 해설

샌드박스(Sandbox): — 외부로부터 격리된 안전한 실행 환경을 의미한다. 프로그램이 시스템의 다른 부분에 영향을 주지 않고 독립적으로 동작하도록 제한하여 보안 사고를 방지하는 기술적 장치이다.
워크스페이스 격리(Workspace Isolation): — AI 에이전트가 특정 프로젝트 폴더 내의 파일에만 접근할 수 있도록 권한을 제한하는 기법이다. 시스템 전체의 민감한 데이터에 접근하는 것을 차단하여 보안성을 높인다.
Claude 설정 파일(claude.md): — Claude Code 세션이 시작될 때 자동으로 로드되는 지침 파일이다. 에이전트가 준수해야 할 보안 규칙이나 행동 강령을 텍스트 형태로 정의하여 실행을 제어한다.

언급된 도구

Claude Code추천

Anthropic에서 제공하는 CLI 기반 AI 코딩 에이전트

Docker추천

애플리케이션을 컨테이너에 격리하여 실행하기 위한 플랫폼

언급된 리소스

GitHubClaude Cage GitHub Repository