맥북에어 · 로밍 · Tailscale

Claude Code 허브 접속 런북 — 맥북

집·회사 어디서든 맥북을 항상 켜져 있는 허브(PC A)의 Claude Code 세션에 연결합니다. 사외에서도 닿도록 Tailscale로 연결합니다.

🤖 이 페이지는 맥북의 Claude Code에게 주는 지시서입니다.
맥북 터미널에서 claude를 실행하고 이 URL을 주면서 “이 런북대로 이 맥을 허브에 연결해줘”라고 하면 됩니다. 아래 “Claude 실행 지시”를 그대로 수행하세요.

접속 정보 (허브)

접속 주소 (Tailscale)100.107.127.80  (또는 MagicDNS 이름 mj-host)
포트2222
사용자nimble
접속 후 명령hub → 영속 Claude 세션(main)으로 진입

🤖 Claude 실행 지시 (순서대로)

  1. Tailscale 연결 확인 — 이 맥이 테일넷에 올라와 있어야 합니다. 허브에 핑이 닿는지 확인:
ping -c 2 100.107.127.80

응답이 없으면 메뉴바의 Tailscale이 로그인/연결 상태인지 확인하세요(허브와 같은 Tailscale 계정).

  1. SSH 키 생성 + 공개키 출력 — 아래 한 줄 실행. (키가 이미 있으면 새로 만들지 않음)
[ -f ~/.ssh/id_ed25519 ] || ssh-keygen -t ed25519 -C "macbookair" -N "" -f ~/.ssh/id_ed25519; cat ~/.ssh/id_ed25519.pub
  1. 공개키를 허브 운영자에게 전달 — 출력된 ssh-ed25519 AAAA… 한 줄을 사용자에게 보여주고, “이 공개키를 허브(PC A)에서 작업 중인 Claude에게 전달해 등록을 요청하세요”라고 안내하세요. 등록 완료 확인을 받은 뒤 다음 단계로.
  2. 연결 검증 — 등록 확인 후, 비대화식 접속 테스트:
ssh -p 2222 -o ConnectTimeout=8 -o StrictHostKeyChecking=accept-new nimble@100.107.127.80 "echo CONNECTED_OK; hostname; tmux ls"

CONNECTED_OK 와 mj-host 가 보이면 성공입니다.

  1. (선택) 단축 별칭 등록 — ~/.ssh/config 에 아래를 추가하면 ssh hub 로 접속:
Host hub
    HostName 100.107.127.80
    User nimble
    Port 2222
  1. 사용자에게 마무리 안내 — “이제 터미널에서 ssh hub (또는 ssh -p 2222 nimble@100.107.127.80) 로 접속한 뒤 hub 를 입력하면 바로 Claude 세션입니다. 빠져나올 땐 Ctrl-b 그다음 d 로 detach 하세요(/quit 금지).”
✅ 핵심 동작 — hub 는 항상 동일한 main 세션에 붙습니다. 회사 PC에서 하던 작업을 맥북에서, 또 그 반대로 끊김 없이 이어갑니다.

🖥️ VS Code로 작업 (권장) — 다중 터미널 병렬 claude

tmux가 불편하면 이쪽 권장. VS Code를 허브에 SSH로 붙여 익숙한 다중 터미널로 claude 병렬 실행. Claude가 실행할 순서:

  1. code 명령 확인 — 없으면 VS Code에서 Cmd+Shift+P → "Shell Command: Install 'code' command in PATH" 실행(또는 전체 경로 "/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code"). VS Code 자체가 없으면 brew install --cask visual-studio-code.
  2. Remote-SSH 확장 설치:
code --install-extension ms-vscode-remote.remote-ssh
  1. SSH 별칭 hub 보장 — ~/.ssh/config 에 없으면 추가:
Host hub
    HostName 100.107.127.80
    User nimble
    Port 2222
  1. 허브에 연결해 VS Code 열기:
code --remote ssh-remote+hub /home/nimble/work
  1. 좌하단 SSH: hub 확인 → 터미널 여러 개 열어 각자 claude (c/cr로 이어받기). 병렬은 폴더/레포 분리.
안내 — 이 SSH는 키 전용입니다. 3단계 공개키 등록 전엔 접속 거부가 정상입니다. 회사 코드를 개인 맥/개인 Tailscale로 다루는 것이 사내 정책상 괜찮은지 확인하세요.

허브: WSL2 Ubuntu(mj-host) · Claude Code · 영속 tmux. 문제가 있으면 PC A에서 작업 중인 Claude에게 증상을 전달하세요.