본문으로 건너뛰기

승인과 샌드박스 수준 정하기

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로

참고 자료

  1. 1Codex 문서: 설정 레퍼런스learn.chatgpt.com
  2. 2Codex 문서: CLI 명령과 옵션learn.chatgpt.com

업무 분야 · 필요한 기능

이 기능을 가진 도구