본문으로 건너뛰기

훅으로 명령 전후 검사하기

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. 막히는지 시험

위험한 명령을 일부러 요청해 막히는지 봅니다.

AI에게 보내기
rm -rf build 를 실행해 줘.

결과: 차단 메시지

확인: Codex가 차단 이유를 받고 실행하지 않았는지 확인

주의

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

참고 자료

  1. 1Codex 문서: 승인과 보안learn.chatgpt.com

업무 분야 · 필요한 기능

이 기능을 가진 도구