sbx
sbx
sbx는 Docker Sandboxes로 AI 에이전트용 격리 샌드박스 환경을 관리하는 명령이에요. AI 코딩 에이전트를 안전한 환경에서 실행하고 싶을 때 사용해요.
출처: 문서
본문
Docker Sandboxes는 Docker로 구동되는 AI 에이전트용 격리 샌드박스 환경을 만들어요. 명령 없이 실행하면 대화형 모드가 시작되고, 명령을 넘기면 CLI로 동작해요.
sbx COMMAND
지원하는 명령은 다음과 같아요.
| 명령 | 설명 |
|---|---|
sbx attach |
클라우드 샌드박스에 연결해요. 중지돼 있으면 먼저 시작해요. |
sbx completion |
지정한 셸의 자동 완성 스크립트를 생성해요. |
sbx cp |
샌드박스와 호스트 사이에서 파일·디렉터리를 복사해요. |
sbx create |
에이전트용 샌드박스를 만들어요. |
sbx daemon |
sandboxd 데몬을 관리해요. |
sbx diagnose |
sbx 설치의 일반적인 문제를 진단해요. |
sbx env |
실험적 — sbxenv.yaml 파일에서 선언적으로 샌드박스를 관리해요. |
sbx exec |
샌드박스 안에서 명령을 실행해요. |
sbx kit |
실험적 — kit 아티팩트를 관리해요. |
sbx login |
Docker에 로그인해요. |
sbx logout |
실행 중인 로컬 샌드박스를 멈추고 Docker에서 로그아웃해요. |
sbx ls |
샌드박스 목록을 보여줘요. |
sbx mcp |
MCP 서버를 관리해요. |
sbx policy |
샌드박스 정책을 관리해요. |
sbx ports |
샌드박스 포트 게시를 관리해요. |
sbx prune |
중지된 모든 샌드박스를 제거해요. |
sbx reset |
모든 샌드박스를 초기화하고 상태를 정리해요. |
sbx rm |
하나 이상의 샌드박스를 제거해요. |
sbx run |
샌드박스에서 에이전트를 실행해요. |
sbx secret |
저장된 시크릿을 관리해요. |
sbx settings |
Docker Sandboxes 설정을 관리해요. |
sbx setup |
실험적 — 호스트 구성을 감지하고 Docker Sandboxes를 준비해요. |
sbx skills |
실험적 — 샌드박스에서 사용할 수 있는 스킬을 관리해요. |
sbx stop |
제거하지 않고 하나 이상의 샌드박스를 중지해요. |
sbx template |
샌드박스 템플릿을 관리해요. |
sbx ttl |
클라우드 샌드박스의 TTL을 조회하거나 연장해요. |
sbx tui |
대화형 TUI 대시보드를 열어요. |
sbx version |
Docker Sandboxes 버전 정보를 보여줘요. |
sbx volume |
영구 볼륨을 관리해요 (클라우드 전용). |
지원하는 옵션은 다음과 같아요.
| 옵션 | 기본값 | 설명 |
|---|---|---|
--cloud |
로컬 sandboxd 대신 Docker Cloud Sandboxes API로 전달해요 (지원 동사가 계속 늘어나요 — 현재 목록은 sbx --cloud --help 참고). |
|
-D, --debug |
디버그 로깅을 켜요. |