Shell

에이전트가 설치되지 않은 셸 샌드박스의 용도와 사용법을 설명해 드릴게요.

출처: 문서

본문

이 페이지는 로컬 샌드박스를 설명해요. 클라우드 동작과 제한 사항은 로컬과 클라우드 샌드박스 비교 문서를 보세요.

sbx run shell은 미리 설치된 에이전트 바이너리 없이 샌드박스 안의 Bash 로그인 셸로 진입시켜 줘요. 에이전트를 수동으로 설치·구성하거나, 커스텀 구현을 테스트하거나, 실행 중인 환경을 살펴볼 때 유용해요.

$ sbx run shell ~/my-project

sbx run은 워크스페이스를 현재 디렉터리로 기본 설정해요. 대화형 셸 대신 일회성 명령을 실행하려면 -- 뒤에 넘겨 주세요:

$ sbx run shell -- -c "echo 'Hello from sandbox'"

마운트 없는 샌드박스(mountless sandbox)를 만들려면 워크스페이스 경로 없이 sbx create를 쓰고, 이름으로 붙여서 사용하세요:

$ sbx create --name scratch shell
$ sbx run --name scratch

추가 인자 없이 샌드박스는 bash -l을 실행해요. -- 뒤의 첫 인자가 플래그(-로 시작)면 -l 뒤에 추가되므로 로그인 셸 동작이 유지돼요:

$ sbx run shell -- -c "echo hi"  # bash -l -c "echo hi" 를 실행

첫 인자가 일반 단어면 -l을 대신 대체해요.

샌드박스를 실행하기 전에 저장된 시크릿(stored secrets)으로 자격 증명을 저장해 두세요. 프록시가 이를 아웃바운드 API 요청에 주입하며, 자격 증명은 VM 안에 절대 저장되지 않아요:

$ sbx secret set anthropic
$ sbx secret set openai

셸 안에 들어가면 표준 방법으로 에이전트를 설치할 수 있어요. 예를 들어 npm install -g @continuedev/cli. 복잡한 설정이라면 매번 대화형으로 설치하기보다 워크로드 키트(workload kit)를 만드는 게 좋아요.

셸 샌드박스는 shell 기본 이미지를 사용해요 — 미리 설치된 에이전트가 없는 공통 기본 환경이죠.

관련 문서와 심화 내용은 원문을 참고해 주세요.