시작 가이드

Windows: 계정으로 Windows 연결하기.

Tactic Remote를 설치하고 첫 연결을 수행하는 과정을 안내합니다. Mac(또는 Windows PC)과 iPhone이 필요합니다.

소요 시간: 첫 설정에 약 10분. 이후 재연결은 몇 초면 됩니다.

사전 준비

Tactic Remote Mac 앱 -- 로컬 서버와 고정된 Node runtime을 포함합니다. 처음 실행할 때 로컬 의존성을 확인하고 Homebrew, tmux 같은 기본 구성 요소 설치를 도와줄 수 있습니다.
AI 코딩 agent CLI 최소 1개 -- Tactic Remote는 Claude Code, OpenAI Codex, Sourcegraph Amp를 실행할 수 있습니다. 첫 세션을 만들기 전에 사용할 agent를 설치하고 로그인해 주세요.
# Claude Code (Claude Code 문서에서 권장하는 native installer) curl -fsSL https://claude.ai/install.sh | bash # OpenAI Codex npm install -g @openai/codex # Sourcegraph Amp npm install -g @sourcegraph/amp
터미널에서 이미 claude, codex, amp 중 하나가 정상 실행된다면 Tactic Remote에서 사용할 수 있습니다.
tmux -- Mac/Linux 터미널 세션을 연결이 끊긴 뒤에도 유지합니다. Mac 앱이 확인하고 설치를 도와줄 수 있으며, CLI 사용자는 macOS에서 brew install tmux를 실행할 수 있습니다.

Mac 앱 대신 한 명령 CLI 시작 방식을 사용하고 Node.js나 Homebrew가 없다면 먼저 설치하세요:

# Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
 
# Node.js
brew install node

Tactic Remote는 Mac에서 두 가지 설정 경로를 지원합니다.

다운로드 페이지에서 Tactic Remote Mac 앱을 받으세요. DMG를 열고 앱을 Applications로 드래그합니다.

처음 실행하면 메뉴 바에 앱이 나타납니다. 아이콘을 클릭하면 다음을 확인할 수 있습니다:

Mac 앱에는 서버가 내장되어 있어 설정 흐름이 더 안내형이며, 터미널에 익숙하지 않은 사용자에게는 보통 이쪽이 가장 쉽습니다.

터미널에서 이 명령 하나를 실행합니다:

npx tacticremote

서버가 시작되고 QR 코드가 표시됩니다. iPhone으로 스캔하면 연결 완료입니다.

요구 사항: Node.js 16+, tmux (macOS에서 brew install tmux), 그리고 설치된 agent CLI 1개 이상 (claude, codex, amp 중 하나).

macOS와 Linux에서 작동합니다.

어느 쪽을 선택해야 하나요? 대부분의 사용자에게는 설정을 안내하고 메뉴 바에 QR 코드를 보여주는 Mac 앱이 기본 선택으로 더 좋습니다. CLI는 이미 Terminal을 주로 쓰거나 macOS와 Linux에서 같은 흐름을 유지하고 싶은 경우에 적합합니다.

Bonjour 자동 검색: 두 기기가 같은 WiFi에 있으면, iOS 앱이 Bonjour를 통해 Mac을 자동으로 감지할 수 있습니다 -- 서버 목록에서 확인하세요.

설정에서 실행할 agent를 선택합니다: Claude Code, Codex, Amp. 기본값은 Claude Code입니다.
Start 버튼을 탭합니다.
선택한 agent가 Mac의 tmux 세션 안에서 실행됩니다. 터미널 출력이 iPhone에 실시간으로 스트리밍됩니다.
테스트 프롬프트를 보내보세요:

List the files in the current directory.

agent의 응답이 폰에 스트리밍되면 모든 것이 정상 동작하는 것입니다.