WSL/노트북 codex SSH attach 죽음 사고 — frontend tty 직접 attached 상태에서 SSH 끊김으로 세션 동반 종료

WSL/노트북 codex SSH attach 죽음 사고 — frontend tty 직접 attached 상태에서 SSH 끊김으로 세션 동반 종료

• 발생 일자: 2026-05-28 KST
• 심각도: medium (작업 손실은 없었으나 codex 세션이 함께 죽어 재접속 필요)
• 재발 가능성: high → low (wrapper + autostart 적용 후 낮아짐)
• 영향 범위: WSL / 노트북 codex REPL, SSH attach 경유 세션

사건

노트북/WSL 쪽 codex 가 tmux 내부 wrapper 없이 SSH 프론트엔드 tty 에 직접 붙은 상태로 돌다가, SSH 연결이 끊기면서 codex 세션도 같이 종료됐다. 결과적으로 작업은 살아 있어도 attach 경로가 끊겨 재진입이 필요했다.

관찰된 사실

1. 본진/맥미니처럼 tmux main 안에서 codex 를 띄운 패턴이 아니었다.
2. WSL/노트북은 frontend tty 직접 attached 상태라 SSH 끊김이 곧 codex 종료로 이어졌다.
3. 노트북 쪽은 detached tmux 세션은 무사했고, systemd user side 는 4분 갭 뒤 자가복구했다.
4. 사고 후 wrapper/auto-start 적용으로 reattach 경로를 표준화했다.

근본 원인

• codex REPL 이 tmux 보호막 없이 SSH attach 에 직접 매달려 있었다.
• SSH disconnect / session loss 가 곧 codex exit 로 전파됐다.
• 재접속 시 자동 복구 장치가 없어서 사람이 다시 들어가야 했다.

재발방지

1. codex 는 tmux main 세션 안에서만 띄운다.
2. WSL/노트북은 wrapper script + systemd user unit 으로 autostart 한다.
3. reattach 후 idempotent skip 이 확인돼야 정상으로 간주한다.

관련 task

• T-260528-14 — WSL/노트북 codex SSH attach 죽음 사고 issue 박기
• T-260528-12 — WSL/노트북 codex tmux main wrapper 영구화

상태

• 원인 기록과 재발방지 패턴을 issue 로 고정.
• wrapper / autostart 적용 이후 재현 방지 상태로 전환.