휴대폰으로 코딩 이어하기 | Orca Mobile + Tailscale 설정 가이드

이 구성이 맞는 사람과 준비물

맞는 경우: 밖에 나가도 에이전트 상태를 보고 continue나 짧은 지시를 보내고 싶다. 집에 전원 연결해 켜 둘 컴퓨터가 있다.

안 맞는 경우: 24시간 켜 둘 기계가 없다. 폰에서 긴 코드를 고치고 싶다. 터미널 로그만 보면 된다(그 경우 Tailscale SSH만으로도 충분할 수 있다). 회사 장비나 회사 저장소면 사내 정책을 먼저 확인하세요.

준비물은 네 가지입니다. 서버 컴퓨터(본체, 서랍 속 노트북, 미니PC 등), 스마트폰, Orca 계정(데스크톱과 폰 동일), Tailscale 계정(서버와 폰 동일). Claude Code, Codex, git 로그인은 서버 컴퓨터 OS 사용자에 있어야 합니다. 들고 다니는 노트북에만 있는 세션은 복사되지 않습니다. 페어링은 서버 화면이 필요하니, 처음은 집에서 하세요.

Tailscale로 서버와 폰 잇기

Orca보다 Tailscale이 먼저입니다. Connected가 아니면 QR을 만들어도 폰이 서버에 닿지 않습니다.

서버에서 tailscale.com/download로 OS별 클라이언트를 설치하고 로그인합니다. 기기 이름을 orca-home처럼 알아보기 쉽게 바꿉니다. 폰에도 Tailscale을 설치하고 같은 계정으로 로그인합니다.

폰 앱 기기 목록에서 서버 옆이 Connected면 통과입니다. Offline이면 같은 계정인지, 서버 Tailscale이 켜져 있는지부터 봅니다. 같은 집 Wi-Fi일 필요는 없습니다. 주소는 보통 100.으로 시작합니다.

품질만 보고 싶을 때 서버 터미널에서 아래를 칩니다. 설정을 바꾸지 않습니다.

tailscale status
tailscale ping orca-home
tailscale netcheck

relay여도 터미널 조작은 대개 됩니다. Connected일 때만 다음으로 가세요.

⚠️ 주의: Connected가 아닌데 Orca 페어링부터 하면 시간만 버립니다.

서버에 Orca Desktop 올리기

서버에서 onorca.dev/download로 Orca Desktop을 설치합니다. macOS는 brew install --cask stablyai/orca/orca도 가능합니다. 실행 후 로그인하고, 밖에서 다룰 저장소를 엽니다. 집에서 에이전트를 한 번 돌려 명령이 도는지 확인하세요.

쓸 CLI는 서버에 설치되어 있고 로그인되어 있어야 합니다. 에이전트가 실제로 돌아가는 쪽에 자격증명이 있어야 한다는 점은 Remote Orca Servers에도 나옵니다.

Orca Mobile 페어링

폰에 Orca Mobile을 설치하고 서버와 같은 Orca 계정으로 로그인합니다.

💡 Tip: UI 버전 안내 (2026-07-27 실기기). 이 글은 Orca Desktop 모바일 (BETA) 화면을 기준으로 했습니다. 공개 Orca Mobile 문서에는 account/status 메뉴의 일회용 코드 방식이 남아 있을 수 있습니다. 앱에 QR 코드 생성이 보이면 앱 화면을 따르고, QR이 없으면 공식 문서의 일회용 코드 방식을 쓰세요. 가능하면 설정·정보에서 Orca 앱 버전 번호를 적어 두면 나중에 재현하기 쉽습니다.

모바일 설정 열기

서버 Orca에서 Settings(톱니)를 엽니다. 검색에 모바일을 쳐도 됩니다. 왼쪽 설정 시작 아래 모바일을 누릅니다. 오른쪽 제목이 모바일 (BETA) 이면 맞습니다. 안 보이면 앱을 업데이트하세요.

LAN → Tailscale 100. → QR

휴대폰 페어링에서 연결 방식은 LAN을 고릅니다. 같은 Wi-Fi이거나 Tailscale로 이미 이어진 경우이며 추가 로그인이 없습니다. Orca Relay는 이 글에서 다루지 않습니다.

이 컴퓨터의 주소에서 옆에 (Tailscale)이 있고 100.으로 시작하는 줄을 고릅니다. 127.0.0.1은 그 컴퓨터 안에서만 통합니다. 집 LAN IP만 고르면 밖(호텔·LTE)에서 안 닿을 수 있습니다. Tailscale이 목록에 없으면 새로고침 후 Connected를 다시 확인합니다.

주소가 맞으면 QR 코드 생성을 누릅니다. 폰 Orca Mobile에서 Pair Desktop으로 그 QR을 스캔합니다. 서버의 페어링된 장치에 새 행이 생기면 성공입니다. 행이 없으면 아직 연결된 게 아닙니다.

폰에서 되는 일

Orca Mobile 기준으로 worktree와 에이전트 상태 보기, 파일 탐색, 터미널 스크롤백, continue/yes/짧은 텍스트와 첨부/음성, Live 모드, Source Control의 stage와 커밋, 브라우저 뷰, 푸시 알림이 됩니다. 긴 코드 편집은 되지 않습니다. 문서는 read-mostly(읽기와 짧은 조작 위주)로 설명합니다.

Tailscale 개인 무료 플랜으로도 이 용도는 대개 충분합니다. 폰에서 모델을 호출하면 집에서 누른 것과 같은 사용료가 나갑니다.

집 Wi-Fi와 LTE에서 테스트

집 Wi-Fi에서만 테스트하면 외부 접속 문제를 발견하지 못할 수 있습니다. 집에서 통과한 뒤 폰을 LTE/5G로 바꿔 같은 항목을 다시 하세요.

worktree 목록이 보이는지, waiting에 continue를 보내면 서버가 반응하는지, 파일 트리와 Source Control stage가 되는지, 에이전트 완료 푸시가 오는지 확인합니다. 상태가 안 맞으면 해당 worktree를 강제 새로고침합니다.

절전, 재부팅, 보안

서버가 잠들거나 꺼지면 모바일 연결도 중단됩니다. 초보자 기본은 OS 설정(GUI) 이고, 강한 명령어는 막혔을 때만 씁니다.

macOS (기본: GUI)

전원 어댑터를 꽂은 상태에서 시스템 설정 → 배터리 → 옵션으로 들어가, 전원 어댑터 사용 시 디스플레이가 꺼져 있어도 자동으로 잠자지 않기를 켭니다. Apple도 잠자기 방지가 전력 사용을 늘릴 수 있다고 안내합니다. (Apple 잠자기 안내)

뚜껑을 닫아 쓰는 구성이라면 가방이나 밀폐된 공간에서는 쓰지 마세요. 통풍이 되는 고정 장소에 전원을 연결한 경우에만 사용합니다.

집 서버가 GUI만으로 부족할 때(고급) 아래를 쓸 수 있습니다. -a는 배터리에도 적용되므로 노트북을 어댑터에서 분리하면 방전·발열 위험이 있습니다. 되돌리기: sudo pmset -a disablesleep 0.

sudo pmset -c sleep 0
sudo pmset -a disablesleep 1
pmset -g

Windows 11

설정 → 시스템 → 전원 및 배터리에서 절전을 안 함으로 둡니다. 잠금 후 다시 자는 경우가 있으면 관리자 터미널에서 숨김 항목을 표시한 뒤, 제어판 전원 옵션 고급 설정의 시스템 무인 절전 시간 제한을 0으로 둡니다.

powercfg /attributes SUB_SLEEP 7bc4a2f9-d8fc-4469-b07b-33eb785aaca0 -ATTRIB_HIDE

다시 숨기려면 마지막을 +ATTRIB_HIDE로 바꿉니다.

Linux

서버 전용 장비라면 sleep 타깃을 막을 수 있습니다. 되돌리기는 unmask입니다.

sudo systemctl mask sleep.target suspend.target hibernate.target hybrid-sleep.target

일반 노트북이면 전면 mask 대신, 전원 연결 시 절전만 끄거나 /etc/systemd/logind.conf에 HandleLidSwitchExternalPower=ignore를 넣는 쪽이 안전합니다. 데스크톱 환경이 lid를 직접 처리하면 logind 설정이 안 먹을 수 있습니다. (logind.conf)

재부팅 후 살아나는지

정전·재부팅 후 자동 켜짐, 로그인 후 Orca 자동 실행을 확인하고, 실제로 한 번 재부팅한 뒤 폰에서 다시 붙습니다.

OS 자동 로그인은 기본 권장이 아닙니다. 재부팅 복구에는 편하지만, 저장소와 API 토큰이 있는 기계에 물리 접근하면 바로 들어갈 수 있습니다. 꼭 필요하다면 FileVault, BitLocker, LUKS 같은 디스크 암호화와 화면 잠금을 먼저 검토하세요. 가능하면 자동 로그인보다 로그인 항목·서비스로 Orca만 올리는 편이 낫습니다.

Tailscale 키 만료 확인하기

새 tailnet의 기본 키 만료는 흔히 180일입니다. 만료되면 그 기기 연결이 끊깁니다. (Key expiry) 장기간 무인 운영하는 신뢰할 수 있는 서버라면 Machines에서 Disable Key Expiry를 고려할 수 있습니다. 대신 분실·침해 시 접근이 오래 남을 수 있으니, ACL을 최소 권한으로 두고 안 쓰는 기기는 바로 제거하세요. “무조건 끄기”가 정답은 아닙니다.

Tailscale SSH (선택, Linux)

Orca만 죽었을 때 폰으로 재시작하려면 tailscale set --ssh를 쓸 수 있습니다. 목적지에서 SSH 기능이 켜져 있어야 하고, tailnet의 네트워크·SSH 접근 정책이 허용되어야 하며, 접속할 OS 사용자가 있어야 합니다. (Tailscale SSH)

⚠️ 주의: tailscale set --ssh를 실행하면 Tailscale IP로 연결된 기존 SSH 세션이 멈출 수 있습니다. 로컬 콘솔이나 다른 접속 수단을 확보한 뒤 설정하세요. 원격에서 tailscale up --force-reauth는 그 연결을 끊을 수 있어 함부로 돌리지 마세요.

밖에서 막혔을 때

나가기 전 체크리스트

서버 전원과 네트워크, Tailscale Connected(서버와 폰), Orca Desktop 로그인과 열린 저장소, 모바일 QR 페어링 행, 집 Wi-Fi와 LTE 테스트, 절전 설정, 재부팅 후 재접속, (선택) 키 만료 정책과 디스크 암호화를 확인합니다. 여기까지면 밖에서 폰이 실제로 쓸모 있습니다.

출처와 링크

• Orca Mobile: 기능, read-mostly, 문서상 페어링
• Remote Orca Servers: 서버 쪽 자격증명, QR/링크 경로
• Ways to run Orca: 실행 방식
• Tailscale 다운로드
• Tailscale Key expiry
• Tailscale SSH
• Apple Mac 잠자기
• systemd logind.conf
• 실기기 화면 (2026-07-27): Settings > 설정 시작 > 모바일 (BETA), LAN, Tailscale 100., QR

조사 기준: 2026년 7월. 공식 문서와 실기기 BETA 화면을 대조했습니다. 페어링 UI는 사용자 화면 기준이며, 문서와 다르면 앱 화면을 우선하되 QR이 없으면 공식 문서 경로를 씁니다. 이 글은 24시간 서버 컴퓨터 한 대 + Tailscale + 데스크톱 모바일 QR만 다룹니다.