Windows에서 iPhone으로 Claude Code 원격 제어하기: Tactic Remote 1.8.0

당신의 Claude Code 작업이 실행 중입니다.

리팩터링일 수도, 테스트 보완일 수도, 디버깅 세션일 수도 있습니다. 대부분의 경우 5분, 20분, 때로는 30분 넘게 걸립니다.

이 시간 동안 agent는 당신이 지켜볼 필요가 없습니다. 다음 단계를 스스로 결정합니다. 하지만 몇몇 중요한 지점에서는 멈춥니다. commit 할지, 위험한 명령을 실행할지, 어떤 수정 방향이 의도와 맞는지 같은 순간입니다.

이런 순간에는 당신이 있어야 하지만, 반드시 컴퓨터 앞에 있을 필요는 없습니다.

Tactic Remote는 Claude Code(그리고 Codex와 Amp)의 실행 상태, 출력, 승인 대기 지점을 iPhone으로 옮깁니다. 컴퓨터로 돌아가지 않아도 작업 진행 상황을 확인하고 다음 단계를 결정할 수 있습니다.

1.8.0부터 이 연결이 Windows 사용자에게도 열렸습니다. 이 글은 Windows 쪽에서 무엇을 할 수 있는지, Mac과 어떻게 다른지, 페어링은 어떻게 진행되는지, Preview의 현재 경계는 어디까지인지 설명합니다.

Claude Code 원격 제어가 해결하는 문제

AI agent에게 실제 변경 작업을 맡기는 데 익숙해졌다면 다음 상황을 분명히 겪어봤을 겁니다.

• 30분짜리 작업을 시작했는데 회의에 끌려갔다
• 통근길에 어젯밤 돌린 batch 작업이 끝났는지 확인하고 싶다
• 소파에 앉아 변경 사항이 의도대로인지 확인하고 싶다
• agent가 yes/no 팝업에서 멈췄는데 컴퓨터 앞에 없다

전통적인 원격 방식은 이런 상황에 잘 맞지 않습니다.

• SSH + tmux: 가능하지만 iPhone에서 명령을 입력하고 터미널 출력을 읽기에는 거칠다
• VNC / 원격 데스크톱: 전체 데스크톱을 6인치 화면에 우겨넣어 조작 정밀도가 떨어진다
• 클라우드 기반 중계: 코드와 세션을 남의 서버로 보내는 것을 대부분의 개발자는 원하지 않는다

Tactic Remote의 접근은 다릅니다. iPhone에는 네이티브 iOS 앱이 있고, 컴퓨터의 Tactic Remote 서버와 로컬 네트워크에서 직접 연결됩니다. 클라우드를 거치지 않고, 데스크톱 전체를 휴대폰으로 던지지도 않습니다.

Windows와 Mac의 차이

1.8.0 이전에 Windows 사용자가 쓸 수 있는 경로는 명령줄뿐이었습니다. PowerShell이나 WSL2에서 npx tacticremote를 실행하는 방식입니다. 동작은 했지만, Mac 사용자가 메뉴 바 아이콘을 한 번 클릭하는 경험과는 차이가 컸습니다.

1.8.0은 Windows 데스크톱 앱을 도입해 Windows 사용자도 그래픽 인터페이스로 서버를 시작하고 관리할 수 있게 했습니다. Electron 기반의 네이티브 앱이며, 실행하면 다음을 제공합니다.

• 상태 패널: 서버 수신 주소, 현재 연결 수, API Key(활성화한 경우)
• 서버 시작 / 중지 버튼
• 페어링 QR 코드를 크게 표시해 iPhone에서 쉽게 스캔
• Cloudflare Tunnel 스위치, 원터치로 원격 접근 활성화

전체 흐름은 Mac 메뉴 바 앱과 동일합니다. 앱을 열고, 서버를 시작하고, iPhone으로 스캔하면 끝입니다. 페어링은 보통 5초 안에 완료됩니다.

30초 안에 첫 페어링 끝내기

Windows에서의 구체적인 단계입니다.

1. 다운로드 페이지에서 TacticRemote-Windows-Setup-1.8.0.exe를 받아 설치 프로그램을 실행합니다
2. Tactic Remote를 실행하고 Start Server를 클릭합니다
3. iPhone에서 Tactic Remote iOS App을 엽니다
4. iPhone에서 근처 기기를 선택하거나 데스크톱에 표시된 QR 코드를 스캔합니다
5. 완료

iPhone과 컴퓨터는 같은 Wi-Fi 네트워크에 있어야 합니다. mDNS / Bonjour로 자동 발견되므로 IP나 포트를 입력할 필요가 없습니다.

원격에서 쓰려면(카페, 출장, 다른 네트워크) Cloudflare Tunnel을 켭니다. 데스크톱에서 클릭 한 번이면 임시 공용 주소가 생성되고, iPhone에서 같은 QR 코드로 연결할 수 있습니다. 전송은 전 구간 암호화됩니다.

iPhone이 연결된 뒤 할 수 있는 일

연결되면 iOS 앱은 다음 워크플로를 제공합니다.

Chat Mode: agent의 출력을 메시지 버블로 보여주고, 도구 호출(Edit / Bash / Read / Grep)은 아이콘으로 구분하며, Thinking 구간은 별도로 접어둡니다. 원시 터미널 스트림을 읽는 것보다 편안합니다.

Terminal Mode: 원시 터미널 뷰는 그대로 남아 있어 전체 ANSI 출력을 봐야 할 때 전환할 수 있습니다.

Quick Prompts: 자주 쓰는 지시(현재 diff 리뷰, 테스트 보완, 버그 설명)를 템플릿으로 저장해 두면 다음에 한 번에 보낼 수 있습니다.

Mobile Git Review: agent가 어떤 파일을 바꿨는지, 각 파일의 diff는 어떤지 휴대폰에서 바로 보고 계속할지 결정합니다.

Push Notifications: agent가 작업을 마쳤거나, prompt에서 승인을 기다리거나, 종료되면 iPhone으로 푸시 알림이 옵니다.

Multi-agent 지원: 세션마다 Claude Code, Codex, Amp 중에서 백엔드를 고를 수 있습니다.

iPad 최적화 레이아웃: split view, 외장 키보드 단축키, 네이티브 제스처.

세 가지 연결 방식 중 무엇을 쓸지

세 방식은 자유롭게 조합할 수 있습니다. 예를 들어 로컬 네트워크 + API Key, 또는 Cloudflare Tunnel + API Key.

Windows Preview의 현재 범위

1.8.0의 Windows 빌드는 Preview입니다. 의미는 다음과 같습니다.

이미 안정적인 부분:

• 서버 시작 / 중지, QR 코드 표시, 페어링, 장시간 세션 유지
• ConPTY 백엔드 위에서 Claude Code, Codex, Amp 실행
• Cloudflare Tunnel
• API Key 인증
• 로컬 네트워크 mDNS 발견
• 한국어, 영어를 포함한 다국어 인터페이스

아직 다듬는 부분:

• 앱 내 자동 업데이트는 아직 활성화되지 않았습니다. 새 버전은 직접 받아야 합니다
• 특정 Windows 버전 조합에서의 ConPTY 경계 동작은 계속 보강 중입니다
• 매우 오래 유지되는 세션(수 시간 이상)은 가끔 서버 재시작이 필요할 수 있습니다

주 작업 플랫폼이 macOS라면 가장 오래 검증된 Mac 버전을 그대로 쓰는 것을 권장합니다. 주로 Windows에서 일한다면 Windows 빌드를 쓸 수 있고, 우리는 피드백을 기다리고 있습니다. GitHub Issues.

CLI는 대체되지 않습니다

npx tacticremote는 Windows에서도 1.8.1부터 네이티브 바이너리로 동작하며, 더 이상 WSL2가 필요하지 않습니다. PowerShell이나 cmd에서 바로 실행됩니다.

데스크톱 앱 대신 CLI를 쓰는 상황은 다음과 같습니다.

• 개발 환경이 터미널 중심이라 앱을 하나 더 띄우고 싶지 않은 경우
• 클라우드 VM, 원격 개발 머신, Docker 컨테이너에서 서버를 돌리려는 경우
• 배포를 스크립트화하려는 경우
• CI 통합 작업

CLI와 데스크톱 앱은 서로를 대체하는 관계가 아니라 두 개의 진입로입니다. 같은 iPhone 앱으로 모두 연결할 수 있습니다.

자주 묻는 질문

Windows에서 Claude Code를 쓸 수 있나요? 가능합니다. Anthropic의 Claude Code CLI가 로컬에 설치되어 로그인된 상태여야 하며, Tactic Remote는 PTY를 통해 그것을 실행하고 세션을 iPhone으로 브리지합니다.

Codex와 Amp도 지원하나요? 지원합니다. 각 세션마다 백엔드 agent를 독립적으로 선택할 수 있습니다.

코드가 클라우드로 업로드되나요? 기본적으로 그렇지 않습니다. 로컬 네트워크 직접 연결 모드에서는 모든 트래픽이 로컬 네트워크 안에 머뭅니다. Cloudflare Tunnel 모드에서는 트래픽이 Cloudflare를 통해 암호화되어 전달되지만 저장되지는 않습니다.

iPhone과 컴퓨터가 같은 Apple ID에 로그인되어 있어야 하나요? 아니요. 페어링은 mDNS 자동 발견과 QR 코드로 이루어집니다.

SSH + tmux와 비교하면 어떻게 다른가요? SSH는 원격 터미널 로그인을 제공하지만, iPhone에서 명령을 입력하고 ANSI 출력을 읽기에는 경험이 좋지 않습니다. Tactic Remote는 "agent 출력 읽기 + prompt 승인" 같은 상황을 위해 설계되었지 "터미널을 대체"하기 위한 것이 아닙니다. Chat Mode, Quick Prompts, Mobile Review는 SSH에 없는 부분입니다.

유료인가요? 기본 기능은 무료입니다. iOS 앱은 App Store에서 무료로 받을 수 있고, 데스크톱 앱과 CLI도 무료입니다.

Linux도 지원하나요? 지원합니다. npx tacticremote는 Linux에서 바로 동작하고, systemd와 함께 장기 서비스로 배포할 수도 있습니다. 능력은 Mac이나 Windows에서와 동일합니다.

시작하기

• iOS 앱: App Store에서 받기
• Windows 데스크톱 앱 (Preview): 다운로드 페이지 또는 GitHub Release v1.8.0
• Mac 메뉴 바 앱: 다운로드 페이지
• CLI (모든 플랫폼): npx tacticremote

Windows Preview 릴리스 노트 전체: Windows 동반 앱 Preview 릴리스.

문제나 피드백이 있다면: GitHub Issues.