OpenAI Codex 샌드박스는 에이전트 주위에 그은 울타리입니다. Codex가 어떤 파일을 바꾸고 네트워크에 닿을 수 있는지를 정할 뿐, 언제 멈춰서 물어볼지는 정하지 않습니다. OpenAI는 2026년 11월 Codex 샌드박스를 자세히 설명한 글에서 새 샌드박스가 컨테이너에 의존하지 않고 운영체제의 네이티브 격리 메커니즘을 쓴다고 밝혔습니다. 기본적으로 현재 작업 공간 안에서만 읽고 쓸 수 있고, 네트워크는 기본적으로 꺼져 있으며, 경계를 넘는 작업은 먼저 사용자의 승인이 필요합니다.
샌드박스 세 단계는 각각 무엇을 하나
샌드박스에는 세 단계가 있습니다. read-only는 읽기 전용으로, Codex는 파일을 보고 계획만 세울 뿐 아무것도 바꾸지 못합니다. 먼저 둘러보고 결정하기에 적합합니다. workspace-write는 기본 단계로, 현재 작업 공간 안에서 파일을 읽고 쓰고 로컬 명령을 실행할 수 있어 일상적인 코딩의 주력입니다. danger-full-access는 울타리를 통째로 걷어내는 것으로, 파일 시스템과 네트워크 모두 제한이 없어지므로 격리된 CI 환경이나 일회용 컨테이너에만 적합합니다. 단계를 바꾸려고 종료 후 다시 시작할 필요는 없습니다. 세션 안에서 /permissions를 입력하면 되고, 실행할 때 --sandbox 매개변수를 줄 수도 있습니다. --yolo는 샌드박스와 승인을 동시에 끄므로 공식이 명시적으로 권장하지 않으니 일상 설정으로 쓰지 마세요.
승인과 네트워크는 별개의 스위치
샌드박스는 '할 수 있는지'를, 승인은 '먼저 물어볼지'를 정합니다. 두 스위치는 따로 설정하세요. 승인 정책은 on-request, never, 더 세밀한 granular 세 가지가 있습니다. 기본 Auto 프리셋은 workspace-write와 on-request의 조합으로, 작업 공간 안에서는 바로 작업하고 작업 공간 밖에 쓰거나 네트워크를 쓸 때는 먼저 묻습니다. 네트워크는 기본적으로 꺼져 있습니다. 네트워크가 필요한 작업은 [sandbox_workspace_write] 아래에서 network_access를 켜되, 해당 작업에만 켰다가 끝나면 끄는 편이 좋습니다. 한두 개 디렉터리만 더 열고 싶다면 모드 전체를 넓히지 말고 writable_roots로 개별 허용 목록에 추가하는 편이 안전합니다. 공식 문서에는 .git, .codex 같은 디렉터리는 쓰기 가능한 작업 공간 안에서도 읽기 전용으로 남는다고 명시되어 있습니다.
초보자를 위한 기본 설정
처음에는 기본 Auto 프리셋을 그대로 쓰는 것을 권합니다. ~/.codex/config.toml에 sandbox_mode = "workspace-write"와 approval_policy = "on-request"를 쓰고, 네트워크가 꺼진 상태인지 확인하세요. 먼저 git이 있는 저장소에서 써서 잘못 바꿔도 되돌릴 수 있게 하세요. 낯선 저장소는 먼저 read-only로 전환해 둘러본 뒤 문제가 없으면 쓰기 권한을 넓히세요. CI 같은 무인 작업에는 read-only와 never 조합이 가장 안정적입니다. 메커니즘에 대한 공식의 전체 설명은 OpenAI의 Codex 샌드박스 상세 해설에서 확인할 수 있습니다. 팀원과 함께 코드를 짜고 싶다면 Cursor Projects 멀티플레이어의 초대 방법도 보세요.