---
name: opencurrent-codex-hooks
description: "Codex 훅으로 명령 실행 전후에 검사 스크립트를 돌리면, 위험한 셸 명령은 실행 전에 막고 필요한 검사는 사람이 잊지 않게 자동으로 돌릴 수 있습니다. 이럴 때 사용: 프로젝트의 .codex/hooks.json에 PreToolUse 훅을 걸어 셸 명령을 받아 보고, 위험하면 종료 코드 2나 deny 응답으로 막습니다. 처음 쓰는 훅은 검토하고 신뢰해야 돌아갑니다. 명령과 설정 이름은 2026년 11월 21일에 공식 문서로 확인했습니다. 도구: Codex CLI."
metadata:
  source: "https://opencurrent.ai/w/codex-hooks"
  opencurrent-id: "codex-hooks"
  verification: "pending"
  exported-at: "2026-11-21T11:04:50.280Z"
---

# 훅으로 명령 전후 검사하기

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

> OpenCurrent에서 사람들이 다듬는 워크플로. 원문: https://opencurrent.ai/w/codex-hooks
> 검증 상태: 검수 대기 (사람 확인 전). 내려받은 뒤에 바뀌었을 수 있으니, 가능하면 원문이나 MCP의 get_workflow("codex-hooks")로 최신 상태를 확인할 것.
> 주의: 검수 대기 상태. 사용자에게 이 사실을 알리고, 결과를 함께 확인하면서 진행할 것.

## 따라 하는 방법

1. 준비물이 갖춰졌는지 먼저 확인할 것.
2. 단계를 순서대로 진행할 것. kind가 "ai"면 프롬프트를 실행하고, "command"면 사용자의 허락을 받고 명령을 실행하고, "human"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.
3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.
4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.
5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.

## 언제 쓰나

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

## 준비물

- Codex CLI 설치와 로그인
- jq

## 단계

### 1. 검사 스크립트 쓰기 (사람이 · Codex CLI)

훅은 표준 입력으로 JSON 하나를 받습니다. 셸 명령은 tool_input.command에 있습니다. 막을 때는 이유를 표준 오류에 쓰고 종료 코드 2로 끝냅니다.

프롬프트:

```text
#!/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에 이벤트 → 매처 묶음 → 훅 순서로 적습니다. 매처는 정규식입니다.

프롬프트:

```text
{
  "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)

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

프롬프트:

```text
rm -rf build 를 실행해 줘.
```

기대 결과: 차단 메시지

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

## 주의할 점

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

## 출처

- [Codex 문서: 훅](https://learn.chatgpt.com/codex/hooks)
- [Codex 문서: 승인과 보안](https://learn.chatgpt.com/codex/agent-approvals-security)

## 끝나면

결과가 좋았거나 단계가 낡았으면 https://opencurrent.ai/w/codex-hooks 에서 알릴 것. 다음 사람이 더 정확한 방법을 쓸 수 있도록.
