命令字典
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
使此会话可从 claude.ai 远程控制
/remote-control(别名 /rc)是一条会话内 slash 命令,作用是将当前正在进行的 Claude Code 交互式会话接入 Remote Control 桥接层,使你可以从 claude.ai/code、Claude iOS App 或 Claude Android App 继续操作同一个会话——对话历史完整保留。
与终端命令 claude remote-control(服务器模式,另起一个新进程)不同,/rc 只在你已经在一个交互式会话内时使用,不接受 --verbose、--sandbox、--no-sandbox 等 flag。
版本与订阅要求(来源:官方文档原文):
| 条件 | 要求 |
|---|---|
| Claude Code 最低版本 | v2.1.51 |
| 支持的订阅 | Pro、Max、Team、Enterprise(不支持 API Key 认证) |
| Team / Enterprise | 需要管理员在 Claude Code 管理设置中开启 Remote Control 开关 |
在会话内直接输入:
/remote-control
或使用别名:
/rc
命令执行后,会话立即接入 Remote Control,终端 footer 区域出现状态指示器,并在对话中输出一个可直接在浏览器中打开的 session URL。
在命令后追加名称参数:
/remote-control My Project
/rc "API Refactor Sprint"
不传名称时,标题按以下优先级自动确定:
--name / --remote-control / /remote-control 的名称/rename 设置的标题<主机名>-<随机词组>,例如 myhost-graceful-unicorn发出第一条新提示后,标题会自动更新为该提示内容(前提是未显式命名)。
Remote Control 激活后,有三种方式从其他设备接入:
/rc 激活后,终端 footer(输入框下方)持续显示状态指示器 /rc active;终端过窄、放不下时会自动隐藏。指示器本身是一个指向 claude.ai 对应会话的链接。连接失败时指示器消失,并弹出带失败原因的通知,重新运行 /remote-control 可重试。
键盘操作:
| 按键 | 效果 |
|---|---|
↓(下方向键)聚焦指示器后按 Enter | 打开状态面板,显示 session URL 和 QR 码 |
重新运行 /remote-control | 同样弹出状态面板 |
如果希望每次启动交互式会话时自动开启 Remote Control,无需每次手动输入 /rc:
/config,找到 Enable Remote Control for all sessions,设置为 true恢复为按需模式:将该项设置回 false。
此设置开启后,每个
claude进程各自注册一个独立的 remote session。若需要单进程服务多个并发会话,应改用终端的服务器模式claude remote-control。
Remote Control 激活期间,Claude 可在任务完成或需要你决策时向手机推送通知(需要 Claude Code v2.1.110+)。
配置步骤:安装 Claude App → 用同一账号登录 → 允许系统通知权限 → 在终端 /config 中开启 Push when Claude decides。
| 约束 | 说明 |
|---|---|
| 每个进程限 1 个 remote session | 交互式进程不支持多 session;多 session 并发需用服务器模式 claude remote-control |
| 本地进程必须持续运行 | 关闭终端、退出 VS Code 或停止 claude 进程均会终止 session |
| 网络中断超过约 10 分钟 | Session 超时,进程自动退出;需重新运行命令 |
| Ultraplan 与 RC 互斥 | 启动 Ultraplan 会断开 Remote Control,因两者共用 claude.ai/code 接口,同时只能一个连接 |
| API Key 认证不可用 | Remote Control 要求 claude.ai OAuth 登录;官方仅列出「不支持 API keys / API key 认证」,ANTHROPIC_API_KEY 存在时需先 unset |
/rc 不接受 flag | --verbose、--sandbox、--no-sandbox 仅在终端命令 claude remote-control 中有效 |
部分命令仅本地可用(从移动端/Web 无法触发):/plugin、/resume 等打开交互式选择器的命令。
可从移动端/Web 使用的命令:/compact、/clear、/context、/usage、/exit、/usage-credits、/recap、/reload-plugins;v2.1.166 起加入 /mcp(返回文本摘要而非打开选择器)。
v2.1.195 改进了 Remote 会话(Claude Code on the web / 云端容器)的启动流程:在后台容器启动期间,前台会展示一份 provisioning checklist(预配置清单),逐项显示容器初始化进度,而不是只给一个无反馈的等待 spinner,让你清楚知道环境正在准备到哪一步。来源:changelog v2.1.195 "Improved Remote session startup with a provisioning checklist while the container starts"。
注意:这里的 "Remote session" 指的是 Anthropic 云端容器(web 版 / 云环境)的启动;与本文主题
/remote-control(把本地会话桥接到手机/浏览器、本地工具仍在本机跑)不是同一回事,只是名字相近。
| 方式 | 入口 | 会话历史 | 本地工具/MCP | 适用场景 |
|---|---|---|---|---|
/remote-control(本文) | 已有交互式会话内 | 携带 | 是 | 在进行中的任务,切换到手机/浏览器继续操控 |
claude --remote-control | 终端启动新会话时加 flag | 新会话 | 是 | 一开始就知道需要远程,边本地边远程 |
claude remote-control | 终端(服务器模式) | 每次连接新建 | 是 | 多人/多设备并发共享,支持 worktree 模式 |
| Claude Code on the web | claude.ai/code(无本地) | 新会话 | 否(云端环境) | 无本地环境,需要 Anthropic 云基础设施 |
| Dispatch | Claude App 主动发消息 | 新任务 | 是(Desktop) | 离开电脑时委派新任务 |
/rc 接通手机,在沙发上查看进度、发出下一步指令,无需重开对话。/rc 挂起本地监控,等推送通知到手机,确认测试通过后直接在 Claude App 发下一条指令。/rc 不出现在 autocomplete 下拉列表中:这是一个已知 UI bug(GitHub issue #30020,已关闭为 not planned)。命令本身功能正常,直接手打 /rc 或 /remote-control 即可触发,不影响使用。
Ultraplan 静默断开 RC 连接:启动 Ultraplan 会立即断开正在活跃的 Remote Control session,且不会有明显警告。若两者都需要使用,注意先完成 RC 会话再开 Ultraplan。
API Key 环境变量导致 RC 不可用:如果 shell 里设置了 ANTHROPIC_API_KEY,Remote Control 会拒绝启动并报错。解决方法:unset ANTHROPIC_API_KEY,然后用 /login 通过 claude.ai OAuth 认证。
Team / Enterprise 用户首次使用报错:Remote Control 在这两个 plan 下默认关闭,需要组织管理员在 claude.ai/admin-settings/claude-code 中手动开启开关,用户侧无法自行绕过。
修复了未登出时的错误信息,现在解释如何登录
修复移动和网络应用中显示错误权限模式
修复连接时留下过时提示的问题
autocomplete 现在在 Remote Control 已激活时显示'Disconnect Remote Control'选项
修复了在gateway和第三方提供商部署上不应出现该命令的问题
[VSCode]新增命令用于桥接session到claude.ai/code在浏览器或手机上继续
添加了可选的 name 参数来设置自定义会话标题(如 `/remote-control My Project`)。