참조 devcontainer 설정과 관련 Dockerfile은 그대로 사용하거나 필요에 따라 사용자 정의할 수 있는 사전 구성된 개발 컨테이너를 제공합니다. 이 devcontainer는 Visual Studio Code Dev Containers 확장 및 유사한 도구와 함께 작동합니다. 컨테이너의 향상된 보안 조치(격리 및 방화벽 규칙)를 통해 claude --dangerously-skip-permissions를 실행하여 무인 작업을 위한 권한 프롬프트를 우회할 수 있습니다.
devcontainer가 상당한 보호 기능을 제공하지만, 모든 공격에 완전히 면역인 시스템은 없습니다. --dangerously-skip-permissions로 실행할 때, devcontainer는 악성 프로젝트가 Claude Code 자격 증명을 포함하여 devcontainer에서 액세스 가능한 모든 것을 유출하는 것을 방지하지 않습니다. 신뢰할 수 있는 저장소로 개발할 때만 devcontainer를 사용하는 것을 권장합니다. 항상 좋은 보안 관행을 유지하고 Claude의 활동을 모니터링하세요.

​
주요 기능

  • 프로덕션 준비 Node.js: 필수 개발 종속성이 포함된 Node.js 20을 기반으로 구축
  • 설계에 의한 보안: 필요한 서비스에만 네트워크 액세스를 제한하는 사용자 정의 방화벽
  • 개발자 친화적 도구: git, 생산성 향상 기능이 있는 ZSH, fzf 등 포함
  • 원활한 VS Code 통합: 사전 구성된 확장 및 최적화된 설정
  • 세션 지속성: 컨테이너 재시작 간에 명령 기록 및 구성 보존
  • 어디서나 작동: macOS, Windows 및 Linux 개발 환경과 호환

​
4단계로 시작하기

  1. VS Code와 Remote - Containers 확장 설치
  2. Claude Code 참조 구현 저장소 복제
  3. VS Code에서 저장소 열기
  4. 프롬프트가 표시되면 “Reopen in Container” 클릭 (또는 명령 팔레트 사용: Cmd+Shift+P → “Remote-Containers: Reopen in Container”)

​
구성 분석

devcontainer 설정은 세 가지 주요 구성 요소로 구성됩니다:

​
보안 기능

컨테이너는 방화벽 구성을 통해 다층 보안 접근 방식을 구현합니다:
  • 정밀한 액세스 제어: 화이트리스트에 등록된 도메인(npm 레지스트리, GitHub, Anthropic API 등)에만 아웃바운드 연결 제한
  • 허용된 아웃바운드 연결: 방화벽은 아웃바운드 DNS 및 SSH 연결을 허용
  • 기본 거부 정책: 다른 모든 외부 네트워크 액세스 차단
  • 시작 검증: 컨테이너 초기화 시 방화벽 규칙 검증
  • 격리: 메인 시스템과 분리된 안전한 개발 환경 생성

​
사용자 정의 옵션

devcontainer 구성은 필요에 따라 적응할 수 있도록 설계되었습니다:
  • 워크플로우에 따라 VS Code 확장 추가 또는 제거
  • 다양한 하드웨어 환경에 대한 리소스 할당 수정
  • 네트워크 액세스 권한 조정
  • 셸 구성 및 개발자 도구 사용자 정의

​
사용 사례 예시

​
안전한 클라이언트 작업

devcontainer를 사용하여 다양한 클라이언트 프로젝트를 격리하여 환경 간에 코드와 자격 증명이 섞이지 않도록 보장합니다.

​
팀 온보딩

새로운 팀 구성원은 필요한 모든 도구와 설정이 사전 설치된 완전히 구성된 개발 환경을 몇 분 안에 얻을 수 있습니다.

​
일관된 CI/CD 환경

CI/CD 파이프라인에서 devcontainer 구성을 미러링하여 개발 및 프로덕션 환경이 일치하도록 보장합니다.

​
관련 리소스