tmux에서 Claude Code 세션을 놓치지 않는 법

tmux 창에서 Claude Code를 돌리고 있다면, 나를 기다리는 창을 훅으로 표시하고 모든 세션을 한눈에 보는 방법이에요.

tmux는 오래 걸리는 Claude Code 세션에 잘 맞아요. 터미널을 닫아도 계속 돌고, 화면을 나누거나 빠르게 옮겨 다닐 수 있어요. 문제는 탭과 같아요. Claude가 허락을 기다리는 창과 아직 일하는 창이 똑같이 보여요.

기다리는 창을 훅으로 표시하기

훅은 Claude Code가 돌고 있는 tmux 칸 안에서 실행되기 때문에 tmux에 명령을 보낼 수 있어요. 아래는 Claude가 나를 기다릴 때 창 이름을 바꾸고, 내가 답하면 tmux가 다시 이름을 붙이게 해요. ~/.claude/settings.json에 넣어요.

{
  "hooks": {
    "Notification": [
      {
        "hooks": [
          { "type": "command", "command": "[ -z \"$TMUX_PANE\" ] || tmux rename-window -t \"$TMUX_PANE\" '● needs you'" }
        ]
      }
    ],
    "UserPromptSubmit": [
      {
        "hooks": [
          { "type": "command", "command": "[ -z \"$TMUX_PANE\" ] || tmux set-window-option -t \"$TMUX_PANE\" automatic-rename on" }
        ]
      }
    ],
    "PostToolUse": [
      {
        "hooks": [
          { "type": "command", "command": "[ -z \"$TMUX_PANE\" ] || tmux set-window-option -t \"$TMUX_PANE\" automatic-rename on" }
        ]
      }
    ]
  }
}

이제 tmux 상태 막대에서 어느 창이 기다리는지 보여요. 창 이름을 직접 붙여 쓴다면 automatic-rename을 켜는 대신 원래 이름으로 되돌리게 바꾸세요. tmux 밖에서는 이 훅이 아무 일도 하지 않아요.

창 단위로 표시되기 때문에, 한 창을 여러 칸으로 나눠 쓴다면 어느 칸인지는 직접 찾아야 해요.

tmux 안이든 밖이든 모든 세션 보기

Alien Desk는 작은 맥 패널에 Claude Code 세션을 모두 보여 줘요. tmux 안의 세션도 함께요. 어느 세션이 나를 기다리는지, 일하는 중인지, 끝났는지 보이고, 줄을 누르면 그 세션이 있는 터미널 창이 앞으로 와요. 이 기능은 무료예요.