anthropics / anthropics/claude-code

Remote Control fails to connect with "connect timed out" — reproducible, session confirmed alive

Open
#95,577 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

area:networking duplicate platform:windows
Dominant language
TypeScript
Stars
147k
Forks
24k
PR merge metrics
PR metrics pending

Description

Remote Control repeatedly fails to connect for a session that is demonstrably alive and responsive at the time of the attempt.

Environment:

  • Claude Code version: 2.1.168
  • OS: Windows 11 Pro, build 26200 (10.0.26200.0), 64-bit

Reproduced on two separate days (2026-09-18 and 2026-09-19) with the same session ("DCS-reports repo access"), same failure both times:

Remote Control failed to connect: Remote Control connect timed out

Details:

  • The local Claude Code desktop app was open and the session was actively responding to messages at the exact time of each failed connection attempt — this is not a case of the local host being offline or asleep.
  • Toggling Remote Control off then back on for the session reproduces the same timeout both times, rather than a stuck one-off.
  • Separately, a browser tab at claude.ai/code connected to this same session showed a "Remote Control disconnected — Claude Code on the computer running this session is offline" banner, even though the session was live on the same laptop the browser tab was open on, and had no other local sessions active to conflict with it.

This points at the Remote Control connection/relay service rather than anything client-side (network, app state, or which machine/session is involved), since the same failure reproduced identically across two days with a confirmed-live session.

Possibly related: #95491 ("Remote Control is not restored for sessions killed by a stealth auto-update") describes a similar end symptom (Remote Control silently unreachable), but I checked the local app logs directly and confirmed no auto-update/relaunch event occurred near either of my two failures — the session was never restarted. So this looks like a distinct mechanism from #95491, not a duplicate, though the maintainers may want to check whether they share an underlying cause.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing the Remote Control toggle failure with Claude Code 2.1.168 on Windows 11 using the confirmed-live session, then trace the Remote Control connection and relay path. Compare the behavior with issue #95491 without assuming the same cause. Done means a live session connects reliably and claude.ai/code no longer reports it as offline.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
backend-api-design, cloud
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.