훅으로 명령 전후 검사하기
Codex 훅으로 명령 실행 전후에 검사 스크립트를 돌리면, 위험한 셸 명령은 실행 전에 막고 필요한 검사는 사람이 잊지 않게 자동으로 돌릴 수 있습니다.
프로젝트의 .codex/hooks.json에 PreToolUse 훅을 걸어 셸 명령을 받아 보고, 위험하면 종료 코드 2나 deny 응답으로 막습니다. 처음 쓰는 훅은 검토하고 신뢰해야 돌아갑니다. 명령과 설정 이름은 2026년 11월 21일에 공식 문서로 확인했습니다.
준비
- Codex CLI 설치와 로그인
- jq
1. 검사 스크립트 쓰기
훅은 표준 입력으로 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/hooks.json에 이벤트 → 매처 묶음 → 훅 순서로 적습니다. 매처는 정규식입니다.
{
"PreToolUse": [
{
"matcher": "^Bash$",
"hooks": [ { "type": "command", "command": ".codex/hooks/guard.sh" } ]
}
]
}결과: .codex/hooks.json
확인: JSON이 읽히는지 확인(jq . .codex/hooks.json)
3. 검토하고 신뢰하기
관리자가 배포하지 않은 훅은 Codex에서 검토하고 신뢰해야 돕니다. 처음 실행할 때 안내에 따라 내용을 읽고 신뢰합니다.
결과: 신뢰된 훅
확인: 훅이 돌았다는 상태 표시가 보이는지 확인
4. 막히는지 시험
위험한 명령을 일부러 요청해 막히는지 봅니다.
rm -rf build 를 실행해 줘.결과: 차단 메시지
확인: Codex가 차단 이유를 받고 실행하지 않았는지 확인
주의
- 훅 오류·시간 초과는 막지 않고 지나갈 수 있음. 차단은 스크립트가 확실히 2로 끝나게
- 명령 글자로만 맞추는 검사는 돌려 쓴 명령을 놓칠 수 있음. 샌드박스와 함께
- PreToolUse에서 continue·stopReason 같은 필드를 돌려주면 훅이 실패로 처리되고 명령은 실행됨
참고 자료
- 1Codex 문서: 승인과 보안learn.chatgpt.com
댓글