tmux-claude.plist 의 PATH 누락으로 텔레그램 plugin 자동 재기동 시 spawn 실패

발생 일자: 2026-05-14 09:04 KST (mac-mini 자동 재기동 시점부터 재발 패턴)
해결 일자: 2026-05-14 19:23 KST
심각도: medium (특정 사용자 봇 통로 끊김, 외부 데이터 손실 없음)
재발 가능성: high (본진 com.user.tmux-claude.plist / com.user.tmux-main.plist 에도 같은 PATH 누락 잔존)
영향 범위: mac-mini Claude Code 의 텔레그램 봇 @MyClaude4. 잠재적으로 본진의 동일 plist 잡

증상

mac-mini 텔레그램 봇 (@MyClaude4) 이 9:04 AM 부터 강대종 메시지에 응답 안 함. /mcp 화면에 plugin:telegram:telegram 등장 X. /plugin 입력 시 Failed to reconnect to plugin:telegram:telegram 노출. claude 본체 프로세스의 자식 프로세스 0건 — 즉 telegram MCP server 가 spawn 자체 안 됨.

1차 임시 복구: cache 디렉토리 (~/.claude/plugins/cache/claude-plugins-official/telegram) 삭제 + claude --dangerously-skip-permissions 수동 재시작 → 일시 복구. 약 2시간 후 자동 재기동 시점에 동일 증상 재발.

원인

두 가지 root cause 가 겹침:

launchd plist 의 EnvironmentVariables.PATH 누락 (진짜 원인):
- .mcp.json 의 spawn 명령 = bun run --cwd ${CLAUDE_PLUGIN_ROOT} --shell=bun --silent start
- bun 실제 위치 = /Users/user/.bun/bin/bun (homebrew 가 아님)
- launchd 잡 com.user.tmux-claude 의 PATH = /usr/bin:/bin:/usr/sbin:/sbin (bun 없음)
- → launchd 가 claude 부팅하면 plugin spawn 시 bun 못 찾음 → MCP server 안 뜸 → “Failed to reconnect”
- 강대종 수동 claude --dangerously-skip-permissions 시엔 zsh login PATH (~/.bun/bin 포함) → 일시 복구
- 비교: com.claude.agent-inbox-watcher plist 엔 EnvironmentVariables.PATH 박혀있어서 정상 작동
plist 자체가 invalid XML (보조 원인, strict mode 충돌):
- line 11 의 <string>cd ~ && ... 2>/dev/null || ...</string> 에서 && 가 XML escape 안 됨 (&& 이어야 함)
- 어제까지는 launchd 가 우연히 받아들였지만 오늘부터 strict 해진 정황 (macOS 업데이트 등 추정, 정확한 trigger 미확인)
- plutil / PlistBuddy 둘 다 “Encountered unknown ampersand-escape sequence at line 11” 로 read 거부
- 이 invalid XML 때문에 PlistBuddy 로 EnvironmentVariables 추가 시도하면 plist 가 더 broken 됨

조치

Python plistlib 으로 plist 새로 작성 (XML escape 자동 처리)
- && → &&
- 2> → 2>
- plutil -lint 검증: OK
EnvironmentVariables.PATH = /Users/user/.bun/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin 추가
launchctl bootout gui/501/com.user.tmux-claude + launchctl bootstrap gui/501 <plist> 재로드
옛 claude tmux 세션 kill + launchctl kickstart -k gui/501/com.user.tmux-claude → 새 claude 세션 19:15:38 부팅
검증: 새 claude PID 24854 의 자식 24867 = bun run --cwd .../telegram/0.0.6 --shell=bun --silent start ← telegram MCP server 정상 spawn ✅
백업 4개 보관:
- .bak.2026-05-14 (자동 백업 추정)
- .bak-rtk-2026-05-14 (원본 2차)
- .bak-rtk-2026-05-14-broken (PlistBuddy 손상본)
- 현재 = plistlib valid
추가: 본진 launchd 점검 결과 com.user.tmux-claude.plist + com.user.tmux-main.plist 둘 다 PATH 누락 (동일 함정). 본진 SoT 영역이라 직접 미수정, mac-report 로 surface 만.

예방 (Forcing function 우선)

자동 plist lint hook: 모든 노드 (Mac 본진 / mac-mini / WSL / desktop3060ti) 의 ~/Library/LaunchAgents/com.user.*.plist + com.claude.*.plist 또는 동등 systemd unit 에 대해:
- plutil -lint 통과 검증 (XML valid)
- EnvironmentVariables.PATH 존재 + homebrew/bun 경로 포함 여부 검증
- 매주 1회 cron 또는 새 plist 추가 시 git commit hook 강제
- 실패 시 강대종 텔레그램 즉시 알림
plist 작성 표준 = Python plistlib 만: PlistBuddy / 수동 XML 편집 금지 (XML escape 실수 ↓). 새 launchd 잡 만들 때 항상 plistlib.dump() 경유. 보일러플레이트 1개 마련 (~/.claude/skills/... 또는 ~/claude-skills/snippets/).
plugin install 시 spawn command 가 minimal PATH 에서 찾히는지 검증: 새 plugin install 시 .mcp.json 의 command 값을 추출해서 /usr/bin:/bin:/usr/sbin:/sbin 환경에서 command -v 로 찾을 수 있는지 검증. 못 찾으면 EnvironmentVariables.PATH 박는 안내.

재발 이력

(초기 작성. 이번이 첫 박제.)

tmux-claude.plist 의 PATH 누락으로 텔레그램 plugin 자동 재기동 시 spawn 실패

증상

원인

조치

예방 (Forcing function 우선)

재발 이력

관련 링크