ArticleOpenAI·2026년 11월 18일·0

Inside the Codex sandbox

Quick Summary

Codex 샌드박스는 사용자의 기존 개발 환경에서 명령을 실행하되, 권한 프로필로 파일시스템과 네트워크 접근 범위를 정하고 그 제한을 자식 프로세스에도 적용한다.

Inside the Codex sandbox 관련 대표 이미지

🖼️ 인포그래픽

Inside the Codex sandbox 내용을 설명하는 본문 이미지

🖼️ 4컷 인포그래픽

Inside the Codex sandbox의 핵심 내용을 4단계로 요약한 인포그래픽
Inside the Codex sandbox 핵심 내용을 4단계로 압축한 4컷 인포그래픽

💡 한 줄 요약

Codex 샌드박스는 사용자의 기존 개발 환경에서 명령을 실행하되, 권한 프로필로 파일시스템과 네트워크 접근 범위를 정하고 그 제한을 자식 프로세스에도 적용한다.

📌 핵심 요약

  • OpenAI는 모델 훈련·정렬과 샌드박스를 함께 사용하는 심층 방어 방식을 설명한다. 샌드박스가 명령의 접근 범위를 제한해도 허용된 파일 변경이 나중에 다른 프로그램에 영향을 줄 가능성은 남는다.
  • Git 저장소가 작업공간 루트일 때 기본 제공 :workspace 프로필은 작업공간 쓰기를 허용하고 .git과 .codex는 읽기 전용으로 둔다. 파일 읽기는 사용자의 운영체제 권한 안에서 폭넓게 허용하며, 네트워크는 기본 차단한다.
  • Codex는 macOS, Linux, Windows의 격리 기능을 공통 API로 제공한다. 명령은 기존 환경의 도구를 사용할 수 있고, 자식 프로세스는 부모의 제한을 상속해 원래 명령이 종료된 뒤에도 그 제한을 받는다.
  • 모델은 exec_command로 개별 명령에 추가 권한을 요청할 수 있다. 실행을 담당하는 하네스가 사용자 설정에 따라 직접 승인이나 자동 검토를 거쳐 허용 여부를 결정한다.
  • 사용자는 config.toml에 이름을 붙인 권한 프로필을 정의해 프로젝트 간에 재사용할 수 있다. 네트워크는 차단, 전체 직접 접근, 프록시를 통한 도메인 제한 중에서 구성할 수 있고, 기업 관리자는 requirements.toml로 사용자가 선택할 수 있는 프로필을 제한할 수 있다.

🧩 주요 포인트

  1. :workspace의 넓은 읽기 범위 덕분에 빌드 도구가 저장소 밖의 SDK와 라이브러리를 쓸 수 있지만, 같은 범위의 민감한 파일도 읽힐 수 있다.
  2. 기존 환경의 도구에 운영체제별 제한을 적용하므로 Mac의 iOS 빌드 도구와 iPhone 시뮬레이터를 사용하는 작업도 지원할 수 있다.
  3. 명령별 추가 권한은 하네스의 승인 판단을 거치고, 기업은 requirements.toml로 프로필 선택 범위를 정할 수 있어 개별 실행과 조직 설정 양쪽에서 권한을 통제할 수 있다.

🧠 상세 정리

1. 작업에 맞춰 나누는 파일 권한과 네트워크 권한

OpenAI는 Codex가 사용자의 컴퓨터에서 명령을 실행하는 일을 일상적인 기능이면서 보호가 필요한 작업으로 본다. 이를 위해 모델 훈련과 정렬에 더해, 명령을 실행하는 동안 프로그램이 접근할 수 있는 파일과 네트워크를 제한하는 샌드박스를 둔다. 사용자는 세션에 적용할 권한 프로필을 통해 작업에 필요한 읽기·쓰기 범위와 외부 연결 여부를 각각 정할 수 있다. 사진 정리라면 ~/Pictures 안의 사진을 읽고 수정하도록 허용하면서 네트워크를 차단해 업로드를 막을 수 있다. 코드 검토라면 소스 파일을 읽기 전용으로 유지하면서 온라인 문서를 조회하는 데 필요한 네트워크 접근을 허용할 수 있다.

2. :workspace 기본값의 이점과 남는 위험

Git 저장소를 작업공간 루트로 삼으면 :workspace는 소스 파일을 매번 승인받지 않고 편집할 수 있게 하면서 .git과 .codex 같은 디렉터리는 읽기 전용으로 둔다. 컴파일러와 런타임이 저장소 밖에 있는 SDK, 라이브러리, 설정을 쓰는 경우가 많아 파일 읽기는 사용자의 운영체제 권한 안에서 폭넓게 허용한다. 그 결과 API 키가 담긴 설정 파일처럼 작업과 무관한 민감한 파일도 읽기 범위에 들어갈 수 있다. 기본 네트워크 차단은 읽은 데이터를 외부 서비스로 직접 전송하는 일을 막지만, 의존성을 내려받는 정상 작업에도 추가 접근 권한이 필요해진다. OpenAI는 쓰기가 허용된 로컬 파일의 변경이 나중에 다른 프로그램의 실행에 영향을 줄 수 있다는 점을 들어 샌드박스와 모델 훈련·정렬을 병행하는 이유를 설명한다.

3. 기존 개발 환경에서 명령을 실행하는 이유

OpenAI는 개발자가 자신의 컴퓨터에 구성해 둔 도구를 그대로 쓸 수 있도록 각 운영체제의 격리 기능을 활용하는 방식을 택했다. 개발자가 필요에 따라 바꾸는 환경을 Docker 컨테이너에 재현하려면 손이 들고, 일부 작업은 호스트에서 실행되는 도구에 의존한다. 예를 들어 Mac에서 iOS 앱을 개발할 때 컨테이너 안의 Codex는 Mac용 실행 파일로 구성된 iOS 빌드 도구를 직접 실행하거나 iPhone 시뮬레이터를 띄울 수 없다. 빌드와 시뮬레이터 실행을 Mac 호스트에 맡기는 설계도 가능하지만, 그렇게 위임한 작업은 컨테이너의 보호 범위를 벗어나므로 별도의 제한이 필요하다. Codex가 운영체제별 샌드박스에 투자한 이유는 이런 작업을 원래 도구가 있는 환경에서 수행하면서 명령에 접근 제한을 적용하기 위해서다.

4. 공통 API와 자식 프로세스의 권한 상속

Codex 하네스는 macOS, Linux, Windows에서 서로 다른 운영체제의 격리 기능을 공통 API로 제공한다. 호출자는 실행할 명령과 권한 프로필을 전달하고, 프로필이 제한적인 네트워크 접근을 허용한다면 그 조건을 집행할 프록시도 제공해야 한다. API는 샌드박스 안에서 프로세스를 시작한 뒤 하네스가 해당 프로세스의 종료를 기다릴 수 있도록 Child 핸들을 반환한다. 이렇게 시작된 명령이 다른 프로세스를 실행하면 자식은 부모의 샌드박스 제한을 상속하며, 같은 원리가 그 아래의 후손 프로세스에도 적용된다. 따라서 처음 실행한 명령이 먼저 종료되더라도 계속 실행 중인 후손 프로세스에는 기존 제한이 유지된다.

5. 모델의 권한 요청을 판단하는 하네스

코딩 작업에서 자주 쓰이는 셸 도구 exec_command는 모델이 생성한 명령을 받아 실행하며, 하네스는 명령을 시작할 때 적용할 권한 프로필과 필요한 경우 네트워크 프록시를 전달한다. 모델은 개별 명령에 대해 현재 턴의 기본 설정을 사용하거나, 샌드박스 안에서 추가 권한을 요청하거나, 샌드박스 밖에서 실행할 권한을 요청할 수 있다. 요청을 허용할지는 하네스가 사용자 설정에 따라 판단하며, 사용자에게 직접 승인을 요청하거나 자동 검토로 보낼 수 있다. 실행이 승인되면 하네스는 원래 요청의 명령 인자에 승인된 권한 조건을 적용한다. 셸 도구 외에도 하네스의 로컬 파일 읽기와 수정 기능이 같은 격리 기반을 사용하며, 개발자는 codex sandbox 명령으로 자신의 도구에서도 샌드박스 실행 기능을 재사용할 수 있다.

6. 여러 프로젝트에서 재사용하는 권한 프로필

사용자는 config.toml의 [permissions]에 이름을 붙인 프로필을 정의해 여러 프로젝트에서 같은 파일시스템·네트워크 제한을 재사용할 수 있다. 글에 나온 dev 프로필은 기본 제공 :workspace의 보호 설정을 상속하면서 ~/build-cache에 쓰기를 허용하고 작업공간 안의 일부 경로에는 추가 제한을 둔다. 파일시스템 항목별로 읽기 전용, 읽기·쓰기 허용, 접근 차단을 지정할 수 있으며 :workspace_roots 아래의 규칙은 각 작업공간 루트를 기준으로 해석된다. 기본적으로 Codex CLI는 현재 작업 디렉터리 하나를 루트로 삼고, ChatGPT 데스크톱 앱은 프로젝트의 소스 폴더들을 사용한다. 따라서 dev에서 .vscode를 읽기 전용으로 지정하면 여러 소스 폴더가 있는 프로젝트에서도 각 루트 아래의 .vscode에 같은 제한이 적용된다.

7. 프록시가 집행하는 도메인별 네트워크 제한

네트워크 권한은 모든 접근을 차단하거나, 전체 직접 접근을 허용하거나, 프록시를 통해 허용할 도메인을 제한하는 세 가지 방식으로 구성할 수 있다. :workspace의 기본값은 네트워크 차단이며, :danger-full-access의 기본값은 전체 직접 접근이다. 사용자 정의 프로필에서 네트워크를 활성화하고 프록시를 비활성화하면 직접 접근이 전면 허용되므로, 특정 도메인으로만 연결을 허용하려는 경우에는 프록시와 도메인 규칙이 함께 필요하다. 도메인 규칙에는 정확한 이름과 와일드카드 패턴을 쓸 수 있고 명시적인 차단 규칙이 허용 규칙보다 우선한다. 허용 범위에 들어가지 않는 도메인으로의 요청은 설정에 따라 별도 승인을 받아야 하거나 차단된다.

8. 설정의 우선순위와 기업 관리자의 통제 범위

Codex는 여러 config.toml 파일을 병합해 사용자가 프로젝트 전반의 기본값을 정하고 신뢰하는 특정 프로젝트에서는 일부 값을 바꿀 수 있도록 한다. 테이블은 재귀적으로 병합하고 같은 값이 충돌하면 우선순위가 높은 설정을 적용하며, 배열은 통째로 교체한다. 권한 프로필이 파일 경로와 네트워크 도메인을 테이블로 표현하므로 팀은 필요한 항목만 바꾸면서 다른 항목에 대한 조직 기본 설정의 변경을 계속 상속할 수 있다. 기업 관리자는 시스템 파일이나 클라우드 정책 등에서 제공하는 requirements.toml의 관리 요건을 통해 사용자가 바꿀 수 있는 설정의 범위도 제한할 수 있다. 대표적인 예로 allowed_permission_profiles를 지정하면 기업 사용자가 선택할 수 있는 권한 프로필의 집합을 정할 수 있다.

🧾 핵심 주장 / 시사점

  • 파일의 읽기·쓰기와 네트워크 연결을 따로 정할 수 있어, 소스 수정을 막으면서 온라인 문서 조회는 허용하는 식으로 작업 목적에 맞는 권한을 구성할 수 있다.
  • 명령이 끝나는 시점과 권한 제한이 끝나는 시점은 다를 수 있다. 처음 명령보다 오래 실행되는 자식 프로세스도 상속받은 제한을 계속 적용받는다.
  • 설정 병합은 팀이 필요한 경로와 도메인만 조정할 수 있게 하고, 관리 요건은 사용자가 선택할 수 있는 프로필의 범위를 조직이 정할 수 있게 한다.

✅ 액션 아이템

  • :workspace의 파일 읽기 범위에 빌드에 필요한 SDK와 라이브러리 외에 민감한 파일도 포함되는지 확인한다.
  • 작업에 필요한 외부 연결 범위에 따라 네트워크 차단, 전체 직접 접근, 프록시를 통한 도메인 제한 중 적합한 방식을 정한다.
  • exec_command의 추가 권한 요청에 직접 승인과 자동 검토 중 어떤 방식을 적용할지 검토한다.

❓ 열린 질문

  • :workspace에서 빌드 도구에 필요한 읽기 범위를 유지하면서 민감한 파일의 접근 범위를 어디까지 줄일 수 있는가?
  • 어떤 작업에 전체 직접 접근이 필요하고, 어떤 작업은 프록시를 통한 도메인 제한만으로 수행할 수 있는가?
  • 기업 관리자는 requirements.toml로 사용자가 선택할 수 있는 권한 프로필을 어디까지 제한할 것인가?

관련 문서

공통 태그와 주제 흐름을 기준으로 같이 보면 좋은 문서를 이어서 제안합니다.