# Claude Code Remote Control not working? Fixes > Remote Control fails when an API key or gateway outranks your claude.ai login, an org leaves it off, or the claude process stops. Each message and its fix. Source: https://shuriken.sh/guides/claude-code-remote-control-not-working When Claude Code Remote Control is not working, the message names the cause: an API key, a gateway or Bedrock in place of your claude.ai login, a Team or Enterprise toggle that is off, or a claude process that stopped. Run claude update and claude doctor, then fix what the message names. By Shuriken Updated 27 October 2026 8 min read **Contents** When Claude Code Remote Control is not working, the message it prints names the cause. Most of the messages point at one of three things: something other than your claude.ai login is in charge (an API key, a gateway in ANTHROPIC_BASE_URL, Bedrock), a Team or Enterprise Owner hasn't turned it on, or the claude process that owns the session has stopped. Before anything else, run claude update, then claude doctor. Anthropic's [Remote Control docs](https://code.claude.com/docs/en/remote-control) say claude doctor shows which eligibility check failed, and several messages changed wording between versions, so an old build can print a message that no longer matches the docs. ## Remote Control error messages and their fixes # The wording below is from Anthropic's Remote Control troubleshooting section and [error reference](https://code.claude.com/docs/en/errors), read on 24 October 2026. | Message | Cause | Fix | | --- | --- | --- | | Remote Control requires a claude.ai subscription or You must be logged in to use Remote Control | Not signed in with a claude.ai account | claude auth login , pick the claude.ai option | | Remote Control requires claude.ai subscription auth. | ANTHROPIC_API_KEY , ANTHROPIC_AUTH_TOKEN or apiKeyHelper is used ahead of your login | Remove the one it names from your shell and from the env block of your settings | | Remote Control requires a full-scope login token | Signed in with claude setup-token or CLAUDE_CODE_OAUTH_TOKEN , which can only make model requests | claude auth login | | Remote Control is only available when using Claude via api.anthropic.com | Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, or ANTHROPIC_BASE_URL set to a gateway or proxy | Unset the variable it names, then restart the session | | Unable to determine your organization for Remote Control eligibility | Cached account details are stale or incomplete | claude auth login | | Remote Control isn't enabled for this account | The account check came back off, usually stale entitlements after a plan change | claude auth logout , then claude auth login , and update | | Remote Control is disabled by your organization's policy | The Team or Enterprise toggle is off (its default), a managed disableRemoteControl , HIPAA, missing roles, or a login left over from a Team or Enterprise org | An Owner turns on Remote Control in Claude Code admin settings; /status shows which org you're in | | Remote Control was turned off by your organization's policy | The policy changed while you were connected | Once it's allowed again, /remote-control or claude remote-control | | Remote Control requires feature-flag evaluation | A variable that turns off feature flags is set, and the message names it | Unset CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC or DISABLE_GROWTHBOOK in the shell and in settings.json ; for DISABLE_TELEMETRY or DO_NOT_TRACK , see below | | Couldn't verify Remote Control eligibility | The feature-flag service couldn't be reached: offline, or a proxy in the way | Retry once online; claude doctor for details | | Couldn't verify your organization's policy for remote control | Claude Code started offline, before the VPN came up, or a proxy blocked the request | Get online, run /remote-control again | | Your organization requires Trusted Devices for Remote Control, but this device is not enrolled | Trusted Devices is on | /login (enrolment happens during sign-in) | | session expired for trusted-device check | Your sign-in is more than 18 hours old | /login , or confirm with Face ID, Touch ID, Windows Hello or a passkey | | Remote Control disconnected with Claude.ai login expired | The saved login expired or was revoked | /login , then /remote-control | | Couldn't reconnect to your Remote Control session | A resumed conversation couldn't reach its old remote session, maybe for a moment | /remote-control , or a fresh claude --remote-control | | could not reach the Remote Control server for about 30 minutes | Presence heartbeats kept failing | /remote-control | | Remote credentials fetch failed | Not signed in, port 443 blocked, or session creation failed | Rerun with claude remote-control --verbose | | Remote Control got an unexpected server response | The server replied in a form this version can't read | claude update , then /remote-control | ## Why it says "requires a claude.ai subscription" on a paid plan # When an API key or token is set, Claude Code uses it ahead of your claude.ai login. Anthropic's docs say the signed-in version of the message names the credential, for example ANTHROPIC_API_KEY is set, so this session is using API-key auth. Remote Control never accepts API-key auth, so the fix is to take that key out of the session's way, not to sign in again. - Run env | grep ANTHROPIC in the terminal where you start Claude Code. If it lists ANTHROPIC_API_KEY or ANTHROPIC_AUTH_TOKEN, unset it and find the line in your shell profile that sets it. - Open ~/.claude/settings.json, plus .claude/settings.json and .claude/settings.local.json in the project, and remove the variable from each env block. Remove an apiKeyHelper line too. - Start a new session and run /remote-control again. The same goes for "Remote Control is only available when using Claude via api.anthropic.com". The message names what routed you away, such as CLAUDE_CODE_USE_BEDROCK or a custom ANTHROPIC_BASE_URL, and the error reference adds that a gateway blocks Remote Control "even when you sign in with claude.ai". If your company requires the gateway, Remote Control is off the table for those sessions. [Claude Code on Bedrock or Vertex](https://shuriken.sh/guides/claude-code-bedrock-vertex) covers that setup. ## Remote Control isn't enabled for this account, or your organisation blocks it # "Remote Control isn't enabled for this account" is about the account itself: the check came back off. Anthropic's docs put it down to cached entitlements after a plan change, fixed by claude auth logout, then claude auth login, and an update if your Claude Code is old. Before v2.1.239 the same message read "Remote Control is not yet enabled for your account". "Disabled by your organization's policy" is a different check. On Team and Enterprise plans, Remote Control is off by default, and an Owner turns it on with the Remote Control toggle at claude.ai/admin-settings/claude-code. If it works for colleagues but not for you, and your Enterprise org uses custom roles, you need both the cloud sessions permission and the Claude Code remote control permission. If the message mentions disableRemoteControl, your IT administrator turned it off on this device through managed settings, whatever the org toggle says. An organisation with Anthropic's HIPAA configuration can't turn it on at all; /status shows HIPAA on its Organization configuration line. There is a trap for people who left a company plan. If you're on Pro or Max now but Claude Code still holds a login from an earlier Team or Enterprise organisation, it checks that organisation's policy. Run /status to see which plan and org you're signed in under, then claude auth logout and claude auth login. If you set DISABLE_TELEMETRY or DO_NOT_TRACK, Remote Control still works on Claude Code v2.1.283 or later (v2.1.304 in the Desktop app), unless your organisation requires Trusted Devices. Then you have to unset them. CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC and DISABLE_GROWTHBOOK turn it off on any version. ## Remote Control keeps disconnecting # When the network drops or changes, what Claude Code does next depends on how you started Remote Control. After a VPN or network change, something between your machine and Anthropic can start answering with HTTP 403. An interactive session keeps retrying for up to three minutes, then disconnects and names what refused: a network edge, or a proxy, VPN or firewall on your side. When the machine is awake but has no network, the two modes part ways. claude remote-control (server mode) gives up after roughly 10 minutes and exits, so you run it again. An interactive session retries for as long as the outage lasts and reconnects by itself. When the laptop sleeps, Claude Code reconnects once it wakes and is online, but nothing runs in between. Our [lid-closed guide](https://shuriken.sh/guides/keep-claude-code-running-lid-closed) has the free ways to keep a MacBook awake and what each one risks. Started Claude Code before the VPN connected? That gives "Couldn't verify your organization's policy". Each new /remote-control checks again, so you don't need to restart Claude Code. If an Owner switches Remote Control off while you're connected, the session drops with "turned off by your organization's policy" and doesn't come back on its own. A session started with /remote-control or claude --remote-control keeps running locally; claude remote-control (server mode) archives its sessions and exits. With Shuriken you follow and answer your agents' chats from your phone. [Download](https://shuriken.sh/download) ## The session went offline: the claude process stopped # Remote Control is a window into a process on your computer. Close the terminal, quit the Desktop app or VS Code, or stop claude any other way, and the session goes offline. On a remote machine over SSH, the docs say to start claude inside tmux or screen so it survives the SSH connection dropping. The [Claude Code over SSH guide](https://shuriken.sh/guides/claude-code-over-ssh) walks through that setup, and [running several sessions in tmux](https://shuriken.sh/guides/claude-code-tmux-multiple-sessions) covers the layout. ## How to bring a stopped session back # - If you stopped claude remote-control with Ctrl+C, go to the same directory and run claude remote-control to bring back every session it served, claude remote-control --continue for only the session it started with, or claude remote-control --session-id for one. The ID is the part of the claude.ai/code URL between /code/ and any ?. These work for about four hours after the server stopped, unless you started it with --no-create-session-in-dir or ran a second claude remote-control in the same directory; --continue and --session-id need Claude Code v2.1.200 or later. - If you started it with claude --remote-control or /remote-control, resume the conversation with claude --continue or claude --resume. If that prints "Couldn't reconnect to your Remote Control session", run /remote-control. - If Claude Code says "Previous session is unavailable", run /remote-control to start a new remote session under your current login. Remote Control drives a session on your own machine. A session that runs in Anthropic's cloud is a different feature, with its own errors: pulling one into your terminal is covered in [Claude Code teleport](https://shuriken.sh/guides/claude-code-teleport-cloud-sessions). Remote Control works only for Claude Code; Codex has its own, through the ChatGPT app, and [running Codex from your phone](https://shuriken.sh/guides/codex-remote-control-from-phone) has its setup and its failure modes. ## How Shuriken does it # Shuriken doesn't go through Remote Control, so none of the messages above apply to it. Your agents run on your own computers and servers, and with the background service installed (Settings › Devices) they keep running after you close the app window. The web app at app.shuriken.sh follows every chat on every computer and server you've added, whatever the agent: Claude Code, Codex, Gemini CLI or any of the others Shuriken runs. What travels between your devices is end-to-end encrypted, and our cloud relays it without being able to read it. As with Remote Control, the computer has to be on. A computer signed in to Shuriken starts with Keep awake set to Always, and Cocaine mode keeps a Mac running with the lid closed. A Shuriken server runs as a service and restarts on its own. Native iPhone and Android apps are planned for November 2026; until then, the phone app is the web app, and our guide to [running Claude Code from your phone](https://shuriken.sh/guides/run-claude-code-from-your-phone) compares all four routes. To try it on your own machines, [download Shuriken](https://shuriken.sh/download). Share [X](https://x.com/intent/post?url=https%3A%2F%2Fshuriken.sh%2Fguides%2Fclaude-code-remote-control-not-working&text=Claude%20Code%20Remote%20Control%20not%20working%3F%20Fixes)[LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fshuriken.sh%2Fguides%2Fclaude-code-remote-control-not-working)[Hacker News](https://news.ycombinator.com/submitlink?u=https%3A%2F%2Fshuriken.sh%2Fguides%2Fclaude-code-remote-control-not-working&t=Claude%20Code%20Remote%20Control%20not%20working%3F%20Fixes)[Reddit](https://www.reddit.com/submit?url=https%3A%2F%2Fshuriken.sh%2Fguides%2Fclaude-code-remote-control-not-working&title=Claude%20Code%20Remote%20Control%20not%20working%3F%20Fixes)[E-mail](mailto:?subject=Claude%20Code%20Remote%20Control%20not%20working%3F%20Fixes&body=https%3A%2F%2Fshuriken.sh%2Fguides%2Fclaude-code-remote-control-not-working) ## Sources - [Claude Code docs: Continue local sessions from any device with Remote Control](https://code.claude.com/docs/en/remote-control) (accessed 24 October 2026) - [Claude Code docs: Error reference](https://code.claude.com/docs/en/errors) (accessed 24 October 2026) - [Claude Code docs: Environment variables](https://code.claude.com/docs/en/env-vars) (accessed 24 October 2026) ## Frequently asked questions **Why does Remote Control say I need a claude.ai subscription when I pay for Max?** Because another credential is in use. If ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN or an apiKeyHelper setting is set, Claude Code uses it ahead of your login, and Remote Control refuses API-key auth. Remove it from your shell and from the env block of your settings files. **Does Remote Control work with Bedrock, Vertex AI or an API key?** No. Anthropic's docs say it needs a Pro, Max, Team or Enterprise plan, that API keys are not supported, and that it is not available on Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry or with ANTHROPIC_BASE_URL pointed at a gateway. **Why does Remote Control disconnect when my laptop sleeps?** The session runs on the laptop, so nothing happens while it sleeps. Claude Code reconnects on its own when the machine is back online. A server started with claude remote-control that stays awake but offline exits after about 10 minutes. **How long can I bring back a session after stopping claude remote-control?** About four hours, according to Anthropic's docs. In the same directory, claude remote-control --continue or --session-id brings it back; after that, start a new session. **Does Remote Control work with Codex or Gemini CLI?** No. Remote Control is a Claude Code feature. Codex has its own remote control, through the ChatGPT app and a paired computer. We found no remote feature for Gemini CLI, so it needs SSH and tmux or a harness like Shuriken. On your phone Your agents in your pocket. Follow every chat from your phone: the queue, the changes and your voice, end-to-end encrypted. [Download](https://shuriken.sh/download) [Other platforms](https://shuriken.sh/download#main) ## Keep reading - [Remote Control vs Happy Coder vs Shuriken: Comparison 27 Oct 2026 6 min read Claude Code's Remote Control, Happy Coder and Shuriken all put coding agents on your phone. What each covers, what it costs, and where it falls short.](https://shuriken.sh/compare/claude-remote-control-vs-happy-coder) - [Remote control for coding agents compared (2026): Comparison 27 Oct 2026 9 min read Remote control for coding agents in 2026: Claude Code, Codex and Copilot CLI steer from a phone, OpenCode serves a web UI, and Gemini CLI has none.](https://shuriken.sh/compare/coding-agent-remote-control-compared) - [Claude Code on Android with Termux: what works: Guide 27 Oct 2026 7 min read Claude Code broke on plain Termux in April 2026: it became a glibc binary Android can't run. Ubuntu in proot-distro works; a remote computer works better.](https://shuriken.sh/guides/claude-code-android-termux) - [Get Claude Code notifications on your phone: Guide 27 Oct 2026 6 min read Get a phone push when Claude Code finishes or needs approval: Remote Control's built-in push, or a Stop and Notification hook with ntfy. Codex too.](https://shuriken.sh/guides/claude-code-notifications-on-your-phone) - [How to use Claude Code on an iPad: Guide 27 Oct 2026 7 min read Claude Code doesn't run on iPadOS. On an iPad you drive it remotely: Remote Control, cloud sessions at claude.ai/code, or SSH and tmux to your computer.](https://shuriken.sh/guides/claude-code-on-ipad) - [Claude Code on Telegram, Discord or iMessage: Guide 27 Oct 2026 8 min read Claude Code reaches Telegram, Discord and iMessage through channels, a research preview: an official plugin and claude --channels, on your own computer.](https://shuriken.sh/guides/claude-code-telegram-discord-channels) - [Your agents on your phone, from the browser: Update 27 Oct 2026 4 min read Open app.shuriken.sh in any phone browser and add it to your home screen: every chat, the queue, Changes and voice. Browsers never count as devices.](https://shuriken.sh/blog/phone-web-app) - [We're building native iOS and Android apps: Planned 27 Oct 2026 3 min read Two native phone apps for Shuriken, iPhone and Android, are planned for November 2026. Until then, phones use the web app at app.shuriken.sh.](https://shuriken.sh/blog/native-ios-android-apps) ## Free tools - [Claude limit reset tracker](https://shuriken.sh/tools/limit-resets/claude) - [Codex limit reset tracker](https://shuriken.sh/tools/limit-resets/codex)