에이전트를 여러 개 쓸 때 tmux가 유용한 이유

여러 코딩 에이전트를 동시에 돌릴 때 tmux가 유용한 이유는, SSH가 끊겨도 세션이 서버에 남고 패인마다 작업을 나눠 로그를 유지한 채 다시 붙을 수 있기 때문입니다.

이 글은 공식 위키와 매뉴얼을 기준으로 한 일반 사용 안내이며, 배포판 패키지와 키 바인딩 설정에 따라 세부 동작은 달라질 수 있습니다.

SSH가 끊기면 왜 긴 에이전트 실행이 죽나?

한 줄 답: SSH 터미널에서 바로 시작한 전경 실행은 그 연결에 묶이지만, 세션 관리자는 연결 시간 초과나 의도적 분리 뒤에도 서버에서 실행을 유지합니다.

터미널 멀티플렉서는 하나의 터미널에서 여러 프로그램을 다루는 도구입니다. 화면에서 분리해도 프로그램이 백그라운드에서 계속 실행되고, 나중에 다른 터미널에서 같은 세션에 다시 연결할 수 있습니다.

공식 시작 안내는 원격 서버의 프로그램을 연결 끊김으로부터 보호하는 용도를 제시합니다. 여러 로컬 컴퓨터에서 원격 프로그램에 접근하고, 한 터미널에서 여러 프로그램과 셸을 함께 다루는 용도도 포함합니다.

SSH 터미널에서 Cursor, Claude Code, Codex 같은 코딩 에이전트를 직접 시작하면 그 전경 실행은 해당 연결에 묶입니다. SSH 연결이 끝나면 그 실행도 함께 끝나므로, 긴 작업은 세션 안에서 시작하는 방식이 적합합니다.

매뉴얼은 세션이 ssh(1) 연결 시간 초과나 C-b d에 의한 의도적 분리 뒤에도 살아남는다고 설명합니다. 연결을 다시 맺은 뒤 같은 세션에 붙으면 실행 화면과 로그를 이어서 확인할 수 있습니다.

세션은 어떻게 만들고 분리하고 다시 붙이나?

한 줄 답: 새 세션을 만들고 기본 접두사 뒤 d로 분리한 다음, 목록에서 확인해 다시 연결합니다.

인수 없이 새 세션 명령인 new-session을 실행하면 새 세션을 만들고 그 세션에 연결합니다. 첫 세션의 기본 이름은 0입니다.

tmux new

기본 접두사는 C-b입니다. 세션 안에서 C-b d를 입력하면 클라이언트가 분리되며, 실행 중인 프로그램은 세션에서 계속 유지됩니다. 공식 위키의 메시지 예시는 [detached (from session mysession)]입니다.

다시 연결할 때는 attach-session 명령의 별칭인 attach를 사용합니다. 인수 없이 실행하면 이미 연결되지 않은 세션 가운데 가장 최근에 사용한 세션을 우선합니다.

세션이 여러 개이면 목록 명령으로 서버가 관리하는 세션을 확인할 수 있습니다. 대상이 분명할 때는 -t로 세션 이름을 지정해 연결합니다.

tmux attach
tmux attach -t mysession
tmux ls

이름 있는 세션은 에이전트를 나눌 때 왜 쓰나?

한 줄 답: 고유한 이름을 붙이면 여러 장기 실행을 기본 숫자 이름 대신 식별해 대상 세션에 다시 연결할 수 있습니다.

세션 이름은 -s로 정합니다. 세션 이름은 서로 달라야 하므로, 같은 이름을 여러 세션에 사용할 수 없습니다.

Cursor, Claude Code, Codex 같은 코딩 에이전트의 장기 실행을 각각 cursor, claude, codex라는 세션 이름으로 구분할 수 있습니다. 아래 명령은 제품 설정이 아니라 이름 있는 세션을 만드는 일반적인 예입니다.

tmux new -s cursor
tmux new -s claude
tmux new -s codex

새 세션 명령에 -d를 쓰면 세션을 만들되 바로 연결하지 않습니다. -A를 쓰면 지정한 이름이 이미 있을 때 새 세션 대신 해당 세션에 연결하는 동작을 합니다.

tmux new -smysession
tmux new -Asmysession

대상 세션에 다시 붙을 때는 대상 지정 옵션 -t로 이름을 지정합니다. 연결 명령의 -d는 같은 세션에 붙어 있는 다른 클라이언트를 분리한 뒤 대상 세션에 연결하는 옵션입니다.

tmux attach -t mysession
tmux attach -d -t mysession

에이전트마다 한 작업을 이름 있는 세션 또는 패인에 두면 재접속 때 어떤 실행인지 확인하기 쉽습니다. 기본 숫자 이름에 의존하지 않고 이름으로 대상을 정할 수 있어 여러 장기 실행을 구분하는 데 도움이 됩니다.

윈도와 패인은 여러 에이전트에 무엇을 하나?

한 줄 답: 세션 안의 윈도는 화면을 차지하고 패인으로 나뉘며, 입력은 한 번에 활성 패인 하나로만 갑니다.

세션은 의사 터미널의 모음입니다. 클라이언트는 세션을 화면에 표시하고, 하나의 서버가 /tmp의 소켓을 통해 세션을 관리합니다.

윈도는 화면을 차지하는 단위이며 직사각형 패인으로 나뉠 수 있습니다. 프로그램은 패인에서 실행되고, 패인은 윈도에 속하며, 윈도는 세션에 연결됩니다.

한 윈도에는 한 번에 하나의 활성 패인만 있습니다. 입력은 활성 패인으로만 전달됩니다.

기본 조작은 기본 접두사인 C-b를 먼저 누른 뒤 다음 키를 입력하는 방식입니다. 필요한 화면 구성을 만들 때는 다음 세 가지 조작을 사용합니다.

조작	키	동작
새 윈도	`C-b c`	새 윈도를 만듭니다.
가로 분할	`C-b %`	패인을 좌우로 나눕니다.
세로 분할	`C-b "`	패인을 위아래로 나눕니다.

따라서 여러 코딩 에이전트를 동시에 사용할 때는 작업 하나당 패인 하나를 두면 입력 대상이 분명해집니다. Cursor, Claude Code, Codex를 각각 별도 패인이나 세션에 두면 실행을 식별하기 쉽고, 분리한 동안에도 해당 패인의 로그가 유지되어 다시 연결한 뒤 각 작업의 진행 화면을 확인할 수 있습니다.

Ubuntu·Debian에는 어떻게 설치하나?

한 줄 답: 공식 설치 표의 Debian 또는 Ubuntu 항목은 다음 명령을 제시합니다.

Ubuntu와 Debian에서는 배포판 패키지를 설치한 뒤 앞서 설명한 새 세션, 분리, 재접속 순서로 사용할 수 있습니다. 설치 명령은 다음과 같습니다.

apt install tmux

공식 위키는 사전 빌드 패키지가 최신이 아닐 수 있다고 안내합니다. 이 글의 설치 예시는 해당 표에 기재된 기본 명령만 다룹니다.

FAQ는 무엇을 확인하나?

한 줄 답: 연결이 끊긴 뒤 세션 목록, 대상 이름, 활성 패인, 설치 명령을 차례로 확인합니다.

다음 표는 일반적인 확인 순서입니다. 특정 에이전트의 명령이나 개인 실행 사례를 전제로 하지 않습니다.

확인 항목	일반적인 답
SSH 끊김 후에는 어떻게 확인하나?	`tmux ls`로 남은 세션을 확인한 뒤 `tmux attach -t 이름`으로 대상에 다시 붙습니다.
이름 있는 세션은 어떻게 구분하나?	`-s`로 고유 이름을 만들고 `-t`로 대상 세션을 지정합니다.
입력은 어느 패인으로 가나?	한 윈도의 활성 패인 하나로만 전달됩니다.
Ubuntu·Debian에는 어떻게 설치하나?	`apt install tmux` 명령으로 설치합니다.

관련 글은 Claude Code에 Ollama Cloud를 붙여 쓰는 후기입니다.

출처는 어디를 보면 되나?

한 줄 답: 생성·분리·재접속과 화면 구성은 공식 위키와 매뉴얼의 해당 항목에서 확인할 수 있습니다.

아래 네 문서는 이 글에서 다룬 기본 동작과 구조를 설명합니다. 설치 명령과 세션·윈도·패인의 정의도 각 공식 문서에서 확인할 수 있습니다.

도구 구독이 부담되면 할인 경로만 보시면 됩니다.