Tmux로 AI 에이전트를 운영하는 법

핵심 요약

• Tmux는 AI 코딩 에이전트를 독립된 세션에서 실행하며, 터미널을 닫아도 프로세스는 계속 동작하고 재접속 시 그대로 복구된다.
• Claude Code의 최신 버전은 --worktree --tmux 플래그로 자동 설정을 지원하지만, 여러 에이전트 관리, 스크립팅, 원격 실행은 수동으로 구성해야 한다.
• 세션은 프로젝트 단위로 명명하고, 각 작업마다 윈도우를 만들며, send-keys로 스크립트에서 에이전트에 입력할 수 있다.
• capture-pane으로 에이전트 화면을 읽을 수 있고, pipe-pane으로 모든 출력을 파일에 기록할 수 있다.
• 상태 표시줄에 스크립트를 연결해 어느 에이전트가 작업 중이고 어디서 입력을 기다리는지 표시할 수 있다.
• Tmux는 SSH 연결이 끊겨도 원격 머신의 에이전트를 계속 실행하며, 재접속하면 같은 세션으로 돌아온다.
• Tmux의 한계는 에이전트가 입력 대기 상태인지 사고 중인지 구분 불가, 종료 알림 없음, 스크린 스크래핑의 불안정성, 세션 간 상태 공유 불가, 재부팅 시 모든 기록 손실이다.
• 출처 사이트인 crystl은 맥OS 터미널로서 Tmux의 한계를 보완하며, 승인 대기 중인 에이전트를 카드로 띄우고, 에이전트 상태를 한눈에 보고, 구조화된 기록으로 파싱 없이 검색할 수 있다.
• Crystl은 프로젝트 단위로 세션을 정리하고 git 워크트리로 병렬 작업을 격리하며, 창을 닫거나 재부팅해도 기록이 남는다.