docs: add Remote Control troubleshooting guide for Pro/Max plan eligibility errors#29985
Open
HarshalJain-cs wants to merge 2 commits intoanthropics:mainfrom
Open
Conversation
Added a comprehensive troubleshooting guide for Remote Control errors, including common causes, troubleshooting steps, and related issues.
This was referenced Mar 2, 2026
… 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.
This was referenced Mar 3, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds
docs/remote-control-troubleshooting.md— a comprehensive community troubleshooting guide for the widespreadRemote Control environments are not available for your accounterrors 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:
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.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
@antrewmorrisonwith thearea:docslabel, confirming this is a known docs/comms gap.What this PR adds
docs/remote-control-troubleshooting.mdincludes:claude doctorcheck, full re-auth cycleRelated Issues
Closes / helps users in: #28817, #28816, #29037, #29185, #29449, #29638, #29980
Notes