Claude Code Remote Control完整指南：手机、浏览器继续本地会话

Claude Code Remote Control完整指南：手机、浏览器继续本地会话 Claude Code Remote Control完整指南：手机、浏览器继续本地会话 Modified June 10 • 如果本地会话权限很宽，远端也会继承 ⠀ 8.2 传输安全 ⠀ 官方当前的安全架构： ⠀ • 所有流量走 HTTPS/TLS，经由 Anthropic API 中转 • 你的机器不会打开任何入站端口 • 使用多个短期、单一用途、独立过期的凭据 ⠀ 8.3 建议做法 ⠀ • 涉及高风险仓库时，优先配合 sandbox • 高风险任务不要顺手开 bypassPermissions • 给 Remote Control 会话显式命名，避免误连错会话 9. Team / Enterprise 常见阻塞 ⠀ Team 和 Enterprise 下，Remote Control 默认可能是关闭的。 ⠀ 你可能看到这类报错： ⠀ • Remote Control requires a claude.ai subscription • Remote Control is disabled by your organization’s policy • Unable to determine your organization for Remote Control eligibility • Remote Control requires a full scope login token • Remote Control is not yet enabled for your account ⠀ 9.1 排查顺序 ⠀ 1. 先确认你不是 API key 登录 2. 再确认管理员已经打开 Claude Code 后台里的 Remote Control 开关 3. 确认当前项目已接受 workspace trust 4. 检查是否设置了 CLAUDE CODE DISABLE NONESSENTIAL TRAFFIC 或 DISABLE TELEMETRY 环境变量（会干扰 RC 连接） 5. 用 /status 确认当前登录方式和订阅状态 ⠀ 9.2 托管策略：forceRemoteSettingsRefresh（v2.1.92） ⠀ 若组织使用 remote managed settings，请关注 v2.1.92 引入的策略项（以下为 v2.1.92 release英文原文）： ⠀ Added forceRemoteSettingsRefresh policy setting: when set, the CLI blocks startup until remote managed settings are freshly fetched, and exits if the fetch fails (fail closed) ⠀ 含义：开启后，CLI 在成功拉取到最新远程托管设置之前不会启动；若拉取失败则 直接退出（fail closed）。具体在项目/企业配置中的写法，以官方托管设置文档与你方管理员下发的 schema 为准，本教程不臆造 JSON 示例。 ⠀ 9.3 更高版本增强（v2.1.93 → v2.1.158） ⠀ v2.1.152 到 v2.1.158 这轮更新里，Remote / 后台相关变化主要不是“多一个入口”，而是稳定性和可控性增强： ⠀ • claude agents 可用 ! <command 启动可附着的后台 shell，命令行等价入口是 claude bg exec '<command '。 • /remote control autocomplete 会在已连接时显示断开入口，Chrome 集成可通过 /chrome 选择连接的浏览器。 • 后台会话的 stale daemon、pinned session 重启、idle grace、worktree isolation、tmux/Windows IME/终端渲染等问题有多轮修复。 • stdio MCP 子进程会收到 CLAUDE CODE SESSION ID 和 CLAUDECODE=1，脚本化排查时可以用这两个环境变量识别调用来源。 ⠀ v2.1.92 之后的版本对 Remote Control 做了一系列增强和修复（以下版本号经 GitHub Release Notes 逐条核实）： ⠀ 版本 增强 v2.1.98 修复 Remote Control 权限处理器中的内存泄漏 v2.1.101 修复 worktree 在会话崩溃时被删除、SSH 环境下 /remote control 失败等问题 v2.1.110 远端支持 /autocompact、/context、/exit、/reload plugins 命令 v2.1.110 Push notifications：Claude 可向手机推送通知（需在 /config 中启用 "Push when Claude decides"） v2.1.113 修复子智能体执行过程不在远端实时显示的问题（subagent streaming） v2.1.113 修复会话退出时未正确归档导致重启后丢失的问题 v2.1.116 远端支持 @ file 自动补全和 /usage credits 命令 v2.1.118 119 修复 JWT 刷新期间会话被意外归档的稳定性问题 v2.1.121+ effort.level 在远端会话中可用；worktree.baseRef 控制并发 worktree 分叉来源 v2.1.133 parentSettingsBehavior 影响企业环境下的 RC 启用策略（参见 09 企业实战指南） ⠀ 其中 Push notifications 需要额外配置： ⠀ 1. 手机安装 Claude App（iOS / Android） 2. 在 Claude Code 中执行 /config 3. 启用 "Push when Claude decides" 4. 确保手机和 CLI 使用同一账号 ⠀ 启用后，Claude 在 Remote Control 会话中有重要输出时会主动推送通知到手机。 10. 典型使用场景 ⠀ 场景 1：离开工位继续盯一个长任务 ⠀ 你在终端里： ⠀ Code block Plain Text claude remote control "deploy watch" ⠀ 然后去手机上继续： ⠀ • 看 Claude 跑到哪一步 • 补一句新的指令 • 在沙发上继续盯结果 ⠀ 场景 2：本地项目必须在线，但你要换设备 ⠀ 比如： ⠀ • 本地已有浏览器登录态 • 本地挂着 MCP • 本地项目环境复杂 ⠀ 这时用 Web 新开会话就会丢环境，用 Remote Control 就不会。 11. 常见问题 ⠀ Q1：Remote Control 会把我的代码上传到云端吗？ ⠀ 不会按“云端沙箱执行”的方式迁移过去。会话仍运行在你的本地机器上，远端界面只是连接窗口。 ⠀ Q2：API key 登录能用吗？ ⠀ 不能。当前官方要求是 claude.ai 登录。 ⠀ Q3：Remote Control 和 /mobile 是什么关系？ ⠀ /mobile 只是帮助你下载 Claude 手机 App；真正开启远程接管的是 /remote control 或对应 CLI 入口。 ⠀ Q4：我已经在会话里了，还能临时开吗？ ⠀ 可以，直接： ⠀ Code block Plain Text /remote control ⠀ Q5：它能替代 Cloud / Desktop scheduled tasks 吗？ ⠀ 不能。Remote Control 适合”继续一个正在运行的本地会话”，不是长期持久调度系统。 ⠀ Q6：Ultraplan 模式下能用 Remote Control 吗？ ⠀ 不能。官方文档明确说明 Ultraplan 会断开 Remote Control。如果你需要远程监控，避免在 Remote Control 会话中使用 Ultraplan。 ⠀ Q7：网络不稳定会怎样？ ⠀ 短暂断网会自动重连（包括笔记本合盖/休眠）。但如果网络中断超过约 10 分钟，会话会超时断开。 ⠀ Q8：能同时开多个 Remote Control 会话吗？ ⠀ 在 server mode（claude remote control）下可以，受 capacity 限制（默认 32）。但在交互模式（claude remote control）下，每个交互进程只能有一个 remote session。 12. 实用速查 ⠀ Code block Plain Text 独立 server mode claude remote control 交互模式直接开 Remote Control claude remote control 交互中临时开启 /remote control 给会话命名 /remote control release monitor v2.1.92+：默认会话名带 hostname 前缀；可用 remote control session name prefix 覆盖（参数挂载在哪个子命令上以 claude help 为准） 所有会话自动开启 Remote Control（在 /config 中设置） /config 查看登录状态和订阅信息 /status 手机 App 下载二维码 /mobile v2.1.92 release • 如果本地会话权限很宽，远端也会继承 ⠀ 8.2 传输安全 ⠀ 官方当前的安全架构： ⠀ • 所有流量走 HTTPS/TLS，经由 Anthropic API 中转 • 你的机器不会打开任何入站端口 • 使用多个短期、单一用途、独立过期的凭据 ⠀ 8.3 建议做法 ⠀ • 涉及高风险仓库时，优先配合 sandbox • 高风险任务不要顺手开 bypassPermissions • 给 Remote Control 会话显式命名，避免误连错会话 9. Team / Enterprise 常见阻塞 ⠀ Team 和 Enterprise 下，Remote Control 默认可能是关闭的。 ⠀ 你可能看到这类报错： ⠀ • Remote Control requires a claude.ai subscription • Remote Control is disabled by your organization’s policy • Unable to determine your organization for Remote Control eligibility • Remote Control requires a full scope login token • Remote Control is not yet enabled for your account ⠀ 9.1 排查顺序 ⠀ 1. 先确认你不是 API key 登录 2. 再确认管理员已经打开 Claude Code 后台里的 Remote Control 开关 3. 确认当前项目已接受 workspace trust 4. 检查是否设置了 CLAUDE CODE DISABLE NONESSENTIAL TRAFFIC 或 DISABLE TELEMETRY 环境变量（会干扰 RC 连接） 5. 用 /status 确认当前登录方式和订阅状态 ⠀ 9.2 托管策略：forceRemoteSettingsRefresh（v2.1.92） ⠀ 若组织使用 remote managed settings，请关注 v2.1.92 引入的策略项（以下为 v2.1.92 release英文原文）： v2.1.92 release ⠀ Added forceRemoteSettingsRefresh policy setting: when set, the CLI blocks startup until remote managed settings are freshly fetched, and exits if the fetch fails (fail closed) Added forceRemoteSettingsRefresh policy setting: when set, the CLI blocks startup until remote managed settings are freshly fetched, and exits if the fetch fails (fail closed) ⠀ 含义：开启后，CLI 在成功拉取到最新远程托管设置之前不会启动；若拉取失败则 直接退出（fail closed）。具体在项目/企业配置中的写法，以官方托管设置文档与你方管理员下发的 schema 为准，本教程不臆造 JSON 示例。 ⠀ 9.3 更高版本增强（v2.1.93 → v2.1.158） ⠀ v2.1.152 到 v2.1.158 这轮更新里，Remote / 后台相关变化主要不是“多一个入口”，而是稳定性和可控性增强： ⠀ • claude agents 可用 ! <command 启动可附着的后台 shell，命令行等价入口是 claude bg exec '<command '。 • /remote control autocomplete 会在已连接时显示断开入口，Chrome 集成可通过 /chrome 选择连接的浏览器。 • 后台会话的 stale daemon、pinned session 重启、idle grace、worktree isolation、tmux/Windows IME/终端渲染等问题有多轮修复。 • stdio MCP 子进程会收到 CLAUDE CODE SESSION ID 和 CLAUDECODE=1，脚本化排查时可以用这两个环境变量识别调用来源。 ⠀ v2.1.92 之后的版本对 Remote Control 做了一系列增强和修复（以下版本号经 GitHub Release Notes 逐条核实）： ⠀ 版本 增强 v2.1.98 修复 Remote Control 权限处理器中的内存泄漏 v2.1.101 修复 worktree 在会话崩溃时被删除、SSH 环境下 /remote control 失败等问题 v2.1.110 远端支持 /autocompact、/context、/exit、/reload plugins 命令 v2.1.110 Push notifications：Claude 可向手机推送通知（需在 /config 中启用 "Push when Claude decides"） v2.1.113 修复子智能体执行过程不在远端实时显示的问题（subagent streaming） v2.1.113 修复会话退出时未正确归档导致重启后丢失的问题 v2.1.116 远端支持 @ file 自动补全和 /usage credits 命令 v2.1.118 119 修复 JWT 刷新期间会话被意外归档的稳定性问题 v2.1.121+ effort.level 在远端会话中可用；worktree.baseRef 控制并发 worktree 分叉来源 v2.1.133 parentSettingsBehavior 影响企业环境下的 RC 启用策略（参见 09 企业实战指南） 版本 版本 增强 增强 v2.1.98 v2.1.98 修复 Remote Control 权限处理器中的内存泄漏 修复 Remote Control 权限处理器中的内存泄漏 v2.1.101 v2.1.101 修复 worktree 在会话崩溃时被删除、SSH 环境下 /remote control 失败等问题 修复 worktree 在会话崩溃时被删除、SSH 环境下 /remote control 失败等问题 v2.1.110 v2.1.110 远端支持 /autocompact、/context、/exit、/reload plugins 命令 远端支持 /autocompact、/context、/exit、/reload plugins 命令 v2.1.110 v2.1.110 Push notifications：Claude 可向手机推送通知（需在 /config 中启用 "Push when Claude decides"） Push notifications：Claude 可向手机推送通知（需在 /config 中启用 "Push when Claude decides"） v2.1.113 v2.1.113 修复子智能体执行过程不在远端实时显示的问题（subagent streaming） 修复子智能体执行过程不在远端实时显示的问题（subagent streaming） v2.1.113 v2.1.113 修复会话退出时未正确归档导致重启后丢失的问题 修复会话退出时未正确归档导致重启后丢失的问题 v2.1.116 v2.1.116 远端支持 @ file 自动补全和 /usage credits 命令 远端支持 @ file 自动补全和 /usage credits 命令 v2.1.118 119 v2.1.118 119 修复 JWT 刷新期间会话被意外归档的稳定性问题 修复 JWT 刷新期间会话被意外归档的稳定性问题 v2.1.121+ v2.1.121+ effort.level 在远端会话中可用；worktree.baseRef 控制并发 worktree 分叉来源 effort.level 在远端会话中可用；worktree.baseRef 控制并发 worktree 分叉来源 v2.1.133 v2.1.133 parentSettingsBehavior 影响企业环境下的 RC 启用策略（参见 09 企业实战指南） parentSettingsBehavior 影响企业环境下的 RC 启用策略（参见 09 企业实战指南） ⠀ 其中 Push notifications 需要额外配置： ⠀ 1. 手机安装 Claude App（iOS / Android） 2. 在 Claude Code 中执行 /config 3. 启用 "Push when Claude decides" 4. 确保手机和 CLI 使用同一账号 ⠀ 启用后，Claude 在 Remote Control 会话中有重要输出时会主动推送通知到手机。 10. 典型使用场景 ⠀ 场景 1：离开工位继续盯一个长任务 ⠀ 你在终端里： ⠀ ⠀ 然后去手机上继续： ⠀ • 看 Claude 跑到哪一步 • 补一句新的指令 • 在沙发上继续盯结果 ⠀ 场景 2：本地项目必须在线，但你要换设备 ⠀ 比如： ⠀ • 本地已有浏览器登录态 • 本地挂着 MCP • 本地项目环境复杂 ⠀ 这时用 Web 新开会话就会丢环境，用 Remote Control 就不会。 11. 常见问题 ⠀ Q1：Remote Control 会把我的代码上传到云端吗？ ⠀ 不会按“云端沙箱执行”的方式迁移过去。会话仍运行在你的本地机器上，远端界面只是连接窗口。 ⠀ Q2：API key 登录能用吗？ ⠀ 不能。当前官方要求是 claude.ai 登录。 ⠀ Q3：Remote Control 和 /mobile 是什么关系？ ⠀ /mobile 只是帮助你下载 Claude 手机 App；真正开启远程接管的是 /remote control 或对应 CLI 入口。 ⠀ Q4：我已经在会话里了，还能临时开吗？ ⠀ 可以，直接： ⠀ ⠀ Q5：它能替代 Cloud / Desktop scheduled tasks 吗？ ⠀ 不能。Remote Control 适合”继续一个正在运行的本地会话”，不是长期持久调度系统。 ⠀ Q6：Ultraplan 模式下能用 Remote Control 吗？ ⠀ 不能。官方文档明确说明 Ultraplan 会断开 Remote Control。如果你需要远程监控，避免在 Remote Control 会话中使用 Ultraplan。 ⠀ Q7：网络不稳定会怎样？ ⠀ 短暂断网会自动重连（包括笔记本合盖/休眠）。但如果网络中断超过约 10 分钟，会话会超时断开。 ⠀ Q8：能同时开多个 Remote Control 会话吗？ ⠀ 在 server mode（claude remote control）下可以，受 capacity 限制（默认 32）。但在交互模式（claude remote control）下，每个交互进程只能有一个 remote session。 12. 实用速查 ⠀ 13. 下一步建议 ⠀ • 想把外部消息直接推到会话中：继续看 Channels与计划任务完整指南 • 想理解模型切换、1M context 和 opusplan：继续看 安装指南中的模型配置章节 最后更新：2026年5月30日 | 适用版本：Claude Code v2.1.158 最后更新：2026年5月30日 | 适用版本：Claude Code v2.1.158 课程信息 ⠀ • 作者：老金 • GitHub：https://github.com/KimYx0207 • 公众号：老金带你玩AI • X（Twitter）：老金带你玩AI • 个人博客：https://aiking.dev • 预计学时：1 2小时 • 难度等级：⭐⭐ 进阶 • 更新日期：2026年5月30日 • 适用版本：Claude Code v2.1.158（验证于 2026 05 30） • 信息来源：Claude Code 官方文档 Remote Control Claude Code 官方文档 Remote Control 本课学习目标 ⠀ 完成本课后，你将能： ⠀ 1. 理解 Remote Control 和 Claude Code on the Web 的区别 2. 正确启动 Remote Control 的三种模式 3. 从手机、平板或浏览器继续本地 Claude Code 会话 4. 理解并发模式、worktree、sandbox 与权限边界 5. 解决 Team / Enterprise 下最常见的启用问题 1. 先说结论 ⠀ Remote Control 不是“把你的本地项目同步到云端”，而是： ⠀ 让 claude.ai/code 或 Claude 手机 App 变成你本地 Claude Code 会话的远程窗口。 让 claude.ai/code 或 Claude 手机 App 变成你本地 Claude Code 会话的远程窗口。 ⠀ 核心特点： ⠀ • 会话继续在你的机器上跑 • 本地文件系统、MCP、配置仍然可用 • 手机 / 浏览器 / 终端可以同时连同一会话 • 适合中途离开工位但不想中断当前任务 2. 它和 Claude Code on the Web 有什么区别 ⠀ 这是最容易混淆的一点。 ⠀ 功能 Remote Control Claude Code on the Web 运行位置 你的本地机器 Anthropic 云端 文件系统 本地真实项目 云端克隆 / 沙箱 MCP / 本地工具 可直接复用本地环境 取决于云端环境 是否能离开终端继续 可以 可以，但其实是另一种会话形态 典型场景 我已在本地做了一半，想在手机上继续 我想远程开一个新的云端任务 功能 功能 Remote Control Remote Control Claude Code on the Web Claude Code on the Web 运行位置 运行位置 你的本地机器 你的本地机器 Anthropic 云端 Anthropic 云端 文件系统 文件系统 本地真实项目 本地真实项目 云端克隆 / 沙箱 云端克隆 / 沙箱 MCP / 本地工具 MCP / 本地工具 可直接复用本地环境 可直接复用本地环境 取决于云端环境 取决于云端环境 是否能离开终端继续 是否能离开终端继续 可以 可以 可以，但其实是另一种会话形态 可以，但其实是另一种会话形态 典型场景 典型场景 我已在本地做了一半，想在手机上继续 我已在本地做了一半，想在手机上继续 我想远程开一个新的云端任务 我想远程开一个新的云端任务 ⠀ 如果你已经在终端里干了一半活，想躺沙发继续看、继续发指令，用 Remote Control。 ⠀ 如果你想新开一个云端任务，不依赖本地运行环境，用 Claude Code on the Web。 3. 使用前提 ⠀ v2.1.139+ 登录方式限制：如果当前会话通过 ANTHROPIC API KEY、apiKeyHelper 或 ANTHROPIC AUTH TOKEN 走 API key / helper 登录，Remote Control、/schedule、claude.ai MCP connectors 和 notification preferences 会被禁用。要使用远控和计划能力，优先使用支持这些能力的 Claude.ai 登录路径。 v2.1.139+ 登录方式限制：如果当前会话通过 ANTHROPIC API KEY、apiKeyHelper 或 ANTHROPIC AUTH TOKEN 走 API key / helper 登录，Remote Control、/schedule、claude.ai MCP connectors 和 notification preferences 会被禁用。要使用远控和计划能力，优先使用支持这些能力的 Claude.ai 登录路径。 ⠀ 官方当前要求： ⠀ • Claude Code v2.1.51+ • 使用 claude.ai 登录 • 不是 API key 模式 • Team / Enterprise 需要管理员先在后台启用 Remote Control ⠀ 支持 Remote Control 的订阅计划：Pro、Max、Team、Enterprise。 ⠀ 3.1 推荐先检查这三件事 ⠀ ⠀ ⠀ 确认你已经至少在项目目录里启动过一次 claude，并接受过 workspace trust。 4. 三种启动方式 ⠀ 4.1 方式一：独立服务器模式 ⠀ 这是最纯粹的 Remote Control 方式。 ⠀ ⠀ 它会： ⠀ • 在当前终端进入 server mode • 显示一个会话 URL • 可以按空格显示二维码 • 等待你从别的设备连接 ⠀ 适合： ⠀ • 本地不需要继续敲终端 • 就想把这个会话“挂出来” ⠀ 常用参数 ⠀ ⠀ ⠀ ⠀ ⠀ 这些参数里最值得理解的是： ⠀ • name：远端会话标题 • spawn same dir|worktree|session：并发会话如何创建（默认 same dir） • sandbox / no sandbox：是否启用沙箱 • capacity <N ：最多允许多少个并发会话 ⠀ 在 server mode 运行时，可以按 w 键在 same dir 和 worktree 之间实时切换。 4.2 方式二：本地交互会话 + Remote Control ⠀ 如果你既想保留终端交互，也想让手机或浏览器接入，用这个： ⠀ ⠀ 或者： ⠀ ⠀ 它和 claude remote control 的区别是： ⠀ • 你还能继续在本地终端里正常聊天 • 同时又能从远端设备控制同一个会话 4.3 方式三：在已运行会话里临时开启 ⠀ 如果你已经在 Claude Code 里工作了，不想重启： ⠀ ⠀ 也可以直接命名： ⠀ ⠀ 这会把当前会话历史一起带过去，并展示： ⠀ • 会话 URL • QR 码 ⠀ 适合： ⠀ • 正在做一半才决定“我要换设备继续” 5. 怎么从别的设备连接 ⠀ Remote Control 启动后，官方支持三种常见连接方式： ⠀ 1. 直接打开终端里显示的 URL 2. 扫 QR 码 3. 在 claude.ai/code 或手机 App 的会话列表中找到它 ⠀ 会话标题来自哪里 ⠀ 官方当前的优先级是： ⠀ 1. name / remote control / /remote control 传入的名字 2. /rename 设置的名字 3. 最近一条有意义的消息 4. 自动生成的名字 ⠀ v2.1.92（GitHub Release v2.1.92）