자주 발생하는 문제
Tactic Remote에서 가장 빈번하게 발생하는 문제의 해결 방법.
서버에 연결할 수 없음
증상: 연결 시간 초과 또는 즉시 실패.
해결:
- 두 기기가 같은 WiFi에 있는지 확인합니다 (로컬 모드).
- Mac 앱 / 서버가 실제로 실행 중인지 확인합니다.
- IP 주소와 포트가 정확한지 확인합니다. Mac에서
ipconfig getifaddr en0을 실행하세요. - macOS 방화벽이 활성화되어 있으면 앱의 수신 연결을 허용합니다.
- 트래픽 경로를 변경하는 VPN이 있으면 두 기기 모두에서 비활성화합니다.
- 기업/호텔 WiFi는 기기를 격리할 수 있습니다. 자택 네트워크나 휴대폰 핫스팟을 사용해 보세요.
IP 주소에서 점을 입력할 수 없음
증상: 일부 로캘 (독일어, 프랑스어)에서 숫자 키보드에 . 대신 ,가 표시됨.
해결: 표준 알파벳 키보드로 전환하여 점을 입력하거나, 메모 앱에서 IP 주소를 복사해서 붙여넣으세요.
연결되었지만 터미널이 비어 있음
증상: 녹색 연결 표시가 있지만 터미널 화면에 아무것도 표시되지 않음.
해결:
- 세션 선택기를 열고 세션을 다시 선택합니다.
- 세션이 없으면 새로 생성합니다.
- 세션은 있지만 출력이 없으면 Start를 탭하여 Claude Code를 실행합니다.
Start를 탭해도 아무 반응이 없음
증상: Start를 탭했지만 변화가 없음.
이것은 Claude Code가 이미 실행 중일 때 예상되는 동작입니다. 앱에 중복 시작 방지 기능이 있습니다. 상태 표시를 확인하세요 -- Running (녹색)이면 Claude Code가 이미 활성 상태입니다. 바로 프롬프트를 보내면 됩니다.
알림이 도착하지 않음
증상: Claude Code가 작업을 완료했지만 푸시 알림이 오지 않음.
해결:
- iOS 설정 > Tactic Remote > 알림이 활성화되어 있는지 확인합니다.
- 서버와 앱이 최신 버전인지 확인합니다.
- 알림은 Claude Code hook 이벤트가 필요합니다. 자동으로 전송되지만 WebSocket 연결이 도달 가능해야 합니다.
앱이 백그라운드에 있으면 연결이 끊김
증상: 잠시 후 앱으로 돌아오면 연결 해제 상태가 표시됨.
이것은 정상적인 iOS 동작입니다. iOS는 배터리 절약을 위해 백그라운드 네트워크 연결을 일시 중단합니다. 앱으로 돌아오면 자동으로 재연결됩니다.
장시간 작업에서는 앱을 열어두지 말고 푸시 알림에 의존하세요.
서버 IP가 계속 변경됨
증상: Mac이 매번 다른 IP를 받아서 저장된 연결이 깨짐.
해결:
- 시스템 설정 > 네트워크에서 Mac에 고정 IP를 할당합니다.
- 수동 IP 대신 Bonjour 자동 검색을 사용합니다.
- 안정적인 URL을 위해 Cloudflare Tunnel을 사용합니다.
Claude Code에서 "API key not set" 표시
이것은 Tactic Remote 오류가 아니라 Claude Code 오류입니다. Claude Code가 작동하려면 Anthropic API 키가 필요합니다.
터미널에서 설정하세요:
또는 claude config를 실행하여 영구적으로 설정합니다.
참고: 이것은 Tactic Remote 서버 API 키와 별개입니다. Anthropic 키는 Claude AI 서비스용이고, 서버 API 키는 iPhone-Mac 연결 인증용입니다.
추가 도움이 필요한가요?
지원 페이지를 방문하거나 GitHub에 이슈를 등록하세요. 다음 정보를 포함해 주세요:
- 앱 버전
- 연결 모드 (로컬 또는 Cloudflare Tunnel)
- 시도한 내용과 결과