Cmd. /hooks
Codex lifecycle hooks를 검토하고 신뢰/비활성화 상태를 관리하는 명령
핵심 요약
/hooks는 설정된 lifecycle hook의 출처와 신뢰 상태를 훑어보면서 새 hook을 신뢰하거나 non-managed hook을 비활성화하는 명령입니다.PreToolUse·PermissionRequest·PostToolUse·UserPromptSubmit·Stop등 실행 시점별 hook을 점검할 수 있습니다.- managed hook은 system·MDM·cloud·
requirements.toml정책으로 신뢰되어 사용자 browser에서 비활성화할 수 없습니다. - 2026-05-14 GA 공지로 표준 명령이 됐습니다.
features.hooks가 canonical key이고codex_hooks는 deprecated alias입니다. - plugin-bundled hooks는 opt-in이라
[features].plugin_hooks = true가 필요하며, hook을 완전한 enforcement boundary로 가정하지 마세요.
명령어 원본 선언
/hooks공식 설명 요약
/hooks는 설정된 lifecycle hooks를 훑어보고, 새 hook 또는 변경된 hook을 신뢰하거나 non-managed hook을 비활성화하는 명령.
사용법
/hooks좋은 사용 예
- 프로젝트
.codex/hooks.json또는[hooks]를 추가한 직후 실행해 실행될 hook과 출처를 확인 - 플러그인 bundled hooks를 켜기 전에
/plugins로 플러그인 상태를 확인하고/hooks로 hook 신뢰 여부를 검토 - 팀 정책상 managed hook과 개인/프로젝트 hook을 구분해 온보딩 문서에 남김
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
| /hooks | lifecycle hook 검토/신뢰/비활성화 | hook이 실행되기 전 source와 trust 상태를 확인할 때 |
| /plugins | plugin inventory와 bundled hooks 확인 | hook이 plugin에서 온 것인지 확인할 때 |
| /debug-config | 설정 계층 진단 | hook이 왜 로드됐는지 config precedence까지 봐야 할 때 |
활용 사례
PreToolUse,PermissionRequest,PostToolUse,UserPromptSubmit,Stophook의 운영 점검- secret scan, prompt policy, post-command validation 같은 팀 guardrail 검토
- plugin-bundled hooks opt-in 전에 실제 hook source와 trust 상태 확인
2026-05-14 변경사항
- Codex changelog에서 Hooks general availability가 공지됨
- 공식 slash commands 문서에
/hooks가 등재되어 preview 항목이 아니라 표준 명령으로 다룰 수 있음 - hooks 문서 기준
features.hooks는 canonical feature key이며,codex_hooks는 deprecated alias로 유지됨 - plugin-bundled hooks는 현재 release에서 opt-in이며
[features].plugin_hooks = true가 필요함
주의사항
- managed hooks는 system, MDM, cloud,
requirements.toml정책으로 신뢰되며 사용자 hook browser에서 비활성화할 수 없습니다 - project-local hooks는 프로젝트
.codex/layer를 신뢰한 경우에만 로드됩니다 - hook은 guardrail일 뿐, 모든 shell/tool 경로를 완전한 enforcement boundary로 막아준다고 가정하지 마세요
도입 시점 (릴리즈 기준)
- 판정: 공식 문서 등재 + GA
- 최초 근거 버전:
rust-v0.129.0 - 시기(UTC): 2026-05-07 / GA 공지 2026-05-14
- 릴리즈 링크: https://developers.openai.com/codex/changelog
출처
- Codex slash commands: https://developers.openai.com/codex/cli/slash-commands
- Codex hooks: https://developers.openai.com/codex/hooks
- Codex changelog: https://developers.openai.com/codex/changelog