[DOCS] Remote Control docs omit disabling behavior when `ANTHROPIC_BASE_URL` points at a non-Anthropic host
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/remote-control
Section/Topic
Remote Control availability, troubleshooting, and provider/gateway limitations.
Current Documentation
The Remote Control troubleshooting section currently covers policy and network causes:
"Remote Control is disabled by your organization's policy"
"The error mentions disableRemoteControl: your IT administrator has disabled Remote Control on this device through managed settings, independent of the organization-wide toggle."
The page also says network or proxy issues may block outbound HTTPS requests, but it does not mention the provider-routing case where ANTHROPIC_BASE_URL points to a non-Anthropic host.
What's Wrong or Missing?
Claude Code v2.1.196 disables Remote Control when ANTHROPIC_BASE_URL points at a non-Anthropic host. The release says this now matches the existing behavior under CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX, and CLAUDE_CODE_USE_FOUNDRY. The Remote Control docs currently explain org policy and network failures, but not that choosing a third-party/custom API endpoint disables the feature even when the user is otherwise logged in.
Suggested Improvement
Add a provider-configuration note to the availability or troubleshooting section:
Remote Control requires a direct Anthropic-hosted Claude Code session. It is disabled when the session is routed through a non-Anthropic provider or custom API endpoint, includingCLAUDE_CODE_USE_BEDROCK,CLAUDE_CODE_USE_VERTEX,CLAUDE_CODE_USE_FOUNDRY, or anANTHROPIC_BASE_URLvalue that points at a non-Anthropic host.
Also link to the LLM gateway/provider docs so users understand this is an availability limitation rather than an account-policy failure.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/remote-control | Primary Remote Control availability and troubleshooting page |
| https://code.claude.com/docs/en/llm-gateway-connect | Cross-reference for custom ANTHROPIC_BASE_URL routing |
| https://code.claude.com/docs/en/third-party-integrations | Cross-reference for Bedrock, Vertex, and Foundry provider routing |
Total scope: 3 pages affected.
Claude Code v2.1.196 extended the existing third-party-provider Remote Control disable behavior to non-Anthropic ANTHROPIC_BASE_URL hosts.
3 Comments
This is very inconvenient bc it prevents us from using our LLM gateway with
/remote-control, even if we are logged into the claude.ai account! Would be great to get clarity on the reason behind this change.The Remote Control docs now cover this in both the requirements list and troubleshooting: as of v2.1.196, Remote Control is disabled when
ANTHROPIC_BASE_URLpoints at a host other thanapi.anthropic.com(gateway or proxy), even with a claude.ai login. See https://code.claude.com/docs/en/remote-control and https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md. Closing.🤖 Generated with Claude Code
This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.