codex/main tmux 라우팅 사고 — `d`/`m`/`cx`가 main과 codex 사이를 잘못 오감

발생 일자: 2026-06-18 KST
영향 범위: WSL에서 데스크탑 d, 데스크탑 cx 후 m, 노트북 M 후 cx
상태: resolved

사건

WSL CLI에서 d를 누르면 데스크탑 main이 아니라 codex 화면으로 붙었다.
데스크탑에서 cx 접속 후 m을 누르면 main shell로 돌아가지 않고 codex가 다시 붙었다.
노트북 M으로 main에 들어간 뒤 cx를 치면 cx: 지금 다른 tmux(클로드 쪽) 안입니다. detach 후 또는 새 터미널에서 cx 실행하세요. 문구가 뜨며 codex로 전환되지 않았다.

관찰된 사실

WSL ~/.bashrc의 d alias는 ssh desktop3060ti /usr/bin/tmux new-session -A -s main이었다. 원격 main 세션의 active pane이 tmux라서 main attach가 곧 codex처럼 보였다.
데스크탑 ~/home/<user>/bin/m은 단순 tmux new-session -A -s main 래퍼였다. shell pane을 선택하거나 nested pane을 회피하지 않았다.
데스크탑 ~/home/<user>/bin/cx는 WRAPPER_VERSION="2026-06-18-nested-tmux" 구버전이었다. default tmux main 안에서 codex tmux를 nested attach했다.
데스크탑 ~/.bashrc에는 alias m='tmux attach -t main ...'가 남아 있어 ~/home/<user>/bin/m 래퍼를 shadowing했다.
노트북의 실제 cx는 ~/home/<user>/.local/bin/cx가 먼저 잡혔다. 이 파일은 cx bridge 기능이 있는 별도 wrapper였고, non-codex tmux 안에서 에러를 출력하고 종료하는 분기가 남아 있었다.
노트북 ~/.bashrc의 alias m='tmux new-session -A -s main'도 ~/home/<user>/bin/m 래퍼를 타지 않았다.

근본 원인

WSL 3노드의 codex는 전용 tmux socket -L codex의 codex 세션에서 돌고, main 작업공간은 default tmux socket의 main 세션에서 돈다.
plain tmux attach/new-session alias는 active window가 nested tmux/codex일 때 그대로 잘못 붙는다.
cx가 default tmux 안에서 codex를 nested attach하면 main pane 자체가 codex attach 상태가 되어 m으로 복귀하는 동작이 꼬인다.
wrapper 파일을 고쳐도 shell alias나 PATH 우선순위(~/.local/bin/cx > ~/bin/cx)가 남으면 실제 실행 경로는 계속 구버전을 탄다.

수정

WSL

~/.bashrc:
- alias d='TERM=xterm-256color ssh -t desktop3060ti ~/home/<user>/bin/m'

desktop3060ti

~/home/<user>/bin/m을 shell pane 선택형 wrapper로 교체.
- default socket main 세션을 보장한다.
- bash|zsh|sh|fish pane을 우선 선택한다.
- shell pane이 없으면 main-shell window를 만든다.
- 다른 tmux socket 안에서 실행되면 detach-client -E로 main attach로 교체한다.
~/home/<user>/bin/cx를 WRAPPER_VERSION="2026-06-18-detachE-cross-tmux" 버전으로 교체.
- default tmux 안에서 cx 실행 시 nested attach하지 않는다.
- codex grouped client를 만든 뒤 현재 main client를 detach-client -E로 codex attach로 교체한다.
~/.bashrc:
- alias m='~/home/<user>/bin/m'
- alias d='~/home/<user>/bin/m'
이미 떠 있는 main bash에도 live alias를 주입했다.

notebook3060

~/home/<user>/.local/bin/cx와 ~/home/<user>/bin/cx를 WRAPPER_VERSION="2026-06-18-detachE-cross-tmux-bridge" 버전으로 교체.
- cx bridge 기능은 유지했다.
- non-codex tmux 안에서 에러 종료하지 않고 detach-client -E로 codex attach로 교체한다.
~/home/<user>/bin/m을 desktop3060ti와 같은 shell pane 선택형 wrapper로 설치.
~/.bashrc:
- alias m='~/home/<user>/bin/m'
이미 떠 있는 main bash에도 live alias를 주입했다.

검증

desktop3060ti:

grep -n 'WRAPPER_VERSION\|detach-client -E' ~/home/<user>/bin/cx
# WRAPPER_VERSION="2026-06-18-detachE-cross-tmux"

grep -n 'alias m=\|alias d=' ~/home/<user>/.bashrc
# alias m='~/home/<user>/bin/m'
# alias d='~/home/<user>/bin/m'

tmux display-message -p -t main 'main=#{window_name} #{pane_current_command}'
# main=bash bash

tmux -L codex display-message -p -t codex 'codex=#{window_name} #{pane_current_command}'
# codex=node node

notebook3060:

grep -n 'WRAPPER_VERSION\|detach-client -E\|cx bridge' ~/home/<user>/.local/bin/cx ~/home/<user>/bin/cx
# WRAPPER_VERSION="2026-06-18-detachE-cross-tmux-bridge"
# detach-client -E present
# cx bridge comment present

grep -n 'alias m=' ~/home/<user>/.bashrc
# alias m='~/home/<user>/bin/m'

bash -n ~/home/<user>/.local/bin/cx
bash -n ~/home/<user>/bin/cx
bash -n ~/home/<user>/bin/m
# syntax-ok

tmux display-message -p -t main 'main=#{window_name} #{pane_current_command}'
# main=bash bash

tmux -L codex display-message -p -t codex 'codex=#{window_name} #{pane_current_command}'
# codex=node node

백업

WSL: ~/.bashrc.bak-d-main-20260618-233206
desktop3060ti:
- ~/home/<user>/bin/m.bak-d-main-20260618-233206
- ~/home/<user>/bin/cx.bak-m-return-20260618-233803
- ~/home/<user>/.bashrc.bak-m-wrapper-20260618-233843
notebook3060:
- ~/home/<user>/.bashrc.bak-cx-m-wrapper-20260618-234410
- ~/home/<user>/bin/cx.bak-cx-m-wrapper-20260618-234410
- ~/home/<user>/.local/bin/cx.bak-cx-m-wrapper-20260618-234410

재발방지

main 진입은 plain tmux new-session -A -s main alias가 아니라 ~/home/<user>/bin/m wrapper를 타야 한다.
cx는 default tmux 안에서 nested attach하거나 에러 종료하면 안 된다. cross-socket 전환은 detach-client -E가 정석이다.
Linux 노드에서 cx 수정 전후에는 반드시 type -a cx로 실제 실행 경로를 확인한다. 노트북은 ~/home/<user>/.local/bin/cx가 먼저 잡힐 수 있다.
wrapper를 고친 뒤 ~/.bashrc alias shadowing도 같이 확인한다.
수정 후 검증은 main=bash bash, codex=node node처럼 두 socket의 active pane을 분리 확인한다.

codex/main tmux 라우팅 사고 — d/m/cx가 main과 codex 사이를 잘못 오감

사건

관찰된 사실

근본 원인

수정

WSL

desktop3060ti

notebook3060

검증

백업

재발방지

관련 문서

codex/main tmux 라우팅 사고 — `d`/`m`/`cx`가 main과 codex 사이를 잘못 오감