에이전트 샌드박스
에이전트 샌드박스(agent sandbox)는 AI 에이전트가 코드와 명령을 실행하는 격리된 환경입니다. 컨테이너, 가상 머신, 운영체제 제한 등이 있으며, 정해진 한계 밖의 파일, 네트워크, 데이터에 닿지 못하게 합니다.
다른 이름: sandboxing, code sandbox
작성 Divya Sharma · 2026년 11월 15일 확인 · 리뷰 방식
에이전트는 아무도 검토하지 않은 코드를 실행합니다. 스스로 고른 명령, 직접 쓴 스크립트, 설치한 패키지입니다. 샌드박스는 그 코드가 잘못되었거나 에이전트가 프롬프트 인젝션에 속았을 때 피해를 제한합니다.
작동 방식
샌드박스에는 몇 가지 형태가 있습니다.
- 로컬 머신의 운영체제 제한. 예를 들어 Claude Code는 macOS에서는 Seatbelt, Linux에서는 bubblewrap이 강제하는 경계 안에서 셸 명령을 실행할 수 있습니다. 쓰기는 프로젝트 폴더로 제한되고, 네트워크 트래픽은 도메인마다 확인하는 프록시를 거칩니다. - 에이전트 전체를 담는 컨테이너나 가상 머신. 컴퓨터 사용과 클라우드 코딩 에이전트에 쓰입니다. - E2B 같은 호스팅 코드 샌드박스. 모델이 쓴 코드를 원격 머신에서 실행하고 출력을 돌려줍니다.
핵심은 한계를 모델이 아니라 운영체제나 하이퍼바이저가 강제한다는 점입니다. 모델이 어떤 명령을 실행하기로 하든 경계는 유지됩니다.
왜 중요한가
최악의 경우가 격리되므로, 샌드박스가 있으면 에이전트가 명령마다 휴먼 인 더 루프 승인을 받지 않고도 일할 수 있습니다. 네트워크 접근이 막혀 있으면 훔친 데이터가 밖으로 나가지 못하므로 데이터 유출을 막는 데도 도움이 됩니다.
한계
샌드박스는 그 안에서 실행되는 것만 보호합니다. Claude Code의 경우 파일 도구와 MCP 서버는 셸 샌드박스 밖에서 실행됩니다. 샌드박스 안에 둔 비밀 정보는 허용된 도메인을 통해 여전히 새어 나갈 수 있습니다. 샌드박스는 좁은 에이전트 권한과 함께 쓰십시오.
관련 용어
- 코딩 에이전트
- 코딩 에이전트(coding agent)는 소프트웨어를 직접 다루는 AI 에이전트입니다. 사람이 붙여 넣을 코드를 제안하는 데 그치지 않고, 코드베이스를 읽고, 파일을 수정하고, 명령과 테스트를 실행하며, 변경이 동작할 때까지 반복합니다.
- 휴먼 인 더 루프
- 휴먼 인 더 루프(HITL, human-in-the-loop)는 AI 시스템이 정해진 지점에서 멈추고 사람이 다음 단계를 승인, 수정, 거부하게 하는 설계로, 위험하거나 불확실한 동작이 자동으로 실행되지 않게 합니다.
- 프롬프트 인젝션(Prompt injection)
- 프롬프트 인젝션(prompt injection)은 사용자가 입력하거나 웹 페이지, 파일, 도구 결과에 숨겨진 텍스트가 언어 모델에 들어가, 개발자가 의도하지 않은 방식으로 모델의 동작을 바꾸는 공격입니다.
- 에이전트 권한
- 에이전트 권한(agent permissions)은 AI 에이전트가 어떤 도구, 파일, 명령, 네트워크, 계정을 쓸 수 있는지, 어떤 동작에 먼저 사람의 승인이 필요한지를 정하는 규칙입니다. 에이전트가 실수하거나 조작당해도 피해를 제한하기 위한 것입니다.
- 데이터 유출(AI 에이전트)
- AI 에이전트에서 데이터 유출(data exfiltration)은 공격자가 에이전트를 속여 접근 가능한 비공개 데이터를 읽게 하고, 웹 요청, 이메일, 이미지 링크 등 공격자가 통제하는 경로로 내보내게 하는 것을 말합니다.