Claude Code 新增远程控制功能,程序员可通过网页直接远程操作开发环境,显著提升开发效率。544 points 热度反映市场刚需。
使用完整的本地环境进行远程操作:你的文件系统、MCP servers、工具和项目配置都保持可用,输入 @ 可以自动补全本地项目的文件路径。
对话和子 agent 及动态 workflow 的进度在所有连接的设备之间同步,你可以从终端、浏览器和手机交替发送消息。在 v2.1.207 之前,由 Desktop app 托管的会话不会向连接的设备发送子 agent 或 workflow 进度。
当你在 Claude app 或 claude.ai/code 中添加附件时,Claude Code 会将其下载到你的机器,并以 @ 文件引用的形式传递给 Claude,可带标题也可不带。在 v2.1.202 之前,Claude Code 可能会丢弃没有标题的附件。
如果你的笔记本电脑休眠或网络断开,会话在你的机器重新上线时会自动重新连接。Claude Code 在连接重建期间将 agent 和 workflow 的状态更新排入队列,并在恢复后传递这些更新。在 v2.1.207 之前,在重新连接或凭证刷新期间发送的更新可能会丢失,因此连接的设备会继续显示已完成的任务为运行中。
可在 Pro、Max、Team 和 Enterprise 计划上使用。不支持 API 密钥。在 Team 和 Enterprise 上,Owner 必须先在 Claude Code 管理设置中启用 Remote Control 切换。
运行 claude 并使用 /login 通过 claude.ai 登录(如果还没有的话)。如果没有符合条件的登录,claude remote-control 会以错误代码退出,而 claude --remote-control 仍然会启动交互式会话,并在启动后不久显示 Remote Control 失败通知。
在 Amazon Bedrock、Google Cloud's Agent Platform 或 Microsoft Foundry 上不可用。从 v2.1.196 开始,当 ANTHROPIC_BASE_URL 指向 api.anthropic.com 以外的主机(例如 LLM gateway 或 proxy)时,Remote Control 也会被禁用。取消设置该变量以使用 Remote Control。
DISABLE_TELEMETRY、DO_NOT_TRACK、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 和 DISABLE_GROWTHBOOK 各自都会禁用 Remote Control 可用性依赖的功能标志评估。在 shell 环境或 settings.json 文件的 env 块中的任何地方取消设置这些变量,以使用 Remote Control。
至少在项目目录中运行一次 claude 以接受工作区信任对话框。启动信任对话框永远不会为你的主目录保存信任,因此请从项目目录启动 Remote Control。
claude remote-control
claude --remote-control
claude --remote-control "My Project"
/remote-control
/remote-control My Project
/remote-control
长时间运行的 turn:当一个 turn 运行时间超过服务器调优的阈值时,会出现一个带有"从你的手机查看"链接的"仍在工作"通知,因此你可以从你的手机或浏览器跟进该 turn,而不用在终端上等待。Claude Code 会在 turn 结束时将其移除。
重复的权限提示:在你对一个会话中的多个权限提示进行应答后,会出现一个"从你的手机批准工具调用"的通知,显示会话 URL。Claude Code 会在你的下一个 turn 开始时将其移除。
打开浏览器中的会话 URL 可直接跳转到 claude.ai/code 上的该会话。
扫描会话 URL 旁边显示的二维码可以直接在 Claude app 中打开它。使用 claude remote-control 时,按空格键可切换二维码显示。
打开 claude.ai/code 或 Claude app,并在会话列表中按名称找到该会话。在 Claude 移动 app 中,点击导航中的 Code 以访问会话列表。Remote Control 会话在联机时会显示带有绿色状态点的计算机图标。
会话名称来自以下来源(按优先级):
--name、--remote-control 或 /remote-control 的名称/rename 设置的标题--remote-control-session-name-prefix 设置的前缀Remote Control 需要满足两个条件:
已注册设备:每个浏览器、手机或 desktop app 成员用于 Remote Control 的都会注册自己的凭证。注册只在完整登录后不久提供,因此设备作为实际身份验证的一部分而不是在后台静默加入受信任列表。
最近登录:成员的登录不超过 18 小时。成员无需每天重新登录,而是使用 Face ID、Touch ID、Windows Hello 或 passkey 来确认存在。这个生物识别步骤立即刷新会话。
打开 Claude Code 管理设置
启用"需要受信任设备"
告知成员预期情况
首次在每台设备上使用:成员被要求注册。如果他们的登录不是最近的,他们首先通过你的正常流程(包括 SSO,如果已配置)登录,然后确认注册。
日常使用:具有已注册设备和最近登录的成员不会看到任何提示。当登录超过 18 小时后,下一个 Remote Control 交互会显示单个 Face ID、Touch ID、Windows Hello 或 passkey 提示。
未注册的设备:在注册该设备之前,无法查看或控制 Remote Control 会话。该设备上的常规 Claude 聊天不受影响。
没有平台认证器:在没有 Face ID、Touch ID 或 Windows Hello 的机器上的成员可以使用硬件安全密钥,或重新登录而不是步骤向上。
在终端中:运行 Claude Code 的机器在开发人员登录 CLI 时会自动接收自己的凭证。终端中没有单独的注册步骤。
安装 Claude 移动 app
用你的 Claude Code 账户登录
在 Claude Code 中启用推送
如果 /config 显示"无手机已注册",请在手机上打开 Claude app,以便它可以刷新其推送令牌。下次 Remote Control 连接时警告将消除。
在 iOS 上,Focus 模式和通知摘要可能会压制或延迟推送。检查"设置" → "通知" → "Claude"。
在 Android 上,激进的电池优化可能会延迟传递。在系统设置中将 Claude app 从电池优化中豁免。
每个交互过程一个远程会话:在 server mode 之外,每个 Claude Code 实例一次支持一个远程会话。使用 server mode 从单个进程运行多个并发会话。
本地进程必须保持运行:Remote Control 作为本地进程运行。如果你关闭终端、退出 VS Code 或以其他方式停止 claude 进程,会话结束。要在断开 SSH 连接后将会话保持在远程机器上运行,请在 tmux 或 screen 内启动它。
网络中断时间过长:如果你的机器已启动但无法访问网络超过大约 10 分钟,会话会超时,进程退出。运行 claude remote-control 再次启动新会话。
Ultraplan 断开 Remote Control:启动 ultraplan 会话会断开任何活跃的 Remote Control 会话,因为两个功能都占用 claude.ai/code 界面,一次只能连接一个。
某些命令仅限本地:仅在终端界面中运行的命令,例如 /plugin 或 /resume,仅从本地 CLI 运行,无论你是否传递参数。以下命令可从移动和网络使用:
文本输出命令:/compact、/clear、/context、/usage、/exit、/usage-credits(打印计费 URL 而不是打开浏览器)、/recap、/reload-plugins
/model、/effort、/fast、/color 和 /rename:传递值作为参数,例如 /model sonnet 或 /effort high。从移动和网络,/model 和 /effort 采用参数代替终端选择器或滑块。
/mcp(从 v2.1.166):从移动 app,返回服务器状态的文本摘要而不是打开选择器。在网络上,/mcp 单独打开 claude.ai 连接器目录而不是返回摘要。reconnect、enable 和 disable 子命令可从两者运行。与本地 CLI 不同,/mcp reconnect 没有服务器名称会重新连接每个失败或需要认证的服务器。
/config(从 v2.1.181):从移动 app,传递 key=value 以设置设置,或无参数运行以列出你可以设置的密钥。在网络上,/config 打开你的设置的 Claude Code 部分,并忽略命令后的文本。
在 Team 和 Enterprise 上,从移动或网络的 /usage-credits 不会向你的管理员发送 usage-credits 请求。发送需要仅在交互式 CLI 中出现的确认,因此该命令告诉你在那里运行它。在 v2.1.211 之前,文本形式在没有确认的情况下发送了请求。
你用 API 密钥或 Console 账户进行了身份验证:Remote Control 需要 claude.ai OAuth。运行 /login 并选择 claude.ai 选项。如果你的环境中设置了 ANTHROPIC_API_KEY,取消设置它。
Owner 尚未为你的组织启用它:Remote Control 在 Team 和 Enterprise 计划上默认关闭。Owner 可以在 claude.ai/admin-settings/claude-code 通过启用 Remote Control 切换来启用它。此切换是服务器端组织设置。
管理切换呈灰显状态:你的组织具有与 Remote Control 不兼容的数据保留或合规性配置。这不能从管理面板中更改。请联系 Anthropic 支持以讨论选项。
错误提到 disableRemoteControl:你的 IT 管理员通过托管设置在此设备上禁用了 Remote Control,独立于组织范围的切换。
运行以下命令查看详细日志:
claude remote-control --verbose
未登录:运行 claude 并使用 /login 通过你的 claude.ai 账户进行身份验证。Remote Control 不支持 API 密钥身份验证。
网络或代理问题:防火墙或代理可能会阻止出站 HTTPS 请求。Remote Control 需要访问端口 443 上的 Anthropic API。
会话创建失败:如果你还看到"会话创建失败 — 查看调试日志",则故障发生在设置早期。检查你的订阅是否有效。
网络版 Claude Code:在 Anthropic 托管的基础设施上运行会话而不是你的机器,通过云环境配置
Ultraplan:从终端启动云规划会话,并在浏览器中查看计划
Channels:将 Telegram、Discord 或 iMessage 转发到会话中,这样 Claude 可以在你离开时对消息做出反应
Dispatch:从你的手机发送任务消息,它可以生成 Desktop 会话来处理
身份验证:设置 /login 并管理 claude.ai 的凭证
CLI 参考:包括 claude remote-control 在内的标志和命令的完整列表
安全性:Remote Control 会话如何融入 Claude Code 安全模型
数据使用:本地和远程会话期间通过 Anthropic API 流动的数据
这个页面有帮助吗?