Claude Code Remote Control 怎么用?手机远程控制、官方限制与替代方案(2026)

Claude Code Remote Control 怎么开启?本文给出 claude remote-control、claude --remote-control 和 /remote-control 三种官方用法,说明手机与浏览器连接、账号要求、验证方法和常见报错,并比较自定义模型、Codex、多机器场景下的 PandaNpc 方案。

PandaNpc本文首发于 更新于
A phone and browser securely controlling a Claude Code session running on a development computer
Claude Code stays on the development machine while a phone, browser, or another computer acts as the remote control surface.

最快的官方做法: 把 Claude Code 升级到当前版本,在项目目录运行 claude remote-control, 然后从手机上的 Claude App 或浏览器打开 claude.ai/code,就能启动并控制仍在你电脑上运行的会话。 如果会话已经开着,直接输入 /remote-control;如果还想继续在本地终端里同时操作,用 claude --remote-control。

如果你只使用官方 Claude Code 和 Claude.ai 订阅,优先使用官方 Remote Control。若你使用 API Key、 Bedrock、Vertex、自定义 ANTHROPIC_BASE_URL,或者希望在同一个界面里远程控制 Codex、PandaCode、 DeepSeek harness 和多台开发机,再考虑 PandaNpc。本文把两条路都讲清楚,不需要先猜哪一种适合你。

资料与命令按 Anthropic Remote Control 官方文档核对于 2026 年 8 月 30 日。 Claude Code 更新很快,实际可用命令仍以本机 claude --help 和 /help 为准。

Claude Code Remote Control 三种启动方式

三种命令不是同义词,区别在于你要从哪里开始:

你的场景 命令 会发生什么
想让手机以后随时发起新会话 claude remote-control 启动 server mode,手机或 Web 可以在这台机器上新建会话
想在本地终端和远端同时操作 claude --remote-control 启动正常交互会话,同时把它开放给 Claude App 和 claude.ai/code
当前会话已经运行到一半 /remote-control 或 /rc 保留现有对话历史,生成远程 URL 和手机二维码

官方 Remote Control 的执行仍在本机:项目文件、MCP、工具和配置不会被搬进一个新的云端容器;手机和 浏览器只是远程控制界面。它与 Claude Code on the web 不同,后者运行在 Anthropic 管理的云环境里。

使用官方 Remote Control:从检查到成功连接

第一步:确认版本、登录和工作区

先在开发机执行:

bash
claude --version

官方文档要求 Claude Code v2.1.51 或更新版本。 然后在目标项目目录正常启动一次 claude,完成 /login 和工作区信任确认。Remote Control 使用 Claude.ai 身份;官方当前明确写明 API Key 不支持。 Team 或 Enterprise 组织如果看不到入口,还需要管理员在 Claude Code 管理设置中开启 Remote Control。

第二步:选择一种启动模式

想从手机选择目录并启动新会话,运行:

bash
cd /path/to/project
claude remote-control --name "My Project"

想在开发机终端里继续输入,同时允许手机接管,运行:

bash
cd /path/to/project
claude --remote-control "My Project"

已有会话则直接输入:

text
/remote-control My Project

终端会显示会话 URL;claude remote-control 模式下按空格还可以显示二维码。

第三步:从手机或浏览器连接

使用同一个 Claude 账号:

  • 浏览器打开 https://claude.ai/code,在会话列表里选择带电脑图标的会话;
  • iOS 或 Android 打开 Claude App,进入 Code 标签;
  • 或直接打开终端给出的 URL、扫描二维码。

第一次连接后,先发一个只读验证提示,不要马上批准写文件:

Print the current working directory and show git status --short. Do not modify anything.

路径正确、Git 状态符合预期,并且权限确认能在手机或浏览器出现,才算真正连通。

官方 Remote Control、Claude Code Web 和 PandaNpc 怎么选

需求 官方 Remote Control Claude Code on the web PandaNpc
Agent 在哪里运行 你的电脑 Anthropic 云端环境 你的电脑、服务器或开发容器
远端入口 Claude App、claude.ai/code claude.ai/code iOS、浏览器、桌面端、浏览器插件
本地文件和 MCP 保留 使用云端工作区 保留在运行 Agent 的主机
支持的引擎 Claude Code Claude Code Claude Code、Codex、PandaCode、DeepSeek harness、Pi
认证边界 Claude.ai 登录;API Key 不支持 Claude.ai 登录 使用每个引擎在主机上已有的账号、API 或自定义提供方配置
多机器统一管理 每台 Claude Code 主机分别提供会话 以云端任务为中心 账号下统一显示开发机、服务器和各引擎连接
公网入站端口 不需要 不适用 不需要,主机主动建立出站连接

所以选择很简单:官方能力满足就用官方。 PandaNpc 的价值不是把同一条官方命令再包装一次,而是补上 跨引擎、API/自定义模型、多机器统一管理和设备私网这些场景。

本地主机、认证中继和远程设备之间的出站连接架构
主机和远程设备都主动连接认证中继,不需要开放公网 SSH 或 Agent 端口;代码和工具执行仍留在主机。

官方方案不适用时:用 PandaNpc 远程控制本机 Agent

PandaNpc 的 PandaPaw 运行在开发机旁边,把本机的 Claude Code、Codex 等引擎注册为远程连接。 模型调用仍遵循该引擎自己的账号和提供方配置,远端只负责发送指令、显示结果和处理审批。

第一步:在开发机安装并登录 PandaPaw

macOS / Linux:

bash
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh

Windows 管理员 PowerShell:

powershell
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

安装器会打开浏览器授权页。批准后检查:

bash
pandapaw status

第二步:从 Agent 页面选择主机和项目

浏览器打开 PandaNpc Agent,确认目标机器是绿色在线状态,选择 Claude Code 和正确的项目目录,再发送前面的只读验证提示。手机和桌面客户端使用同一份连接列表。

PandaNpc 侧边栏中的远程 Agent 连接列表
先确认远程主机、Agent 引擎和项目目录,再进入会话并批准工具调用。

如果你只关心 iPhone 上的权限卡、问题卡和 Live Activity,可以继续看 手机连接 Claude Code 的 iOS 工作流。

多台机器和多个 Agent:不要逐台做端口映射

当你只有一台开发机时,一条远程会话就够了;当 Claude Code、Codex 和其他 Agent 分散在台式机、 笔记本、NAS、云服务器或开发容器时,真正的问题变成了主机发现和安全互联。

PandaNpc 的 设备互联 会把账号下的机器加入一张加密私网,为每台机器 分配稳定私有 IP,并自动注册它能运行的 Agent。设备优先点对点连接,无法打洞时回退中继;整个过程不要求 公网 IP 或路由器端口映射。这样手机只需要选择“哪台机器、哪个 Agent、哪个项目”,不需要保存一组 SSH 端口、动态域名和长期密钥。

多台 Windows、macOS 和 Linux 设备的私网地址与在线状态
设备管理页统一显示主机系统、在线状态和私网地址;不再逐台维护公网端口。

这类设备组网解决的是“Agent 彼此能不能安全到达”;任务拆分、上下文共享和结果汇总仍属于多 Agent 编排层,两者不能混为一谈。

常见问题与排错

`claude remote-control` 或 `/remote-control` 不存在

先看 claude --version。主命令至少需要 v2.1.51,VS Code 支持所需版本更高;升级后重新打开终端和 会话。仍然没有时运行 /help,确认组织策略没有关闭 Remote Control。

手机上找不到电脑或会话

确认手机、浏览器和 CLI 登录的是同一个 Claude 账号与组织,并且开发机上的 claude remote-control 进程仍在运行。手机端进入 Code 标签,而不是普通聊天列表。

使用 API Key、Bedrock、Vertex 或自定义网关时无法开启

官方 Remote Control 当前要求 Claude.ai 登录,并明确不支持 API Key。先确认这是不是你必须保留的认证 方式;可以切回订阅登录就用官方,不能切换则使用能连接本机 CLI 的方案,例如 PandaNpc。不要为了远程控制 把生产环境的网关或身份策略悄悄改掉。

电脑能不能关机或合盖

不能。屏幕可以关闭,但运行 Agent 的主机必须保持开机、Claude/PandaPaw 进程必须存活并能联网。 官方 Remote Control 会在主机恢复后自动重连;如果频繁睡眠、切网或出现“在线但不再出消息”,按 Claude Code 远程断线排查清单逐项检查。

多个远程会话会不会修改同一份文件

会有冲突风险。官方 server mode 默认可以从同一目录创建多个会话;需要并行修改时使用 claude remote-control --spawn worktree,让会话获得独立 Git worktree。PandaNpc 中也应为并行 Agent 选择不同工作区或 worktree,不要让两个写入型会话同时操作同一 checkout。

PandaNpc 显示机器离线

在主机执行 pandapaw status,依次确认账号授权、后台服务、出站 HTTPS/WebSocket 和对应引擎登录。 开放一个公网入站端口不能修复被公司代理阻断的出站连接。

安全边界:代码在本地,不等于什么都不经过网络

官方 Remote Control 由本机主动建立出站 HTTPS 连接,不会在路由器上开放入站端口;消息通过 Anthropic API 的 TLS 连接在远端界面和本机会话之间传递。项目文件和工具执行留在主机,但为了显示对话和处理指令, 会话数据仍然需要经过官方服务。

PandaNpc 同样让主机主动连接认证中继,执行留在主机;远端要显示的消息、状态、Diff 和审批会经过中继。 无论使用哪一种方案,都应:

  • 先核对主机和工作目录,再批准写文件或运行命令;
  • 不把远程连接分享给不可信的人;
  • 敏感项目优先使用默认审批或仅接受编辑模式;
  • 公司设备遵守公司批准的 VPN、VDI、身份和审计要求。

FAQ

What is Claude Code Remote Control?

它让 Claude App 或 claude.ai/code 控制仍在你电脑上运行的 Claude Code。手机和浏览器是远程界面, 本地文件、MCP、工具和项目配置继续留在开发机。

How do I use Claude Code from my phone?

在开发机运行 claude remote-control、claude --remote-control,或在已有会话输入 /remote-control; 随后用同一账号打开 Claude App 的 Code 标签或 claude.ai/code。如果还要控制 Codex、自定义模型或多台 主机,可以使用 PandaNpc 的 Agent 页面。

Claude Code Remote Control 支持浏览器吗?

支持。官方入口是 claude.ai/code;PandaNpc 也提供浏览器、iOS 和桌面客户端。两者都让 Agent 在主机上 执行,而不是把整个项目复制到当前浏览器。

Claude Code Remote Control 支持 API Key 吗?

官方当前明确写明不支持 API Key,需要通过 Claude.ai 登录。如果你的 Claude Code 必须使用 API、Bedrock、 Vertex 或自定义 ANTHROPIC_BASE_URL,应保留原有认证并选择能连接本机 CLI 的远程方案。

手机断网后 Claude Code 会停止吗?

只要开发机和 Agent 进程仍在线,手机断网或关闭页面不会等同于停止主机会话。重新连接后可以继续查看。 但开发机睡眠、关机或长时间断网时无法执行新工作。

官方 Remote Control 能控制 Codex 或多个 Agent 吗?

不能,它是 Claude Code 功能。要在同一界面管理 Claude Code、Codex、PandaCode、DeepSeek harness、Pi 以及多台主机,需要额外的多引擎连接层;PandaNpc 的 PandaPaw 和设备互联就是为这个场景设计的。

结论

只想从手机或浏览器继续一条官方 Claude Code 会话:运行 claude remote-control,官方方案最短、最直接。 需要 API/自定义模型、Codex 等其他引擎、多台主机或私有设备组网:保留本机 Agent 配置,通过 PandaPaw 把连接统一放进 PandaNpc。

无论选哪条路,成功标准都不是“页面显示在线”,而是远端能读到正确工作目录、看到真实 Git 状态、收到 权限确认,并且在断线重连后继续同一份本地会话。