연결 진단

문제가 발생했을 때 무작위 재시도는 시간 낭비입니다. 다음 순서를 따라 원인을 분리하세요.

Step 1: 증상 분류

Step 2: 서버 확인

Mac에서 서버가 리스닝 중인지 확인합니다:

lsof -nP -iTCP:8765 -sTCP:LISTEN

node 프로세스가 보여야 합니다. 아무것도 나타나지 않으면 서버가 실행 중이 아닙니다.

Cloudflare Tunnel을 사용하는 경우도 확인하세요:

ps aux | grep cloudflared

Step 3: 네트워크 도달성 테스트

같은 네트워크의 다른 기기 (또는 Mac 자체)에서:

# 포트 도달 가능 여부 테스트
nc -zv <mac-ip> 8765
 
# 터널 사용 시
curl -I https://your-tunnel-url.trycloudflare.com

포트에 도달할 수 없으면 확인하세요:

• Mac 방화벽 설정
• 올바른 네트워크 인터페이스 (WiFi는 en0, 이더넷은 en1)
• 기기가 같은 서브넷에 있는지

Step 4: Mac 성능 확인

연결은 되지만 느리게 느껴질 때:

# CPU와 메모리
top -l 1 -s 0 | head -10
 
# tmux 세션 확인 (너무 많지 않은지?)
tmux list-sessions

Mac에 부하가 높으면 터미널 출력이 지연되어 네트워크 문제처럼 보일 수 있습니다.

Step 5: 세션 새로고침

출력이 오래되었거나 터미널이 비어 있을 때:

1. iPhone 앱에서 세션 선택기를 엽니다.
2. 세션을 다시 선택합니다.
3. tmux 세션에 다시 연결되어 출력이 새로고침됩니다.

세션이 더 이상 존재하지 않으면 (삭제 또는 서버 재시작), 새 세션을 생성하세요.

Step 6: 알림 전달 확인

푸시 알림이 동작하지 않을 때:

1. iOS 권한: 설정 > Tactic Remote > 알림 > 허용.
2. Hook 이벤트: Claude Code가 hook 이벤트를 발생시키고 서버가 이를 중계합니다. 서버가 수신하는지 확인:

   curl -X POST http://localhost:8765/hook -d '{"type":"test"}'

3. 앱 버전: Mac 앱과 iOS 앱 모두 최신 버전인지 확인합니다.

지원 이슈 등록 시기

위의 방법으로 해결되지 않으면 지원팀에 문의하세요. 다음 정보를 포함합니다:

• 앱 버전 (Mac 및 iOS)
• 연결 모드 (로컬 또는 터널)
• 시도한 단계
• 스크린샷 또는 에러 메시지 (API 키는 가려주세요)