Skip to content

docs: add Remote Control troubleshooting guide for Pro/Max plan eligibility errors#29985

Open
HarshalJain-cs wants to merge 2 commits intoanthropics:mainfrom
HarshalJain-cs:docs/fix-remote-control-troubleshooting-guide
Open

docs: add Remote Control troubleshooting guide for Pro/Max plan eligibility errors#29985
HarshalJain-cs wants to merge 2 commits intoanthropics:mainfrom
HarshalJain-cs:docs/fix-remote-control-troubleshooting-guide

Conversation

@HarshalJain-cs
Copy link

Summary

Adds docs/remote-control-troubleshooting.md — a comprehensive community troubleshooting guide for the widespread Remote Control environments are not available for your account errors reported by Pro and Max plan users.

Motivation

This issue has generated 7+ duplicate issues with 100+ combined reactions in the past 4 days alone (#28817, #28816, #29037, #29185, #29449, #29638, #29980). The root cause is a combination of:

  1. A docs inconsistency on code.claude.com/docs/en/remote-control: the page simultaneously states Remote Control is available on Pro plans AND that Pro support is "coming soon" — confusing users who think something is broken on their end when it may be a rollout limitation.

  2. Legitimate local config issues (wrong auth method, conflicting env vars, leftover npm installs) that cause the same error for users who ARE eligible but have a misconfigured environment.

Issue #28817 is already assigned to @antrewmorrison with the area:docs label, confirming this is a known docs/comms gap.

What this PR adds

docs/remote-control-troubleshooting.md includes:

  • Current rollout status table (Max: generally available, Pro: rollout in progress) with clarification of the contradictory docs statements
  • All 4 error message variants and what each means
  • 6-step troubleshooting checklist covering: auth method verification, env var conflicts, settings.json reset, version update, claude doctor check, full re-auth cycle
  • Platform-specific notes for Windows, macOS, and Linux/WSL
  • Related issues table linking all 7 tracking issues
  • Next steps when no local fix works (wait for rollout, upgrade to Max, upvote tracking issue)

Related Issues

Closes / helps users in: #28817, #28816, #29037, #29185, #29449, #29638, #29980

Notes

Added a comprehensive troubleshooting guide for Remote Control errors, including common causes, troubleshooting steps, and related issues.
… soon

Updated troubleshooting guide for Remote Control feature, clarifying plan eligibility and error Corrects the plan eligibility information based on official docs at code.claude.com/docs/en/remote-control. Remote Control currently requires Max plan; Pro support is coming soon. Previous version incorrectly described this as a rollout issue fixable via local config. Also adds: - UX bug documentation for the 3 confirmed CLI bugs - SSH+tmux and VS Code Remote SSH as alternatives for Pro users - Clearer error message explanations - Platform-specific notes for WSL usersmessages.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant