教程

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 完整指南:本地会话远程控制原理(本地运行+远程窗口)、前置要求(Max 计划/login/工作区信任)、两种启动方式(claude remote-control 命令 vs 会话内 /rc)、三种远程连接方式(URL/QR 码/会话列表)、TLS 出站 HTTPS 安全机制,以及与 Claude Code on the Web 的运行位置/文件系统/MCP 可用性完整对比。2026/3/5教程OpenClaw 手机端完全使用指南:iOS 和 Android 随时随地访问 AI 助手OpenClaw 手机端访问完整教程:手机端的本质(通过 Telegram/WhatsApp 使用 AI,不是独立 App)、iOS 配套 App 的 Node 功能(摄像头/位置/语音)、Android 端使用方式、手机版 WebChat 访问配置、通过 Tailscale 从手机直连 Gateway、手机拍照让 AI 分析、语音唤醒在 iOS 上的工作原理、以及 Telegram Bot 在手机端的最佳使用实践(命令列表/快速回复)。2026/3/21教程OpenClaw 远程访问完全指南:SSH 隧道、Tailscale 与跨设备连接OpenClaw 远程访问所有方案完整教程:SSH 隧道转发(通用方案)、Tailscale 组网(推荐)、三种远程架构对比(VPS always-on/桌面机远程/笔记本本地)、macOS App 的 Remote over SSH 模式、CLI 远程默认配置(openclaw.json gateway.remote 字段)、认证凭据优先级说明、WebSocket 安全规则(loopback-only 原则)、以及 Tailscale Serve 暴露控制面板的完整步骤。2026/3/21教程Claude Code MCP 完整使用指南:安装配置主流 MCP 服务器扩展 AI 能力Claude Code MCP(Model Context Protocol)完整使用指南:MCP 是什么(AI 工具扩展标准)、claude mcp 命令管理服务器(add/remove/list)、主流 MCP 服务器安装配置(文件系统/GitHub/PostgreSQL/Brave Search/Slack)、本地 stdio 与远程 SSE 两种连接方式、MCP 服务器安全配置、在 CLAUDE.md 中声明 MCP 工具使用规范,以及自定义 MCP 服务器的快速开发入门。2026/3/18教程Claude Code 输出格式控制完全指南:JSON、流式、结构化输出使用方法Claude Code 和 Claude API 输出格式完整控制指南:--output-format 参数(text/json/stream-json)、非交互模式(-p)的输出控制、结构化 JSON 输出(--json-schema 字段约束)、流式输出(Server-Sent Events)的处理方式、include-partial-messages 流式渐进显示、以及 CI/CD 管道中解析 JSON 输出的实用技巧。2026/3/18教程Claude Code 项目初始化最佳实践:新项目 5 分钟搭建完美 AI 编程环境Claude Code 新项目最佳初始化流程:CLAUDE.md 标准模板(项目背景/技术栈/代码规范/禁止操作)、.claudeignore 初始配置、.claude/commands/ 常用命令预置、settings.json 权限与模型设置、--init 命令的自动化初始化、项目级 vs 全局配置的优先级说明,以及不同类型项目(Web前端/后端API/全栈/开源库)的专项初始化模板。2026/3/18