안전한 Start와 재연결

가장 많은 혼동을 일으키는 두 가지: Claude Code를 실수로 두 번 시작하는 것과 재연결 후 오래된 출력을 보는 것. 이 페이지에서 두 가지를 모두 방지하는 방법을 다룹니다.

안전한 Start

Start를 탭하기 전에 세션 상태 표시를 확인하세요:

• 녹색 (Running): Claude Code가 이미 활성 상태. Start를 탭하지 마세요.
• 회색 (Stopped): Claude Code가 실행 중이 아님. Start를 탭하여 실행합니다.

앱에 중복 시작 방지 기능이 내장되어 있어, Claude가 이미 실행 중일 때 Start를 탭해도 아무 일도 일어나지 않습니다. 하지만 표시를 먼저 확인하면 혼동을 피할 수 있습니다.

Claude가 실행 중인지 확실하지 않을 때

세션 선택기를 열고 세션을 다시 선택하세요. 터미널 화면이 새로고침되어 현재 상태를 보여줍니다. Claude Code 프롬프트가 보이면 실행 중이고, 일반 셸 프롬프트가 보이면 실행 중이 아닙니다.

재연결

앱이 백그라운드에 있다가 다시 열리거나 네트워크 중단 후:

1. 자동 재연결: 앱이 자동으로 서버에 재연결합니다. 보통 1-3초 소요.
2. 세션 복원: tmux 세션의 터미널 출력이 폰으로 다시 스트리밍됩니다.

터미널이 비어 있거나 오래되어 보일 때

장시간 백그라운드 후 발생할 수 있습니다. 해결:

1. 세션 선택기를 엽니다 (좌상단).
2. 현재 세션을 다시 선택합니다.
3. 터미널 화면이 새로고침됩니다.

세션이 삭제된 경우

누군가 (또는 서버 재시작으로) tmux 세션이 제거된 경우:

• 앱이 빈 상태를 표시합니다.
• 새 세션을 생성하고 다시 시작하세요.

장시간 작업

수 분 이상 걸리는 작업의 경우:

1. 앱을 계속 열어두지 마세요. iOS가 결국 네트워크 연결을 중단합니다.
2. 대신 알림을 사용하세요. Claude Code hook 이벤트가 작업 완료 시 iPhone에 푸시 알림을 보냅니다.
3. 알림이 도착하면 앱을 열고, 재연결하고, 결과를 확인합니다.

iOS에서 영구적인 포그라운드 연결을 유지하려는 것보다 이 방식이 더 안정적입니다.

일상 루틴

1. 앱을 엽니다. 자동으로 재연결됩니다.
2. 세션 상태를 확인합니다. Claude Code가 실행 중이면 이전 작업을 이어갑니다.
3. 중지된 상태면 Start를 탭합니다.
4. 프롬프트를 보냅니다. 장시간 작업은 폰을 잠그고 알림을 기다립니다.
5. 끝나면 세션을 계속 실행하거나 Stop을 탭합니다.