맥북 본진 codex CLI 무한 업데이트 알림 — npm-global/homebrew 중복설치 + PATH 우선순위 mismatch

발생 일자: 2026-06-07 21:49 KST
해결 일자: 2026-06-07 22:00 KST
심각도: low
재발 가능성: medium
영향 범위: 🍎 본진 Mac codex CLI (codex 세션 사용 흐름)

증상

본진 Mac codex 세션에서 “Update available 0.136.0 → 0.137.0” 프롬프트가 업데이트(1번)를 눌러도 매번 다시 떠 무한 반복. 업데이트는 성공한다는데 끝나지 않음.

원인

codex 가 두 곳에 중복 설치돼 “실행되는 사본”과 “업데이트되는 사본”이 갈라짐.

~/.npm-global/lib/node_modules/@openai/codex (옛 0.136) — 셸 PATH 우선순위 1순위(~/.zshrc:24 의 export PATH=$HOME/.npm-global/bin:$PATH + start-wrapped-session.sh 의 동일 PATH prepend)라 codex 실행 시 항상 이 사본이 뜸.
/opt/homebrew/lib/node_modules/@openai/codex (새 0.137) — ~/.npmrc 의 prefix=/opt/homebrew 때문에 codex 자가업데이트(npm i -g @openai/codex)는 이 사본만 갱신.
결과: 실행본(npm-global 0.136)은 영영 안 바뀌고 → 매 실행 “0.136 → 0.137 업데이트 있음” 재출현.

뿌리는 2026-05-20 “맥을 3노드(nvm)처럼 npm-global prefix 로 통일” 시도의 반쪽 적용 잔재. ~/.zshenv 주석에 본인이 “Mac npm-global 은 그 패턴 안 통함”이라 기록(claude 쪽 동형 사고 issue 2026-05-29-mac-claude-update-stale-staging-enotempty-loop).

조치

옛 npm-global codex 사본(pkg + bin 심링크)을 ~/.npm-global/_disabled/codex-2026-06-07-2200/ 으로 가역 보관 이동(RETIRED.md 복원법 포함, 삭제 아님). homebrew 단일화.

검증: interactive which codex → /opt/homebrew/bin/codex, 버전 codex-cli 0.137.0. npm-global 사본 부재 확인.
실행 중이던 codex 세션은 이미 로드된 옛 프로세스라 재실행부터 0.137 적용.

예방 (Forcing function 우선)

trio-vote(2026-06-07) 예방안 A 만장일치(3-0) 채택 — 감지형 forcing function. mac 일일 헬스체크가 codex 의 npm-global·homebrew 양대 prefix 동시존재를 감지하면 텔레그램 경고. B(.zshrc 잔재 정리)는 RC파일 ack 게이트라 후속 별 사이클.

막을 코드/훅: claude-automations PR #109 — scripts/env-token-healthcheck.sh 에 codex 중복설치 감지 블록 추가(# ⚠️ 제거 금지 가드 마커). 둘 다 존재 시 REPORT 에 [mac-codex] codex 중복설치 감지 한 줄 → 기존 텔레그램 알림 경로로 발사. mac(Darwin) 로컬 한정, Linux 노드 자연 skip. https://github.com/ssamssae/claude-automations/pull/109

재발 이력

<처음 생성 — 비어있음>