Cloudflare Sandbox SDK — 에이전트용 격리 컨테이너 실행면

개요

Cloudflare Sandbox SDK는 Workers 애플리케이션이 신뢰할 수 없는 코드나 장시간 실행 프로세스를 격리된 컨테이너에서 실행하도록 만드는 SDK다. Workers의 가벼운 isolate만으로 부족한 AI 코드 실행, CI/CD, 데이터 분석, 대화형 개발 환경을 Containers와 Durable Objects 위에 올린다.

핵심 구성

• getSandbox()로 샌드박스 인스턴스를 얻고 exec(), 파일 읽기·쓰기, 백그라운드 프로세스, PTY를 제어한다.
• Python·JavaScript·TypeScript용 영속 code interpreter와 구조화 출력, 서비스용 preview URL, trycloudflare.com quick tunnel을 제공한다.
• R2 백업·복원으로 git clone과 npm install 같은 초기화 비용을 줄이고, outbound Worker로 자격 증명 주입·허용 호스트·동적 egress 정책을 적용한다.
• 예제에는 AI 에이전트, OpenAI Agents, Claude Code headless, OpenCode, TypeScript validator가 포함된다.

선택 기준과 한계

가벼운 에이전트 도구 호출은 2026-08-09-github-cloudflare-agents의 Worker/Code Mode가 더 적합하고, Linux 명령·네이티브 의존성·장기 프로세스가 필요할 때 Sandbox로 승격한다. 현재 README는 beta이며 API가 v1 전까지 바뀔 수 있고, 로컬 개발에는 Docker가 필요하다. 설치·컨테이너 실행·성능 측정은 수행하지 않았다.

출처

• GitHub 저장소 — Apache License 2.0.
• Containers/Sandboxes GA changelog — 2026-04-13 GA 및 기능 목록.
• 2026-08-09-github-cloudflare-containers · 2026-08-09-github-cloudflare-moltworker · moc-cloudflare-open-source