Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix [DOCS+UX] Remote Control: docs don't say sessions live under Code tab; QR code doesn't deep-link there either [2 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#56031•Fetched 2026-05-05 05:59:57
View on GitHub
Comments
2
Participants
2
Timeline
5
Reactions
0
Author
jspersonjsperson
Participants
github-actions[bot]github-actions[bot]jspersonjsperson
Timeline (top)
labeled ×3commented ×2
RAW_BUFFERClick to expand / collapse

The Remote Control documentation at https://code.claude.com/docs/en/remote-control has a discoverability gap, and the QR code workflow doesn't paper over it the way it should.

Issue 1 — Docs don't specify the Code tab.

The "Connect from another device" section says:

Open claude.ai/code or the Claude app and find the session by name in the session list. Remote Control sessions show a computer icon with a green status dot when online.

This treats "the Claude app" as homogeneous. A user opening the Claude app for the first time lands on their Chats list, sees nothing, and assumes the feature is broken — when in fact they need to navigate to the Code tab.

Suggested fix: add a single sentence, e.g.

Open the Claude app and tap the Code tab. Remote Control sessions appear in the session list there, marked with a computer icon and green status dot.

Issue 2 — The QR code doesn't deep-link to the session.

Scanning the QR code shown by claude remote-control (or pressing spacebar to display it) opens the Claude app, but lands on the app's default surface (typically Chats) rather than navigating directly to the Code tab and the active Remote Control session. The user still has to know to tap the Code tab and find the session manually.

This is the bigger problem. The QR code is positioned as the "quick access from your phone" path, but it doesn't actually take you to the session — it just launches the app. If the QR code carried a deep link that opened the session directly, the docs gap would be much less painful.

Suggested fix: make the QR code (and the session URL it encodes) deep-link directly to the Code tab and the session, bypassing the app's default landing surface.

For context: I personally lost ~30 minutes troubleshooting this before realizing the session was waiting under Code. The feature itself works; the navigation and the QR flow are the barriers.

extent analysis

TL;DR

Update the Remote Control documentation and QR code workflow to improve discoverability and deep-linking to the Code tab and active session.

Guidance

  • Update the "Connect from another device" section in the documentation to specify navigating to the Code tab in the Claude app.
  • Modify the QR code to deep-link directly to the Code tab and the active Remote Control session, rather than just launching the app.
  • Verify the updated documentation and QR code workflow by testing the user journey from both the web and app interfaces.
  • Consider adding clear visual cues or tooltips in the app to help new users discover the Code tab and Remote Control sessions.

Example

No code snippet is provided as the issue is related to documentation and workflow updates.

Notes

The suggested fixes aim to address the discoverability gap and improve the user experience, but may require additional testing and iteration to ensure a seamless workflow.

Recommendation

Apply the workaround by updating the documentation and QR code workflow, as this will provide a more direct and intuitive user experience for Remote Control sessions.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#database connection#vector store#embedding generation#cache error#pipeline error

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [DOCS+UX] Remote Control: docs don't say sessions live under Code tab; QR code doesn't deep-link there either [2 comments, 2 participants]