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

最快的官方做法: 把 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:从检查到成功连接
第一步:确认版本、登录和工作区
先在开发机执行:
claude --version官方文档要求 Claude Code v2.1.51 或更新版本。 然后在目标项目目录正常启动一次 claude,完成
/login 和工作区信任确认。Remote Control 使用 Claude.ai 身份;官方当前明确写明 API Key 不支持。
Team 或 Enterprise 组织如果看不到入口,还需要管理员在 Claude Code 管理设置中开启 Remote Control。
第二步:选择一种启动模式
想从手机选择目录并启动新会话,运行:
cd /path/to/project
claude remote-control --name "My Project"想在开发机终端里继续输入,同时允许手机接管,运行:
cd /path/to/project
claude --remote-control "My Project"已有会话则直接输入:
/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/自定义模型、多机器统一管理和设备私网这些场景。

官方方案不适用时:用 PandaNpc 远程控制本机 Agent
PandaNpc 的 PandaPaw 运行在开发机旁边,把本机的 Claude Code、Codex 等引擎注册为远程连接。 模型调用仍遵循该引擎自己的账号和提供方配置,远端只负责发送指令、显示结果和处理审批。
第一步:在开发机安装并登录 PandaPaw
macOS / Linux:
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | shWindows 管理员 PowerShell:
iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex安装器会打开浏览器授权页。批准后检查:
pandapaw status第二步:从 Agent 页面选择主机和项目
浏览器打开 PandaNpc Agent,确认目标机器是绿色在线状态,选择 Claude Code 和正确的项目目录,再发送前面的只读验证提示。手机和桌面客户端使用同一份连接列表。

如果你只关心 iPhone 上的权限卡、问题卡和 Live Activity,可以继续看 手机连接 Claude Code 的 iOS 工作流。
多台机器和多个 Agent:不要逐台做端口映射
当你只有一台开发机时,一条远程会话就够了;当 Claude Code、Codex 和其他 Agent 分散在台式机、 笔记本、NAS、云服务器或开发容器时,真正的问题变成了主机发现和安全互联。
PandaNpc 的 设备互联 会把账号下的机器加入一张加密私网,为每台机器 分配稳定私有 IP,并自动注册它能运行的 Agent。设备优先点对点连接,无法打洞时回退中继;整个过程不要求 公网 IP 或路由器端口映射。这样手机只需要选择“哪台机器、哪个 Agent、哪个项目”,不需要保存一组 SSH 端口、动态域名和长期密钥。

这类设备组网解决的是“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 状态、收到 权限确认,并且在断线重连后继续同一份本地会话。
相关文章

手机连 Claude Code:iOS 上随时查看会话与审批工具
本文面向开发者,分享用手机连 Claude Code 的最佳实践。通过 PandaNpc iOS app 实时查看会话、审批工具调用并回应提问,借助 pandapaw 和 iOS Live Activity 实现高效远程操控,提升编码灵活性。
阅读全文 →
Claude Code 远程断线排查:六种断法的症状、判据和对应解法
Claude Code 远程连接断了,先别急着重连——不同断法的症状不一样,修法也完全不同。本文按「你看到的现象」倒推六种断因(机器睡眠、切网掐长连接、投屏式方案本机必须开着、半死连接、重连丢会话、进程被回收),每种给出确认判据和对应解法,最后是一张可以照着走的排查清单。
阅读全文 →
设备互联:不用公网 IP、不折腾端口映射,随时随地安全直连自己的设备
想在外面用手机或另一台电脑访问家里/公司电脑上的 Claude Code、SSH、内部服务,却卡在没有公网 IP、不敢开端口映射、frp/花生壳配置又烦?设备互联在桌面客户端里一键开启,把你的每台设备加进你专属的加密网络,每台设备拿一个固定私有 IP,无论在哪都像连在同一个局域网一样直连——端到端加密、零公网暴露、随时一键吊销。
阅读全文 →