Claude Code Remote Control 怎么用:手机和浏览器远程接管电脑上的会话,常见报错怎么办(2026)
一句话结论
Remote Control 是把你电脑上正在运行的 Claude Code 会话「投」到手机或另一台电脑的浏览器上:在项目目录运行 claude remote-control,或在已有会话里输入 /remote-control(简写 /rc),然后用 Claude App 扫码或打开 claude.ai/code 就能接着发消息。Claude 始终在你本机运行,文件、MCP 服务器和项目配置都留在本机,所以电脑要开着、claude 进程不能关。需要 Pro、Max、Team 或 Enterprise 订阅登录,不支持 API key。
阅读说明
官方信息查阅日期:2026-10-24,来源:Claude Code 官方文档「Continue local sessions from any device with Remote Control」。功能和报错文字随版本更新,以官方文档为准。
使用条件
| 条件 | 官方要求 |
|---|---|
| 套餐 | Pro、Max、Team、Enterprise;Team / Enterprise 需要 Owner 先在 Claude Code 管理设置里打开 Remote Control 开关 |
| 登录方式 | 运行 claude 后用 /login 以 claude.ai 账号登录;API key 不支持 |
| 接入方式 | 必须直连 Anthropic API。用 Amazon Bedrock、Google Cloud、Microsoft Foundry,或把 ANTHROPIC_BASE_URL 指向其他地址(如 LLM 网关)时不可用 |
| 环境变量 | 设置了 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 或 DISABLE_GROWTHBOOK 时不可用 |
| 合规配置 | 开启零数据保留(ZDR)或 HIPAA 配置的组织不能使用 |
三种启动方式
服务器模式:在项目目录运行
claude remote-control终端会显示会话链接,按空格键显示二维码,用手机扫码即可打开。这个模式可以同时服务多个会话(默认上限 32 个),
--spawn worktree让每个会话用独立的 git worktree,避免互相改同一批文件。交互式会话:
claude --remote-control(或--rc),终端里照常打字,同时也能在手机上操作。已有会话中开启:输入
/remote-control,会带上当前对话历史。VS Code 扩展和 Claude 桌面版的 Code 标签页里也用这个命令。
第一次使用会弹出一次性确认,选择启用后才会连接。想让每个会话自动连接,在 /config 里把「Enable Remote Control for all sessions」设为 true。
从其他设备连接
- 在任意浏览器打开终端里显示的会话链接;
- 用 Claude 手机 App 扫二维码;
- 或打开
claude.ai/code/ Claude App 的 Code 页,在会话列表里找带电脑图标、绿点在线的会话。
手机上还没装 Claude App,可以在 Claude Code 里运行 /mobile 显示下载二维码。连接后可以在手机上发图片和文件、切换模型(/model sonnet)、调整 effort、看 git 改动;/plugin、/resume 等只能在本机终端用。
安全与数据
- 本机只发出 HTTPS 请求,不会在电脑上开放入站端口;流量经 Anthropic API 走 TLS。
- 连接期间,会话记录(你的消息、Claude 的回复、工具调用)会保存在 Anthropic 服务器上用于多设备同步,按官方数据使用政策保留;代码执行和文件访问仍在本机。
- 想彻底关闭:在设置里用
disableRemoteControl。
Remote Control 和云端会话有什么区别
| Remote Control | 云端会话(Claude Code on the web) | |
|---|---|---|
| 在哪运行 | 你自己的电脑 | Anthropic 托管的云端虚拟机 |
| 能用本机 MCP、工具和配置 | 能 | 不能,用云端环境配置 |
| 电脑能不能关 | 不能 | 能 |
| 适合 | 本机做到一半,出门用手机接着盯 | 不想装环境、仓库没克隆在本地、并行跑多个任务 |
云端会话的用法见 Claude Code 云端会话怎么用。
常见报错
| 报错原文 | 原因 | 怎么办 |
|---|---|---|
Remote Control requires a claude.ai subscription / You must be logged in to use Remote Control | 没用 claude.ai 账号登录,或 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、apiKeyHelper 抢了优先级 | claude auth login 选 claude.ai;删掉报错里点名的变量或设置 |
Remote Control requires a full-scope login token | 用的是 claude setup-token 生成的长期令牌或 CLAUDE_CODE_OAUTH_TOKEN,只能发模型请求 | claude auth login 重新登录 |
Remote Control isn't enabled for this account | 换套餐后本地缓存的权益过期 | claude auth logout 再 claude auth login,并更新 Claude Code;claude doctor 可看哪项检查没过 |
Remote Control is only available when using Claude via api.anthropic.com | 走了 Bedrock / Google Cloud / Foundry 或自定义 ANTHROPIC_BASE_URL | 取消报错里点名的变量,重启会话 |
Remote Control is disabled by your organization's policy | 组织未开启、管理员用 disableRemoteControl 禁用、HIPAA 配置,或个人套餐却仍登录在旧的 Team 组织下 | /status 看当前组织;个人套餐重新登录;组织问题找 Owner |
Couldn't verify your organization's policy for remote control | 离线启动或网络拦截,拿不到组织策略 | 恢复网络后再运行 /remote-control;claude doctor 看 Organization policy 一行 |
Remote credentials fetch failed | 没登录、防火墙拦了 443 出站请求,或订阅不可用 | claude remote-control --verbose 看完整错误,再按原因处理 |
Remote Control got an unexpected server response | 本地版本太旧,读不懂服务器回复 | claude update 后重新 /remote-control |
Previous session is unavailable — run /remote-control to start a new one | 恢复对话时找不回原来的远程会话 | 运行 /remote-control 新开一个 |
session expired for trusted-device check | 组织要求可信设备,登录已超过 18 小时 | /login,或在手机上用 Face ID / Touch ID / 通行密钥确认 |
更多 Claude Code 报错见 Claude Code 报错对照 和 AI 报错速查。
常见问题
关掉终端后还能从手机继续吗?
不能实时继续。服务器模式用 Ctrl+C 停掉后,约 4 小时内在同一目录再运行 claude remote-control(或加 --continue)可以把会话找回来;超过时间就要新开。远程服务器上跑的话,官方建议放在 tmux 或 screen 里。
会额外收费吗?
官方文档没有单列 Remote Control 的费用,会话照常计入你套餐的用量。套餐价格见 Claude Code 最低多少钱。
和 Codex 的远程控制一样吗?
思路类似,但是两个不同产品。Codex 的做法见 Codex 远程控制。
参考来源(官方)
- Claude Code Docs · Continue local sessions from any device with Remote Control:https://code.claude.com/docs/en/remote-control(查阅日期:2026-10-24)
- Claude Code Docs · Use Claude Code in the cloud:https://code.claude.com/docs/en/claude-code-on-the-web(查阅日期:2026-10-24)