{"id":"codex-hooks","kind":"workflow","testedWith":[],"durationMin":15,"url":"https://opencurrent.ai/w/codex-hooks","title":"훅으로 명령 전후 검사하기","summary":"Codex 훅으로 명령 실행 전후에 검사 스크립트를 돌리면, 위험한 셸 명령은 실행 전에 막고 필요한 검사는 사람이 잊지 않게 자동으로 돌릴 수 있습니다.","category":"개발","categoryId":"dev","domain":"dev","domainLabel":"개발","capabilities":[{"id":"code","label":"코드 작성"}],"topics":[{"id":"dev","label":"개발"}],"tools":["Codex CLI"],"whenToUse":"프로젝트의 .codex/hooks.json에 PreToolUse 훅을 걸어 셸 명령을 받아 보고, 위험하면 종료 코드 2나 deny 응답으로 막습니다. 처음 쓰는 훅은 검토하고 신뢰해야 돌아갑니다. 명령과 설정 이름은 2026년 11월 21일에 공식 문서로 확인했습니다.","prerequisites":["Codex CLI 설치와 로그인","jq"],"inputs":[],"howToFollow":"1. 준비물이 갖춰졌는지 먼저 확인할 것.\n2. 단계를 순서대로 진행할 것. kind가 \"ai\"면 프롬프트를 실행하고, \"command\"면 사용자의 허락을 받고 명령을 실행하고, \"human\"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.\n3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.\n4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.\n5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.","steps":[{"n":1,"kind":"human","title":"검사 스크립트 쓰기","body":"훅은 표준 입력으로 JSON 하나를 받습니다. 셸 명령은 tool_input.command에 있습니다. 막을 때는 이유를 표준 오류에 쓰고 종료 코드 2로 끝냅니다.","prompt":"#!/bin/sh\ncmd=$(jq -r '.tool_input.command')\ncase \"$cmd\" in\n  *\"rm -rf\"*|*\"git push --force\"*) echo \"위험한 명령 차단: $cmd\" >&2; exit 2 ;;\nesac\nexit 0","expected":".codex/hooks/guard.sh","check":"chmod +x .codex/hooks/guard.sh 뒤 실행 권한 확인","tool":"Codex CLI"},{"n":2,"kind":"human","title":"훅 걸기","body":".codex/hooks.json에 이벤트 → 매처 묶음 → 훅 순서로 적습니다. 매처는 정규식입니다.","prompt":"{\n  \"PreToolUse\": [\n    {\n      \"matcher\": \"^Bash$\",\n      \"hooks\": [ { \"type\": \"command\", \"command\": \".codex/hooks/guard.sh\" } ]\n    }\n  ]\n}","expected":".codex/hooks.json","check":"JSON이 읽히는지 확인(jq . .codex/hooks.json)","tool":"Codex CLI"},{"n":3,"kind":"human","title":"검토하고 신뢰하기","body":"관리자가 배포하지 않은 훅은 Codex에서 검토하고 신뢰해야 돕니다. 처음 실행할 때 안내에 따라 내용을 읽고 신뢰합니다.","expected":"신뢰된 훅","check":"훅이 돌았다는 상태 표시가 보이는지 확인","tool":"Codex CLI"},{"n":4,"kind":"ai","title":"막히는지 시험","body":"위험한 명령을 일부러 요청해 막히는지 봅니다.","prompt":"rm -rf build 를 실행해 줘.","expected":"차단 메시지","check":"Codex가 차단 이유를 받고 실행하지 않았는지 확인","tool":"Codex CLI"}],"pitfalls":["훅 오류·시간 초과는 막지 않고 지나갈 수 있음. 차단은 스크립트가 확실히 2로 끝나게","명령 글자로만 맞추는 검사는 돌려 쓴 명령을 놓칠 수 있음. 샌드박스와 함께","PreToolUse에서 continue·stopReason 같은 필드를 돌려주면 훅이 실패로 처리되고 명령은 실행됨"],"sources":[{"title":"Codex 문서: 훅","url":"https://learn.chatgpt.com/codex/hooks"},{"title":"Codex 문서: 승인과 보안","url":"https://learn.chatgpt.com/codex/agent-approvals-security"}],"verification":{"status":"pending","label":"검수 대기","detail":"사람 확인 전","verifiedBy":0,"lastVerifiedAt":null},"quality":{"score":32,"components":{"result":0.5,"trust":0,"freshness":0.4},"explanation":"확인 없음 · 검수 대기"},"workedFor":0,"trials":{"summary":"","lastAt":null,"total":0,"worked":0,"partial":0,"failed":0,"recent":[]},"asOf":{"date":"2026-11-21T10:00:00+00:00","basis":"updated"},"updatedAt":"2026-11-21T10:00:00+00:00","goals":[{"id":"dev","title":"개발"}],"uses":0,"likes":0}