승인과 샌드박스 수준 정하기
Codex의 승인 모드와 샌드박스를 config.toml에 일에 맞게 정해 두면, 매번 묻는 창에 끊기지 않으면서도 작업 폴더 밖을 건드리는 사고를 막을 수 있습니다.
~/.codex/config.toml에 approval_policy와 sandbox_mode를 정하고, 필요할 때만 네트워크를 엽니다. 한 번만 다르게 돌릴 때는 실행 옵션으로 덮어쓰고, 승인과 샌드박스를 모두 끄는 옵션은 격리된 환경에서만 씁니다. 명령과 설정 이름은 2026년 11월 21일에 공식 문서로 확인했습니다.
준비
- Codex CLI 설치와 로그인
1. 설정 파일 열기
사용자 설정은 ~/.codex/config.toml입니다. 프로젝트 루트의 .codex/config.toml도 읽는데, 신뢰한 프로젝트에서만 적용되고 가까운 파일이 이깁니다.
mkdir -p ~/.codex && ${EDITOR:-nano} ~/.codex/config.toml결과: 열린 config.toml
확인: 파일 경로가 맞는지 확인
2. 승인과 샌드박스 정하기
approval_policy는 on-request(필요할 때 묻기)나 never, sandbox_mode는 read-only, workspace-write, danger-full-access 가운데 고릅니다. 평소 개발에는 작업 폴더 쓰기와 필요할 때 묻기가 무난합니다.
approval_policy = "on-request"
sandbox_mode = "workspace-write"결과: 두 줄이 들어간 설정
확인: Codex를 다시 열어 작업 폴더 밖 쓰기를 요청하면 승인을 묻는지 확인
3. 네트워크는 필요할 때만
workspace-write에서는 네트워크가 기본으로 꺼져 있습니다. 패키지 설치처럼 꼭 필요할 때만 켭니다.
[sandbox_workspace_write]
network_access = true결과: 네트워크를 연 설정
확인: npm install 같은 명령이 되는지 확인
4. 한 번만 다르게 돌리기
실행 옵션이 설정을 덮어씁니다. 읽기만 시킬 때는 아래처럼 엽니다.
codex --sandbox read-only --ask-for-approval on-request결과: 읽기 전용으로 열린 세션
확인: 파일 수정을 요청하면 막히는지 확인
주의
- --yolo(--dangerously-bypass-approvals-and-sandbox)는 승인과 샌드박스를 모두 끔. 격리된 컨테이너·VM에서만
- danger-full-access는 작업 폴더 밖 파일과 네트워크에 제한이 없음
- approval_policy의 untrusted는 지원하지 않고 on-failure는 사라질 예정. on-request나 never로
참고 자료
- 1Codex 문서: 설정 레퍼런스learn.chatgpt.com
- 2Codex 문서: CLI 명령과 옵션learn.chatgpt.com
댓글