세션과 워크플로
세션 동작 방식, Claude 시작 방법, 재연결 동작을 설명합니다.
Tactic Remote는 tmux 세션을 사용하여 연결이 끊겨도 Claude Code 프로세스를 유지합니다. 이 페이지에서는 세션 동작 방식과 일상 워크플로를 설명합니다.
세션 동작 방식
각 세션은 다음에 매핑됩니다:
- 작업 디렉토리 (프로젝트 폴더).
- Mac에서 Claude Code를 실행하는 tmux 세션.
- iPhone에 표시되는 터미널 출력 스트림.
다음 상황에서도 세션은 유지됩니다:
- iPhone 앱이 닫히거나 백그라운드로 전환될 때.
- 네트워크가 일시적으로 끊길 때.
- Mac이 절전 모드에 들어갔다가 깨어날 때.
재연결하면 앱이 세션과 터미널 출력을 복원합니다.
세션 생성
- 세션 선택기 (앱 좌상단)를 탭합니다.
- New Session을 탭합니다.
- Mac의 파일 시스템을 탐색하여 프로젝트 디렉토리를 선택합니다.
- 세션 이름을 지정합니다 (예:
my-api,frontend-work). - Create를 탭합니다.
여러 프로젝트를 위한 복수 세션을 만들고 전환할 수 있습니다.
Claude Code 시작
Start 버튼을 탭하면 현재 세션에서 Claude Code가 실행됩니다.
앱에 중복 시작 방지 기능이 있어, Claude Code가 이미 세션에서 실행 중이면 Start를 탭해도 아무 일도 일어나지 않습니다. 실수로 이중 실행되는 것을 방지합니다.
시작 전 확인: 상태 표시를 확인하세요. 녹색 "Running"이면 Claude가 이미 활성 상태입니다 -- Start를 탭할 필요가 없습니다.
프롬프트 전송
채팅 입력창에 타이핑하고 전송합니다. 프롬프트가 WebSocket을 통해 Mac으로 전달되고, Claude Code 프로세스에 전달됩니다. 출력이 실시간으로 스트리밍됩니다.
빠른 동작
앱에서 자주 사용하는 터미널 입력을 위한 단축 버튼을 제공합니다:
- Enter -- 입력 제출
- Escape -- 현재 작업 취소
- Tab -- 자동 완성
- 방향키 -- 탐색
- Ctrl+C -- 중단
재연결
앱이 연결을 잃으면 (네트워크 변경, 백그라운드 전환 등):
- 지수 백오프로 자동 재연결을 시도합니다.
- 재연결 시 기존 tmux 세션에 다시 연결됩니다.
- 연결 해제 중 누적된 터미널 출력이 복원됩니다.
별도 조치가 필요 없습니다 -- 앱을 다시 열기만 하면 됩니다.
화면이 오래되어 보이면: 세션 선택기를 열고 세션을 다시 선택하세요. 강제로 새로고침됩니다.
알림
장시간 작업에서는 앱을 열어둘 필요가 없습니다:
- Claude Code는 작업 완료 시 발생하는 hooks를 지원합니다.
- 서버가 이 이벤트를 iPhone 푸시 알림으로 중계합니다.
- 알림이 도착하면 앱을 열어 결과를 확인합니다.
Tactic Remote의 iOS 알림 권한을 활성화해 두세요.
세션 종료
- Claude 중지: Stop 버튼을 탭하면 Claude Code 프로세스가 종료됩니다. 세션은 나중에 다시 시작할 수 있도록 유지됩니다.
- 세션 삭제: 세션 선택기에서 스와이프하여 삭제합니다. Mac에서 tmux 세션이 제거됩니다.