教程

Claude Code Remote Control:手机/平板远程控制本地会话、HTTPS 安全连接与 Web 版对比

Claude Code Remote Control 完整指南:核心价值(本地环境全保留/多设备同步/网络中断自恢复)、使用要求(Pro/Max/Team/Enterprise 订阅/不支持 API Key)、三种启动方式(命令行新建 claude remote-control/从已有会话 /remote-control 或 /rc/所有会话默认启用)、标志说明(--name/--verbose/--sandbox)、三种远程连接方式(URL/QR 扫码/会话列表绿色在线点)、安全架构(出站 HTTPS/TLS 加密/短期凭证独立过期)、Remote Control vs Web 版对比表(执行环境/本地文件系统/MCP/关机是否继续),以及三大局限性(每次一个连接/终端保持/10 分钟网络超时)。

2026/3/94分钟 阅读ClaudeEagle

Remote Control 让你从手机、平板或任意浏览器继续本地 Claude Code 会话——代码在你的机器上运行,Web 和移动界面只是「远程窗口」。

核心价值

  • 本地环境全保留:文件系统、MCP 服务器、工具、项目配置一切如常
  • 多设备同步:终端、浏览器、手机可交替发送消息,对话实时同步
  • 网络中断自恢复:笔记本合盖或断网后,重新上线时会话自动重连

使用要求

条件说明
计划Pro、Max、Team、Enterprise 订阅(不支持 API Key)
认证已通过 /login 登录 claude.ai 账号
Workspace trust在项目目录运行过一次 claude,接受 workspace trust 对话框
Teams/EnterpriseAdmin 需在 admin settings 中先启用 Claude Code

三种启动方式

方式一:命令行(新建会话)

bash
cd your-project
claude remote-control
# 或者指定名称
claude remote-control "My Project"
claude remote-control --name "My Project"

进程保持在终端前台运行,等待远程连接。显示:

  • 会话 URL(直接在浏览器打开)
  • 空格键 显示/隐藏 QR 码(用手机扫码直接连接)
  • 终端实时显示连接状态和工具执行活动

可用标志

标志说明
--name "My Project"设置在 claude.ai/code 会话列表中显示的名称
--verbose显示详细连接和会话日志
--sandbox / --no-sandbox启用/禁用沙箱隔离(默认关闭)

方式二:从已有会话转为 Remote(推荐)

如果已经在交互模式下工作,直接转为 Remote 并保留对话历史:

/remote-control # 或带名称 /remote-control My Project # 别名 /rc

注意:/remote-control 命令不支持 --verbose--sandbox--no-sandbox 标志。

方式三:设为所有会话默认启用

/config → 设置 Enable Remote Control for all sessions = true

每个 Claude Code 实例支持同时一个远程会话。运行多个实例时,每个获得独立环境和会话。

从其他设备连接

方式操作
直接打开 URL浏览器访问终端显示的会话 URL,直接跳转到 claude.ai/code 对应会话
扫 QR 码claude remote-control 时按空格显示 QR,用手机扫码在 Claude App 中打开
会话列表在 claude.ai/code 或 Claude App 找到会话名称,Remote Control 会话显示绿色在线点

会话名称来源(按优先级):--name 参数 → 最后一条消息 → /rename 值 → 「Remote Control session」

下载 Claude 移动 App:在 Claude Code 中运行 /mobile 显示 iOS/Android 下载 QR 码。

安全架构

  • 本地 Claude Code 只发出 出站 HTTPS 请求,不开放任何入站端口
  • 启动后向 Anthropic API 注册并轮询任务
  • 远程设备连接时,服务器通过流式连接路由消息
  • 所有流量经 TLS 加密(与常规 Claude Code 会话相同安全级别)
  • 连接凭证:多个短期凭证,每个仅限单一用途,独立过期

Remote Control vs Claude Code on the Web

两者都使用 claude.ai/code 界面,区别在于会话运行位置

特性Remote ControlClaude Code on the Web
执行环境你的本地机器Anthropic 云端基础设施
本地文件系统可访问不可访问
本地 MCP 服务器可用不可用
本地工具和配置保留不保留
关机继续运行不可以(进程终止)可以
适用场景本地工作中途切设备无本地环境/并行任务/共享仓库

局限性

限制说明
每次一个远程连接每个 Claude Code 会话只支持一个远程连接
终端必须保持运行Remote Control 是本地进程,关闭终端即结束会话
网络超时机器在线但无法访问网络超过约 10 分钟,会话超时退出;重新运行 claude remote-control 启动新会话

原文:Remote Control - Claude Code Docs | 来源:Anthropic 官方文档

相关文章推荐

教程Claude Code Remote Control 完整指南:用浏览器界面控制本地终端会话Claude Code Remote Control 完整指南:取本地权限和云端 UI 两者之长;两种启用方式(--remote-control 标志和 /remote-control 命令);4 个核心使用场景(手机远程审查/向同事展示/大屏查看长输出/配合 /diff 可视化);与 Ultraplan/Ultrareview 的互斥关系;/teleport 反向操作(把 Web/iOS 会话拉回本地);/desktop 移交到桌面应用;以及安全注意事项。2026/5/7教程Claude Code Remote Control:从手机或任意浏览器远程控制本地开发环境的完整指南Claude Code Remote Control 完整指南:本地会话远程控制原理(本地运行+远程窗口)、前置要求(Max 计划/login/工作区信任)、两种启动方式(claude remote-control 命令 vs 会话内 /rc)、三种远程连接方式(URL/QR 码/会话列表)、TLS 出站 HTTPS 安全机制,以及与 Claude Code on the Web 的运行位置/文件系统/MCP 可用性完整对比。2026/3/5教程Claude Code Remote Control 详解:用手机或另一台电脑控制本地 AI 编程会话Claude Code Remote Control 完整指南:3 种启动方式(Server/交互/现有会话)、手机扫码连接步骤、实际使用场景,以及与网页版的核心区别、安全机制和常见报错解决方法。2026/4/13教程Claude Code Skills 进阶:动态上下文注入、路径限定激活和 Subagent 集成深度指南Claude Code Skills 三个高级特性深度指南:动态上下文注入(!! 命令预处理原理、内联和多行语法、实战健康检查 Skill 含 6 个命令块、安全注意事项);路径限定自动激活(TypeScript 严格模式/SQL 安全/React 组件三个实战示例);context: fork 在 Subagent 运行(适用场景判断、agent 类型选择);以及三种特性组合的完整 PR 审查 Skill 示例。2026/5/10教程Claude Code Skills 官方完整指南:从入门到高级模式的权威教程Claude Code Skills 官方文档完整中文整理:Skills vs CLAUDE.md 核心区别;目录结构;存储位置和优先级;实时变更检测和 Monorepo 自动发现;完整 Frontmatter 字段参考(20+字段);字符串替换(动态参数);内容类型(参考类 vs 任务类);调用控制表;Skill 内容生命周期(压缩保留机制);三个高级模式(动态注入/路径限定/Subagent运行);以及内置 Bundled Skills 和权限控制方法。2026/5/10教程Claude Code Slack 集成完整指南:团队协作、CI 通知和权限管理Claude Code Slack 集成完整指南:5 大核心功能(频道触发任务/代码问答/CI 通知/PR 审查/Routines 结果推送);安装配置步骤;4 个权限等级(read/write/execute/pr)及频道级配置;人工审批工作流;GitHub Actions + Slack 通知自动化;4 个团队协作场景(新人上手/PM 提需求/频道分工规范/结构化请求模板);以及官方 Slack 集成 vs OpenClaw 方案的对比。2026/5/8