네트워크 허용 목록과 호스트 측 시크릿 주입을 지원하는 Linux 기반 CLI로, AI 에이전트를 임시 microVM에서 실행합니다.
anthropics/sandbox-runtime
컨테이너 없이 OS 수준에서 임의의 프로세스의 파일 시스템 및 네트워크 접근을 제한하는 경량 CLI이자 라이브러리입니다.
- 스타
- 6,425
- 포크
- 562
- 열린 이슈
- 300
- 마지막 커밋
- 7시간 전
어떤 프로젝트인가요?
srt는 AI 에이전트, 로컬 MCP 서버, bash 명령 또는 다른 프로세스와 같은 임의의 명령을 감싸서 읽기, 쓰기 및 연결할 수 있는 대상을 제한합니다. macOS에서는 생성된 Seatbelt 프로파일과 함께 sandbox-exec를 사용하고, Linux에서는 네트워크 네임스페이스와 함께 bubblewrap을 사용합니다. Windows에서는 전용 로컬 계정으로 프로세스를 실행하고 Windows Filtering Platform 이그레스 펜스를 적용합니다.
네트워크 접근은 기본적으로 차단됩니다. 허용된 트래픽은 호스트의 HTTP 및 SOCKS5 프록시를 거치며, 프록시가 도메인 허용 목록과 차단 목록을 적용합니다. 파일 시스템 규칙은 읽기에 대해 차단 후 허용 모델을, 쓰기에 대해서는 허용 전용 모델을 사용합니다. 두 플랫폼 모두 Unix 소켓 접근은 기본적으로 차단됩니다.
이 패키지는 명령줄에서 `srt`로 사용하거나 SandboxManager가 포함된 TypeScript 라이브러리로 가져와 사용할 수 있습니다. 설정 파일, macOS의 위반 보고, 런타임 설정 채널도 지원합니다.
핵심 기능
- 01모든 프로세스 트리의 파일 시스템 읽기 및 쓰기를 제한합니다
- 02호스트 측 프록시를 통해 도메인 허용 목록과 차단 목록을 적용합니다
- 03macOS에서는 sandbox-exec를, Linux에서는 bubblewrap을 사용합니다
- 04Unix 소켓 접근을 기본적으로 차단합니다
- 05CLI와 TypeScript 라이브러리 API를 모두 제공합니다
활용 사례
- AI 코딩 에이전트가 SSH 키를 읽거나 임의의 호스트에 접속하지 못하도록 샌드박싱합니다
- 로컬 MCP 서버가 특정 디렉터리와 네트워크 대상에만 접근하도록 제한합니다
- 신뢰할 수 없는 bash 명령이나 빌드 스크립트를 제한된 접근 권한으로 실행합니다
빠른 시작
- 1
npm으로 패키지를 전역 설치합니다
npm install -g @anthropic-ai/sandbox-runtime - 2
샌드박스 내에서 명령을 실행합니다
srt "curl example.com"
사용 전 알아둘 점
- 베타 연구 프리뷰이며 API와 구성 형식은 변경될 수 있습니다.
- macOS의 sandbox-exec, Linux의 bubblewrap 같은 OS 프리미티브에 의존하며, Linux에서는 bubblewrap을 설치해야 합니다.
- Windows 지원에는 프로세스 토큰 및 시스템 서비스와 관련해 문서화된 알려진 제한 사항이 있습니다.
포함된 컬렉션
토픽
자주 묻는 질문
- sandbox-runtime은(는) 무엇인가요?
- 컨테이너 없이 OS 수준에서 임의의 프로세스의 파일 시스템 및 네트워크 접근을 제한하는 경량 CLI이자 라이브러리입니다. srt는 AI 에이전트, 로컬 MCP 서버, bash 명령 또는 다른 프로세스와 같은 임의의 명령을 감싸서 읽기, 쓰기 및 연결할 수 있는 대상을 제한합니다. macOS에서는 생성된 Seatbelt 프로파일과 함께 sandbox-exec를 사용하고, Linux에서는 네트워크 네임스페이스와 함께 bubblewrap을 사용합니다. Windows에서는 전용 로컬 계정으로 프로세스를 실행하고 Windows Filtering Platform 이그레스 펜스를 적용합니다.
- sandbox-runtime은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- sandbox-runtime은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- sandbox-runtime은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. sandbox-runtime의 마지막 커밋은 2026년 10월 24일입니다.
- sandbox-runtime은(는) 어디에 사용할 수 있나요?
- AI 코딩 에이전트가 SSH 키를 읽거나 임의의 호스트에 접속하지 못하도록 샌드박싱합니다 로컬 MCP 서버가 특정 디렉터리와 네트워크 대상에만 접근하도록 제한합니다 신뢰할 수 없는 bash 명령이나 빌드 스크립트를 제한된 접근 권한으로 실행합니다
- sandbox-runtime는 어떻게 설치하나요?
- npm으로 패키지를 전역 설치합니다: npm install -g @anthropic-ai/sandbox-runtime 샌드박스 내에서 명령을 실행합니다: srt "curl example.com"
- sandbox-runtime은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/anthropics/sandbox-runtime
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Claude Code와 다른 AI 코딩 에이전트를 기본 OS 샌드박스나 Docker 안에서 자동 승인으로 실행해, 컴퓨터를 더 안전하게 지켜 주는 샌드박스 래퍼입니다.
FUSE를 통해 암호문 폴더를 읽을 수 있는 평문 뷰로 마운트하는 Go 기반 암호화 오버레이 파일시스템입니다.
AI 에이전트마다 프로젝트의 쓰기 및 분기 가능한 복사본을 제공하는 버전 관리 파일시스템
Linux 시스템 호출을 사용자 공간에서 가로채 컨테이너를 샌드박싱하는 Go 기반 애플리케이션 커널로, runsc OCI 런타임으로 실행할 수 있습니다.