Codex 권한·샌드박스·승인 구분하기
명령이 막혔을 때 "묻지 않고 전부 실행"으로 바꾸면 원인도 모르고 접근 범위부터 넓히게 됩니다. 먼저 막힌 이유가 파일 경계인지, 네트워크 제한인지, 승인 대기인지 구분하세요.
이 글은 공식 보안 문서를 참고한 비공식 해설입니다. 아래 옵션 조합을 실제 AI 세션이나 OS별 환경에서 시험하지 않았습니다. 현재 CLI 도움말과 조직의 유효 정책을 함께 확인해야 합니다.
서로 다른 두 제어
샌드박스는 명령이 접근할 수 있는 파일·네트워크 같은 기술적 경계를 정합니다. Codex가 실행하는 Git·테스트 러너·패키지 매니저 같은 하위 명령도 이 경계의 영향을 받습니다.
승인 정책은 에이전트가 어떤 상황에서 멈추고 허가를 요청하는지 정합니다. 승인을 묻지 않는 설정과 접근 제한이 없는 설정은 같은 뜻이 아닙니다. 지침 파일에 적은 약속도 이 두 제어를 대신하지 않습니다.
처음에는 읽기 위주로
코드를 이해하는 작업은 다음처럼 읽기 전용 경계에서 시작할 수 있습니다. 실행하면 AI 세션을 시작하므로 사용자가 계정과 이용 조건을 확인한 뒤 결정하세요.
codex --sandbox read-only --ask-for-approval on-request
read-only는 모든 명령 실행을 차단한다는 뜻이 아닙니다. 공식 승인·보안 안내의 조합 표에 따르면 읽기 전용 경계 안에서 파일을 읽고 명령을 실행할 수 있으며, 경계를 넘는 동작에는 승인이 필요할 수 있습니다. 모든 통신을 차단하는 오프라인 모드로도 해석하지 마세요.
수정이 필요한 연습 프로젝트에서는 다음 조합이 프로젝트 경계 안의 작업을 허용하는 출발점이 될 수 있습니다.
codex --sandbox workspace-write --ask-for-approval on-request
workspace-write는 모든 폴더를 쓰도록 허용하는 설정이 아닙니다. 작업 루트·추가 쓰기 경로·네트워크 조건·조직 제한을 확인해야 합니다. 프로젝트 안의 명령이라도 외부 서비스 호출이나 비용이 발생하는 테스트일 수 있으니 실행 목적을 검토하세요.
승인 화면에서 볼 것
- 실행할 명령과 작업 디렉터리가 원래 요청과 연결되는지
- 쓰기·삭제·설치·외부 요청이 포함되는지
- 한 번 허용인지 세션 전체 허용인지
- 거절했을 때 읽기만으로 진행할 대안이 있는지
- 다른 저장소나 개인 홈 폴더까지 범위가 커지는지
필요한 작업을 진행할 수 있는 가장 좁은 범위를 선택하세요. CLI 안에서는 /permissions로 현재 권한 프로필을 확인하거나 변경할 수 있습니다. 메뉴 이름과 가능한 항목은 버전·조직 정책에 따라 달라질 수 있습니다.
기본 해결책으로 쓰지 않을 것
전체 접근 모드나 샌드박스·승인 우회는 이 입문 흐름의 해결책이 아닙니다. never 승인 정책도 "항상 안전하다"는 뜻이 아니라 승인 질문을 하지 않는다는 뜻입니다. 특히 신뢰하지 않는 저장소·다운로드·이슈 본문의 지시를 그대로 실행하면 안 됩니다.
자동 승인 검토 기능이 제공되더라도 샌드박스 경계가 사라지는 것은 아닙니다. 이 글에서는 자동 검토를 켜거나 조직 보안 설정을 변경하지 않습니다. 관리 정책으로 막힌 작업은 로컬 옵션으로 우회하려 하지 말고 담당 관리자에게 필요한 범위를 설명하세요.
실패 원인을 먼저 기록하세요
승인 대기라면 명령과 요청 범위를 확인하고, 샌드박스 초기화 오류라면 운영체제의 사전 조건을 확인합니다. 네트워크 차단이라면 목적지와 허용 정책을 확인합니다. 서로 다른 실패를 전부 권한 부족으로 묶지 마세요.
작업 경계를 정했다면 리뷰와 테스트에서 결과 검증을 이어갑니다. 같은 에이전트가 구현과 설명을 모두 했더라도, 실제 변경과 테스트 출력에 근거해 사람이 최종 판단해야 합니다.
공식 한국어 도움말: ChatGPT 플랜과 Codex에서 계정별 이용 안내를 확인할 수 있습니다. 이 글은 해당 도움말의 공식 번역이 아니며, 계정 조건과 요금은 공식 안내를 우선합니다.
추가 공식 참조
- Permissions — 기존 샌드박스·승인 원문과 별도의 현재 권한 안내입니다. 전체 permission profile 절차는 이 글에서 설명 완료로 세지 않습니다.
다음은 관련 세부 기능과 전체 참조 문서입니다. 아래 항목은 원문 전체를 한국어로 설명하거나 실행 검증한 범위가 아닙니다. 적용 조건과 정확한 옵션은 공식 원문을 확인하세요.