Show GN: comux - AI 코딩 에이전트를 위한 tmux — 단일 엔드포인트로 Claude Code·Codex 세션을 한곳에서

# Show GN: comux - AI 코딩 에이전트를 위한 tmux — 단일 엔드포인트로 Claude Code·Codex 세션을 한곳에서 > **요약** — comux는 분산된 tmux 세션을 단일 컨트롤 플레인으로 묶어, Claude Code·Codex 같은 AI 코딩 에이전트가 여러 머신에서 동시에 작업을 조율하고 결과를 모을 수 있게 해주는 오픈소스 도구다. 본문에서는 comux가 등장한 배경, 단일 tmux 대비 장점, 멀티 에이전트 워크플로우, 그리고 실전에서 마주친 함정까지 정리한다. ## 등장 배경 — 한 머신의 tmux로는 부족해졌다 긱뉴스에 올라온 comux 자체가 보여주듯, 한 개발자가 두세 대의 머신을 오가며 tmux 세션을 키우는 일은 드물지 않다. 노트북에서 코드 편집, 데스크탑에서 빌드·테스트, 원격 서버에서 배포 직전 로그 확인까지 — 같은 `tmux`라도 프로세스는 머신마다 격리돼 있어 스크롤백을 공유하려면 `ssh`로 들어가서 `tmux attach -t`를 다시 입력해야 한다. 이때 `comux`는 한쪽 머신의 데몬이 다른 머신의 tmux 서버를 TCP로 끌어와 단일 트리에 합친다. 그 결과 `comux ls` 한 줄로 모든 머신의 세션·창·패널이 한 화면에 뜬다. ## 핵심 기능 — 분산 tmux를 단일 트리로 `comux`는 단순한 `ssh + tmux` 자동화를 넘어, tmux의 프로토콜을 그대로 유지하면서 네트워크 노드를 끼워 넣는다. 주요 기능은 다음과 같다. - **세션/창/패널 투명 통합** — 로컬 tmux 안에 원격 tmux의 창이 한 노드로 보인다. 키 바인딩, copy-mode, 상태바 모두 그대로 동작한다. - **클라이언트 디스커버리** — 같은 LAN/WAN의 comux 데몬을 자동 발견하고, 인증 토큰으로 신뢰 관계를 맺는다. mDNS가 막힌 환경에선 정적 호스트 등록도 지원한다. - **에이전트 친화 API** — `comux send-keys`, `comux capture-pane` 같은 명령이 머신 구분 없이 작동해, AI 에이전트가 다른 머신의 패널에 키 입력을 보내고 출력 일부를 읽어올 수 있다. - **스크롤백 캐시** — 모든 원격 tmux의 최근 N줄을 로컬에 캐시해, 네트워크 단절 후에도 세션 내용을 그대로 볼 수 있다. ## AI 코딩 에이전트 워크플로우 가장 흥미로운 쓰임은 역시 Claude Code·Codex 같은 코딩 에이전트를 여러 머신에 동시에 띄워, 한 컨트롤 플레인이 작업을 분배하고 결과를 취합하는 패턴이다. 다음은 comux 위에서 두 대의 머신에 Claude Code를 띄워 같은 저장소를 동시에 분석하게 만드는 예시다. ```bash # 1. 모든 머신에 comux 데몬 시작 (한 번만) $ comux daemon --token-file ~/.config/comux/token & # 2. 컨트롤 머신에서 comux 트리에 원격 노드 등록 $ comux peer add laptop.local --as ll $ comux peer add desktop.local --as ds # 3. 머신별로 격리된 tmux 세션을 만들고 에이전트 진입 $ comux new -s cc-laptop -t ll 'claude --dangerously-skip-permissions' $ comux new -s cc-desktop -t ds 'claude --dangerously-skip-permissions' # 4. 결과를 모으고 싶을 때 — 특정 세션의 마지막 200줄만 가져오기 $ comux capture-pane -t ll:cc-laptop -p -S -200 > /tmp/cc-laptop.txt $ comux capture-pane -t ds:cc-desktop -p -S -200 > /tmp/cc-desktop.txt ``` ## 실전 함정 — 알아두면 시간을 아끼는 4가지 1. **세션 이름 충돌** — 로컬과 원격 tmux가 모두 `default` 세션을 갖고 있으면 comux는 한쪽을 우선시한다. 머신마다 `-s`로 명시적 이름을 붙이는 편이 안전하다. 2. **SSH 키 권한** — comux는 내부적으로 ssh_controlmaster를 재사용하지만, 키 권한이 600이 아니면 디스커버리 단계에서 침묵하고 실패한다. 처음 디버깅할 때 `-v` 플래그로 실제 ssh 호출을 확인하라. 3. **copy-mode 동기화** — 원격 tmux의 vim copy-mode는 comux 프록시에서 키 시퀀스가 잘릴 수 있다. 큰 텍스트를 복사할 땐 `comux send-keys -l`로 직접 문자열을 전달하는 편이 안정적이다. 4. **에이전트 컨텍스트 분리** — 여러 에이전트를 띄울 때 `-c`로 작업 디렉터리를 다르게 잡지 않으면 같은 `.claude/` 캐시를 공유해 의도치 않은 상태가 섞인다. 머신이 달라도 작업 디렉터리까지 격리해야 진짜 분산 효과가 나온다. ## 전망 — 에이전트 오케스트레이션의 기반 comux는 'tmux를 네트워크로 확장한다'는 단순한 가치에서 출발했지만, 실제로 가장 빛을 발하는 영역은 AI 코딩 에이전트의 분산 실행이다. 단일 머신에서 멀티 에이전트를 돌리면 CPU·메모리·API 레이트 리밋이 즉시 병목이 되는데, comux 같은 분산 tmux 레이어가 있으면 그 병목을 자연스럽게 머신 단위로 확장할 수 있다. 앞으로는 작업 큐·결과 취합·에이전트 간 메시지 패스 같은 기능이 comux 위에 얹힐 가능성이 크고, 이미 몇몇 팀이 그 위에 간단한 스케줄러를 올려 실험하고 있다. ## 핵심 정리 - comux는 분산 tmux 세션을 단일 트리로 묶어, AI 에이전트가 여러 머신의 패널을 한 컨트롤 플레인에서 다룰 수 있게 한다. - `comux peer add`로 노드를 등록하고 `comux new -t `로 세션을 띄우면 Claude Code·Codex를 머신별로 격리해 돌릴 수 있다. - 실전에서는 세션 이름 명시, SSH 키 권한, copy-mode 동기화, 작업 디렉터리 격리 4가지를 반드시 챙겨야 분산 효과가 나온다. - 분산 tmux는 향후 멀티 에이전트 오케스트레이션의 기반 레이어로 자리 잡을 가능성이 크다. --- 원문: https://news.hada.io/topic?id=31859

---

📰 원본 출처 · https://news.hada.io/topic?id=31859 (#N=31859)

이 글은 GeekNews(긱뉴스)에 게제된 글을 기반으로 작성되었습니다. 원본의 라이선스와 저작권은 원작자에게 있습니다.