Codex sandbox와 Docker Sandboxes의 차이는 에이전트의 명령이 어디서 실행되는가에 있습니다. Codex sandbox는 명령을 사용자의 머신에 그대로 두고 OS 도구(macOS에서는 Seatbelt, Linux에서는 bubblewrap + seccomp, Windows에서는 MXC)로 제한합니다. Docker Sandboxes는 자체 커널과 파일시스템, Docker Engine, 네트워크를 갖춘 microVM 안으로 에이전트를 옮깁니다. 네이티브 툴체인이 필요하면 Codex의 샌드박스를, 에이전트가 하는 모든 일에 단단한 경계를 두고 싶다면 Docker Sandboxes를 선택하세요.
Codex 샌드박스 vs Docker Sandboxes 한눈에 보기
| Codex 샌드박스 | Docker Sandboxes | |
|---|---|---|
| 명령 실행 위치 | 기존 환경 | 샌드박스마다 하나의 microVM |
| 격리 방식 | Seatbelt(macOS), bubblewrap + seccomp-bpf(Linux), MXC(Windows) | 하이퍼바이저, 샌드박스별 별도 커널 |
| 설정 방법 | config.toml의 권한 프로필 |
sbx CLI와 정책 |
| 기본 네트워크 | :workspace 프로필에서는 차단 |
기본 허용 목록이 있는 기본 차단 프록시 |
| 네이티브 호스트 도구 | 지원(Xcode, 시뮬레이터, 로컬 SDK) | 미지원, VM 내부에 있는 것만 사용 |
| 대상 에이전트 | Codex(codex sandbox를 통한 모든 명령 포함) |
Claude Code, Codex, Copilot, Cursor, Devin, Kiro, OpenCode 등 |
| 팀 정책 | requirements.toml 관리형 요구사항 |
Docker AI Governance(별도 유료 구독) |
| 가격 | Codex에 포함 | sbx CLI와 로컬 컴퓨팅은 무료, 클라우드는 사용한 만큼 과금 |
Codex 샌드박스란 무엇인가?
Codex 샌드박스는 Codex가 컴퓨터에서 실행하는 명령이 무엇을 읽고, 쓰고, 접근할 수 있는지 제한하는 계층입니다. 작업을 컨테이너나 VM으로 옮기지 않고, 각 명령과 그 명령이 만들어내는 모든 자식 프로세스를 운영체제 자체의 샌드박싱 기능으로 감싸며 권한 프로필에 지정한 규칙을 적용합니다.
Git 저장소에서는 내장된 :workspace 프로필이 기본값입니다. 워크스페이스 내부 쓰기는 허용하면서 .git과 .codex는 읽기 전용으로 유지하고, 그 밖의 영역은 폭넓게 읽을 수 있게 하며(컴파일러는 저장소 밖의 SDK가 필요합니다), 네트워크 접근은 차단합니다. config.toml에서 이 프로필을 확장할 수 있습니다. 다음 예시는 OpenAI 글에서 인용한 것입니다:
default_permissions = "dev"
[permissions.dev]
description = "Development with extra read-only protections."
extends = ":workspace"
[permissions.dev.filesystem]
"~/build-cache" = "write"
[permissions.dev.filesystem.":workspace_roots"]
".devcontainer" = "read"
".vscode" = "read"
"**/*.env" = "deny"
"secrets" = "deny"
codex sandbox 명령은 에이전트 세션 밖에서 특정 프로필로 아무 프로그램이나 실행합니다. 프로필을 시험해볼 때, 또는 Codex가 샌드박스 없이 실행하려는 stdio MCP 서버를 감쌀 때 쓸 수 있습니다:
codex sandbox --permission-profile dev -- bash -c 'cat > .vscode/settings.json'
macOS에서는 이 쓰기가 Operation not permitted 오류로 실패합니다. 그대로 복사해 쓸 수 있는 프로필은 권한 프로필 문서를 참고하세요.
Docker Sandboxes란 무엇인가?
Docker Sandboxes는 AI 코딩 에이전트를 격리된 microVM에서 실행하며, 로컬 머신이나 Docker가 관리하는 클라우드 인프라 위에서 구동됩니다. 샌드박스마다 자체 커널과 Docker 데몬, 파일시스템, 네트워크를 갖습니다. 에이전트는 sudo와 전용 Docker Engine을 포함해 VM 내부에서 완전한 권한을 가지지만, 사용자가 공유한 호스트 리소스에만 접근할 수 있습니다.
제어는 sbx CLI로 하며 Docker Desktop은 필요하지 않습니다. 로컬 샌드박스는 Apple silicon에서 macOS 14 이상, Hypervisor Platform이 활성화된 Windows 11, 또는 KVM이 있는 Ubuntu 24.04 이상이 필요합니다. 시작 가이드에서 발췌했습니다:
cd ~/my-project
sbx run --name my-sandbox claude # or: sbx run codex
sbx policy ls
sbx policy allow network registry.npmjs.org
sbx stop my-sandbox
sbx rm my-sandbox
프로젝트 디렉터리는 동일한 절대 경로로 VM에 마운트됩니다. 직접 마운트는 읽기-쓰기 방식이므로 에이전트가 작업 트리를 그 자리에서 수정합니다. --clone을 사용하면 호스트 저장소가 읽기 전용으로 마운트되고, 에이전트는 별도의 Git 클론에서 작업합니다. 인증 정보는 호스트에 남습니다. Docker의 아키텍처 문서에 따르면 "원시 인증 정보 값은 결코 VM 안으로 들어가지 않습니다."

격리 강도: OS 정책 vs 별도 커널
Codex는 호스트 커널 위에서 프로세스를 제약합니다. macOS에서는 (deny default)에서 시작하는 Seatbelt 프로필을 생성합니다. Linux에서는 bubblewrap으로 파일시스템 뷰를 구성하고 네트워크, IPC, PID 네임스페이스를 분리하며, no_new_privs가 설정된 seccomp-bpf 필터를 적용합니다. Windows에서는 Microsoft의 MXC(Microsoft eXecution Container) 라이브러리로 옮겨가는 중입니다. 제한은 실제로 커널 수준에서 강제되지만, 에이전트는 사용자의 커널을 공유하며 필터를 통해 머신을 바라보는 셈입니다.
Docker는 에이전트와 호스트 사이에 하이퍼바이저를 둡니다. 샌드박스마다 커널이 분리되어 있고 "호스트 데몬으로 이어지는 경로가 없는" 자체 Docker Engine을 갖습니다. VM 안에서 커널 버그가 발생하거나 규칙이 잘못 설정되어도 에이전트가 사용자의 노트북을 넘겨받지는 않습니다.
두 방식 모두 문서에서 솔직하게 밝히고 있는 빈틈이 있습니다:
- Codex의 기본 프로필은 폭넓은 읽기를 허용하므로, 다른 곳에 있는 API 키가 담긴 설정 파일이 계속 읽힐 수 있습니다. OpenAI는 또한 에이전트가
node_modules/prettier처럼 무시 목록에 있는 파일을 변조할 수 있고, 나중에 편집기가 이 파일을 샌드박스 밖에서 실행할 수 있다고 경고합니다. - Docker의 직접 마운트는 읽기-쓰기 방식이라 에이전트가 수정한 Git 훅, CI 설정,
Makefile이 나중에 호스트에서 실행될 수 있습니다. 로컬 stdio MCP 서버도 샌드박스 VM 밖에서 실행됩니다.
어느 쪽도 에이전트의 변경 사항을 검토해야 한다는 사실을 없애주지 못합니다. Codex 샌드박스와 씨름 중이었다면, Codex 샌드박스 우회하기 가이드에서 더 안전한 중간 지점을 다루고 있습니다.
네이티브 도구와 설정 비용
OpenAI가 컨테이너에 반대하는 논거는 구체적입니다. iOS 앱을 만들면서 Codex를 Docker 안에 샌드박싱하면 "Codex는 네이티브 Mac 실행 파일로 구성된 iOS 빌드 툴체인을 실행할 수 없고, 아이폰 시뮬레이터도 띄울 수 없습니다." 이런 단계를 호스트에 위임하면 다시 샌드박스 밖으로 나가게 됩니다.
그래서 Codex 샌드박스는 설정에 드는 비용이 거의 없습니다. 셸과 SDK, 캐시가 있던 자리에 그대로 남아 있기 때문입니다.
Docker Sandboxes는 초기 준비가 더 필요합니다. VM은 템플릿(Codex의 경우 docker/sandbox-templates:codex)에서 시작하고, 키트를 쓰거나 VM 내부에 직접 설치해서 도구를 추가합니다. 샌드박스는 ~/.codex 같은 사용자 수준 설정을 읽지 않고 작업 디렉터리의 프로젝트 수준 설정만 읽습니다. 그 대신 모든 에이전트에 똑같이 동작하는 깨끗하고 재현 가능한 환경을 얻고, 컨테이너 워크로드를 VM의 전용 Docker Engine 안에서 안전하게 실행할 수 있습니다.
이미 컨테이너에서 빌드하는 서비스라면 그 비용은 작습니다. Xcode나 라이선스가 필요한 데스크톱 SDK라면 비용이 큽니다.
네트워크 제어 비교
두 방식 모두 도메인을 검사하는 프록시를 거쳐 트래픽을 보내며, 기본적으로 닫힌 상태에서 시작합니다.
Codex에는 세 가지 모드가 있습니다. 네트워크 차단(:workspace 기본값), 전체 접근(:danger-full-access), 또는 프로필별 도메인 규칙을 강제하는 프록시입니다:
[permissions.dev.network]
enabled = true
[permissions.dev.network.domains]
"*.openai.com" = "allow"
"localhost" = "allow"
"evil.example" = "deny"
[features]
network_proxy = true
명시적인 거부가 허용보다 우선하며, 목록에 없는 도메인에 대한 요청은 사용자의 승인을 기다리며 멈출 수 있습니다. 프록시는 호스트명이 허용된 뒤에야 이를 해석하지만, OpenAI는 광범위한 와일드카드가 여전히 DNS 기반 유출을 허용할 수 있다고 지적합니다.
Docker는 VM에서 나가는 모든 TCP를 호스트의 프록시로 라우팅하고 UDP와 ICMP는 기본적으로 차단하며, 규칙은 sbx policy로 관리합니다. Docker의 보안 모델 페이지는 "기본 허용 도메인에 광범위한 와일드카드가 포함되어 있다"고 경고하므로, 기본값을 신뢰하기 전에 sbx policy ls를 실행해 확인하세요.
팀 정책: 관리형 요구사항 vs Docker AI Governance
팀에는 사용자가 몰래 완화할 수 없는 정책이 필요합니다.
Codex는 관리형 요구사항을 사용합니다. 관리자가 /etc/codex/requirements.toml 같은 시스템 파일이나 클라우드 정책을 통해 requirements.toml을 배포하면, 사용자가 선택할 수 있는 프로필이 제한됩니다:
default_permissions = ":read-only"
[allowed_permission_profiles]
":read-only" = true
":danger-full-access" = false
Docker는 이 계층을 Docker AI Governance라는 이름으로 판매합니다. 샌드박스 네트워크 및 파일시스템 정책, Cedar로 작성되어 Docker의 MCP Gateway에서 강제되는 MCP 도구 정책, 그리고 각 결정을 로컬에 보관하거나 클라우드로 보낼 수 있는 감사 기록을 제공합니다. Docker 문서는 조직 수준 정책을 별도의 유료 구독으로 안내합니다. 장점은 Codex뿐 아니라 팀이 사용하는 모든 에이전트에 하나의 정책을 적용할 수 있다는 점입니다.
언제 무엇을 쓸까
단일한 정답은 없습니다. 작업에 맞춰 경계를 고르세요:
- Codex 샌드박스를 쓰세요: macOS나 iOS용으로 빌드하거나, 호스트에서만 쓸 수 있는 SDK에 의존하거나, 별도 설정 없이 바로 시작하고 싶고 Codex가 유일한 에이전트일 때.
- Docker Sandboxes를 쓰세요: 여러 에이전트를 운영하거나, 에이전트와 노트북 사이에 별도 커널을 두고 싶거나, 에이전트가 내부 Docker와 함께 오랜 무인 작업을 수행하도록 할 때.
- 둘 다 쓰세요: Codex를 단단한 경계 안에 두고 싶을 때. Docker의 Codex 페이지를 보면
sbx run codex는 기본적으로codex --dangerously-bypass-approvals-and-sandbox를 시작합니다. microVM이 벽이 되고 Codex 자체의 승인 절차는 물러나는 구조입니다. 선택하기 전에 이 트레이드오프를 기억해 두세요.

어느 샌드박스에서든 Apidog CLI로 API 테스트하기
어떤 벽을 선택하든, 에이전트는 자신의 변경 사항이 실제 API에서 동작한다는 것을 입증해야 합니다. Apidog CLI는 테스트 케이스와 실행을 위한 명령을 제공하고, 에이전트가 읽을 수 있는 JSON 출력을 내놓습니다. 한 번만 설정하면 됩니다:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
그다음 네트워크를 정확히 두 호스트에만 열어주세요. 사용자의 API와 CLI의 기본 API 베이스인 api.apidog.com입니다. Codex에서는 프로필의 [permissions.<name>.network.domains] 테이블에 둘 다 추가하세요. Docker Sandboxes에서는 sbx policy allow network api.apidog.com과 사용자 API의 호스트를 실행하세요.
에이전트에게 프롬프트 하나를 던져보세요:
Using Apidog CLI, create a test case in project <projectId> for
POST /orders on endpoint <endpointId> that asserts a 201 status and an
"id" field in the body. Run it against environment <envId> and summarize
any failures.
에이전트는 스키마를 읽고, 페이로드를 검증하고, 케이스를 실행합니다:
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog test-case run --project <projectId> --endpoint <endpointId> -e <envId> -r cli,json
실행이 네트워크 오류로 실패한다면 샌드박스가 제 역할을 한 것입니다. 허용 목록에서 어떤 호스트를 빠뜨렸는지 확인해 보세요. 전체 Codex 워크스루는 Codex에서 Apidog CLI 사용하기를 참고하고, 같은 실행을 CI 파이프라인으로 옮길 때는 -r cli,json을 -r junit으로 바꾸세요. Apidog의 무료 플랜은 최대 4명의 사용자를 지원합니다.
FAQ
Codex 샌드박스는 컨테이너인가요? 아닙니다. Codex는 기존 환경에서 명령을 제한하며, macOS에서는 Seatbelt, Linux에서는 bubblewrap과 seccomp-bpf, Windows에서는 MXC를 사용합니다. 별도의 파일시스템 이미지나 VM은 없습니다.
Docker Sandboxes는 그냥 컨테이너인가요? 아닙니다. Docker 문서는 이들을 하이퍼바이저 격리와 샌드박스별 별도 커널을 갖춘 microVM으로 설명합니다. 각 샌드박스는 자체 Docker Engine을 실행하므로, 에이전트가 그 안에서 컨테이너를 빌드하고 실행할 수 있습니다.
Docker Sandboxes 안에서 Codex를 실행할 수 있나요? 네. sbx run codex는 Codex를 microVM에서 시작합니다. 기본적으로 --dangerously-bypass-approvals-and-sandbox와 함께 실행되므로, Codex의 샌드박스가 아니라 VM이 경계가 됩니다.
Docker Sandboxes는 무료인가요? Docker에 따르면 sbx CLI와 로컬 샌드박스 컴퓨팅은 상업적 용도를 포함해 무료입니다. 클라우드 샌드박스는 사용한 만큼 과금되는 구독을 사용하며, 모델 제공자 비용은 별도이고, 조직 수준 정책 관리는 별도의 유료 구독입니다.
두 샌드박스 중 MCP 서버까지 보호하는 것이 있나요? 기본적으로는 없습니다. Codex는 codex sandbox로 감싸지 않는 한 stdio MCP 서버를 샌드박싱하지 않습니다. Docker는 로컬 stdio MCP 서버를 VM 밖에서 실행하며, MCP 게이트웨이와 Cedar 정책은 이를 통해 라우팅되는 서버에만 적용됩니다.
