Shell 에이전트

이 페이지는 로컬 샌드박스를 다뤄요. 클라우드 동작과 제한은 Compare local and cloud sandboxes를 참고해요.

출처: 문서

본문

sbx run shell은 미리 설치된 에이전트 바이너리 없이 샌드박스 안의 Bash 로그인 셸로 들어가게 해줘요. 에이전트를 수동으로 설치·구성하거나, 커스텀 구현을 테스트하거나, 실행 중인 환경을 검사하는 데 유용해요.

$ sbx run shell ~/my-project

sbx run의 작업 공간 기본값은 현재 디렉터리예요.

인터랙티브 셸 대신 일회성 명령을 실행하려면 -- 뒤에 전달해요.

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

마운트 없는 샌드박스를 만들려면 작업 공간 경로 없이 sbx create를 쓴 뒤 이름으로 attach해요.

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

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

$ sbx run shell -- -c "echo hi"   # runs bash -l -c "echo hi"

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

샌드박스를 실행하기 전에 저장된 시크릿을 사용해 자격 증명을 저장해요. 프록시가 이를 나가는 API 요청에 주입하며, 자격 증명은 VM 안에 절대 저장되지 않아요.

$ sbx secret set anthropic
$ sbx secret set openai

셸 안에서 에이전트를 표준 방식으로 설치할 수 있어요. 예: npm install -g @continuedev/cli. 복잡한 설정이라면 매번 인터랙티브하게 설치하는 대신 워크로드 키트(workload kit)를 만드는 편이 낫습니다.

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