본진 ~/.zshrc 의 claude tmux 자동 생성 라인이 launchd plist 와 race — cc 가 빈 zsh 세션에 grouped attach

발생 일자: 2026-05-29 07:28 KST 직전 (형님 cc 안 붙는 증상 발견)
가시화: 2026-05-29 07:29:25 KST (형님 msg27671 “m 메인세션에서 cc가 안붙는 증상이 있었어”)
해결 일자: 미정 (이슈 박는 시점 ack 대기, .zshrc line 16 제거 fix 후보)
심각도: medium (cc 가 안 붙는 것처럼 보임. 실제 채널/세션은 다른 경로로 살아있어 데이터 손실 0. 형님 진입 동선만 깨짐)
재발 가능성: high (launchd plist 가 어떤 이유로 죽거나 멈추면 매 새 zsh 진입마다 빈 claude 세션이 만들어짐)
영향 범위: 🍎 본진 cc 진입 동선 + ~/.zshrc line 16 의 fail-deadly 자동 생성

증상

형님 m alias (tmux attach -t main 2>/dev/null || tmux new -s main) 으로 main 세션 진입 후 cc 호출 → 화면 변화 0. main 세션의 zsh prompt 가 그대로 보이고, cc 가 silent 으로 5번 호출된 흔적이 남음 (tmux capture-pane -t main:0 -p 결과 user@<mac-host> ~ % cc 5줄).

가시 증상:

main 세션 화면이 cc 호출 후에도 zsh prompt 그대로
tmux ls 결과: claude (group claude), claude-98322 (group claude, attached), claude-98931 (group claude, attached), main 모두 존재
claude REPL 실제 살아있음 — PID 98325 claude --channels plugin:telegram@claude-plugins-official
단 PID 98325 의 PPID = 961, PID 961 = tmux new -d -s claude (decrypt-run.sh 없는 단순 명령)

탐지

본진 자가 진단 (07:35~07:45 KST):

cc 실행 경로 확인 — ~/Users/<user>/bin/cc (Apr 18 변경 후 그대로, 한 달 무수정)
claude 바이너리 위치 — /opt/homebrew/bin/claude 정상, ~/.bun/bin/claude 부재
tmux ls + list-clients → claude/claude-98322/claude-98931/main 4 세션, ttys000/ttys004 가 grouped client 둘 다 attached+focused
tmux capture-pane -t main:0 → cc 5번 silent fail 흔적
ps -ww -p 98325 -o pid,ppid,command → PPID 961 = tmux new -d -s claude
stat -f '%Sm' /tmp/com.user.tmux-claude.{out,err}.log → mtime = 2026-05-28 16:08:10 KST (어제 telegram plugin ENOENT 사고 시점 이후 launchd 재실행 0)
~/.zshrc line 16 발견: tmux has-session -t claude 2>/dev/null || tmux new -d -s claude

근본 원인

~/.zshrc line 16 이 zsh 시작 시 tmux has-session -t claude 검사 후 false 면 tmux new -d -s claude (claude REPL 없이 빈 zsh 만 띄움) 으로 자동 세션을 만든다.

com.user.tmux-claude.plist 의 RunAtLoad program 은:

tmux has-session -t claude || tmux new -d -s claude 'cd ~/Users/<user> && export PATH=... && exec ~/Users/<user>/infra-config/scripts/decrypt-run.sh --profile telegram /opt/homebrew/bin/claude --channels plugin:telegram@claude-plugins-official'

즉 빈 세션이 아니라 claude REPL 까지 띄움. 두 명령이 같은 claude 이름 세션을 두고 race 하는데, 먼저 만든 쪽이 이긴다 (둘 다 has-session 검사로 skip 처리).

타이밍:

어제 2026-05-28 16:08 KST telegram plugin ENOENT 사고 (issues/2026-05-28-mac-telegram-plugin-enoent.md) 회복 후 launchd plist 가 그 시점 이후 다시 안 돔 (/tmp/com.user.tmux-claude.{out,err}.log mtime 정확히 5/28 16:08:10).
사이 어딘가에 claude 세션이 죽음.
오늘 새벽 어떤 시점에 형님이 (또는 자동화가) 새 zsh 를 열자 line 16 의 tmux has-session false → tmux new -d -s claude 으로 claude REPL 없는 빈 zsh 세션 (PID 961) 생성.
그 빈 세션 안에서 추후 어떤 동작으로 claude --channels plugin:telegram@claude-plugins-official 이 첫 윈도우에 실행되어 PID 98325 가 살아남. 단 plist 의 decrypt-run.sh wrapper 가 안 끼어 있어서 환경변수 fallback 경로로 띄워진 상태.

형님이 m → main 진입 → cc 시도 시점에 이미 빈 또는 PPID 961 짜리 비표준 세션이 존재. cc 는 tmux has-session -t claude PASS 으로 ensure_base skip → tmux new-session -d -t claude -s claude-<PID> 으로 grouped client 만들고 switch-client → 그 client view 가 보여주는 세션 화면 = claude REPL 화면. 단 비표준 세션 진입 시점이라 형님 입장에서 “안 붙음” 으로 해석.

(참고 — 형님 가설 “본진/맥미니/노트북 3명이 업데이트하다가 깨진 거 같다” 와 직접 관계는 없음. 다만 어제 telegram plugin ENOENT 사고 회복 commit 흐름 [42d1da6, 383d9f6] 에서 plist 단독 책임으로 정리됐어야 할 자동 생성 라인이 .zshrc 에 남아 race 가능성을 살려둔 게 간접 원인.)

복구 (ack 대기)

후보 A (추천) — .zshrc line 16 제거

-# 본진 챗봇 세션 자동 유지 (5노드 표준, 2026-05-16 통일 후 2026-05-18 이름 fix)
-tmux has-session -t claude 2>/dev/null || tmux new -d -s claude
+# claude tmux 세션 생성은 launchd com.user.tmux-claude.plist 단독 책임.
+# 죽으면 `launchctl kickstart -k gui/$(id -u)/com.user.tmux-claude` 으로 명시 복구.

이유:

plist 가 RunAtLoad + state=active 으로 책임 (decrypt-run.sh wrapper + bun PATH 포함 완전한 환경).
.zshrc 의 빈 세션 자동 생성은 plist 가 죽었을 때 fail-deadly: 빈 세션을 만들어 plist 의 has-session 검사를 PASS 시켜버려 plist 재시도가 의미를 잃음.
죽었을 때 명시 복구가 더 안전 — 어제 v3 cold-restart 패턴 (launchctl bootout + pkill -KILL -f "claude --channels" + launchctl bootstrap) 이 표준.

후보 B — line 16 을 plist 와 동일 명령으로 맞춤

-tmux has-session -t claude 2>/dev/null || tmux new -d -s claude
+tmux has-session -t claude 2>/dev/null || tmux new -d -s claude 'cd ~/Users/<user> && exec ~/Users/<user>/infra-config/scripts/decrypt-run.sh --profile telegram /opt/homebrew/bin/claude --channels plugin:telegram@claude-plugins-official'

장점: zsh 진입만으로 claude REPL 까지 자동 복구. 단점: 명령 복잡도 ↑, plist 와 .zshrc 두 곳에 똑같은 명령 박혀 sync drift 위험.

.zshrc 변경 = hard rule 형님 명시 ack 필수

CLAUDE.md (“사용자 셸 RC 파일 변경 = 형님 명시 ack 필수, scope creep 금지”) 룰 적용. ack 없이 진행 금지.

재발방지

글로벌 룰 — RC 파일 fail-deadly 자동화 검토 — ~/.zshrc / ~/.bashrc 의 자동 세션 생성/attach 라인이 launchd/systemd 와 race 하는지 점검. fail-deadly 패턴 (= 빈 상태를 만들어 상위 책임자의 retry 를 막음) 잡히면 (a) 제거 (b) 상위 책임자와 동일 명령 으로 강제 sync. 메모리에 박을 것 (feedback_rc_fail_deadly_session_seed).
launchd plist 재시작 헬스체크 추가 (deferred) — /tmp/com.user.tmux-claude.{out,err}.log mtime + launchctl print runs 카운트 + tmux capture-pane -t claude:0 화면 sanity check. plist 가 죽었거나 빈 세션만 띄운 상태 자동 탐지. 본 사이클은 별 task 로 분리.
cc 스크립트의 base 세션 무결성 검증 추가 (deferred) — ensure_base 안에서 tmux list-windows -t claude pane PID 의 command 가 claude --channels 인지 확인. 빈 zsh 만 있으면 (= line 16 race 결과) kill_all_group 후 plist 패턴으로 재생성. 별 task.
plist 단독 책임 명시 docstring — com.user.tmux-claude.plist 와 .zshrc 양쪽에 “claude 세션 생성은 plist 단독 책임” 주석 박아 다음 챗봇이 .zshrc 에 자동 생성 라인 도로 추가하는 사고 방지. 본 fix commit 에 포함.
재발 시 본 이슈 참조 — main 세션 cc 안 붙는 패턴 잡히면 즉시 (a) ps -p $(tmux list-windows -t claude -F '#{pane_pid}') -o command 확인 (b) PPID 가 tmux new -d -s claude 단순 명령이면 line 16 race 확정 (c) launchctl kickstart -k 또는 v3 cold-restart 으로 plist 재가동.

사이드 노트

cc 스크립트 line 75-77 의 set-hook -t "$CLIENT" client-detached "kill-session -t =$CLIENT" + switch-client -t "=$CLIENT" 조합은 정상 동작 (의도된 grouped client 자동 청소). 본 사고와 무관. 단 switch-client 가 잘못 trigger client-detached hook 가능성은 별 task 로 한 번 reproduce 시도 필요.
동일 RC race 패턴이 다른 노드 (맥미니/WSL/desktop3060ti/notebook3060) ~/.bashrc/~/.zshrc 에도 있는지 sweep 검사 필요. 별 task.
형님 두 번째 메시지 (주간 토큰 22시 리셋이 지금 이미 리셋) 는 별 이슈 — anthropic 사이드 또는 scrape SoT 정의 변화 가설. 별 reply 으로 surface 후 진행.