OpenAI는 에이전트의 안전을 확보하기 위해 심층 방어(새 창에서 열기) 접근 방식을 취합니다. 학습과 정렬에 대한 투자가 이 노력의 토대이지만, 에이전트 하네스인 Codex(새 창에서 열기)에도 추가적인 보호 기능을 구현하고 있습니다. Codex가 가장 자주 수행하는 작업 중 하나는 사용자의 컴퓨터에서 명령을 실행하는 것이며, 여기에는 잠재적인 위험이 따릅니다. 그래서 사용자가 제어하는 파일 시스템 및 네트워크 제한 내에서 Codex가 기존 환경을 활용해 작업할 수 있도록 Codex 샌드박스를 만들었습니다.
(새 창에서 열기)샌드박스(새 창에서 열기)는 프로그램이 실행 중에 접근할 수 있는 대상을 제한합니다. 사진 정리 작업이라면 명령이 ~/Pictures의 파일을 읽고 수정할 수 있게 허용하되, 업로드를 방지하도록 네트워크 접근은 차단하는 식으로 Codex 샌드박스를 구성할 수 있습니다. 코드 검토 시에는 소스 파일을 읽기 전용으로 유지하면서 온라인 문서 접근을 허용할 수 있습니다. 사용자는 (새 창에서 열기)권한 프로필(새 창에서 열기)을 통해 Codex 샌드박스를 구성합니다. 권한 프로필은 Codex 세션의 파일 시스템 및 네트워크 제한을 정의합니다.
이 글에서는 먼저 Codex 샌드박스의 기본 설정에서 고려한 절충점을 살펴보고, 샌드박스의 설계와 하네스가 이를 사용해 명령을 실행하는 방식을 설명합니다. 또한 최종 사용자와 기업이 필요에 맞게 권한을 조정하는 방법, 개발자가 자체 도구에서 샌드박스를 재사용하는 방법도 소개합니다. 마지막으로 이러한 제한이 macOS, Linux, Windows에서 어떻게 적용되는지 살펴봅니다.
Codex의 설계 원칙은 실질적인 작업이 가능하면서도 보수적인 샌드박스 기본값을 설정하는 것입니다. 예를 들어 Git 리포지터리를 워크스페이스 루트로 사용할 때 기본 제공되는 :workspace 권한 프로필은 다음과 같이 작동합니다.
워크스페이스 내 쓰기는 허용하되,
.git과.codex같은 디렉터리는 읽기 전용으로 유지합니다. 따라서 Codex는 변경할 때마다 허가를 요청하지 않고 소스 코드를 편집할 수 있지만,.codex/config.toml이나.git/hooks아래의 Git 훅을 직접 변경할 수는 없습니다.사용자의 기존 OS 권한 범위 내에서 광범위한 파일 시스템 읽기를 허용합니다. 컴파일러, 런타임, 빌드 도구는 리포지터리 외부의 SDK, 라이브러리, 구성에 의존합니다. 읽기를 워크스페이스로만 제한하면 일반적인 워크플로 중 상당수가 제대로 작동하지 않게 됩니다. 다만 그 대가로 컴퓨터의 다른 위치에 있는 민감한 파일도 읽을 수 있게 될 수 있습니다. API 키가 포함된 구성 파일이 그 예입니다.
네트워크 접근을 비활성화합니다. 이렇게 하면 명령이 읽을 수 있는 데이터를 유출하려는 시도를 포함해 외부 서비스로 직접 업로드하는 행위가 차단됩니다. 의존성 다운로드 같은 정상적인 작업도 차단되므로, 이런 작업에는 추가 접근 권한이 필요합니다.
이러한 제한으로 여러 유형의 바람직하지 않은 동작을 방지할 수 있지만, 유해한 행위가 여전히 발생할 수 있습니다. 예를 들어 에이전트가 node_modules/prettier처럼 로컬에 설치된 패키지에 악성 코드를 삽입할 수 있습니다. Git은 흔히 node_modules를 무시하도록 설정되어 있으므로 이런 변경은 git status에 나타나지 않을 수 있습니다. 사용자의 편집기가 저장 시 해당 Prettier를 실행한다면, 파일을 저장하는 것만으로도 Codex 샌드박스 외부에서 악성 코드가 실행될 수 있습니다. 바로 이 때문에 심층 방어 접근 방식을 취합니다. 샌드박스가 명령의 접근 범위를 제한하는 한편, 학습과 정렬은 모델이 사용자의 의도에 맞게 그 접근 권한을 활용하도록 돕습니다.
기업 환경에서 샌드박스 권한을 조정하고 다른 보호 수단과 함께 사용하는 방법은 Codex 보안 쿡북(새 창에서 열기)을 참조하세요.
가상 머신과 컨테이너(새 창에서 열기)는 샌드박싱에 널리 쓰이는 두 가지 메커니즘이지만, Codex 샌드박스는 다른 접근 방식을 취합니다. Codex는 작업을 격리된 별도의 환경에서 실행하는 대신, 각 플랫폼의 샌드박싱 기능을 사용해 사용자의 기존 환경에서 실행되는 명령을 제한합니다.
많은 개발자에게 노트북은 언제든 원하는 대로 바꿀 수 있는 맞춤형 개발 환경입니다. 이 환경을 Docker 컨테이너에 재현하려면 수고가 들고, 일부 워크플로는 여전히 호스트에서 실행되는 도구에 의존합니다.
예를 들어 Mac에서 Codex로 iOS 앱을 개발하는 상황을 생각해 보겠습니다. Codex를 Docker 내부에서 실행해 샌드박싱하면, 네이티브 Mac 실행 파일로 구성된 iOS 빌드 도구 체인을 실행할 수 없고 iPhone 시뮬레이터를 띄워 코드를 실행할 수도 없습니다. Docker 기반 워크플로에서 빌드와 시뮬레이터 작업을 Mac 호스트에 위임할 수는 있지만, 이 작업들은 컨테이너의 샌드박스 외부에서 실행되므로 별도의 제한이 필요합니다. Codex에서는 OS별 샌드박싱에 집중적으로 투자해 구성을 단순하게 유지하고, 당면한 작업에 가장 적합한 환경에서 Codex가 실행되도록 하는 방식을 선호합니다.
하네스는 macOS, Windows, Linux에서 공통 API를 통해 이러한 OS별 샌드박싱 메커니즘을 제공합니다. 이 API는 명령과 권한 프로필을 입력받습니다. 권한 프로필이 제한적인 네트워크 접근을 허용한다면, 호출자는 그 제한을 적용할 네트워크 프록시를 제공해야 합니다.
이 함수는 샌드박스에서 프로세스를 시작하고, 하네스가 프로세스 종료를 기다리는 데 사용할 수 있는 Child 핸들을 반환합니다. 각 자식 프로세스는 부모의 샌드박스 제약을 상속합니다. 따라서 제한은 명령이 시작한 프로세스 트리 전체에 적용되며, 최초 프로세스가 종료된 뒤에도 남아 있는 하위 프로세스에도 적용됩니다.
다음 다이어그램은 구성부터 샌드박스 내 명령 실행까지 이 구성 요소들이 어떻게 연결되는지 보여줍니다. 이어지는 섹션에서 각 단계를 설명합니다.

Codex 에이전트 루프 자세히 살펴보기에서 설명했듯이, Codex 하네스는 모델이 생성한 도구 호출을 실행하는 역할을 맡습니다. 코딩 작업에서 가장 자주 사용하는 도구는 셸 도구입니다. 사용자가 Bash 같은 대화형 셸에서 명령을 실행하는 것과 비슷한 방식으로 작동합니다. 여기서는 원샷 (새 창에서 열기)exec_command(새 창에서 열기) 셸 도구(새 창에서 열기)를 통해 하네스가 샌드박스를 활용해 원하는 보호를 제공하는 방식을 살펴보겠습니다.
다음은 Codex 하네스가 샌드박싱 없이 exec_command 도구 호출을 처리하는 방식을 단순화한 예시입니다.
명령을 샌드박싱하기 위해 하네스는 subprocess.Popen() 호출을 spawn_command_under_sandbox()로 교체합니다. 하네스는 권한 프로필을 제공하며, 필요한 경우 네트워크 프록시도 제공합니다.
exec_command 도구를 통해 모델이 개별 명령에 대해 다른 권한을 요청할 수도 있지만, 허용 여부는 하네스가 결정합니다.
use_default를 지정하면 하네스는 해당 턴의 기본 샌드박스 구성을 사용합니다. with_additional_permissions는 샌드박스 내 접근 권한 확대를 요청하고, require_escalated는 샌드박스 외부 실행을 요청합니다. 하네스는 명령을 실행하기 전에 사용자의 설정에 따라 요청을 평가합니다. (예를 들어 Codex는 사용자에게 직접 확인을 요청하거나, 요청을 자동 검토(새 창에서 열기)로 보낼 수 있습니다.) 실행이 승인되면 Codex는 적절한 permission_profile과 network_proxy를 원래 ExecCommandToolCall의 명령 인수와 함께 perform_exec_command_with_sandboxing()에 전달합니다.
spawn_command_under_sandbox()를 주로 사용하는 것은 셸 도구이며, 하네스는 로컬 파일 읽기 및 수정 같은 작업에도 샌드박싱 인프라를 재사용합니다. 이러한 재사용은 하네스 밖으로도 확장됩니다. 뒤에서 살펴보듯, codex sandbox 명령으로 자체 도구에 샌드박스 기반 명령 실행 기능을 통합할 수 있습니다. 다음으로 권한 프로필을 정의하는 방법을 살펴보겠습니다.
이름이 지정된 권한 프로필을 사용하면 여러 프로젝트에서 동일한 파일 시스템 및 네트워크 제한을 재사용할 수 있습니다. config.toml의 [permissions] 아래에 자체 프로필을 정의할 수 있습니다. 예를 들어 다음은 기본 제공 :workspace 프로필을 확장(새 창에서 열기)하는 dev 프로필을 정의합니다.
dev 프로필은 ~/build-cache에 대한 쓰기 권한을 추가하고 워크스페이스 내 파일에 추가 제한을 적용합니다. 파일 시스템 항목은 읽기 전용 접근(read), 읽기·쓰기 접근(write)을 허용하거나 접근을 완전히 차단(deny)할 수 있습니다.
:workspace_roots 테이블에서는 프로젝트의 워크스페이스 루트를 기준으로 한 상대 경로의 규칙을 정의할 수 있습니다. 기본적으로 Codex CLI는 작업 디렉터리를 유일한 워크스페이스 루트로 사용하고, ChatGPT 데스크톱 앱은 프로젝트의 소스 폴더를 사용합니다. Codex는 각 규칙을 모든 루트에 적용하므로, dev의 .vscode 항목은 각 루트 아래의 .vscode 디렉터리를 읽기 전용으로 만듭니다.
dev는 자체 규칙 외에도 :workspace에서 다음 보호 설정을 상속합니다.
Codex 샌드박스의 네트워크 구성에는 크게 세 가지 옵션이 있습니다.
모든 네트워크 접근 비활성화(
:workspace프로필의 기본값)제한 없는 직접 네트워크 접근 활성화(
:danger-full-access프로필의 기본값)네트워크 접근을 프록시로 제한하고, 프록시가 권한 프로필에 따라 통과시킬 요청을 결정하도록 설정
dev에 직접 네트워크 접근을 허용하려면 config.toml의 최상위 수준에 permissions.dev.network.enabled = true를 설정하세요. 네트워크 프록시가 비활성화되어 있으면 이 설정은 제한 없는 네트워크 접근을 허용합니다.
dev가 특정 도메인 집합에만 접근하도록 제한하려면 네트워크 프록시를 활성화하고 도메인 규칙을 구성하세요.
도메인 규칙은 정확한 이름과 와일드카드 패턴을 지원하며, 명시적인 거부 규칙이 허용 규칙보다 우선합니다. 아래 네트워크 프록시에서 설명하듯, 다른 도메인에 대한 요청은 승인이 필요하거나 차단됩니다.
개별 사용자는 여러 프로젝트에 적용할 기본값을 구성하고, 신뢰하는 특정 프로젝트에서는 이를 재정의할 수 있습니다. 기업 관리자는 사용자를 위한 기본값을 구성하면서 사용자가 변경할 수 있는 설정을 제한하고 싶을 수도 있습니다. Codex는 계층화된 구성과 관리형 요구 사항을 통해 두 가지 모두 지원합니다.
구성 우선순위(새 창에서 열기)에서 설명하듯, Codex는 여러 config.toml 파일의 설정을 병합합니다. 테이블은 재귀적으로 병합되며, 값이 충돌하면 우선순위가 높은 소스의 값이 적용됩니다. 배열은 전체가 교체됩니다.
권한 프로필이 파일 시스템 경로와 네트워크 도메인에 테이블을 사용하는 이유가 바로 이것입니다. 팀은 자체 구성에서 개별 항목을 추가하거나 재정의하고, 조직의 기본 구성에 있는 나머지 모든 항목의 변경 사항은 자동으로 상속할 수 있습니다.
관리자는 requirements.toml을 통해 관리형 요구 사항(새 창에서 열기)을 제공하여 사용자가 선택할 수 있는 구성을 제한할 수도 있습니다. 이 요구 사항은 시스템 파일과 클라우드에서 제공하는 정책 등 여러 소스에서 가져올 수 있습니다. 일반적인 활용 사례는 allowed_permission_profiles를 지정해 기업 사용자가 선택할 수 있는 권한 프로필을 제한하는 것입니다. 예를 들어 관리자는 다음과 같은 클라우드 요구 사항을 지정할 수 있습니다.
클라우드 요구 사항은 /etc/codex/requirements.toml의 시스템 요구 사항 파일보다 우선하므로, 해당 파일의 항목이 위에서 명시한 ":danger-full-access" = false를 재정의할 수는 없습니다. :workspace를 지정하지 않으면 다른 요구 사항 계층에서 해당 항목을 제공할 수 있습니다. 최종 병합 테이블에서 항목 값이 false이거나 항목 자체가 없는 프로필은 사용할 수 없습니다.
이렇게 분리하면 조직은 제한을 강제하고, 사용자는 그 범위 안에서 구성을 조정할 수 있습니다. 이렇게 만들어진 권한 프로필은 하네스에서 사용하거나, 다음에서 살펴보듯 명령에 직접 적용할 수 있습니다.
Codex CLI는 Codex 구성에 정의된 권한 프로필에 따라 임의의 명령을 손쉽게 실행할 수 있도록 sandbox 명령을 제공합니다. 이 명령은 주로 프로필을 테스트해 샌드박스가 차단하도록 설계된 동작을 실제로 막는지 확인하는 데 사용됩니다.
예를 들어 다음 명령은 저장 시 악성 자동 포맷터가 실행되도록 VS Code를 구성하려고 시도합니다. .vscode가 이미 존재한다면, 위에서 정의한 dev 프로필에서는 해당 디렉터리가 읽기 전용이므로 이 쓰기가 차단되어야 합니다(codex sandbox는 기본적으로 cwd를 워크스페이스 루트로 취급합니다).
실제로 macOS에서는 다음 오류와 함께 실패합니다.
codex sandbox 명령을 사용하면 에이전트 세션과 별개로 Codex의 샌드박싱 메커니즘을 활용할 수 있습니다. 동일한 구성 언어와 플랫폼별 제한 적용 메커니즘을 사용해 자체 도구가 실행하는 명령을 제한할 수 있습니다.
config.toml에 구성된 stdio MCP 서버의 경우, Codex 하네스는 서버 시작에 사용하는 명령을 샌드박싱하려고 시도하지 않습니다. Codex는 해당 서버에 어떤 파일이나 네트워크 서비스가 필요한지 신뢰할 만하게 추론할 수 없으므로, 기본 샌드박스 프로필을 적용하면 정상적인 구성이 작동하지 않을 수 있습니다.
예를 들어 Codex에서 @modelcontextprotocol/server-memory(새 창에서 열기) MCP 서버를 사용하도록 구성하는 일반적인 방법은 다음과 같습니다.
이 npx 명령은 샌드박스 없이 실행되므로, Codex를 실행하는 사용자와 동일한 권한으로 파일을 쓰고 네트워크 요청을 보낼 수 있습니다. 이는 지나치게 넓은 권한입니다. 권한을 제한하려면 memory-mcp라는 권한 프로필을 정의하고, 원래의 npx 명령을 codex sandbox --permission-profile memory-mcp로 감싸면 됩니다. 그러면 서버가 쓸 수 있는 위치를 제한하고 네트워크 접근을 차단할 수 있습니다.
서버를 시작하기 전에 데이터 디렉터리를 만들고, 버전이 고정된 패키지를 npm 캐시에 저장하세요. 그러면 네트워크 접근을 비활성화하는 프로필에서도 npx --offline으로 서버를 실행할 수 있습니다.
패키지가 캐시되면 Codex는 네트워크 접근 없이 메모리 서버를 시작할 수 있으며, 쓰기는 npm 캐시와 서버의 데이터 디렉터리로 제한됩니다.
샌드박스 구현은 권한 프로필을 운영 체제가 강제하는 제한으로 변환합니다. 네트워크 프록시의 핵심 요청 처리 및 정책 로직은 세 주요 운영 체제에서 공유하지만, 프록시 설정과 샌드박스 통합은 OS별로 구현합니다. 먼저 공유 프록시를 살펴보고, 이어서 macOS, Linux, Windows의 구현을 살펴보겠습니다.
권한 프로필의 네트워크 제한을 적용하기 위해 하네스는 네트워크 프록시를 시작하고, 프록시 연결은 허용하되 외부 호스트로의 직접 연결은 차단하도록 샌드박스를 구성합니다. 프록시는 각 요청을 프로필의 도메인 규칙과 대조해 전달 여부를 결정합니다.
Codex 리포지터리에서 네트워크 프록시는 codex-network-proxy(새 창에서 열기) 크레이트로 구현되어 있습니다. 하네스는 이를 라이브러리로 사용하지만, 독립 실행형 CLI(새 창에서 열기)로 빌드할 수도 있습니다. 활성화되면 codex-network-proxy는 기본적으로 HTTP 프록시와 SOCKS5 프록시를 모두 시작합니다. 이 프록시 주소들은 환경 변수를 통해 샌드박스가 생성한 프로세스에 전달됩니다. HTTP_PROXY, HTTPS_PROXY, ALL_PROXY 같은 표준 환경 변수뿐 아니라, PIP_PROXY처럼 널리 쓰이는 여러 애플리케이션별 환경 변수(새 창에서 열기)도 주입됩니다. 물론 모든 프로그램이 이 환경 변수들을 따르는 것은 아닙니다. 프로그램이 외부 호스트에 직접 연결하려고 하면, 아래 플랫폼별 섹션에서 설명하는 운영 체제의 샌드박스 제한이 이를 차단합니다.
네트워크 프록시는 권한 프로필에 정의된 네트워크 제한을 적용하는 역할을 맡습니다. 예를 들어 앞서 소개한 dev 프로필은 *.openai.com에 대한 요청을 허용하고 evil.example에 대한 요청은 명시적으로 거부합니다. 요청 대상 도메인이 허용 규칙이나 거부 규칙 어느 쪽에도 일치하지 않으면, 프록시는 요청을 일시 중단하고 하네스에 승인 판단을 위임할 수 있습니다. 셸 명령 예시와 마찬가지로 Codex는 사용자에게 직접 확인을 요청하거나, 요청을 자동 검토(새 창에서 열기)로 보낼 수 있습니다. 결정이 내려지면 프록시는 요청을 계속 진행하도록 허용하거나 오류 응답과 함께 거부합니다.
DNS 조회만으로도 호스트 이름에 인코딩된 정보가 유출될 수 있으므로 여기서는 순서가 중요합니다. 따라서 프록시는 요청이 허용되거나 승인되었다고 판단한 뒤에만 요청된 호스트 이름을 조회합니다. 다만 광범위한 와일드카드 규칙이나 DNS 서비스 접근을 허용하면 DNS 기반 데이터 유출이 여전히 가능할 수 있습니다.
macOS에서 Codex는 Apple의 커널이 제한을 강제하는 샌드박싱 메커니즘인 Seatbelt(새 창에서 열기)를 사용합니다. Seatbelt 정책은 샌드박스 제한을 표현하는 Scheme 기반 언어인 Sandbox Profile Language(SBPL)로 작성합니다. Codex는 macOS의 /usr/bin/sandbox-exec 명령으로 Seatbelt를 호출합니다. codex sandbox처럼 샌드박스를 정의하는 옵션 다음에 실행할 명령을 입력받습니다.
PROFILE은 샌드박스를 구성하는 항목들이 담긴 SBPL 문자열입니다. 예를 들어 다음 SBPL 코드 조각은 샌드박스 정책에서 /dev/null과 /dev/zero에 대한 읽기와 쓰기를 허용합니다.
샌드박스를 호출할 때 네트워크 프록시를 활성화하면, 다음과 같은 규칙이 프로필에 주입되어 연결을 해당 로컬 포트로 제한합니다.
Codex의 기본 프로필은 (deny default)로 시작하므로, 명시적으로 허용하지 않는 한 아웃바운드 연결은 차단된 상태로 유지됩니다.
마지막으로 SBPL에는 (param)을 사용하는 플레이스홀더를 포함할 수 있습니다.
이 플레이스홀더는 sandbox-exec에 전달된 -Dkey=value 옵션의 값으로 채워집니다.
Codex는 자체 샌드박스 API를 구현하기 위해 기본 정책(새 창에서 열기)을 바탕으로 sandbox-exec에 전달할 인수 목록을 구성(새 창에서 열기)합니다. 그런 다음 permission_profile과 기타 맥락 정보를 반영해 수정하여 완전한 Seatbelt 프로필을 만듭니다. 완성된 프로필과 함께 전달되는 -D 인수는 Seatbelt가 강제할 제한을 구성하며, 네트워크 프록시는 추가 네트워크 규칙을 적용합니다. 전체 인수 목록을 구성하고 나면 sandbox-exec를 호출하는 것은 간단합니다.
Apple이 서드파티 사용자를 위한 언어 문서를 제공하지 않기 때문에 올바른 SBPL을 생성하기는 어렵습니다. 실제로 man sandbox-exec에는 The sandbox-exec command is DEPRECATED라고 명시되어 있습니다(man 3 sandbox_init에 문서화된 sandbox_init() 라이브러리 함수도 마찬가지입니다). 사용 중단 경고에도 불구하고 macOS는 여전히 /usr/share/sandbox에 Seatbelt 프로필을 포함하며, Google Chrome과 Chromium을 비롯한(새 창에서 열기) 서드파티 소프트웨어도 계속 Seatbelt에 의존하고 있습니다. 따라서 OpenAI는 당분간 Seatbelt를 계속 사용할 계획입니다.
Linux에서 샌드박스를 만들기 위해 Codex는 격리된 환경을 구성하는 명령줄 도구인 bubblewrap(새 창에서 열기)(bwrap)과 시스템 호출을 필터링하는 Linux 커널 메커니즘인 seccomp-bpf(새 창에서 열기)를 함께 사용합니다. codex-linux-sandbox라는 내부 헬퍼가 설정 과정을 조율합니다. macOS의 sandbox-exec처럼 샌드박스 구성 다음에 실행할 명령을 입력받습니다.
파일 시스템 격리나 프록시 라우팅이 필요하면 codex-linux-sandbox는 bwrap을 호출해 초기 샌드박스 환경을 만듭니다. 그런 다음 bwrap은 그 안에서 codex-linux-sandbox --apply-seccomp-then-exec를 실행합니다. 이 두 번째 호출은 사용자의 명령을 실행하기 전에 seccomp-bpf를 사용해 추가 제한을 적용합니다.
초기 샌드박스 환경을 구성하기 위해 Codex는 bubblewrap으로 별도의 마운트 네임스페이스에 권한 프로필의 파일 시스템 규칙을 반영하는 파일 시스템 뷰를 만듭니다. 이 기능은 샌드박스 구현의 핵심이므로 Codex는 사용자가 bwrap을 설치하지 않은 경우를 대비해 자체 복사본을 포함합니다. 다만 PATH에서 호환되는(새 창에서 열기) bwrap(새 창에서 열기)을 찾으면 해당 설치본을 우선 사용합니다. 실제로 일부 Linux 배포판은 기본적으로 사용자 네임스페이스 접근을 비활성화(새 창에서 열기)하지만, 시스템의 bwrap에는 예외를 허용합니다.
또한 sandbox-exec처럼 bwrap도 샌드박스 구성 다음에 샌드박스 내부에서 실행할 명령을 입력받습니다. bwrap은 SBPL 같은 전용 구성 언어 대신 개별 플래그로 설정합니다. Codex는 파일 시스템 뷰를 만들 때 다음 옵션을 사용합니다.
--bind: 쓰기 가능한 파일 또는 디렉터리 지정--ro-bind: 읽기 전용 파일 또는 디렉터리 지정--perms 000 --tmpfs DIR --remount-ro DIR:DIR접근 거부--perms 000 --ro-bind-data FD FILE:FILE접근 거부(FD는/dev/null에 대해 열린 파일 디스크립터)
Codex는 이 옵션을 사용해 거부 glob 패턴을 적용하기 위해 각 명령을 실행하기 전에 패턴을 실제 경로로 확장합니다. 새로 생성된 경로가 해당 패턴과 일치하더라도 해당 명령의 샌드박스 제한에 자동으로 추가되지는 않습니다.
Codex는 샌드박스가 호스트의 다른 유형의 리소스에 접근하지 못하도록 --unshare-ipc, --unshare-pid 같은 옵션도 지정합니다. 따라서 bubblewrap은 단순히 파일의 가시성만 제어하는 것이 아닙니다.
bubblewrap을 사용할 때 네트워크가 비활성화되어 있거나 연결이 반드시 네트워크 프록시를 거쳐야 한다면, Codex는 --unshare-net을 전달해 샌드박스용 새 네트워크 네임스페이스를 만듭니다. 그런 다음 seccomp-bpf를 사용해 명령이 사용할 수 있는 네트워크 시스템 호출과 소켓 계열에 추가 제한을 적용합니다.
구체적으로는 seccompiler 크레이트(새 창에서 열기)로 원하는 필터에 따라 BPF 프로그램을 동적으로 컴파일(새 창에서 열기)하고, 이를 샌드박스의 런처 프로세스에 적용해 전체 프로세스 트리가 제약을 상속하도록 합니다. 따라서 bwrap은 사용자의 명령을 직접 실행하는 대신, 자체 구성 인수와 사용자 명령을 차례로 전달해 codex-linux-sandbox 런처를 실행합니다.
권한 상승 없이 seccomp 필터를 적용하기 위해 런처는 Linux의 no_new_privs 플래그를 설정합니다(새 창에서 열기). 이 플래그는 자식 프로세스에 상속되며, 자식 프로세스가 setuid 실행 파일 같은 다른 프로그램을 실행할 때 추가 권한을 얻지 못하도록 합니다.
seccomp 필터는 네트워크 구성에 따라 달라집니다. 네트워크 접근이 비활성화되어 있으면 connect(2), bind(2) 등 여러 네트워크 관련 시스템 호출을 차단합니다. 다만 샌드박스에서 네트워크 프록시가 활성화되어 있으면 codex-linux-sandbox가 만든 TCP 리스너에 접근할 수 있도록 IP 소켓을 허용합니다. 반면 독립적인 Unix 도메인 소켓 생성은 기본적으로 차단합니다. 이러한 소켓을 통해 의도치 않게 호스트 리소스에 접근할 수 있기 때문입니다.
샌드박스 구성상 네트워크 프록시가 필요하면, Codex 하네스는 동일한 Codex 스레드 내에서 여러 번의 codex-linux-sandbox 호출에 재사용할 수 있는 프록시 인스턴스 하나를 만듭니다. 각 샌드박스에는 격리된 네트워크 네임스페이스에서 이 공유 프록시에 접근할 방법이 필요합니다. Codex는 해당 네임스페이스 내부에 루프백 TCP 리스너를 제공하고, 샌드박스 외부의 프로세스가 그 연결을 수락해 프록시로 중계하도록 구성합니다.
다음 다이어그램은 하나의 프록시 엔드포인트에 대한 구성을 보여주며, 마지막 다이어그램에는 이를 통과하는 연결 하나가 표시되어 있습니다. bubblewrap을 실행하기 전에 codex-linux-sandbox는 제어 채널로 사용할 Unix 소켓 쌍을 만들고 자신을 포크합니다. 자식 프로세스는 run_host_bridge()를 실행하고 이 채널을 통해 리스너의 파일 디스크립터를 받을 때까지 기다립니다.
이 예시에서 부모 프로세스는 exec를 사용해 자신의 프로그램 이미지를 bwrap으로 교체합니다. 이렇게 샌드박스를 설정한 뒤 그 안에서 codex-linux-sandbox --apply-seccomp-then-exec를 실행하면서 제어 채널의 FD를 전달합니다.
두 번째로 호출된 codex-linux-sandbox는 샌드박스의 네트워크 네임스페이스 내부에 루프백 TCP 리스너를 만들고, 소켓을 통해 그 파일 디스크립터를 전달합니다. 리스너는 샌드박스의 네트워크 네임스페이스에 계속 연결되어 있습니다. 따라서 샌드박스 외부에 남아 있는 자식 프로세스는 샌드박스 내부 프로그램의 연결을 수락하면서, 호스트의 네트워크 네임스페이스에서 업스트림 연결을 열 수 있습니다. 전달이 끝나면 두 프로세스 모두 제어 채널 디스크립터를 닫고, 샌드박스 내부 프로세스는 자신이 가진 리스너 복사본도 닫습니다.
TCP 리스너가 준비되면 샌드박스 내부의 프로세스는 해당 리스너를 가리키도록 HTTP_PROXY의 값을 적절히 설정(새 창에서 열기)하고 관련 환경 변수도 설정합니다. 그런 다음 seccomp를 적용한 뒤 포크하여 사용자의 명령을 실행합니다.
샌드박스 외부의 프로세스는 리스너를 열린 상태로 유지합니다. 연결을 수락할 때마다 설정된 프록시에 연결하고 양방향으로 데이터를 중계합니다.
이 추가 메커니즘은 명령에 별도의 루프백 인터페이스를 포함한 자체 네트워크 네임스페이스를 제공합니다. macOS에서는 Seatbelt가 명령이 호스트의 루프백 인터페이스에서 지정된 포트에 직접 연결할 수 있도록 허용합니다. 반면 Linux에서는 명령이 격리된 자체 네임스페이스 내부의 리스너에 연결하고, 샌드박스 외부의 프로세스가 이 연결을 설정된 프록시로 중계합니다. 디스크립터를 전달하면 호스트의 네트워크 네임스페이스를 명령에 노출하지 않고도 이 연결이 가능해집니다.
올해 초, OpenAI는 Windows에서 샌드박싱을 구현하고 그 과정을 글로 소개했습니다. 이후 Microsoft는 Windows 운영 체제 내 프로세스 격리를 위한 새로운 기능과 함께 MXC라는 라이브러리를 출시했습니다. 현재 OpenAI는 기존 샌드박스를 MXC 라이브러리를 활용하는 샌드박스로 교체하고 있습니다.
MXC(Microsoft eXecution Container)는 Windows, Linux, macOS 전반에서 여러 격리 백엔드를 지원하는 Microsoft의 샌드박스 기반 코드 실행 시스템(새 창에서 열기)입니다. Codex는 호환되는 Windows 기기에서 MXC 기반 샌드박스를 지원하며, 네이티브 프로세스 격리를 사용해 사용자의 기존 환경 내에서 명령을 제한합니다.
OpenAI는 보안과 사용성을 개선하고 기존 Windows 샌드박스의 다음과 같은 한계를 해결하기 위해 MXC로 전환하고 있습니다.
샌드박스 설정에 권한 상승 또는 관리자 권한 필요
ACL 확인 및 설정 작업의 높은 비용과 느린 속도
호스트 컴퓨터에 남는 샌드박스 설정 상태:
ACL
방화벽 규칙
샌드박스 사용자
제어 영역 파일
MXC는 JSON 구성 스키마(새 창에서 열기)를 제공합니다. Codex는 MXC SDK(새 창에서 열기)를 사용해 이 스키마에 따라 명령, 작업 디렉터리, 환경, 권한을 포함하는 실행 요청을 구성합니다. 이 권한은 파일 시스템 및 네트워크 접근뿐 아니라 데스크톱, 클립보드 등의 Windows 리소스도 다룹니다.
Codex는 호환성과 보안의 균형을 맞추기 위해 여러 제어 항목에 고정 설정을 사용합니다. 레지스트리 읽기를 허용하고, PowerShell이 시작 시 필요로 하는 Win32k 및 데스크톱 접근 권한을 유지합니다. 클립보드 접근, 입력 주입, 데스크톱 및 시스템 설정 제어는 비활성화됩니다. 마지막으로, MXC가 대체 수단으로 호스트 파일 시스템의 권한을 수정하지 못하도록 막습니다.
Codex는 권한 프로필의 파일 시스템 및 네트워크 규칙을 MXC 구성으로 변환합니다. 앞서 소개한 dev 프로필을 사용하고 다음과 같이 가정해 보겠습니다.
이 컴퓨터의 로컬 드라이브는
C:\,D:\,Z:\뿐입니다.워크스페이스 루트와 작업 디렉터리는
C:\work\demo입니다.사용자의 홈 디렉터리는
D:\Users\dev이므로~/build-cache는D:\Users\dev\build-cache로 해석됩니다.거부 glob 패턴은
C:\work\demo\config\dev.env와C:\work\demo\config\prod.env에만 일치합니다.
이에 해당하는 MXC 설정에는 다음이 포함됩니다.
MXC의 파일 시스템 정책은 기본적으로 접근을 거부합니다. 따라서 Codex는 이 프로필이 허용하는 광범위한 읽기 접근을 제공하기 위해 로컬 드라이브 루트에 읽기 전용 권한을 추가합니다. 이 권한은 사용자의 기존 OS 권한 범위 내에서 재귀적으로 적용됩니다.
한 가지 유의할 점이 있습니다. 드라이브 루트의 쓰기 가능 권한은 재귀적으로 적용되지 않으므로, Codex는 드라이브의 기존 직계 하위 항목까지 포함하도록 권한을 확장합니다.
더 구체적인 경로의 권한이 상위 경로의 권한보다 우선하므로, 읽기 전용인 C:\ 아래에서도 C:\work\demo에는 쓰기를 허용하고 C:\work\demo\.git은 읽기 전용으로 유지할 수 있습니다.
서로 다른 경로 표기나 심볼릭 링크/정션 별칭이 같은 경로를 가리키면 MXC는 더 엄격한 권한을 적용합니다. 거부는 읽기 전용보다 우선하고, 읽기 전용은 읽기·쓰기보다 우선합니다.
MXC는 구체적인 거부 경로만 입력받으므로, Codex는 실행 전에 거부 glob 패턴을 일치하는 파일 및 디렉터리 목록으로 확장합니다. 명령이 실행되는 동안 새로 생긴 glob 일치 경로는 자동으로 추가되지 않습니다.
*.openai.com 같은 도메인 규칙은 앞서 설명한 공유 Codex 네트워크 프록시가 적용합니다. Codex는 이 프록시를 샌드박스 외부에서 실행하고, 앞서 언급한 것과 동일한 표준 *_PROXY 환경 변수를 통해 주소를 명령에 전달합니다. MXC는 외부로의 직접 연결을 차단하면서 프록시 접근을 포함한 호스트 루프백 연결은 허용합니다. 다른 로컬 서비스에도 계속 접근할 수 있습니다.
하네스는 macOS, Linux, Windows에서 동일한 샌드박스 API를 사용해 권한 프로필에 따라 명령을 실행합니다. 해당 제한을 적용하는 데 필요한 설정은 플랫폼별 구현이 처리합니다.
코드를 작성하고 실행하는 능력은 에이전트가 소프트웨어 개발을 넘어 다양한 문제를 유연하게 해결할 수 있게 해줍니다. Codex 샌드박스는 파일 시스템 및 네트워크 접근을 명시적으로 제한하면서 사용자의 기존 환경에서 에이전트가 이 능력을 활용할 수 있게 합니다. 이는 하네스 내에서 재사용할 수 있는 기본 구성 요소이며, codex sandbox 명령을 통해 직접 만든 도구에서도 사용할 수 있습니다.
에이전트가 더 많은 작업을 맡게 됨에 따라, OpenAI는 더 다양한 도구와 환경에서 샌드박싱을 실용적으로 사용할 수 있도록 하려 합니다. 이를 위해 권한을 더 쉽게 구성할 수 있도록 하고, 운영 체제에 더 나은 보호 기능이 도입되면 이를 활용하고자 합니다. OpenAI의 목표는 에이전트가 접근할 수 있는 대상을 사람이 계속 통제하면서, 에이전트가 할 수 있는 일을 넓히는 것입니다.


