우분투가 설치된 노트북에 코덱스를 설치한 후, 맥북에서 원격으로 이어서 사용할 방법을 찾다가 Tailscale과 tmux를 사용해 본 과정을 정리했습니다. 글에선 Codex를 다루고 있지만 Claude Code에서도 똑같이 동작합니다.
.
Tailscale을 우분투가 설치된 노트북과 맥북 양쪽에 설치해서 가상 사설망을 만든 뒤, Tailscale이 생성한 주소로 맥북에서 우분투에 SSH 접속합니다. 포트포워딩이나 공인 고정 IP를 별도로 설정하지 않아도 외부에서 우분투 노트북에 접속할 수 있습니다.
.
추가로 tmux를 설치하여 우분투가 설치된 노트북에서 코덱스로 작업 중인 내용이 맥북에서 원격 접속해도 똑같이 보이도록 했습니다. tmux를 사용하면 SSH 연결이 끊겨도 코덱스 세션이 종료되지 않고 그대로 유지되기 때문에 나중에 다시 접속해서 이어서 작업할 수 있습니다.
.
최초작성 2026.9.15
.
.
1. 우분투가 설치된 노트북 준비
.
1-1. SSH 서버 설치
맥북에서 SSH로 접속할 수 있도록 우분투에 SSH 서버를 설치하고 실행합니다.
.
| sudo apt update sudo apt install openssh-server sudo systemctl enable --now ssh |
.
1-2. tmux 설치
SSH 연결이 끊겨도 Codex를 계속 실행하고, 우분투와 맥북에서 동일한 터미널 세션에 접속하기 위해 tmux를 설치합니다.
.
| sudo apt install tmux |
.
1-3. Tailscale 설치
다음 링크에 접속하여 리눅스 설치를 위해 제공하는 명령어를 복사하여 우분투에서 실행하여 Tailscale을 설치합니다.
.
https://tailscale.com/download/linux
.
설치 완료 후 터미널에서 다음 명령을 실행합니다. 진행 중간에 Tailscale 사이트에 로그인하는 과정이 포함됩니다.
.
| sudo tailscale up |
.
다음 명령을 사용하면 접속 가능한 Tailscale 전용 IP를 출력해 줍니다. 우분투가 설치된 노트북의 네트워크 환경이 바뀌어도 이 IP는 유지됩니다.
.
| tailscale ip -4 |
.
.
2. 맥북에 Tailscale 설치
.
맥북에서도 다음 링크에 접속하여 Tailscale을 설치한 후, 우분투가 설치된 노트북에서 Tailscale 사이트에 로그인할 때 사용한 계정으로 로그인합니다.
.
https://tailscale.com/download/mac
.
이제 맥북 터미널에서 다음처럼 우분투에 접속할 수 있습니다.
.
| ssh 리눅스사용자명@Tailscale전용IP |
.
참고로 Tailscale 관리 페이지에서 MagicDNS를 켜면 IP 대신 노트북의 호스트명으로도 접속할 수 있어 IP를 외울 필요가 없습니다.
.
| ssh 리눅스사용자명@노트북호스트명 |
.
.
3. 우분투가 설치된 노트북과 맥북에서 같은 코덱스 화면 보며 사용하기
.
우분투 노트북에서 코덱스를 사용할 프로젝트 폴더로 이동한 뒤, 다음 명령으로 codex라는 이름의 tmux 세션을 만듭니다.
.
| tmux new -s codex |
.
tmux 세션 안에서 코덱스를 실행합니다. tmux는 안에서 실행되는 프로그램을 가리지 않기 때문에 클로드 코드도 같은 방식으로 사용할 수 있습니다.
.
| codex |
.
이제 맥북 터미널에서 SSH로 우분투에 접속한 뒤 다음 명령을 실행합니다.
.
| tmux attach -t codex |
.
이제 우분투 리눅스에서 실행된 코덱스와 맥북에서 보이는 코덱스가 똑같이 보입니다. 한쪽에서 입력한 내용이 다른 쪽에도 그대로 나타납니다.
.
양쪽 터미널 창의 크기가 다르면 tmux가 작은 쪽 창에 맞춰 화면을 줄여서 보여줍니다. 우분투 쪽 화면이 갑자기 작아졌다면 맥북 터미널 창을 키우면 됩니다.
.
.
4. tmux 세션에서 빠져나오기
.
맥북에서 작업을 마치고 세션을 종료하지 않은 채 빠져나오려면 Ctrl+b를 누른 뒤 d를 누릅니다. 세션과 코덱스는 우분투에서 계속 실행 중인 상태로 남아 있습니다.
.
현재 실행 중인 tmux 세션 목록은 다음 명령으로 확인할 수 있습니다.
.
| tmux ls |
.
다시 이어서 작업하려면 tmux attach -t codex 명령을 실행하면 됩니다. exit를 입력하면 세션 자체가 종료되니 주의하세요.
.
ssh 연결이 끊어졌다면 다시 연결 후 tmux 명령을 실행해줘야 합니다.
| ssh 리눅스사용자명@Tailscale전용IP tmux attach -t codex |
.
.
5. tmux를 좀 더 편하게 사용하기
.
기본 설정으로도 사용에 문제는 없지만, 다음 설정을 추가하면 마우스 휠로 스크롤이 가능해집니다.
.
우분투가 설치된 노트북에서 설정 파일을 만듭니다.
맥북에서도 작업이 가능합니다. ssh로 접속하여 진행하면 됩니다.
.
| nano ~/.tmux.conf |
.
다음 내용을 복사하여 넣습니다.
.
| # 마우스로 스크롤 및 pane 선택 set -g mouse on # 스크롤 기록 늘리기 set -g history-limit 100000 # ESC 반응 속도 개선 set -sg escape-time 10 # 터미널 색상 set -g default-terminal "tmux-256color" |
.
Ctrl + o 누르고 엔터를 누른 후, 이어서 Ctrl + x를 눌러 저장하고 nano에서 빠져나옵니다.
.
다음 명령으로 적용합니다.
.
| tmux source-file ~/.tmux.conf |
.
마우스 스크롤 등 대부분의 설정은 이미 실행 중인 세션에도 바로 반영됩니다. 단 history-limit은 새로 만드는 세션(또는 Ctrl+b c로 새로 여는 창)부터 적용됩니다.
.
이제 마우스 휠을 사용하여 tmux에서 과거 코덱스 실행 내용을 볼 수 있습니다.
.