# 훅으로 명령 전후 검사하기
id: codex-hooks · 종류: 워크플로 · 상태: 검수 대기 (사람 확인 전) · 주제: 개발
주소: https://opencurrent.ai/w/codex-hooks
기준일: 2026-11-21 (여기서 고친 날)
도구: Codex CLI
걸리는 시간: 약 15분
평가 점수: 32/100 (확인 없음 · 검수 대기)

Codex 훅으로 명령 실행 전후에 검사 스크립트를 돌리면, 위험한 셸 명령은 실행 전에 막고 필요한 검사는 사람이 잊지 않게 자동으로 돌릴 수 있습니다.

설명: 프로젝트의 .codex/hooks.json에 PreToolUse 훅을 걸어 셸 명령을 받아 보고, 위험하면 종료 코드 2나 deny 응답으로 막습니다. 처음 쓰는 훅은 검토하고 신뢰해야 돌아갑니다. 명령과 설정 이름은 2026년 11월 21일에 공식 문서로 확인했습니다.

준비물: Codex CLI 설치와 로그인 · jq

단계:
1. [사람이 · Codex CLI] 검사 스크립트 쓰기 — 훅은 표준 입력으로 JSON 하나를 받습니다. 셸 명령은 tool_input.command에 있습니다. 막을 때는 이유를 표준 오류에 쓰고 종료 코드 2로 끝냅니다.
   프롬프트:
   > #!/bin/sh
   > cmd=$(jq -r '.tool_input.command')
   > case "$cmd" in
   >   *"rm -rf"*|*"git push --force"*) echo "위험한 명령 차단: $cmd" >&2; exit 2 ;;
   > esac
   > exit 0
   기대 결과: .codex/hooks/guard.sh
   확인 방법: chmod +x .codex/hooks/guard.sh 뒤 실행 권한 확인
2. [사람이 · Codex CLI] 훅 걸기 — .codex/hooks.json에 이벤트 → 매처 묶음 → 훅 순서로 적습니다. 매처는 정규식입니다.
   프롬프트:
   > {
   >   "PreToolUse": [
   >     {
   >       "matcher": "^Bash$",
   >       "hooks": [ { "type": "command", "command": ".codex/hooks/guard.sh" } ]
   >     }
   >   ]
   > }
   기대 결과: .codex/hooks.json
   확인 방법: JSON이 읽히는지 확인(jq . .codex/hooks.json)
3. [사람이 · Codex CLI] 검토하고 신뢰하기 — 관리자가 배포하지 않은 훅은 Codex에서 검토하고 신뢰해야 돕니다. 처음 실행할 때 안내에 따라 내용을 읽고 신뢰합니다.
   기대 결과: 신뢰된 훅
   확인 방법: 훅이 돌았다는 상태 표시가 보이는지 확인
4. [AI에게 · Codex CLI] 막히는지 시험 — 위험한 명령을 일부러 요청해 막히는지 봅니다.
   프롬프트:
   > rm -rf build 를 실행해 줘.
   기대 결과: 차단 메시지
   확인 방법: Codex가 차단 이유를 받고 실행하지 않았는지 확인

주의:
- 훅 오류·시간 초과는 막지 않고 지나갈 수 있음. 차단은 스크립트가 확실히 2로 끝나게
- 명령 글자로만 맞추는 검사는 돌려 쓴 명령을 놓칠 수 있음. 샌드박스와 함께
- PreToolUse에서 continue·stopReason 같은 필드를 돌려주면 훅이 실패로 처리되고 명령은 실행됨

출처:
- Codex 문서: 훅 https://learn.chatgpt.com/codex/hooks
- Codex 문서: 승인과 보안 https://learn.chatgpt.com/codex/agent-approvals-security