Codex CLI 훅을 쓸 때 막히기 쉬운 설정 문제
Cup은 가 코드를 만드는 동안에만 할 수 있는 무료 오픈소스 승부차기 게임이다. 핵심 내용은 게임보다 훅을 실제로 붙일 때 생기는 설정 문제다. 훅은 먼저 켜고 신뢰해야 작동한다.
설정 뒤 `~/.codex/.toml`에 `[features]`와 ` = true`를 넣거나 `codex --enable `로 실행한 다음, Codex 안에서 `/`를 열어 항목을 신뢰해야 한다. 신뢰 전에는 오류가 크게 보이지 않아도 훅이 실행되지 않는다. 훅 설정은 납작한 목록이 아니라 `` 안에 이벤트별 배열이 들어가는 중첩 구조여야 하며, 납작하게 쓰면 `/`에서 설치된 항목이 0개로 보인다.
윈도우에서는 `curl` 한 줄 명령이 셸마다 다르게 해석되어 실패할 수 있어, 표준 입력으로 이벤트를 읽고 로컬 서버에 보내는 작은 Node 전달기로 바꾸면 , cmd, bash에서 모두 같은 방식으로 작동한다. 이 도구는 `UserSubmit`, `PostToolUse`, `PermissionRe`, `Stop` 이벤트를 다루며, 계정이나 유료 기능 없이 `127.0.0.1`에서만 돌아가고 외부 전송이나 추적은 하지 않는다.
핵심 포인트
- 훅은 켠 뒤 `/`에서 신뢰까지 해야 실행된다.
- `~/.codex/.toml`에 `[features]`와 ` = true`를 넣거나 `codex --enable `로 실행할 수 있다.
- 훅 설정은 이벤트별로 들어가는 중첩 구조여야 하며, 납작한 배열 형태는 설치된 훅으로 잡히지 않는다.
- 윈도우에서는 `curl` 한 줄 명령 대신 작은 Node 전달기를 쓰면 여러 셸에서 더 안정적으로 작동한다.
- Cup은 에서만 실행되고 계정, 유료 기능, 외부 전송, 추적을 쓰지 않는다.