코딩 에이전트에게 어디까지 허용할 것인가
AI 에이전트가 중요한 문서를 지웠다거나 드라이브 하나를 통째로 지웠다는 글을 몇 번 본 적이 있다.
명령 몇 줄을 적어두면 여러 디렉터리를 오가며 파일을 수정하고 명령을 실행하는 코딩 에이전트. 그 모습을 보다 보면 내 컴퓨터를 자율주행에 맡긴 듯한 느낌이 들기도 한다. 그렇다면 그 자율주행은 어디까지 갈 수 있을까. 프로젝트를 수정하는 데 필요한 권한과 개인 문서나 인증 정보에 접근하는 권한은 구분해서 봐야 했다.
그래서 Codex와 Claude Code의 권한 설정과 샌드박스, Container와 VM으로 환경을 나눌 때 생기는 경계를 찾아봤다.
샌드박스와 승인은 다른 장치다
섹션 제목: “샌드박스와 승인은 다른 장치다”에이전트에게 허용할 권한은 작업에 필요한 범위에서 정해야 한다. 작업 공간(workspace)은 프로젝트를 다루는 디렉터리이고, 자격 증명은 API key나 SSH key처럼 서비스 접근에 사용하는 인증 정보다. 작업 공간과 네트워크 접근을 제한하고, 불필요한 자격 증명을 분리하며, 위험한 작업에 승인을 요구하는 것이 출발점이다.
에이전트는 파일을 읽고 수정하며 명령을 실행한다. 따라서 접근 범위를 판단할 때는 세 가지를 나누어 봐야 한다. 어떤 파일을 읽을 수 있는지, 어디에 쓸 수 있는지, 어떤 외부 서비스에 연결할 수 있는지다.
여기에 승인을 요구하는 시점을 더해야 한다. 샌드박스는 실행 중인 명령이 접근할 수 있는 범위를 제한하고, 승인 정책은 특정 작업을 실행하기 전에 검토할지를 정한다. 승인을 자주 받더라도 실행 환경의 접근 범위가 넓을 수 있고, 승인 없이 실행되는 작업도 좁은 샌드박스 안에 제한될 수 있다. Codex 공식 문서는 이 두 장치를 구분해서 설명한다.
Codex 샌드박스 문서에 따르면, 로컬 실행의 workspace-write는 작업 공간 안의 수정과 일반적인 명령 실행을 허용하는 모드다. 기본적으로 명령의 네트워크 접근은 꺼져 있으며, 범위를 벗어나는 실행에는 승인 정책이 적용된다. 다만 작업 공간 밖의 쓰기 제한을 읽기 제한으로 해석해서는 안 된다. 실제 읽기 범위와 보호 대상은 적용된 권한 설정을 함께 확인해야 한다.
Claude Code에도 명령 실행을 제한하는 샌드박스가 있다. 공식 문서에 따르면 기본적으로 비활성화되어 있으며 /sandbox로 설정할 수 있다. 처음 읽을 때 가장 의외였던 부분이다. 이 글을 다시 보며 확인해 보니(2026-11-16) 지금도 기본값은 꺼져 있고, 설정 파일의 sandbox.enabled로도 켤 수 있다. 활성화한 상태에서도 기본 읽기 범위에는 자격 증명 파일이 포함될 수 있고, 환경 변수도 상속된다. 또한 내장 파일 도구와 외부 도구를 연결하는 MCP 서버, 특정 시점에 명령을 실행하는 hooks는 Bash 샌드박스와 적용 범위가 다르다. 따라서 샌드박스를 켰다는 사실만으로 세션 전체가 같은 경계 안에 있다고 판단하기는 어렵다.
이 차이에서 출발하면 설정의 우선순위도 분명해진다. 프로젝트에 필요한 파일만 접근시키고, 불필요한 자격 증명을 실행 환경에서 빼며, 필요한 통신만 허용하는 것이다. 승인 요청이 나타날 때는 명령의 목적과 함께 접근 범위를 얼마나 넓히는지도 살펴봐야 한다.
보호하려는 대상에 따라 점검할 설정도 달라진다.
- 원본 파일의 의도치 않은 수정이 걱정된다면 쓰기 가능한 경로를 확인한다. 원본 대신 프로젝트 사본에서 작업하고, 변경 사항을 검토한 뒤 반영하는 방법도 있다.
- 인증 정보에 대한 접근이 걱정된다면 읽을 수 있는 파일과 전달되는 환경 변수를 확인한다. 작업에 필요하지 않은 개인용·운영용 자격 증명은 실행 환경에서 분리한다.
- 외부로 정보가 전달되는 것이 걱정된다면 허용한 네트워크 연결과 모델 제공자에게 전송되는 내용을 나누어 살펴본다. 아래에서 설명할 실행 환경의 격리만으로 모든 전송이 차단되지는 않는다.
Container와 VM으로 실행 환경을 분리하기
섹션 제목: “Container와 VM으로 실행 환경을 분리하기”명령별 제한보다 넓은 범위를 격리하려면 에이전트 자체를 별도 환경에서 실행하는 방법을 고려할 수 있다. 에이전트와 그 환경 안에서 실행되는 보조 프로세스가 접근할 파일, 자격 증명, 네트워크를 함께 제한하는 방식이다.
Container는 애플리케이션과 필요한 도구를 격리된 환경에서 실행하는 방식이다. VM(Virtual Machine)은 별도의 운영체제를 실행하는 가상 머신이다. 어느 쪽을 선택하든 호스트, 즉 그 환경을 구동하는 컴퓨터와 무엇을 공유하는지 확인해야 한다.
Container를 활용한 구성 예시는 다음과 같다.
- 프로젝트 사본과 필요한 개발 도구만 넣는다.
- 개인 홈 디렉터리와 SSH·클라우드 자격 증명은 공유하지 않는다.
- 관리자 권한이 없는 사용자로 실행하고, 필요한 경로만 쓰기 가능하게 둔다.
- 외부 연결은 필요한 목적지로 제한한다.
- 작업이 끝나면 변경 사항을 검토한 뒤 원본에 반영한다.
여기서 주의할 부분은 호스트와의 연결이다. bind mount는 호스트의 파일이나 디렉터리를 Container 안에서 사용할 수 있도록 연결하는 방식이다. 프로젝트를 쓰기 가능한 bind mount로 연결하면 Container 안에서의 수정이 호스트 파일에도 반영된다. Container에 넣었다는 사실만으로 원본이 보호되는 것은 아니다. Container를 관리하는 서비스인 Docker daemon에 접근할 수 있는 소켓을 공유하는 것 역시 큰 권한을 부여하는 선택이다. Docker 보안 문서에서 이 권한의 영향을 살펴볼 수 있다.
VM은 운영체제의 핵심인 커널을 별도로 가진다. 에이전트를 그 운영체제 안에서 실행하므로 커널 경계를 분리할 수 있다. 신뢰하기 어려운 저장소나 실행 파일을 다루는 경우 고려할 수 있지만, 운영체제와 개발 도구를 준비하고 유지하는 부담이 늘어난다. 공유 폴더와 네트워크, 자격 증명을 넓게 열어두면 그 연결을 통한 위험은 여전히 남는다.
프라이버시도 별도로 살펴봐야 한다. Container나 VM은 로컬 실행의 접근 범위를 제한하지만, 에이전트가 읽은 내용을 모델 제공자에게 전송하는 동작까지 막아주지는 않는다. Claude Code 문서도 격리 여부와 모델에 전송되는 정보는 별개라고 설명한다. Claude Code 공식 문서: 격리의 한계
지금 내가 쓰는 환경
섹션 제목: “지금 내가 쓰는 환경”이 글을 쓴 뒤로 작업 대부분은 외부 OCI 서버의 VM에서 하고 있다. VM은 외부 인바운드 포트를 모두 없애고 Tailscale로만 접속하며, 방화벽도 설정해 두었다. Git은 저장소 권한을 최소로 준 PAT 토큰으로 쓴다.
로컬 머신에서 에이전트를 쓰는 건 지금 이 블로그 글을 다룰 때 정도다. 사실 이것도 로컬에서 할 필요는 없다. 다만 에디터로 직접 열고 고치기엔 로컬이 편하고, 오프라인일 때도 글을 대충이나마 써 둘 수 있다. 로컬에는 Apple의 락다운 모드(Lockdown Mode)와 암호화 설정을 켜 두었다.
로컬보다 VM이라는 생각은 지금도 같다. 로컬 환경에는 생각했던 것보다 훨씬 더 개인적인 파일이 있기 마련이다.
에이전트에게 “이 컴퓨터에서 어떤 PDF를 읽었던 것 같은데…” 같은 애매한 질문을 했다고 해 보자. 에이전트는 아마 지금 실행된 환경에 있는 PDF들을 찾아볼 것이다. 그런데 그중 하나가 이번에 지원한 지원자의 이력서라면, 에이전트는 그 안의 개인정보까지 읽게 된다. 제일 나쁜 건 그 지원자가 원한 일이 아니었다는 점이다.
앞에서 본 것처럼 샌드박스를 켜도 읽을 수 있는 범위는 넓다. 그래서 Computer Use처럼 정말 로컬 환경이 필요한 작업이 아니라면, 에이전트는 로컬이 아니라 가상 환경에서 쓰는 게 맞다고 생각한다.
참고자료
섹션 제목: “참고자료”- OpenAI: Agent approvals & security: Codex의 승인 정책과 샌드박스, 로컬 명령의 기본 네트워크 제한.
- OpenAI: Sandbox:
workspace-write등 샌드박스 모드와 권한 설정. - Claude Code: Configure the sandboxed Bash tool: 활성화 방법, 기본 접근 범위, 샌드박스 밖에서 실행되는 도구/프로세스.
- Claude Code: Choose a sandbox environment: Container/VM의 격리 범위와 모델로 전송되는 정보의 관계.
- Docker: Bind mounts: 호스트 디렉터리 공유와 쓰기 권한의 영향.
- Docker: Docker Engine security: Docker daemon의 권한과 Container 격리의 한계.