本課學(xué)習(xí)目標(biāo)

老金我把 Remote Control 寫成輔助協(xié)作，而不是遠(yuǎn)程放飛，是因?yàn)橐苿?dòng)端接力也必須有邊界。

完成本課后，你將能：

1. 理解 Remote Control 和 Claude Code on the Web 的區(qū)別
2. 正確啟動(dòng) Remote Control 的三種模式
3. 從手機(jī)、平板或?yàn)g覽器繼續(xù)本地 Claude Code 會(huì)話
4. 理解并發(fā)模式、worktree、sandbox 與權(quán)限邊界
5. 解決 Team / Enterprise 下最常見的啟用問題

1. 先說結(jié)論

Remote Control 不是“把你的本地項(xiàng)目同步到云端”，而是：

讓 claude.ai/code 或 Claude 手機(jī) App 變成你本地 Claude Code 會(huì)話的遠(yuǎn)程窗口。

核心特點(diǎn)：

• 會(huì)話繼續(xù)在你的機(jī)器上跑
• 本地文件系統(tǒng)、MCP、配置仍然可用
• 手機(jī) / 瀏覽器 / 終端可以同時(shí)連同一會(huì)話
• 適合中途離開工位但不想中斷當(dāng)前任務(wù)

2. 它和 Claude Code on the Web 有什么區(qū)別

這是最容易混淆的一點(diǎn)。

如果你已經(jīng)在終端里干了一半活，想躺沙發(fā)繼續(xù)看、繼續(xù)發(fā)指令，用 Remote Control。

如果你想新開一個(gè)云端任務(wù)，不依賴本地運(yùn)行環(huán)境，用 Claude Code on the Web。

3. 使用前提

v2.1.139+ 登錄方式限制：如果當(dāng)前會(huì)話通過 ANTHROPIC_API_KEY、apiKeyHelper 或 ANTHROPIC_AUTH_TOKEN 走 API key / helper 登錄，Remote Control、/schedule、claude.ai MCP connectors 和 notification preferences 會(huì)被禁用。要使用遠(yuǎn)控和計(jì)劃能力，優(yōu)先使用支持這些能力的 Claude.ai 登錄路徑。

官方當(dāng)前要求：

• Claude Code v2.1.51+
• 使用 claude.ai 登錄
• 不是 API key 模式
• Team / Enterprise 需要管理員先在后臺啟用 Remote Control

支持 Remote Control 的訂閱計(jì)劃：Pro、Max、Team、Enterprise。

3.1 推薦先檢查這三件事

claude --version

/login

確認(rèn)你已經(jīng)至少在項(xiàng)目目錄里啟動(dòng)過一次 claude，并接受過 workspace trust。

4. 三種啟動(dòng)方式

4.1 方式一：獨(dú)立服務(wù)器模式

這是最純粹的 Remote Control 方式。

claude remote-control

它會(huì)：

• 在當(dāng)前終端進(jìn)入 server mode
• 顯示一個(gè)會(huì)話 URL
• 可以按空格顯示二維碼
• 等待你從別的設(shè)備連接

適合：

• 本地不需要繼續(xù)敲終端
• 就想把這個(gè)會(huì)話“掛出來”

常用參數(shù)

claude remote-control --name "My Project"

claude remote-control --verbose

claude remote-control --sandbox

claude remote-control --spawn worktree

這些參數(shù)里最值得理解的是：

• --name：遠(yuǎn)端會(huì)話標(biāo)題
• --spawn same-dir|worktree|session：并發(fā)會(huì)話如何創(chuàng)建（默認(rèn) same-dir）
• --sandbox / --no-sandbox：是否啟用沙箱
• --capacity <N>：最多允許多少個(gè)并發(fā)會(huì)話

在 server mode 運(yùn)行時(shí)，可以按 w 鍵在 same-dir 和 worktree 之間實(shí)時(shí)切換。

4.2 方式二：本地交互會(huì)話 + Remote Control

如果你既想保留終端交互，也想讓手機(jī)或?yàn)g覽器接入，用這個(gè)：

claude --remote-control

或者：

claude --rc

它和 claude remote-control 的區(qū)別是：

• 你還能繼續(xù)在本地終端里正常聊天
• 同時(shí)又能從遠(yuǎn)端設(shè)備控制同一個(gè)會(huì)話

4.3 方式三：在已運(yùn)行會(huì)話里臨時(shí)開啟

如果你已經(jīng)在 Claude Code 里工作了，不想重啟：

/remote-control

也可以直接命名：

/remote-control Auth Fix Session

這會(huì)把當(dāng)前會(huì)話歷史一起帶過去，并展示：

• 會(huì)話 URL
• QR 碼

適合：

• 正在做一半才決定“我要換設(shè)備繼續(xù)”

5. 怎么從別的設(shè)備連接

Remote Control 啟動(dòng)后，官方支持三種常見連接方式：

1. 直接打開終端里顯示的 URL
2. 掃 QR 碼
3. 在 claude.ai/code 或手機(jī) App 的會(huì)話列表中找到它

會(huì)話標(biāo)題來自哪里

官方當(dāng)前的優(yōu)先級是：

1. --name / --remote-control / /remote-control 傳入的名字
2. /rename 設(shè)置的名字
3. 最近一條有意義的消息
4. 自動(dòng)生成的名字

v2.1.92（GitHub Release v2.1.92）對 Remote Control 默認(rèn)名的補(bǔ)充（以下為 release 英文原文，便于與官方逐字核對）：

Remote Control session names now use your hostname as the default prefix (e.g. myhost-graceful-unicorn), overridable with --remote-control-session-name-prefix

也就是說：在未手動(dòng)命名時(shí)，默認(rèn)名會(huì)帶 hostname 前綴；也可用 CLI 參數(shù) --remote-control-session-name-prefix 覆蓋該前綴行為。具體與上述 1～4 條優(yōu)先級如何疊加，以你當(dāng)前 CLI 行為為準(zhǔn)。

所以如果你想讓手機(jī)上更容易認(rèn)出來，最實(shí)用的是：

/rename monorepo-auth-fix

6. 并發(fā)模式：same-dir還是worktree

如果 Remote Control 會(huì)衍生出多個(gè)并發(fā)會(huì)話，你要先選好隔離方式。

same-dir

• 所有會(huì)話都在同一目錄工作
• 配置簡單
• 但容易互相改同一批文件

worktree

• 每個(gè)并發(fā)會(huì)話單獨(dú)一個(gè) git worktree
• 更適合并行任務(wù)
• 需要 git 倉庫

如果你準(zhǔn)備用 Remote Control 做”多設(shè)備繼續(xù)”而非”多人并發(fā)”，same-dir 足夠。

如果你打算把它當(dāng)作多線程工作臺，優(yōu)先用 worktree。

session

• 每個(gè)并發(fā)會(huì)話獨(dú)立隔離
• 不依賴 git
• 適合不在 git 倉庫中的項(xiàng)目

運(yùn)行時(shí)切換

在 server mode 下，按 w 可以在 same-dir 和 worktree 之間實(shí)時(shí)切換。

7. 遠(yuǎn)端可用命令 vs 僅本地命令

不是所有 Claude Code 命令都能在遠(yuǎn)端界面執(zhí)行。官方當(dāng)前清單：

遠(yuǎn)端可用（手機(jī) / 瀏覽器都能執(zhí)行）：

/compact、/clear、/context、/usage、/exit、/usage-credits、/recap、/reload-plugins、/autocompact

僅本地（必須在終端操作）：

/mcp、/plugin、/resume（涉及交互式選擇器的命令）

這意味著你不能在手機(jī)上裝插件或恢復(fù)舊會(huì)話，但日常的上下文管理和監(jiān)控都能遠(yuǎn)程完成。

8. Sandbox、權(quán)限和安全邊界

Remote Control 的一個(gè)關(guān)鍵誤區(qū)是：

遠(yuǎn)端只是入口，真正執(zhí)行操作的還是你本地機(jī)器。

所以安全問題本質(zhì)上仍是本地 Claude Code 權(quán)限問題。

8.1 官方口徑下要注意的點(diǎn)

• Remote Control 仍繼承本地會(huì)話的文件、工具和 MCP 能力
• 允許誰連入，比“界面在哪”更重要
• 如果本地會(huì)話權(quán)限很寬，遠(yuǎn)端也會(huì)繼承

8.2 傳輸安全

官方當(dāng)前的安全架構(gòu)：

• 所有流量走 HTTPS/TLS，經(jīng)由 Anthropic API 中轉(zhuǎn)
• 你的機(jī)器不會(huì)打開任何入站端口
• 使用多個(gè)短期、單一用途、獨(dú)立過期的憑據(jù)

8.3 建議做法

• 涉及高風(fēng)險(xiǎn)倉庫時(shí)，優(yōu)先配合 sandbox
• 高風(fēng)險(xiǎn)任務(wù)不要順手開 bypassPermissions
• 給 Remote Control 會(huì)話顯式命名，避免誤連錯(cuò)會(huì)話

9. Team / Enterprise 常見阻塞

Team 和 Enterprise 下，Remote Control 默認(rèn)可能是關(guān)閉的。

你可能看到這類報(bào)錯(cuò)：

• Remote Control requires a claude.ai subscription
• Remote Control is disabled by your organization’s policy
• Unable to determine your organization for Remote Control eligibility
• Remote Control requires a full-scope login token
• Remote Control is not yet enabled for your account

9.1 排查順序

1. 先確認(rèn)你不是 API key 登錄
2. 再確認(rèn)管理員已經(jīng)打開 Claude Code 后臺里的 Remote Control 開關(guān)
3. 確認(rèn)當(dāng)前項(xiàng)目已接受 workspace trust
4. 檢查是否設(shè)置了 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 或 DISABLE_TELEMETRY 環(huán)境變量（會(huì)干擾 RC 連接）
5. 用 /status 確認(rèn)當(dāng)前登錄方式和訂閱狀態(tài)

9.2 托管策略：forceRemoteSettingsRefresh（v2.1.92）

若組織使用 remote managed settings，請關(guān)注 v2.1.92 引入的策略項(xiàng)（以下為 v2.1.92 release 英文原文）：

Added forceRemoteSettingsRefresh policy setting: when set, the CLI blocks startup until remote managed settings are freshly fetched, and exits if the fetch fails (fail-closed)

含義：開啟后，CLI 在成功拉取到最新遠(yuǎn)程托管設(shè)置之前不會(huì)啟動(dòng)；若拉取失敗則 直接退出（fail-closed）。具體在項(xiàng)目/企業(yè)配置中的寫法，以官方托管設(shè)置文檔與你方管理員下發(fā)的 schema 為準(zhǔn)，本教程不臆造 JSON 示例。

9.3 更高版本增強(qiáng)（v2.1.93 → v2.1.158）

v2.1.152 到 v2.1.158 這輪更新里，Remote / 后臺相關(guān)變化主要不是“多一個(gè)入口”，而是穩(wěn)定性和可控性增強(qiáng)：

• claude agents 可用 ! <command> 啟動(dòng)可附著的后臺 shell，命令行等價(jià)入口是 claude --bg --exec '<command>'。
• /remote-control autocomplete 會(huì)在已連接時(shí)顯示斷開入口，Chrome 集成可通過 /chrome 選擇連接的瀏覽器。
• 后臺會(huì)話的 stale daemon、pinned session 重啟、idle grace、worktree isolation、tmux/Windows IME/終端渲染等問題有多輪修復(fù)。
• stdio MCP 子進(jìn)程會(huì)收到 CLAUDE_CODE_SESSION_ID 和 CLAUDECODE=1，腳本化排查時(shí)可以用這兩個(gè)環(huán)境變量識別調(diào)用來源。

v2.1.92 之后的版本對 Remote Control 做了一系列增強(qiáng)和修復(fù)（以下版本號經(jīng) GitHub Release Notes 逐條核實(shí)）：

其中 Push notifications 需要額外配置：

1. 手機(jī)安裝 Claude App（iOS / Android）
2. 在 Claude Code 中執(zhí)行 /config
3. 啟用 “Push when Claude decides”
4. 確保手機(jī)和 CLI 使用同一賬號

啟用后，Claude 在 Remote Control 會(huì)話中有重要輸出時(shí)會(huì)主動(dòng)推送通知到手機(jī)。

10. 典型使用場景

場景 1：離開工位繼續(xù)盯一個(gè)長任務(wù)

你在終端里：

claude --remote-control "deploy-watch"

然后去手機(jī)上繼續(xù)：

• 看 Claude 跑到哪一步
• 補(bǔ)一句新的指令
• 在沙發(fā)上繼續(xù)盯結(jié)果

場景 2：本地項(xiàng)目必須在線，但你要換設(shè)備

比如：

• 本地已有瀏覽器登錄態(tài)
• 本地掛著 MCP
• 本地項(xiàng)目環(huán)境復(fù)雜

這時(shí)用 Web 新開會(huì)話就會(huì)丟環(huán)境，用 Remote Control 就不會(huì)。

11. 常見問題

Q1：Remote Control 會(huì)把我的代碼上傳到云端嗎？

不會(huì)按“云端沙箱執(zhí)行”的方式遷移過去。會(huì)話仍運(yùn)行在你的本地機(jī)器上，遠(yuǎn)端界面只是連接窗口。

Q2：API key 登錄能用嗎？

不能。當(dāng)前官方要求是 claude.ai 登錄。

Q3：Remote Control 和/mobile是什么關(guān)系？

/mobile 只是幫助你下載 Claude 手機(jī) App；真正開啟遠(yuǎn)程接管的是 /remote-control 或?qū)?yīng) CLI 入口。

Q4：我已經(jīng)在會(huì)話里了，還能臨時(shí)開嗎？

可以，直接：

/remote-control

Q5：它能替代 Cloud / Desktop scheduled tasks 嗎？

不能。Remote Control 適合”繼續(xù)一個(gè)正在運(yùn)行的本地會(huì)話”，不是長期持久調(diào)度系統(tǒng)。

Q6：Ultraplan 模式下能用 Remote Control 嗎？

不能。官方文檔明確說明 Ultraplan 會(huì)斷開 Remote Control。如果你需要遠(yuǎn)程監(jiān)控，避免在 Remote Control 會(huì)話中使用 Ultraplan。

Q7：網(wǎng)絡(luò)不穩(wěn)定會(huì)怎樣？

短暫斷網(wǎng)會(huì)自動(dòng)重連（包括筆記本合蓋/休眠）。但如果網(wǎng)絡(luò)中斷超過約 10 分鐘，會(huì)話會(huì)超時(shí)斷開。

Q8：能同時(shí)開多個(gè) Remote Control 會(huì)話嗎？

在 server mode（claude remote-control）下可以，受 --capacity 限制（默認(rèn) 32）。但在交互模式（claude --remote-control）下，每個(gè)交互進(jìn)程只能有一個(gè) remote session。

12. 實(shí)用速查

# 獨(dú)立 server mode
claude remote-control
# 交互模式直接開 Remote Control
claude --remote-control
# 交互中臨時(shí)開啟
/remote-control
# 給會(huì)話命名
/remote-control release-monitor
# v2.1.92+：默認(rèn)會(huì)話名帶 hostname 前綴；可用 --remote-control-session-name-prefix 覆蓋（參數(shù)掛載在哪個(gè)子命令上以 claude --help 為準(zhǔn)）
# 所有會(huì)話自動(dòng)開啟 Remote Control（在 /config 中設(shè)置）
/config
# 查看登錄狀態(tài)和訂閱信息
/status
# 手機(jī) App 下載二維碼
/mobile

13. 下一步建議

• 想把外部消息直接推到會(huì)話中：繼續(xù)看 Channels與計(jì)劃任務(wù)完整指南
• 想理解模型切換、1M context 和 opusplan：繼續(xù)看 安裝指南中的模型配置章節(jié)

到此這篇關(guān)于Claude Code Remote Control完整指南：手機(jī)、瀏覽器繼續(xù)本地會(huì)話(最新整理)的文章就介紹到這了,更多相關(guān)Claude Code Remote Control指南內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論