덕삼
블로그

Codex 실전 가이드 2편 — 샌드박스와 승인 정책

Codex 실전 가이드 2편입니다. 1편에서 프로젝트 신뢰가 기본 샌드박스를 바꾼다는 이야기를 했습니다. 이번 편은 그 샌드박스와 승인 정책을 다룹니다. Claude Code 가이드에는 없는 주제입니다. Codex 에서 가장 먼저 부딪히는 차이가 여기 있어서 2편에 두었습니다.

이번 편이 답하는 질문은 이것입니다. Codex 에게 어디까지 맡겨도 되고, 그 경계는 무엇이 지키나. 답은 두 겹입니다. 운영체제 샌드박스가 파일 쓰기와 네트워크를 먼저 막습니다. 그다음 승인 정책과 rules 파일이 샌드박스 밖으로 나갈 명령을 고릅니다. 신뢰한 저장소의 기본값이면 저장소 안 편집은 맡겨도 됩니다. .git 쓰기, 네트워크, 저장소 밖 쓰기는 매번 사람에게 묻게 됩니다.

샌드박스는 세 단계이고 기본은 읽기 전용입니다

codex --help 의 -s, --sandbox 는 값 세 개를 받습니다. 공식 문서의 설명을 옮기면 이렇습니다.

값공식 문서의 설명
read-only파일을 볼 수는 있지만 승인 없이 편집하거나 명령을 실행하지 못한다
workspace-write작업 폴더 안에서 읽고 편집하고 일상적인 로컬 명령을 실행한다
danger-full-access샌드박스 제한 없이 실행한다

공식 문서의 설정 예시는 sandbox_mode 기본값을 read-only 로 적습니다. 1편에서 본 대로 제 맥에서는 신뢰한 저장소가 workspace-write, 처음 보는 폴더가 read-only 였습니다. 강제 수단은 운영체제 기능입니다. 공식 문서 기준으로 macOS 는 Seatbelt 정책과 sandbox-exec 를 씁니다. Linux 는 bwrap 과 seccomp 를 씁니다.

workspace-write 도 .git 과 네트워크는 막습니다

신뢰한 저장소에서 codex debug prompt-input 을 보면 쓰기 가능한 경로가 셋 나옵니다. 저장소 폴더, /private/tmp, 그리고 사용자 임시 폴더($TMPDIR)입니다. 같은 출력에 저장소 안이지만 읽기만 허용된 경로도 있습니다. .git, .agents, .codex, .aws 입니다. 공식 문서의 권한 설명도 이 네 경로를 읽기 전용으로 남긴다고 적습니다. 제 해석은 이렇습니다. 저장소 이력과 에이전트 자신의 스킬·설정을 에이전트가 고치지 못하게 막아 둔 듯합니다.

샌드박스 안에서 실제로 무엇이 막히는지는 codex sandbox 로 잴 수 있습니다. 이 명령은 Codex 가 쓰는 것과 같은 샌드박스 안에서 주어진 명령을 실행합니다. 빈 git 저장소에서 세 가지를 시도했습니다.

codex sandbox -- sh -c 'touch ok.txt; touch .git/probe; curl -s -m 5 https://example.com'
codex sandbox -c sandbox_mode="workspace-write" -- sh -c '...같은 명령...'
시도기본(신뢰 안 한 폴더)workspace-write
작업 폴더에 파일 만들기실패성공
.git 안에 파일 만들기실패실패
외부 주소로 HTTP 요청실패(curl 종료 코드 6)실패(curl 종료 코드 6)

.git 이 막혀 있으니 git commit 은 샌드박스 안에서 끝나지 않습니다. 커밋할 때마다 승인을 받거나, 다음 절의 rules 로 허용해야 합니다. 네트워크도 같습니다. 공식 문서는 workspace-write 의 네트워크가 기본으로 꺼져 있다고 설명합니다. 켜는 설정 키는 sandbox_workspace_write.network_access 입니다. 무엇이 막혔는지 모를 때는 codex sandbox --log-denials 를 씁니다. 도움말 기준으로 macOS 의 샌드박스 거부 기록을 모았다가 명령이 끝난 뒤 보여 줍니다.

샌드박스 밖으로 나가는 길은 승인과 rules 둘뿐입니다

prompt-input 의 권한 안내문에는 샌드박스 밖 실행 조건이 적혀 있습니다. 사용자가 승인했거나, 이미 있는 규칙이 그 명령을 허용했을 때입니다. 판정 단위도 정해져 있습니다. 명령줄을 파이프(|)·&&·||·;·서브셸 경계에서 조각으로 나누고, 조각마다 따로 판정합니다. 리디렉션, 치환, 환경변수 대입, 와일드카드가 든 명령은 규칙과 대조하지 않습니다.

모델이 승인을 요청하는 방식도 안내문에 있습니다. sandbox_permissions 에 "require_escalated" 를 넣고, justification 에 사용자에게 물을 질문을 적습니다. 원하면 prefix_rule 을 제안합니다. 사용자는 그 제안을 받아들여 다음 세션에도 쓸 규칙으로 남길 수 있습니다.

언제 물을지는 승인 정책(approval_policy, CLI 의 -a)이 정합니다. 0.169.0 의 -a 는 값 두 개만 받습니다.

  • on-request — 모델이 판단해 승인을 요청합니다. 공식 문서의 설정 예시는 이 값을 기본값으로 적습니다.
  • never — 묻지 않습니다. 실행이 실패하면 그 결과가 모델에게 바로 돌아갑니다.

공식 문서 기준으로 예전 값 untrusted 는 더 이상 지원하지 않고, on-failure 는 폐기 예정입니다. 예전 글에서 자주 보던 --full-auto 도 지원이 끝났습니다. 공식 문서는 대신 --sandbox workspace-write 를 쓰라고 안내합니다. 반대쪽 끝에는 --dangerously-bypass-approvals-and-sandbox 가 있습니다. 도움말은 이 옵션을 “외부에서 이미 격리된 환경 전용"이라고 적습니다.

그 사이에 --approve-for-me 가 있습니다. 승인 요청을 사람 대신 자동 검토로 보내고, 샌드박스는 workspace-write 를 씁니다. 자동 검토가 거절한 명령은 /approve 로 한 번 다시 시도할 수 있습니다(공식 문서 기준). 이 자동 검토가 어떤 기준으로 판정하는지는 확인하지 못했습니다. 세션 안에서 승인 없이 할 수 있는 범위를 바꾸는 명령은 /permissions 입니다(공식 문서 기준).

rules 파일은 승인을 기억하는 곳입니다

한 번 승인한 명령을 다음에도 묻지 않게 하는 장소가 rules 파일입니다. 공식 문서 기준으로 위치는 설정 층 옆의 rules/ 폴더(~/.codex/rules/default.rules 등)입니다. 저장소의 .codex/rules/ 는 신뢰한 프로젝트에서만 읽습니다. 문법은 prefix_rule() 한 줄입니다.

prefix_rule(pattern=["git", "push"], decision="allow")
prefix_rule(pattern=["git", "reset", "--hard"], decision="forbidden")
prefix_rule(pattern=["rm"], decision="prompt")

decision 은 allow·prompt·forbidden 셋입니다. 여러 규칙이 걸리면 forbidden > prompt > allow 순으로 가장 엄격한 쪽이 이깁니다. 공식 문서는 rules 를 아직 실험 기능이라고 적습니다. 규칙이 의도대로 걸리는지는 codex execpolicy check 로 확인합니다. 최상위 도움말 목록에는 없지만 0.169.0 에서 동작했습니다.

codex execpolicy check -r test.rules -- git reset --hard HEAD
# {"matchedRules":[...{"matchedPrefix":["git","reset","--hard"],"decision":"forbidden"}}],"decision":"forbidden"}

zsh 에서 명령을 변수에 담아 넘기면 단어로 쪼개지지 않습니다. 이때는 규칙이 하나도 걸리지 않은 결과가 나옵니다. 저도 처음에는 규칙이 고장 난 줄 알았습니다.

Claude Code 와 다른 점 — 묻기 전에 먼저 막습니다

Claude Code 가이드 1편은 권한을 “처음엔 좁게, 쓰면서 넓히기"로 다뤘습니다. Codex 도 원칙은 같지만 첫 번째 방어선이 다릅니다.

항목Claude CodeCodex 0.169.0
첫 번째 방어선도구를 쓰기 전에 묻는 권한 확인운영체제 샌드박스
허용 기록설정 파일의 허용·거부 목록rules/*.rules 의 prefix_rule
판정 단위도구와 명령 패턴제어 연산자로 쪼갠 명령 조각

Claude Code 에서 허용 목록에 없는 명령은 사람에게 묻습니다. Codex 에서 샌드박스가 막는 명령은 묻기 전에 먼저 실패합니다. 그래서 승인 요청이 “무엇을 하려는가"보다 “왜 샌드박스 밖이어야 하는가"에 가깝습니다.

실사례 — 승인 버튼이 남긴 93개의 규칙

제 ~/.codex/rules/default.rules 를 세어 보았습니다(2026-11-18). 규칙은 93개였고 전부 allow 였습니다. 그중 25개는 200자가 넘었고, 가장 긴 규칙은 5,938자였습니다. 열어 보니 이슈 본문 전체를 인자로 넣은 이슈 생성 명령이 통째로 규칙이 되어 있었습니다. 한 번만 쓸 명령을 “다음에도 허용"으로 승인한 결과입니다. 이런 규칙은 같은 명령이 다시 올 일이 없으니 아무것도 허용하지 못합니다.

비용은 다른 곳에서 나옵니다. 승인한 규칙은 매 세션 권한 안내문의 “Approved command prefixes” 목록으로 들어갑니다. 신뢰한 저장소에서 잰 권한 안내문은 9,270자였습니다. 끝에는 “[Some commands were truncated]” 가 붙어 있었습니다. 승인 한 번이 이후 모든 세션의 컨텍스트를 조금씩 차지하는 셈입니다.

반대 방향의 위험도 있습니다. 목록에 ["curl"] 이 allow 로 들어 있었습니다. 안내문의 규칙대로라면 curl 로 시작하는 명령 조각은 샌드박스 밖에서 실행됩니다. 네트워크를 막아 둔 샌드박스가 curl 에 한해서는 꺼진 것과 같습니다. 안내문도 ["python3"] 처럼 넓은 접두어는 제안하지 말라고 모델에게 지시합니다. 사람 쪽에서도 같은 기준으로 승인해야 합니다.

지금은 두 가지를 지킵니다. 승인할 때는 ["git", "push"] 처럼 짧고 범주가 분명한 접두어만 남깁니다. 그리고 rules 파일을 가끔 열어 200자가 넘는 규칙과 너무 넓은 접두어를 지웁니다.

정리

Codex 의 경계는 두 겹입니다. 샌드박스가 쓰기와 네트워크를 먼저 막습니다. 승인 정책과 rules 가 샌드박스 밖으로 나갈 명령을 고릅니다. 신뢰한 저장소의 기본값이면 저장소 안 편집은 맡겨도 됩니다. 커밋과 네트워크는 승인이나 규칙이 있어야 하고, 그 규칙은 짧은 접두어로만 남깁니다.

다음에 확인할 것은 하나입니다. ~/.codex/rules/ 를 열어 curl·python3 처럼 넓은 allow 규칙이 있는지 보는 것입니다. 3편에서는 config.toml·프로필, 그리고 세션을 열자마자 차 있는 컨텍스트를 다룹니다.