AI 코딩 에이전트 여러 개 띄울 때 필수라는 tmux 세팅 꿀팁 모음

요약 터미널 멀티플렉서인 tmux와 AI 코딩 에이전트(Claude Code)를 결합하여 개발 생산성을 높이는 세부 실무 팁을 정리한 가이드입니다. AI 코딩 에이전트는 장시간 백그라운드에서 실행되는 프로세스이므로, 터미널 창을 닫거나 SSH 연결이 끊겨도 프로세스가 종료되지 않는 tmux의 세션 유지 특성과 매우 잘 들어맞습니다. 또한 여러 에이전트를 개별 세션으로 묶어 단축키로 손쉽게 전환할 수 있고, 스크립트를 통해 원격으로 키 입력(send-keys)이나 화면 캡처(capture-pane)가 가능해 오케스트레이션에 유리합니다. 최근 Claude Code는 자체적으로 `claude --worktree --tmux` 명령어를 지원하여 독립된 git 워크트리와 tmux 세션을 한 번에 생성해 주는 기능을 탑재했습니다. 단, iTerm2 환경에서는 기본적으로 네이티브 패널로 열리기 때문에 스크립트 제어가 필요한 경우 `--tmux=classic` 옵션을 주어야 기존 방식대로 동작합니다. 하지만 공식 내장 플래그만으로는 여러 에이전트를 단일 세션에서 모니터링하거나 원격 환경에서 정교하게 조율하기 어렵기 때문에 직접 tmux 설정을 커스텀하는 개발자들이 많습니다. 글에서는 프로젝트 단위로 세션을 생성하는 관리법(예: repo 이름으로 세션 명명 및 `-A` 옵션을 통한 세션 생성/접속 통합), 에이전트별 윈도우/패널 분할 레이아웃(tiled, main-vertical 등), 그리고 대용량 히스토리 버퍼(`history-limit 100000`)나 마우스 스크롤 활성화 등 에이전트 구동에 최적화된 `.tmux.conf` 설정 팁을 상세히 다루고 있습니다.