맥미니 한 대에 tmux 세션 두고 맥북과 아이폰에서 SSH로 AI 작업 이어가기

이 글의 설정을 끝내면 되는 일은 이렇습니다.

• 집 맥의 터미널에서 클로드 코드에 긴 작업을 시켜 두고 그냥 자리를 뜹니다.
• 지하철에서 아이폰으로 같은 화면을 열어, 클로드 코드가 물어본 질문에 답하고 다시 닫습니다.
• 카페에서 맥북을 열면 아까 그 대화가 그대로 이어져 있고, 결과 파일도 집 맥에 그대로 있습니다.
• 회사 컴퓨터에서 붙어도 같은 화면이라서, 어느 기기에서 나오든 작업은 멈추지 않습니다.

작업과 파일이 집 맥 한 곳에만 있고 나머지 기기는 그 화면을 들여다보는 창이 되는 구성입니다. 이렇게 되게 해 주는 것이 tmux인데, tmux는 터미널 세션을 컴퓨터 안에 남겨 두었다가 다른 기기에서 그대로 이어 받게 해 주는 터미널 멀티플렉서(terminal multiplexer)입니다. 터미널 창을 닫거나 노트북을 덮어도 그 안에서 돌아가던 프로그램은 멈추지 않습니다. 쉽게 말해 불을 끄지 않고 나올 수 있는 작업실입니다.

기기들을 묶는 쪽은 테일스케일 사용법 글에서 정리했습니다. 거기까지 하면 기기들이 한집 안의 방처럼 이어지지만, SSH로 집 맥에 들어가면 매번 빈 터미널이 열릴 뿐이고 아까 돌려 둔 클로드 코드 화면은 보이지 않습니다. 그 빈자리를 채우는 것이 이 글의 tmux 설정이고, 원격 로그인 켜기, tmux 설치, 세션 만들기, 다른 기기에서 붙기의 네 단계입니다. 명령어는 실제로 쓰고 있는 것을 그대로 옮겼고, SSH 자체가 처음이라면 SSH 뜻과 원격 접속 방법 글을 먼저 보는 편이 편합니다.

위 화면은 tmux 공식 위키에 실린 첫 실행 모습입니다. 평소 터미널과 다른 점은 맨 아래 초록색 줄 하나뿐이고, 이 줄이 지금 어느 세션의 어느 창을 보고 있는지 알려 줍니다. 이 글의 설정이 끝나면 맥북에서도 아이폰에서도 이 줄이 똑같이 보입니다.

테일스케일, SSH, tmux가 각각 맡는 일

세 도구의 이름이 한꺼번에 나오면 무엇이 무엇을 하는지 헷갈리기 쉽습니다. 집에 가려면 길이 있어야 하고 현관 열쇠가 있어야 들어가며 들어간 뒤에는 불을 켜 둔 작업실이 있어야 하듯, 테일스케일이 길을 맡고 SSH 원격 로그인이 열쇠를 맡으며 tmux가 작업실을 맡습니다.

이 가운데 tmux가 맡는 부분이 이번 글의 주제입니다. 헤비 유저들은 tmux 안에 창을 여러 개 띄워 코딩 AI를 병렬로 돌리기도 하는데, 그 사용법까지 따라갈 필요는 없습니다. 이 글에서 만드는 것은 세션 하나와 창 세 개이고, 그것만으로도 기기를 옮겨 다니며 작업을 잇는 데는 충분합니다.

준비물과 기기별 역할

허브가 되는 맥은 한 대면 되고, 나머지 기기는 몇 대여도 상관없습니다. 이 글의 예시 이름은 전부 가상값입니다.

세 기기 모두에 테일스케일이 설치되어 같은 계정으로 로그인되어 있어야 합니다. 그 부분은 앞선 글의 설치 순서 그대로입니다. 허브 맥은 잠자기를 끄고 항상 켜 둡니다.

1단계: 허브 맥에서 원격 로그인 켜기

맥은 SSH 서버가 처음부터 들어 있고 꺼져 있을 뿐입니다. 애플 공식 문서의 순서대로 시스템 설정에서 일반을 누르고 공유로 들어가 원격 로그인을 켭니다.

켜고 나면 스위치 아래에 ssh 사용자이름@컴퓨터이름 형태의 접속 명령이 표시됩니다. 접근을 허용할 사용자는 본인 계정 하나면 충분하고, 원격 사용자의 전체 디스크 접근 허용은 켜지 않아도 됩니다. 터미널에서 켜고 싶다면 아래 한 줄인데 관리자 비밀번호를 묻습니다.

여기서 한 가지를 미리 적어 두겠습니다. 테일스케일에는 자체 SSH 서버 기능이 있어서 이 단계를 건너뛸 수 있을 것처럼 보이는데, 맥의 GUI 앱에서는 그 기능이 동작하지 않습니다. 그래서 맥에서는 이렇게 기본 원격 로그인을 켜는 쪽이 확실합니다. 이유는 뒤에서 따로 다루겠습니다.

2단계: tmux 설치와 기본 설정 파일

허브 맥에 tmux를 설치합니다. 홈브루(Homebrew)가 있으면 한 줄입니다.

설치 뒤 홈 폴더에 .tmux.conf 파일을 만들어 둡니다. 없어도 동작하지만, 이 설정이 있으면 기기를 옮겨 다닐 때 화면이 덜 어긋납니다. 아래 내용을 파일에 그대로 적습니다.

이 가운데 실제로 체감되는 항목은 셋입니다.

• mouse on: 마우스 휠로 이전 출력을 올려 보고 창을 클릭해 옮겨 다닙니다. 클로드 코드의 긴 출력을 읽을 때 유용합니다.
• window-size latest: 맥북과 아이폰이 동시에 붙어 있을 때 마지막에 키를 누른 기기의 화면 크기를 따릅니다. 이 설정이 없으면 아이폰 기준으로 줄어든 크기가 맥북에도 그대로 남을 수 있습니다.
• status-left: 상태줄 왼쪽에 컴퓨터 이름과 세션 이름이 뜹니다. 어느 컴퓨터의 어느 세션에 들어와 있는지 한눈에 보입니다.

상태줄의 각 부분이 무엇을 뜻하는지는 위 공식 그림에 정리되어 있습니다. 왼쪽 대괄호 안이 세션, 그 옆에 번호가 붙은 것이 창이고 별표가 붙은 창이 지금 보고 있는 창입니다.

3단계: 세션 하나 만들고 접속 명령을 한 단어로 줄이기

tmux에는 세션, 창(window), 칸(pane)의 세 층이 있습니다. 공식 위키의 정의로는 세션이 창을 여러 개 묶고, 창이 칸을 여러 개 묶으며, 프로그램은 칸 안에서 돌아갑니다. 이 글에서는 세션 하나에 창 세 개를 두고, 칸 나누기는 쓰지 않습니다.

세션에는 이름을 붙입니다. 이름이 있어야 다른 기기에서 그 이름으로 찾아 붙습니다. 가장 짧게는 tmux new -A -s hub 한 줄로도 되는데, 공식 위키에 따르면 -A 옵션이 같은 이름의 세션이 있으면 붙고 없으면 새로 만드는 동작입니다. 아래 스크립트는 거기에 창 세 개를 미리 만드는 부분을 붙인 것이고, hub라는 세션이 없으면 만들고 있으면 그대로 붙습니다.

파일을 저장한 뒤 chmod +x /usr/local/bin/hub로 실행 권한을 주면, 허브 맥의 터미널에서 hub라고만 쳐도 세션에 들어갑니다. 창 이름과 시작 폴더는 각자의 프로젝트에 맞게 바꾸면 되고, 창 세 개가 부담스러우면 첫 줄 하나만 남겨도 괜찮습니다.

4단계: 맥북과 아이폰에서 붙고 빠져나오기

맥북 터미널에서는 아래 한 줄입니다. 테일스케일이 붙여 준 기기 이름을 그대로 쓰고, 맨 뒤의 hub가 접속하자마자 실행할 명령이며 -t는 그 명령이 화면을 쓰게 하는 옵션입니다.

처음에는 허브 맥의 로그인 비밀번호를 묻습니다. 다음부터 묻지 않게 하려면 맥북에서 ssh-copy-id user@home-mac을 한 번 실행해 공개키를 넘겨 두면 됩니다. 매번 긴 명령을 치지 않으려면 맥북의 ~/.ssh/config에 아래를 적어 두고 ssh hub 한 단어로 붙습니다.

아이폰은 터미널 대신 SSH 앱을 씁니다. Termius나 Blink Shell 같은 앱에 호스트 home-mac, 사용자 이름, 시작 명령 hub를 등록해 두면 탭 한 번으로 같은 세션이 열립니다. 아이폰의 테일스케일 앱이 켜져 있어야 home-mac이라는 이름이 통합니다.

세션 안에서는 Ctrl+b를 먼저 누른 뒤 다음 키를 누르는 방식입니다. 처음에 알아 두면 되는 것은 아래 다섯 개입니다.

빠져나올 때 창을 그냥 닫아도 세션은 남지만, Ctrl+b 다음 d로 나오는 습관을 들이는 편이 깔끔합니다. 작업실 불을 끄지 않고 문만 닫고 나오는 것과 같아서, 다음 기기에서 문을 열면 아까 그 화면이 그대로 있습니다.

tmux 안에서 클로드 코드를 돌릴 때 알아 둘 점

설정이 끝났으면 허브 맥의 세션 첫 번째 창에서 claude를 실행합니다. 이제 맥북에서 ssh hub로 들어가면 그 대화가 그대로 보이고, 아이폰에서 들어가도 같은 화면입니다. 클로드 코드가 질문을 던져 두고 기다리는 상태라면 아이폰에서 답을 치고 나와도 됩니다.

위 화면처럼 한 창을 여러 칸으로 나눠 클로드 코드와 로그를 나란히 보는 것도 되지만, 아이폰처럼 작은 화면에서는 오히려 읽기 어렵습니다. 기기를 옮겨 다니는 용도라면 창 하나에 프로그램 하나를 두는 쪽이 편했습니다.

클로드 코드에는 tmux와 직접 이어지는 옵션도 있습니다. 2026년 9월 기준 claude --worktree 이름 --tmux=classic을 실행하면 작업용 git 워크트리를 만들면서 그 안에서 쓸 tmux 세션까지 함께 만듭니다. 글 한 편이나 기능 하나를 격리해서 맡길 때 쓰는 옵션이고, 이 글의 hub 세션과는 별개로 세션이 하나 더 생기므로 tmux ls로 목록을 확인하면 됩니다.

클로드 코드의 리모트 컨트롤(Remote Control)과 겹치지도 않습니다. 리모트 컨트롤은 세션 하나를 클로드 앱에서 보는 기능이라 VPN이 없어도 되고, tmux는 그 세션이 돌아가는 터미널 자체에 들어가는 방법입니다. 폰에서 대화만 볼 때는 리모트 컨트롤이 가볍고, 파일을 열어 보거나 다른 명령을 함께 칠 때는 tmux 쪽이 맞습니다.

테일스케일 SSH 대신 맥 기본 원격 로그인을 쓰는 이유

테일스케일에는 SSH 서버를 대신 맡아 주는 기능이 있어서 따로 정리한 글도 있습니다. 공개키를 나눠 줄 필요가 없고 접근 제어도 관리 콘솔에서 한 번에 되니 되도록 그쪽을 쓰고 싶어집니다.

다만 맥에서는 사정이 다릅니다. 테일스케일 공식 문서는 맥용 배포판을 앱스토어 버전, 독립 배포판, 오픈소스 CLI(tailscaled) 세 가지로 나누는데, 앱스토어 버전은 SSH 서버가 되지 못한다고 명시합니다. 독립 배포판은 문서상 지원 목록에 있지만, 실제로 tailscale set --ssh를 실행하면 샌드박스가 걸린 GUI 빌드에서는 SSH 서버가 동작하지 않는다는 메시지가 나오는 경우가 있습니다. 확실히 되는 것은 GUI가 없는 오픈소스 CLI 방식뿐입니다.

그래서 맥을 허브로 둘 때는 macOS 기본 원격 로그인을 켜고, 접속은 테일스케일 기기 이름으로만 받는 구성이 무난합니다. 공유기 포트를 열지 않았으니 인터넷에서 22번 포트가 보이지 않고, 같은 테일넷에 로그인한 기기만 home-mac이라는 이름을 알아듣습니다. 테일스케일이 길을 맡고 SSH 열쇠는 맥이 원래 갖고 있던 것을 그대로 쓰는 셈입니다.

두 기기에서 동시에 같은 세션에 붙으면 어떻게 되나요?

둘 다 같은 화면을 보고 둘 다 입력이 됩니다. 맥북에서 붙어 있는 채로 아이폰에서 또 붙어도 어느 쪽도 끊기지 않습니다. 화면 크기는 기본값에서는 작은 쪽에 맞춰지는데, 2단계의 window-size latest 설정을 넣어 두면 마지막에 키를 누른 기기의 크기를 따릅니다. 아이폰으로 잠깐 들여다본 뒤 맥북으로 돌아왔을 때 화면이 작게 남아 있으면 아무 키나 한 번 누르면 원래 크기로 돌아옵니다.

허브 맥이 재시작되면 tmux 세션도 남아 있나요?

남지 않습니다. tmux 세션은 메모리에만 남는 것이라서 맥이 꺼지거나 재시작되면 세션과 그 안의 프로그램이 함께 사라집니다. 그래서 허브 맥은 잠자기를 끄고 자동 업데이트 재시작에 주의하는 편이 안전합니다. 재시작 뒤에는 hub 명령을 한 번 실행하면 창 세 개가 다시 만들어지고, 클로드 코드는 claude --continue로 직전 대화를 이어 갈 수 있습니다.

Orca나 클로드 코드 리모트 컨트롤이 있는데 tmux를 왜 따로 쓰나요?

셋은 보는 범위가 다릅니다. Orca 원격 서버는 작업 공간 전체를 화면째 가져오는 방식이라 별도 앱이 필요하고, 리모트 컨트롤은 클로드 코드 대화 하나를 보는 창입니다. tmux는 SSH 앱만 있으면 어느 기기에서든 터미널 그 자체에 들어가는 방법이라 가장 가볍고, 클로드 코드 밖의 명령도 함께 칠 수 있는 곳입니다. 터미널 위주로 일하는 분이라면 tmux 하나로 충분하고, 화면으로 여러 작업을 한눈에 보고 싶다면 Orca를 더하면 됩니다.

3줄 요약

1. tmux는 터미널 세션을 컴퓨터 안에 남겨 두었다가 다른 기기에서 그대로 이어 받게 해 주는 프로그램입니다. 집 맥에 세션 하나를 켜 두면 맥북이든 아이폰이든 SSH로 들어와 같은 클로드 코드 화면을 봅니다.
2. 설정은 허브 맥에서 원격 로그인 켜기, tmux 설치, 이름 붙인 세션 만들기의 세 단계입니다. 다른 기기에서는 ssh user@home-mac -t hub 한 줄로 붙고 Ctrl+b 다음 d로 빠져나오면 세션은 허브 맥에 남습니다.
3. 테일스케일 SSH 서버는 맥의 GUI 앱에서는 동작하지 않습니다. macOS 기본 원격 로그인을 켜고 접속은 테일스케일 기기 이름으로만 받으면 공유기 포트를 열지 않고도 밖에서 붙을 수 있습니다.

Sources

• tmux 공식 위키: Getting Started
• tmux 매뉴얼 페이지
• Apple 지원 문서: 원격 컴퓨터가 Mac에 접근하도록 허용하기
• Tailscale 공식 문서: Three ways to run Tailscale on macOS
• Tailscale 공식 문서: MagicDNS
• Claude Code 공식 문서: Remote Control