Claude Code Remote Control完整指南手机、浏览器继续本地会话本课学习目标老金我把 Remote Control 写成辅助协作而不是远程放飞是因为移动端接力也必须有边界。完成本课后你将能理解 Remote Control 和 Claude Code on the Web 的区别正确启动 Remote Control 的三种模式从手机、平板或浏览器继续本地 Claude Code 会话理解并发模式、worktree、sandbox 与权限边界解决 Team / Enterprise 下最常见的启用问题1. 先说结论Remote Control 不是“把你的本地项目同步到云端”而是让claude.ai/code或 Claude 手机 App 变成你本地 Claude Code 会话的远程窗口。核心特点会话继续在你的机器上跑本地文件系统、MCP、配置仍然可用手机 / 浏览器 / 终端可以同时连同一会话适合中途离开工位但不想中断当前任务2. 它和 Claude Code on the Web 有什么区别这是最容易混淆的一点。功能Remote ControlClaude Code on the Web运行位置你的本地机器Anthropic 云端文件系统本地真实项目云端克隆 / 沙箱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 登录路径。官方当前要求Claude Codev2.1.51使用claude.ai 登录不是 API key 模式Team / Enterprise 需要管理员先在后台启用 Remote Control支持 Remote Control 的订阅计划Pro、Max、Team、Enterprise。3.1 推荐先检查这三件事claude--version/login确认你已经至少在项目目录里启动过一次claude并接受过 workspace trust。4. 三种启动方式4.1 方式一独立服务器模式这是最纯粹的 Remote Control 方式。claude remote-control它会在当前终端进入 server mode显示一个会话 URL可以按空格显示二维码等待你从别的设备连接适合本地不需要继续敲终端就想把这个会话“挂出来”常用参数claude remote-control--nameMy Projectclaude remote-control--verboseclaude remote-control--sandboxclaude remote-control--spawnworktree这些参数里最值得理解的是--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或者claude--rc它和claude remote-control的区别是你还能继续在本地终端里正常聊天同时又能从远端设备控制同一个会话4.3 方式三在已运行会话里临时开启如果你已经在 Claude Code 里工作了不想重启/remote-control也可以直接命名/remote-control Auth Fix Session这会把当前会话历史一起带过去并展示会话 URLQR 码适合正在做一半才决定“我要换设备继续”5. 怎么从别的设备连接Remote Control 启动后官方支持三种常见连接方式直接打开终端里显示的 URL扫 QR 码在claude.ai/code或手机 App 的会话列表中找到它会话标题来自哪里官方当前的优先级是--name/--remote-control//remote-control传入的名字/rename设置的名字最近一条有意义的消息自动生成的名字v2.1.92GitHub Release v2.1.92对 Remote Control 默认名的补充以下为 release英文原文便于与官方逐字核对Remote Control session names now use your hostname as the default prefix (e.g.myhost-graceful-unicorn), overridable with--remote-control-session-name-prefix也就是说在未手动命名时默认名会带hostname 前缀也可用 CLI 参数--remote-control-session-name-prefix覆盖该前缀行为。具体与上述 14 条优先级如何叠加以你当前 CLI 行为为准。所以如果你想让手机上更容易认出来最实用的是/rename monorepo-auth-fix6. 并发模式same-dir还是worktree如果 Remote Control 会衍生出多个并发会话你要先选好隔离方式。same-dir所有会话都在同一目录工作配置简单但容易互相改同一批文件worktree每个并发会话单独一个 git worktree更适合并行任务需要 git 仓库如果你准备用 Remote Control 做”多设备继续”而非”多人并发”same-dir足够。如果你打算把它当作多线程工作台优先用worktree。session每个并发会话独立隔离不依赖 git适合不在 git 仓库中的项目运行时切换在 server mode 下按w可以在same-dir和worktree之间实时切换。7. 远端可用命令 vs 仅本地命令不是所有 Claude Code 命令都能在远端界面执行。官方当前清单远端可用手机 / 浏览器都能执行/compact、/clear、/context、/usage、/exit、/usage-credits、/recap、/reload-plugins、/autocompact仅本地必须在终端操作/mcp、/plugin、/resume涉及交互式选择器的命令这意味着你不能在手机上装插件或恢复旧会话但日常的上下文管理和监控都能远程完成。8. Sandbox、权限和安全边界Remote Control 的一个关键误区是远端只是入口真正执行操作的还是你本地机器。所以安全问题本质上仍是本地 Claude Code 权限问题。8.1 官方口径下要注意的点Remote Control 仍继承本地会话的文件、工具和 MCP 能力允许谁连入比“界面在哪”更重要如果本地会话权限很宽远端也会继承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 subscriptionRemote Control is disabled by your organization’s policyUnable to determine your organization for Remote Control eligibilityRemote Control requires a full-scope login tokenRemote Control is not yet enabled for your account9.1 排查顺序先确认你不是 API key 登录再确认管理员已经打开 Claude Code 后台里的 Remote Control 开关确认当前项目已接受 workspace trust检查是否设置了CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC或DISABLE_TELEMETRY环境变量会干扰 RC 连接用/status确认当前登录方式和订阅状态9.2 托管策略forceRemoteSettingsRefreshv2.1.92若组织使用remote managed settings请关注v2.1.92引入的策略项以下为 v2.1.92 release英文原文AddedforceRemoteSettingsRefreshpolicy 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.158v2.1.152 到 v2.1.158 这轮更新里Remote / 后台相关变化主要不是“多一个入口”而是稳定性和可控性增强claude agents可用! command启动可附着的后台 shell命令行等价入口是claude --bg --exec command。/remote-controlautocomplete 会在已连接时显示断开入口Chrome 集成可通过/chrome选择连接的浏览器。后台会话的 stale daemon、pinned session 重启、idle grace、worktree isolation、tmux/Windows IME/终端渲染等问题有多轮修复。stdio MCP 子进程会收到CLAUDE_CODE_SESSION_ID和CLAUDECODE1脚本化排查时可以用这两个环境变量识别调用来源。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.110Push notificationsClaude 可向手机推送通知需在/config中启用 “Push when Claude decides”v2.1.113修复子智能体执行过程不在远端实时显示的问题subagent streamingv2.1.113修复会话退出时未正确归档导致重启后丢失的问题v2.1.116远端支持-file 自动补全和/usage-credits命令v2.1.118-119修复 JWT 刷新期间会话被意外归档的稳定性问题v2.1.121effort.level在远端会话中可用worktree.baseRef控制并发 worktree 分叉来源v2.1.133parentSettingsBehavior影响企业环境下的 RC 启用策略参见 09-企业实战指南其中Push notifications需要额外配置手机安装 Claude AppiOS / Android在 Claude Code 中执行/config启用 “Push when Claude decides”确保手机和 CLI 使用同一账号启用后Claude 在 Remote Control 会话中有重要输出时会主动推送通知到手机。10. 典型使用场景场景 1离开工位继续盯一个长任务你在终端里claude --remote-controldeploy-watch然后去手机上继续看 Claude 跑到哪一步补一句新的指令在沙发上继续盯结果场景 2本地项目必须在线但你要换设备比如本地已有浏览器登录态本地挂着 MCP本地项目环境复杂这时用 Web 新开会话就会丢环境用 Remote Control 就不会。11. 常见问题Q1Remote Control 会把我的代码上传到云端吗不会按“云端沙箱执行”的方式迁移过去。会话仍运行在你的本地机器上远端界面只是连接窗口。Q2API key 登录能用吗不能。当前官方要求是claude.ai登录。Q3Remote Control 和/mobile是什么关系/mobile只是帮助你下载 Claude 手机 App真正开启远程接管的是/remote-control或对应 CLI 入口。Q4我已经在会话里了还能临时开吗可以直接/remote-controlQ5它能替代 Cloud / Desktop scheduled tasks 吗不能。Remote Control 适合”继续一个正在运行的本地会话”不是长期持久调度系统。Q6Ultraplan 模式下能用 Remote Control 吗不能。官方文档明确说明Ultraplan 会断开 Remote Control。如果你需要远程监控避免在 Remote Control 会话中使用 Ultraplan。Q7网络不稳定会怎样短暂断网会自动重连包括笔记本合盖/休眠。但如果网络中断超过约 10 分钟会话会超时断开。Q8能同时开多个 Remote Control 会话吗在 server modeclaude remote-control下可以受--capacity限制默认 32。但在交互模式claude --remote-control下每个交互进程只能有一个 remote session。12. 实用速查# 独立 server modeclaude remote-control# 交互模式直接开 Remote Controlclaude --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 下载二维码/mobile13. 下一步建议想把外部消息直接推到会话中继续看 Channels与计划任务完整指南想理解模型切换、1M context 和opusplan继续看 安装指南中的模型配置章节最后更新2026年6月9日 |适用版本Claude Code v2.1.169
Claude Code Remote Control完整指南手机、浏览器继续本地会话本课学习目标老金我把 Remote Control 写成辅助协作而不是远程放飞是因为移动端接力也必须有边界。完成本课后你将能理解 Remote Control 和 Claude Code on the Web 的区别正确启动 Remote Control 的三种模式从手机、平板或浏览器继续本地 Claude Code 会话理解并发模式、worktree、sandbox 与权限边界解决 Team / Enterprise 下最常见的启用问题1. 先说结论Remote Control 不是“把你的本地项目同步到云端”而是让claude.ai/code或 Claude 手机 App 变成你本地 Claude Code 会话的远程窗口。核心特点会话继续在你的机器上跑本地文件系统、MCP、配置仍然可用手机 / 浏览器 / 终端可以同时连同一会话适合中途离开工位但不想中断当前任务2. 它和 Claude Code on the Web 有什么区别这是最容易混淆的一点。功能Remote ControlClaude Code on the Web运行位置你的本地机器Anthropic 云端文件系统本地真实项目云端克隆 / 沙箱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 登录路径。官方当前要求Claude Codev2.1.51使用claude.ai 登录不是 API key 模式Team / Enterprise 需要管理员先在后台启用 Remote Control支持 Remote Control 的订阅计划Pro、Max、Team、Enterprise。3.1 推荐先检查这三件事claude--version/login确认你已经至少在项目目录里启动过一次claude并接受过 workspace trust。4. 三种启动方式4.1 方式一独立服务器模式这是最纯粹的 Remote Control 方式。claude remote-control它会在当前终端进入 server mode显示一个会话 URL可以按空格显示二维码等待你从别的设备连接适合本地不需要继续敲终端就想把这个会话“挂出来”常用参数claude remote-control--nameMy Projectclaude remote-control--verboseclaude remote-control--sandboxclaude remote-control--spawnworktree这些参数里最值得理解的是--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或者claude--rc它和claude remote-control的区别是你还能继续在本地终端里正常聊天同时又能从远端设备控制同一个会话4.3 方式三在已运行会话里临时开启如果你已经在 Claude Code 里工作了不想重启/remote-control也可以直接命名/remote-control Auth Fix Session这会把当前会话历史一起带过去并展示会话 URLQR 码适合正在做一半才决定“我要换设备继续”5. 怎么从别的设备连接Remote Control 启动后官方支持三种常见连接方式直接打开终端里显示的 URL扫 QR 码在claude.ai/code或手机 App 的会话列表中找到它会话标题来自哪里官方当前的优先级是--name/--remote-control//remote-control传入的名字/rename设置的名字最近一条有意义的消息自动生成的名字v2.1.92GitHub Release v2.1.92对 Remote Control 默认名的补充以下为 release英文原文便于与官方逐字核对Remote Control session names now use your hostname as the default prefix (e.g.myhost-graceful-unicorn), overridable with--remote-control-session-name-prefix也就是说在未手动命名时默认名会带hostname 前缀也可用 CLI 参数--remote-control-session-name-prefix覆盖该前缀行为。具体与上述 14 条优先级如何叠加以你当前 CLI 行为为准。所以如果你想让手机上更容易认出来最实用的是/rename monorepo-auth-fix6. 并发模式same-dir还是worktree如果 Remote Control 会衍生出多个并发会话你要先选好隔离方式。same-dir所有会话都在同一目录工作配置简单但容易互相改同一批文件worktree每个并发会话单独一个 git worktree更适合并行任务需要 git 仓库如果你准备用 Remote Control 做”多设备继续”而非”多人并发”same-dir足够。如果你打算把它当作多线程工作台优先用worktree。session每个并发会话独立隔离不依赖 git适合不在 git 仓库中的项目运行时切换在 server mode 下按w可以在same-dir和worktree之间实时切换。7. 远端可用命令 vs 仅本地命令不是所有 Claude Code 命令都能在远端界面执行。官方当前清单远端可用手机 / 浏览器都能执行/compact、/clear、/context、/usage、/exit、/usage-credits、/recap、/reload-plugins、/autocompact仅本地必须在终端操作/mcp、/plugin、/resume涉及交互式选择器的命令这意味着你不能在手机上装插件或恢复旧会话但日常的上下文管理和监控都能远程完成。8. Sandbox、权限和安全边界Remote Control 的一个关键误区是远端只是入口真正执行操作的还是你本地机器。所以安全问题本质上仍是本地 Claude Code 权限问题。8.1 官方口径下要注意的点Remote Control 仍继承本地会话的文件、工具和 MCP 能力允许谁连入比“界面在哪”更重要如果本地会话权限很宽远端也会继承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 subscriptionRemote Control is disabled by your organization’s policyUnable to determine your organization for Remote Control eligibilityRemote Control requires a full-scope login tokenRemote Control is not yet enabled for your account9.1 排查顺序先确认你不是 API key 登录再确认管理员已经打开 Claude Code 后台里的 Remote Control 开关确认当前项目已接受 workspace trust检查是否设置了CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC或DISABLE_TELEMETRY环境变量会干扰 RC 连接用/status确认当前登录方式和订阅状态9.2 托管策略forceRemoteSettingsRefreshv2.1.92若组织使用remote managed settings请关注v2.1.92引入的策略项以下为 v2.1.92 release英文原文AddedforceRemoteSettingsRefreshpolicy 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.158v2.1.152 到 v2.1.158 这轮更新里Remote / 后台相关变化主要不是“多一个入口”而是稳定性和可控性增强claude agents可用! command启动可附着的后台 shell命令行等价入口是claude --bg --exec command。/remote-controlautocomplete 会在已连接时显示断开入口Chrome 集成可通过/chrome选择连接的浏览器。后台会话的 stale daemon、pinned session 重启、idle grace、worktree isolation、tmux/Windows IME/终端渲染等问题有多轮修复。stdio MCP 子进程会收到CLAUDE_CODE_SESSION_ID和CLAUDECODE1脚本化排查时可以用这两个环境变量识别调用来源。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.110Push notificationsClaude 可向手机推送通知需在/config中启用 “Push when Claude decides”v2.1.113修复子智能体执行过程不在远端实时显示的问题subagent streamingv2.1.113修复会话退出时未正确归档导致重启后丢失的问题v2.1.116远端支持-file 自动补全和/usage-credits命令v2.1.118-119修复 JWT 刷新期间会话被意外归档的稳定性问题v2.1.121effort.level在远端会话中可用worktree.baseRef控制并发 worktree 分叉来源v2.1.133parentSettingsBehavior影响企业环境下的 RC 启用策略参见 09-企业实战指南其中Push notifications需要额外配置手机安装 Claude AppiOS / Android在 Claude Code 中执行/config启用 “Push when Claude decides”确保手机和 CLI 使用同一账号启用后Claude 在 Remote Control 会话中有重要输出时会主动推送通知到手机。10. 典型使用场景场景 1离开工位继续盯一个长任务你在终端里claude --remote-controldeploy-watch然后去手机上继续看 Claude 跑到哪一步补一句新的指令在沙发上继续盯结果场景 2本地项目必须在线但你要换设备比如本地已有浏览器登录态本地挂着 MCP本地项目环境复杂这时用 Web 新开会话就会丢环境用 Remote Control 就不会。11. 常见问题Q1Remote Control 会把我的代码上传到云端吗不会按“云端沙箱执行”的方式迁移过去。会话仍运行在你的本地机器上远端界面只是连接窗口。Q2API key 登录能用吗不能。当前官方要求是claude.ai登录。Q3Remote Control 和/mobile是什么关系/mobile只是帮助你下载 Claude 手机 App真正开启远程接管的是/remote-control或对应 CLI 入口。Q4我已经在会话里了还能临时开吗可以直接/remote-controlQ5它能替代 Cloud / Desktop scheduled tasks 吗不能。Remote Control 适合”继续一个正在运行的本地会话”不是长期持久调度系统。Q6Ultraplan 模式下能用 Remote Control 吗不能。官方文档明确说明Ultraplan 会断开 Remote Control。如果你需要远程监控避免在 Remote Control 会话中使用 Ultraplan。Q7网络不稳定会怎样短暂断网会自动重连包括笔记本合盖/休眠。但如果网络中断超过约 10 分钟会话会超时断开。Q8能同时开多个 Remote Control 会话吗在 server modeclaude remote-control下可以受--capacity限制默认 32。但在交互模式claude --remote-control下每个交互进程只能有一个 remote session。12. 实用速查# 独立 server modeclaude remote-control# 交互模式直接开 Remote Controlclaude --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 下载二维码/mobile13. 下一步建议想把外部消息直接推到会话中继续看 Channels与计划任务完整指南想理解模型切换、1M context 和opusplan继续看 安装指南中的模型配置章节最后更新2026年6月9日 |适用版本Claude Code v2.1.169
