anthropics / anthropics/claude-code
Remote Control session drops intermittently even when desktop-side connection is stable
- Langage dominant
- Python
- Étoiles
- 145k
- Forks
- 23.1k
- Métriques de merge des PR
- Métriques de PR en attente
Description
## Summary
Using Claude Desktop's Remote Control feature (view/control a Mac session from the Claude iOS app), the mobile app repeatedly shows the remote session as disconnected, even while actively viewing the screen in the foreground. This happens on both Wi-Fi and cellular data, ruling out network-type as the cause, and happens mid-use (not just after backgrounding the app), ruling out iOS background suspension.
## Environment
- Claude Desktop (macOS), Apple Silicon
- Remote Control feature (`remoteToolsDeviceName` device bridge over `wss://bridge.claudeusercontent.com`)
- Claude iOS app viewing the remote session
## Investigation done
- A separate prior issue (two Macs both using the device name `imac-lan`, causing `socket closed: 4000 Superseded by newer connection` every ~5 min) was identified and fixed by giving each Mac a unique `remoteToolsDeviceName` and restarting the app.
- After that fix, `~/Library/Logs/Claude/main.log` on the Mac shows **zero** `socket closed` / `Superseded` events for 3+ hours of continuous uptime, and the desktop-to-bridge TCP connection stays `ESTABLISHED` throughout (verified via `lsof`).
- Despite the Mac-side connection being fully stable, the phone-side session still drops:
- Happens on both Wi-Fi and mobile data (not a network-switching issue)
- Happens while actively viewing the screen in the foreground (not an iOS background-suspension issue)
- Since the Mac's local log shows no trace of the drop, the disconnect appears to originate either on the relay/bridge server side, or in the iOS app's own connection handling — something not diagnosable from the Mac's local files/logs.
## Expected behavior
The Remote Control session on the phone should remain stable as long as the desktop-side connection is healthy, or at minimum should recover/reconnect gracefully and quickly without requiring manual intervention.
## Actual behavior
Mobile app repeatedly reports the remote session as disconnected while the desktop-side bridge connection shows no errors.
Guide de contribution
Aucun guide de contribution indexé pour ce dépôt
Piste de recherche
The report names ~/Library/Logs/Claude/main.log, lsof output, and the wss://bridge.claudeusercontent.com endpoint, but no repository file or test. Start by locating the Remote Control connection and reconnect handling, then reproduce the foreground disconnect while checking the desktop log and bridge connection. Done means identifying the phone-side or relay cause and keeping the session stable or recovering it without manual intervention.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Évaluation
- Stack technique
- ios, macos
- Domaine
- distributed-systems, mobile-dev, networking
- Type d'issue
- Bug
- Difficulté
- 4/5
- Temps estimé
- 3-5 jours
- Activité
- Active
- Clarté
- À clarifier
- Accessibilité débutants
- 35/100