Cmd. /hooks
Codex lifecycle hooks를 검토하고 신뢰/비활성화 상태를 관리하는 명령
핵심 요약
- Codex lifecycle hooks를 검토하고 신뢰/비활성화 상태를 관리하는 명령
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
Codex lifecycle hooks를 검토하고 신뢰/비활성화 상태를 관리하는 명령
/hooks사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Codex CLI 0.155.1 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/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까지 봐야 할 때 |
실행 결과와 유지 범위
구성된 훅과 실행 조건을 확인합니다. 훅을 수정하면 해당 이벤트에서 실행되는 동작이 달라집니다.
/hooks는 설정된 lifecycle hooks를 훑어보고, 새 hook 또는 변경된 hook을 신뢰하거나 non-managed hook을 비활성화하는 명령.
주의사항
확인할 기본 이벤트는 PreToolUse, PermissionRequest, PostToolUse, UserPromptSubmit, Stop입니다. .codex/hooks.json 또는 인라인 [hooks] 설정에서 구성하며, 관리형 훅과 신뢰하지 않은 프로젝트 훅은 제어 범위가 다릅니다.
- managed hooks는 system, MDM, cloud,
requirements.toml정책으로 신뢰되며 사용자 hook browser에서 비활성화할 수 없습니다 - project-local hooks는 프로젝트
.codex/layer를 신뢰한 경우에만 로드됩니다 - project hook의 사용자 trust는 정확한 content hash에 묶이므로 파일이 바뀌면 다시 검토·신뢰합니다
- MCP hook handler는 기존 연결을 재사용해 synchronous로 실행하고 approval을 요청하거나 다른 hook을 다시 trigger할 수 없습니다. auth·availability 실패를 별도 경로로 다룹니다
- hook은 guardrail일 뿐, 모든 shell/tool 경로를 완전한 enforcement boundary로 막아준다고 가정하지 마세요
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록