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

이 글의 설정을 끝내면 아래 네 가지가 됩니다.

• 집 맥의 터미널에서 클로드 코드에 작업을 맡기고 다른 장소로 이동합니다.
• 지하철에서 아이폰으로 같은 화면을 열어, 클로드 코드가 물어본 질문에 답하고 다시 닫습니다.
• 카페에서 맥북을 열면 아까 그 대화가 그대로 이어져 있고, 결과 파일도 집 맥에 그대로 있습니다.
• 회사 컴퓨터에서 붙어도 같은 화면이라서, 접속용 기기에서 나와도 집 맥의 세션은 남습니다.

작업과 파일이 집 맥 한 곳에만 있고 나머지 기기는 그 화면을 들여다보는 창이 되는 구성입니다. 이 구성을 만드는 도구가 tmux인데, tmux는 터미널 세션을 컴퓨터 안에 남겨 두었다가 다른 기기에서 그대로 이어 받게 해 주는 터미널 멀티플렉서(terminal multiplexer)입니다. 집 맥이 깨어 있고 프로그램이 실행 중이면 접속용 노트북을 닫아도 집 맥의 세션은 유지됩니다. 집 맥 자체를 끄거나 잠재워도 작업이 계속된다는 뜻은 아닙니다. AI가 승인을 기다리거나 사용량 한도에 도달하면 진행은 멈출 수 있습니다. 쉽게 말해 불을 끄지 않고 나올 수 있는 작업실입니다.

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

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

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

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

이 가운데 tmux가 맡는 부분이 이번 글의 주제입니다. 헤비 유저들은 tmux 안에 창을 여러 개 띄워 코딩 AI를 병렬로 돌리기도 하는데, 그 사용법까지 따라갈 필요는 없습니다. 처음에는 세션 하나와 창 하나만 만듭니다. 여러 창과 편의 설정은 첫 접속을 확인한 다음 선택합니다.

준비물과 기기별 역할

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

세 기기 모두에 테일스케일이 설치되어 같은 계정으로 로그인되어 있어야 합니다. 그 부분은 앞선 글의 설치 순서 그대로입니다. 이 글에서 허브 맥은 작업이 실제로 실행되는 집 맥을 뜻합니다. 첫 실습 중에는 깨어 있게 두면 충분하며, 24시간 운영은 필요할 때 정합니다. SSH 첫 접속을 이미 확인한 본인 소유 두 맥으로 시작하고 아이폰은 나중에 추가합니다.

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

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

켜고 나면 스위치 아래에 ssh 사용자이름@컴퓨터이름 형태의 접속 명령이 표시됩니다. 접근을 허용할 사용자는 본인 계정 하나면 충분하고, 원격 사용자의 전체 디스크 접근 허용은 켜지 않아도 됩니다. 터미널의 시스템 설정 명령은 추가 권한이 필요할 수 있으므로 여기서는 설정 앱을 사용합니다. 접속 이름과 비밀번호, 첫 호스트 키 확인은 SSH 첫 접속 안내에 따라 확인합니다.

이 구성은 macOS의 기본 SSH 서버를 사용합니다. 테일스케일 앱은 기기 연결을 맡으며, 별도 기능인 Tailscale SSH를 켜지 않습니다.

2단계: 집 맥에 tmux가 있는지 확인하기

집 맥의 터미널에서 tmux -V를 입력합니다. 버전이 출력되면 이미 설치된 상태입니다. 명령을 찾을 수 없고 Homebrew라는 프로그램 설치 도구가 있다면 다음 명령으로 설치합니다.

brew도 없으면 tmux 공식 설치 안내에서 macOS 설치 조건부터 확인합니다. 처음에는 기본 설정으로 진행합니다. 기존 ~/.tmux.conf 파일을 이 글의 예제로 덮어쓸 필요는 없습니다.

위 그림에서 왼쪽은 세션 이름, 가운데는 창 목록입니다. 별표가 현재 창을 가리킵니다. 색과 배치는 기존 설정에 따라 다를 수 있습니다.

3단계: 집 맥에 연습 세션 만들기

tmux는 창을 묶은 세션, 탭처럼 전환하는 윈도(window), 창 안에서 나눈 페인(pane)으로 구성됩니다. 여기서는 페인을 나누지 않습니다. 집 맥의 터미널에서 아래 명령을 실행합니다.

상태줄에 remote-practice가 보이면 그 안에서 다음을 한 줄씩 실행합니다.

컴퓨터 이름과 사용자 계정을 메모합니다. 세 번째 명령은 화면에 remote-practice-one을 출력합니다. 이제 Ctrl과 b를 함께 누르고 두 키를 놓은 뒤 d를 누릅니다. 맥에서도 Command가 아닌 Control입니다. detached 메시지와 함께 바깥 터미널로 돌아오면 tmux ls로 remote-practice가 남아 있는지 확인합니다.

duplicate session이면 같은 이름이 이미 있습니다. 본인의 연습 세션인지 모르면 기존 작업을 지우지 말고 다른 이름을 씁니다. 이후 연결 명령에서도 바꾼 이름을 사용합니다.

4단계: 맥북에서 같은 세션으로 들어가기

맥북에서 테일스케일 연결을 확인하고 터미널을 엽니다. 아래 USER는 3단계의 집 맥 사용자 계정, ADDR는 테일스케일 관리 콘솔에서 복사한 집 맥 주소로 바꿉니다. 이메일이나 예시 글자를 그대로 입력하지 않습니다.

첫 접속에서 호스트 키 확인을 요청하면 집 맥의 실제 키 지문과 대조합니다. 무조건 yes를 입력하지 않습니다. 비밀번호 또는 등록해 둔 공개 키로 로그인한 뒤 hostname과 whoami 결과가 3단계와 같은지 확인합니다. 두 맥의 이름이 같으면 이름만으로 판단하지 말고 주소와 계정도 대조합니다.

이제 SSH로 들어간 집 맥의 명령창에서 다음을 실행합니다.

remote-practice-one이 보이면 집 맥에 남긴 세션으로 돌아온 것입니다. 여기에 echo 'remote-practice-two'를 입력합니다. Ctrl+b를 누르고 놓은 뒤 d를 누르면 tmux 화면에서만 분리되어 집 맥의 SSH 명령창으로 돌아옵니다. 여기서 exit를 입력하면 SSH 접속도 끝나고 맥북의 터미널로 돌아옵니다.

같은 SSH 접속과 tmux 연결을 다시 수행해 두 번째 문자열까지 확인해 보세요. 다른 기기에서 접속하고, 같은 출력을 확인하고, 분리 후 돌아오는 것이 첫 실습의 완료 기준입니다. 아이폰에서도 이어 연습하려면 이 세션을 종료하지 않고 분리한 상태로 남겨 둡니다. 모든 기기에서 연습을 마쳐 세션을 정말 끝낼 때만 그 세션 안의 빈 명령창에서 exit를 입력합니다. 세션 밖에서 SSH를 종료하는 것과 구분합니다.

접속이 안 될 때 확인하는 순서

• 기기 이름을 찾지 못하면 테일스케일 연결과 MagicDNS 설정을 확인하고 관리 콘솔의 주소로 접속합니다.
• SSH가 거절되면 집 맥의 원격 로그인, 허용 사용자, 계정 및 인증 방식을 확인합니다.
• SSH는 되는데 tmux 세션이 없다면 집 맥과 같은 사용자로 접속했는지, 세션 이름이 맞는지, 집 맥이 재부팅되었는지 확인합니다.
• tmux 명령을 찾지 못하면 접속한 집 맥의 설치와 명령 경로를 확인합니다. 맥북에만 설치해도 집 맥에서 실행되지는 않습니다.

매번 비밀번호를 입력하지 않으려면 공개 키 인증을 따로 설정합니다. ssh-copy-id는 모든 맥에 기본으로 설치된 명령이 아닙니다. SSH 공개 키 안내의 생성과 등록 조건을 확인하며 개인 키 파일은 다른 기기에 보내지 않습니다.

아이폰은 첫 성공 뒤에 추가합니다

아이폰에서는 SSH 클라이언트 앱이 필요합니다. 이미 사용하는 앱이 있다면 집 맥의 테일스케일 주소와 사용자 계정, 인증 정보를 등록합니다. 앱마다 Ctrl 키 입력 방법과 요금이 다르므로 앱 안내에서 확인합니다. 테일스케일을 켜고 집 맥에 SSH로 접속한 다음 tmux attach -t remote-practice를 입력하면 됩니다. 먼저 맥북에서 했던 문자열 확인과 분리를 반복합니다.

특정 SSH 앱을 새로 결제하거나 자동 시작 명령을 등록하는 것은 필수가 아닙니다. 처음에는 SSH 접속과 tmux 연결을 나눠 실행해야 어느 단계에서 실패했는지 알기 쉽습니다.

필요한 경우에만 창과 편의 설정 추가하기

원격 접속과 세션 복귀를 확인했다면 다음 단축키를 사용합니다. 모두 기본 설정 기준이며 Ctrl+b를 누른 뒤 손을 떼고 다음 키를 누릅니다.

창 번호는 기본 설정에서 0부터 시작하지만 기존 설정에 따라 다를 수 있습니다. 상태줄에 실제 표시된 번호를 사용합니다. 창마다 프로젝트 폴더로 이동하고 pwd로 위치를 확인한 뒤 프로그램을 실행합니다.

마우스 스크롤이나 상태줄 설정은 tmux 단축키 안내와 공식 매뉴얼에서 필요한 항목만 확인합니다. 기존 설정을 수정할 때는 먼저 사본을 보관하고 변경할 항목만 반영합니다. 여러 기기가 동시에 붙었을 때 크기 기준을 바꾸고 싶다면 현재 윈도에서 tmux set-window-option window-size latest를 사용할 수 있습니다. 변경 전에 tmux show-options -w window-size로 현재 값을 메모하고, 변경 후 같은 명령으로 latest를 확인합니다. 원래대로 돌리려면 명령 끝의 latest 대신 메모한 값을 넣습니다. 이 설정은 현재 창에 적용되며 접속한 기기 중 최근에 사용한 클라이언트 기준으로 크기를 정합니다.

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

문자열 실습을 마친 뒤 필요하면 집 맥에서 작업용 세션을 따로 만듭니다. 실제 프로젝트 폴더인지 pwd로 확인하고 claude를 실행합니다. 집 맥에 Claude Code가 설치되고 로그인되어 있어야 하며, 해당 구독 또는 API 사용량과 비용이 적용됩니다. 다른 기기에서 집 맥에 SSH로 접속한 뒤 그 작업용 세션에 연결하면 같은 대화를 봅니다. 클로드 코드가 질문을 던져 두고 기다리는 상태라면 아이폰에서 답을 치고 나와도 됩니다.

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

클로드 코드에는 tmux와 직접 이어지는 옵션도 있습니다. 2026년 10월 4일 공식 안내 기준 claude --worktree 이름 --tmux=classic을 실행하면 작업용 git 워크트리를 만들면서 그 안에서 쓸 tmux 세션까지 함께 만듭니다. git 워크트리는 같은 저장소의 작업 폴더를 따로 두는 기능이며 보안 권한을 차단하는 장치는 아닙니다. 별도 작업 폴더에서 작업할 때 쓰는 옵션이고, 이 글의 remote-practice 세션과는 별개로 세션이 하나 더 생기므로 tmux ls로 목록을 확인하면 됩니다.

클로드 코드의 리모트 컨트롤(Remote Control)도 기기를 바꾸며 대화를 잇는 용도로 쓸 수 있습니다. 리모트 컨트롤은 세션 하나를 클로드 앱에서 보는 기능이라 VPN이 없어도 되고, tmux는 그 세션이 돌아가는 터미널 자체에 들어가는 방법입니다. Remote Control은 지원 구독과 claude.ai 로그인이 필요하며 조직 계정에는 관리자 설정도 적용됩니다. 폰에서 대화를 이어 볼 때는 리모트 컨트롤을, 터미널을 직접 조작할 때는 SSH와 tmux 구성을 선택할 수 있습니다.

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

테일스케일에는 SSH 서버를 대신 맡아 주는 기능이 있어서 따로 정리한 글도 있습니다. 공개 키와 접속 권한을 테일스케일이 관리하는 기능이지만 지원되는 운영체제와 설치 방식이 정해져 있습니다.

현재 Tailscale SSH 공식 문서에서 macOS 서버는 오픈소스 tailscale과 tailscaled 방식만 지원합니다. 이 글은 맥 앱을 그대로 쓰면서 macOS 기본 SSH 서버로 인증하는 구성입니다.

테일스케일 주소를 쓴다고 macOS 원격 로그인이 그 네트워크에서만 접속을 받도록 바뀌지는 않습니다. 같은 집 네트워크 등 다른 경로로도 접근할 수 있는지는 방화벽과 SSH 설정에 달려 있습니다. 기기 이름은 접속 주소이지 접근 권한을 제한하는 장치가 아닙니다. 인터넷에 SSH 포트를 직접 공개하지 않고, 필요한 사용자와 네트워크만 허용하는 설정은 별도로 확인합니다.

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

같은 세션에 연결한 두 기기는 같은 화면을 보고 양쪽에서 입력할 수 있습니다. 한쪽의 입력이 다른 쪽에 영향을 주므로 처음에는 한 기기에서만 조작합니다. 한쪽에서 분리해도 다른 쪽 연결까지 자동 종료되지는 않습니다.

화면 크기는 tmux 버전과 해당 창의 설정에 따라 달라집니다. window-size latest를 선택했다면 최근에 사용한 클라이언트가 기준입니다. 작은 화면 문제를 해결하려고 AI 실행 중에 아무 글자나 입력하지 말고, 작은 기기에서 먼저 분리한 뒤 큰 화면을 확인합니다.

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

남지 않습니다. tmux 세션은 메모리에만 남는 것이라서 맥이 꺼지거나 재시작되면 세션과 그 안의 프로그램이 함께 사라집니다. 그래서 허브 맥은 잠자기를 끄고 자동 업데이트 재시작에 주의하는 편이 안전합니다. 재시작 뒤에는 세션과 필요한 프로그램을 다시 실행합니다. 같은 프로젝트 폴더에서 claude --continue로 대화 기록을 이어 갈 수 있지만, 종료된 명령이나 메모리의 실행 상태까지 복원되는 것은 아닙니다. 저장된 파일과 미완료 작업부터 확인합니다.

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

셋은 보는 범위가 다릅니다. Orca 원격 서버는 작업 공간 전체를 화면째 가져오는 방식이라 별도 앱이 필요하고, 리모트 컨트롤은 클로드 코드 대화 하나를 보는 창입니다. 이 구성은 SSH로 집 맥에 접속해 tmux의 터미널 세션을 이어 보는 방식이며, 클로드 코드 밖의 명령도 함께 칠 수 있습니다. 터미널 위주로 일하는 분이라면 tmux 하나로 충분하고, 화면으로 여러 작업을 한눈에 보고 싶다면 Orca를 더하면 됩니다.

참고 자료

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

3줄 요약

1. 집 맥에서 실행한 tmux 세션에 다른 기기가 SSH로 다시 연결하면 같은 작업 화면을 이어 볼 수 있습니다.

2. 먼저 일반 SSH 접속과 기기 이름을 확인하고, tmux 세션에서 출력한 문자와 분리 후 재연결을 연습합니다.

3. 집 맥은 깨어 있어야 작업이 진행되며 테일스케일 주소를 사용하는 것과 SSH 접근 범위를 제한하는 설정은 구분해야 합니다.