claude-code - 💡(How to fix) Fix [Bug] Remote-control bridge session returns not_found error, session not registered on server [1 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#48749Fetched 2026-04-16 06:52:03
View on GitHub
Comments
1
Participants
2
Timeline
5
Reactions
0
Author
Timeline (top)
labeled ×4commented ×1

Error Message

Verify via curl: curl https://api.anthropic.com/v1/claude-code/bridge/sessions/session_01CcrTtsFbisnKXY7WEZdsQX → returns {"type":"error","error":{"type":"not_found_error","message":"Not Found"}} claude remote-control --verbose provides no additional output beyond the timeout error claude remote-control --name "zamtel" fails with Error: timeout of 15000ms exceeded

RAW_BUFFERClick to expand / collapse

Description: When starting a remote control session via /remote-control or claude remote-control --name "...", the CLI reports the session as active and generates a session URL, but attempting to access it from claude.ai/code or the Claude app returns "Failed to load session." Steps to reproduce:

Run claude in a project directory Enter /remote-control inside the session CLI shows: /remote-control is active · Code in CLI or at https://claude.ai/code/session_01CcrTtsFbisnKXY7WEZdsQX Open the URL in browser or Claude app → "Failed to load session" Verify via curl: curl https://api.anthropic.com/v1/claude-code/bridge/sessions/session_01CcrTtsFbisnKXY7WEZdsQX → returns {"type":"error","error":{"type":"not_found_error","message":"Not Found"}}

Expected behavior: Session should be accessible from claude.ai/code or the Claude mobile app. Actual behavior: Bridge session is never registered on the server side. The local ~/.claude/sessions/*.json file is created correctly with a valid bridgeSessionId, but the server has no record of it. Environment:

Claude Code version: 2.1.109 Subscription: Max Auth method: claude.ai OAuth (confirmed via claude auth status) OS: macOS, Mac Mini (Apple Silicon) No ANTHROPIC_API_KEY set Network: direct connection, no proxy, api.anthropic.com reachable (HTTP 200 in ~110ms) claude remote-control --verbose provides no additional output beyond the timeout error

Additional notes:

claude remote-control --name "zamtel" fails with Error: timeout of 15000ms exceeded Running /remote-control inside an interactive session partially works (session file is created) but the bridge session is not found on the server Logging out and back in does not resolve the issue Issue persists across multiple attempts and sessions

extent analysis

TL;DR

The issue may be related to the bridge session not being registered on the server side, and a potential fix could involve investigating the API request to register the session.

Guidance

  • Verify the bridgeSessionId in the local ~/.claude/sessions/*.json file is correctly generated and matches the expected format.
  • Check the network connection and API endpoint https://api.anthropic.com/v1/claude-code/bridge/sessions/ for any issues or errors that might prevent the session from being registered.
  • Investigate the claude remote-control command's behavior when run with the --verbose flag to see if it provides any additional information about the registration process.
  • Review the authentication method and ensure that the claude.ai OAuth authentication is correctly configured and authorized.

Example

No code snippet is provided as the issue does not imply a specific code-related fix.

Notes

The issue may be related to a server-side problem or a configuration issue with the Claude Code version 2.1.109. Further investigation is needed to determine the root cause.

Recommendation

Apply workaround: Investigate alternative methods to register the bridge session, such as manually sending the API request to register the session, to see if it resolves the issue. This is because the issue seems to be related to the session registration process, and an alternative approach might help bypass the problem.

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…

Still need to ship something?

×6

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

Back to top recommendations

TRENDING