Codex 훅이 안 돌 때: 검토·신뢰와 훅 기능 스위치

1. 검토하고 신뢰했나요

Codex는 훅의 지금 해시에 대해 신뢰를 기록합니다. 그래서 새로 생기거나 바뀐 훅은 ‘검토 필요’로 표시되고 신뢰할 때까지 건너뜁니다. 시작할 때 검토할 훅이 있으면 /hooks를 열라는 경고가 나옵니다. 플러그인 훅도 같고, 플러그인 업데이트로 묶인 스크립트가 바뀌면 훅 정의가 같아도 다시 검토해야 합니다.

고치기: 그 프로젝트에서 codex를 실행한 뒤 대화 안에서 /hooks를 입력해 출처와 명령을 확인하고 신뢰합니다(셸에서 codex /hooks로 치는 명령이 아닙니다). 데스크톱 앱에서는 입력창의 Review hooks나 Settings › Hooks에서 합니다. 이미 열려 있던 세션은 새로 시작하는 편이 확실합니다.

--dangerously-bypass-hook-trust는 그 한 번의 실행만 신뢰 기록 없이 켜진 훅을 돌립니다. 직접 만든 훅을 시험할 때만 쓰고, 내용을 모르는 훅에는 쓰지 마세요.

2. 훅 기능 자체가 꺼져 있나요

훅은 기본으로 켜져 있지만, ~/.codex/config.toml의 [features]에 hooks = false가 있으면 모든 훅이 돌지 않습니다. 예전 이름 codex_hooks도 아직 같은 뜻으로 읽힙니다. 이때는 Codex가 훅을 불러오지 않아 /hooks에 신뢰할 항목도 보이지 않습니다(codex-cli 0.163·0.166에서 확인).

고치기: 그 줄을 지우거나 hooks = true로 바꾼 뒤 Codex를 다시 시작합니다. CODEX_HOME을 따로 쓰면 그 폴더의 config.toml을 봐야 합니다. 신뢰 기록도 그 Codex 홈의 설정에 남아서, 다른 CODEX_HOME에서는 다시 검토해야 합니다.

3. 회사 정책이 막고 있나요

관리자가 requirements.toml에 allow_managed_hooks_only = true를 두면 사용자·프로젝트·세션·플러그인 훅은 건너뛰고 관리 훅만 불러옵니다. 관리 훅은 정책으로 신뢰되고 사용자 훅 화면에서 끌 수 없습니다. 이 경우 내 컴퓨터에서 고칠 방법은 없으니 관리자에게 문의하세요.

4. 프로젝트 훅이라면

<저장소>/.codex/hooks.json의 훅은 그 프로젝트의 .codex/ 층을 신뢰했을 때만 불러옵니다. 신뢰하지 않은 프로젝트에서도 사용자·시스템 훅은 그대로 돕니다. 같은 층에 hooks.json과 config.toml의 [hooks]가 함께 있으면 둘을 합치고 시작할 때 경고합니다.

Codex가 아예 시작하지 않을 때

config.toml에 approval_policy = "untrusted"가 남아 있으면 지금 Codex는 approval_policy = "untrusted" is no longer supported; remove this setting 오류로 바로 끝납니다(codex-cli 0.163·0.166에서 확인). 그 줄을 지우거나 on-request로 바꾸세요.

Lidnight로

Lidnight는 Codex를 연결하면 Codex가 실제로 돌릴 Lidnight 훅(명령·시간 제한·해시)을 그대로 보여 주고, 누를 때만 그 훅만 신뢰합니다(공식 codex app-server 사용, 다른 도구·프로젝트·플러그인 훅은 그대로). 훅 기능이 꺼져 있으면 이유를 보여 주고 확인을 받은 뒤 그 한 줄만 켜며(되돌리기 가능), 관리 정책이면 그렇다고 알립니다. Codex가 설정 오류로 시작하지 못하면 그 오류 첫 줄을 화면에 보여 줍니다.

확인: 2026-11-07, OpenAI Codex 문서 ‘Hooks’(learn.chatgpt.com/docs/hooks)와 codex-cli 0.163·0.166 실행 기준. 바뀌었을 수 있으니 문서를 확인하세요.