Remote Control: session not connecting from mobile app
Open 💬 28 comments Opened Feb 25, 2026 by haw-em
Description
Remote Control session starts successfully in terminal but cannot connect from mobile device.
Environment
- Claude Code version: 2.1.58
- OS: macOS tahoe 26.3
- Plan: Max
- iOS: 26.2.1, 17pro
- App version [1.260223.2](url)
Steps to reproduce
- Run
claude remote-controlin terminal — session starts, QR code and URL are displayed - Scan QR code with phone — Claude app opens but does not connect to the session
- Open the session URL in phone browser — same result, no connection
- Check Sessions list in Claude app — remote session does not appear
Other troubleshooting:
-Have restarted both devices, logged in and out of both, am logged in to the same account on both, connected to internet, terminal open and active
Expected behaviour
Scanning QR code or opening session URL should connect to the active remote control session. Session should be visible in the app's sessions list.
Actual behaviour
- QR code scan opens the Claude app but nothing else happens — no session connection
- Session URL does not connect
- Session does not appear in the sessions list on the phone
28 Comments
I second this. I am able to get it to work very intermittently. The first time I got it to work I logged out of the cli and back in. I coded for a few hours but then the app suddenly "refreshed" and the session disappeared. I could not get it back. I got it to work on safari but I had to log out and log back in as well.
Experiencing a similar issue.
Scanning the QR code from
claude remote-controlopens the Claude appbut shows the regular chat interface — not the Code/sessions view.
The remote session is not visible.
However, if I open claude.ai/code in Safari and then tap "Open in app",
the Code section loads correctly and I can see my sessions.
So the issue seems to be that the QR code deep link routes to regular
chat instead of the Code section of the app.
Remote Control session starts successfully in the CLI terminal and is accessible from the web browser and the desktop app, but the iOS mobile app does not connect to the session and does not display it in the sessions list. The app only shows the Code onboarding screen with a "Connect to GitHub" button — there is no option to join an existing Remote Control session.
iOS device: iPhone, iOS app version 1.260223.2 (latest, no updates available)
Desktop app: Working correctly — shows Remote Control session
Web browser: Working correctly — shows Remote Control session
QR code scan opens claude app - but opens a chat window not the remote session
Seems like the "Connect to GitHub" screen is gating the page with the list of active remote sessions; i.e.: if you connect github than you'll see your active remote sessions
thanks that was actually the issue - even though i haven't conneccted github in web or the windows app either
after connecting github the remote session does display
Facing the same issue. Max plan, macOS (Darwin 23.3.0), Claude Code CLI via npm-global install.
claude remote-controlstarts successfully and generates a link/QR code. When I open the link on my phone, it opens a normal claude.ai web chat thread instead of connecting to my local CLI session. No error — just a completely disconnected regular conversation.check if your claude code is linked to github on the phone or not, i had same issue but once i got rid of the 'connect to github' message then the remote sessions appeared
The Remote Control onboarding experience on the Claude iOS app is seriously broken. After scanning the QR code from claude remote-control, the app opens but the session simply doesn't appear anywhere. No error message, no prompt, no indication of what went wrong — just nothing.
If it weren't for Claude itself helping me find this GitHub issue thread, I would have had absolutely no idea how to resolve this. The fact that your own AI had to dig through community discussions to figure out a workaround for your own product's UX gap really says something about how undiscoverable this problem is.
tried the github connection fix, didn't work for me. still just opens the app and nothing happens
Still broken in v2.1.75 (Mar 13, 2026).
New behavior observed in v2.1.75:
Version history for this bug:
This feature has been non-functional across at least 5 consecutive versions. No workaround exists — neither QR scan (mobile app), camera scan (App Store redirect), nor session URL (redirects to
claude.ai/code/family) establishes a connection.Environment: Windows, Node.js install (npm), Max plan, same account on host and mobile device.
Tried both workarounds mentioned in comments (GitHub connect-first, Safari claude.ai/code open-in-app) — neither works. Still fully blocked on v2.1.75. No mobile connection path functional.
v2.1.76 Remote Control fixes — requesting confirmation on mobile QR pairing
v2.1.76 includes what appear to be directly relevant Remote Control server-side fixes:
My setup for context:
Will update to v2.1.76 and retest. Will report back whether the session-silently-dying fix resolves mobile QR pairing. If anyone else has tested v2.1.76 mobile remote control, please share results here.
Upgraded to v2.1.76 and tested immediately. Mobile QR pairing still broken. The Remote Control server-side fixes (silent session death, bridge recovery, stale work items) did not resolve the mobile connection issue. Now confirmed broken across v2.1.71 → v2.1.76, 6 consecutive versions. Still no workaround.
Same issue here - additional data points:
Environment:
∙ macOS, Mac (jack-mac-2.local)
∙ Claude Code: latest
∙ iOS app: latest (March 2026)
∙ Plan: Max
What works:
∙ claude rc starts successfully, session URL generated
∙ Chrome desktop: connects fine
∙ Chrome iOS: connects fine
∙ Safari desktop (claude.ai/code): connects fine
What doesn’t work:
∙ iOS native app: Session doesn’t appear in Code tab session list. When opened via URL, shows “Unknown network error” and stays stuck on “Connecting”
∙ Safari iOS: Shows “Failed to load session” error page
Notes:
∙ The native iOS app used to work with Remote Control previously
∙ This appears to be a WebKit-specific issue since Chrome (Blink engine) works on both desktop and iOS, while Safari and the native app (which uses WebKit) both fail
∙ Restarting the iOS app, force-quitting, and creating new RC sessions did not help
Additional data point for the WebKit diagnosis above: Windows host, iPhone (iOS), same failure.
claude remote-controlstarts on Windows (Node.js npm, v2.1.76, Max plan)So the WebKit failure isn't macOS-specific on the host side — it reproduces with Windows host + iPhone client. The common denominator is the iOS Claude app (WebKit), not anything about the host OS.
@antrewmorrison — confirming this is reproducible on Windows host as well, not just macOS.
v2.1.79 adds
/remote-controlfor VSCode only — "bridge your session to claude.ai/code to continue from a browser or phone." This is exactly the feature we need, but it's not available in the CLI.For those of us using
claudein terminal (not VSCode),claude remote-controlis now confirmed broken across v2.1.71 → v2.1.79, 9 consecutive versions. The VSCode implementation working suggests the server-side infrastructure is functional — the CLI's QR pairing path is the remaining gap.@antrewmorrison — is the VSCode /remote-control bridge using the same session infrastructure as CLI
claude remote-control? If so, is there a timeline for bringing parity to the CLI path? Windows host + iPhone (WebKit) still can't connect via any path.Remote Control mobile still broken on v2.1.79 (CLI)
Environment:
claude --version)Failure modes (both still present):
Note: v2.1.79 added VSCode
/remote-controlsupport, but CLIclaude remote-controlis still broken. Since the VSCode implementation works, the server-side infrastructure is clearly functional — the remaining gap appears to be isolated to the CLI QR pairing path.@antrewmorrison — any update on CLI parity timeline for this?
Adding onto this issue, it would be nice if I could run a Claude cover remote session as a system service instead of a terminal process that way I could have a long running remote session connection and just link up to my computer whenever I want to wherever I am without having to make sure that my remote session is actually running on my remote desktop
v2.1.80 — CLI mobile RC still broken. 10 consecutive versions (v2.1.71 → v2.1.80).
v2.1.80 changelog includes: "Fixed /remote-control appearing for gateway and third-party provider deployments where it cannot function." Meanwhile, CLI users where RC should function still can't connect from mobile.
Timeline:
/remote-controlshipped and works — server-side infrastructure is functionalclaude remote-controlmobile pairing broken across 10 consecutive versionsBoth failure modes unchanged on Windows CLI + iPhone (iOS):
@antrewmorrison — you were assigned Mar 16. Any update on CLI mobile parity? The VSCode implementation proves the backend works. The remaining gap is CLI QR → mobile handshake.
v2.1.80 — tested immediately after upgrade. CLI mobile RC still broken.
Just updated to v2.1.80 and tested
/remote-control(CLI, Windows). Both failure modes unchanged:10 consecutive broken versions. @antrewmorrison — any timeline?
v2.1.81 — tested immediately after upgrade. CLI mobile RC still broken. 11 consecutive versions.
v2.1.81 ships FOUR Remote Control improvements:
None of these fix CLI mobile pairing. QR scan from Claude iOS app → "Connecting..." indefinitely. Never establishes connection.
Windows CLI, iPhone iOS, same account, same network. 11 consecutive broken versions (v2.1.71 → v2.1.81).
@antrewmorrison — assigned since Mar 16, 4 versions ago. Is there a timeline for CLI mobile parity? The VSCode path works. The server infrastructure works. The gap is CLI QR → mobile handshake.
UPDATE: v2.1.81 — CLI mobile RC PARTIALLY WORKING.
Correcting my earlier report. After further testing:
This is real progress after 11 broken versions. Something in v2.1.80/81 improved the CLI handshake path. The inconsistency on v2.1.80 sessions suggests the fix may depend on session state or timing.
Platform: Windows CLI + iPhone iOS. @antrewmorrison — looks like your work is landing. The remaining gap is the v2.1.80 intermittent failures.
v2.1.81 — CLI mobile RC partially working but NOT STABLE.
After more testing over ~12 hours:
What works:
What doesn't:
/reconnector equivalent command — once the connection drops, the session is orphaned from mobileThe missing piece: There's no way to re-pair a session from CLI after the initial QR connection drops. The v2.1.76 fix for "bridge sessions failing to recover after extended WebSocket disconnects" doesn't seem to apply to CLI sessions — or the recovery isn't surfaced to the user.
Expected behavior: Either (a) automatic reconnection when mobile app is reopened, or (b) a
/reconnector/rccommand that regenerates the QR code for re-pairing.Platform: Windows CLI + iPhone iOS, v2.1.81. @antrewmorrison
v2.1.81 update — RC reconnection still broken.
Continuing from my Mar 20 report. The initial v2.1.81 connection fix was real but short-lived:
/remote-controlagain in an existing session does not regenerate a working QR codeThe connection is single-use. Once it drops (phone sleeps, network blip, walk away for a bit), the session is permanently orphaned from mobile. There is no
/reconnectcommand and the bridge recovery fix from v2.1.76 does not apply to CLI sessions.For this to be usable, disconnected sessions need to automatically reconnect when the mobile app is reopened, or
/remote-controlneeds to work as a re-pair command on existing sessions.Platform: Windows CLI + iPhone iOS, v2.1.81. @antrewmorrison
Additional detail on reconnection failure:
When running
/remote-controlon a session that was previously connected, it displays the session URL. Pasting that URL into a browser — the same method that worked for initial connection — does nothing. Page loads but no session connects.So both reconnection paths are dead:
/reconnectcommand existsThe URL appears valid (same format as working initial connections), but the session bridge is gone and can't be re-established.
The QR-code-to-mobile-app flow for Remote Control is frustratingly fragile — I hit the same dead end with sessions that just never appear. pikiclaw takes a different approach: it keeps Claude Code running locally and pipes everything through Telegram (or Feishu/WeChat) as the transport layer, so there's no proprietary handshake to break — if your IM app works, the session works. Streaming output, multi-turn conversation, and file exchange all go through the chat.
npx pikiclaw@latestto try it out.GitHub: https://github.com/xiaotonng/pikiclaw
This is seriously broken. Can't open the chat on my iOS app at all.
Same symptom on Max plan.
Repro:
/remote-controlin CLI → fresh QR + URL generatedRuled out:
Account auth: claude.ai OAuth (Max), same account on both sides.