명령어 하나로 연결: npx tacticremote

Tactic Remote 서버를 npm 패키지로 배포했습니다. 이제 명령어 하나로 서버를 시작할 수 있습니다:

npx tacticremote

전역 설치 불필요. 설정 파일 불필요. Homebrew tap도 필요 없습니다. 터미널에서 명령어를 실행하고 Tactic Remote iOS 앱으로 QR 코드를 스캔하면 바로 연결됩니다.

왜 npx인가

기존에는 iPhone을 Claude Code에 연결하려면 Mac 메뉴 바 앱을 다운로드하거나 Homebrew로 설치해야 했습니다. 둘 다 잘 작동하지만 단계가 추가됩니다——특히 새 머신이나 Linux 서버, GUI 앱을 실행할 수 없는 원격 VM에서는 더욱 번거롭습니다.

npx tacticremote를 사용하면 Node.js가 설치된 어느 환경에서나 서버를 실행할 수 있습니다:

• Mac, Linux, Node.js가 있는 모든 머신 — 플랫폼별 설치 프로그램이 필요 없습니다.
• 원격 VM 및 클라우드 인스턴스 — SSH로 접속 후 명령어를 실행하고 휴대폰으로 QR 코드를 스캔하면 됩니다.
• 새 머신에서 제로 설정 — npx가 패키지를 즉시 다운로드하고 사용 후 자동으로 정리합니다.

작동 방식

npx tacticremote를 실행하면 서버가 다음 작업을 수행합니다:

1. 포트 8765에서 WebSocket 서버를 시작합니다.
2. 로컬 IP 주소를 감지하고 터미널에 QR 코드를 출력합니다.
3. Tactic Remote iOS 앱의 연결을 기다립니다.

연결되면 iPhone에서 Claude Code 세션에 완전히 접근할 수 있습니다——프롬프트 전송, 도구 호출 승인, 파일 탐색, 푸시 알림 수신까지 모두 iPhone에서 가능합니다.

옵션

CLI는 Mac 앱과 동일한 옵션을 지원합니다:

npx tacticremote [options]

  -p, --port <n>      수신 대기 포트              (기본값: 8765)
  --path <dir>        허용할 기본 디렉토리         (기본값: $HOME)
  --api-key <key>     인증 키 설정
  --tunnel            원격 접속을 위한 Cloudflare 터널 활성화
  --no-qr             QR 코드 표시 안 함
  -h, --help          도움말 표시

로컬 네트워크 외부에서 원격 접속이 필요한 경우 --tunnel을 추가하면 Cloudflare 터널이 자동으로 생성됩니다——계정이나 별도 설정이 필요 없습니다.

Homebrew나 Mac 앱을 선호하신다면

기존 사용자에게 달라지는 것은 없습니다. Mac 메뉴 바 앱과 Homebrew tap(brew install TacticSpaceTech/tap/tacticremote)은 계속 완전히 지원됩니다. npx 옵션은 바로 시작하고 싶거나 Mac이 아닌 플랫폼에서 작업하는 사용자를 위한 더 빠른 경로를 추가한 것입니다.

App Store에서 iOS 앱을 다운로드하고 직접 사용해 보세요——서버 측은 npx tacticremote 하나면 충분합니다.