跳到主要內容
maxstudioNews
產品DEV Community (Claude Code)約 9 分鐘

Claude Code 遠端遙控功能:如何啟用與選擇模式

Claude Code 遠端遙控功能讓使用者能從任何裝置(手機、平板或瀏覽器)繼續進行程式開發工作,即使離開電腦,也能透過遠端連線繼續操作。這項功能確保您的程式碼與專案配置仍保留在本地機器上,提供無縫的開發體驗。

Claude Code 遠端遙控功能:如何啟用與選擇模式
圖片來源:DEV Community (Claude Code)

您在辦公桌前開始重構程式碼,卻必須離開。此時測試仍在執行,Claude 也在等待您的決策。您希望透過手機查看進度,而無需將工作轉移到其他伺服器上。這正是 Claude Code 遠端遙控功能所解決的問題。

它將 claude.ai/code 或 iOS/Android 上的 Claude 應用程式,連接到在您本機電腦上持續運行的 Claude Code 會話。您可以從手機、平板或任何瀏覽器接續工作。本指南基於官方文件,我們將以自己的方式解釋,請查閱該頁面以獲取最新詳細資訊。

Claude Code 遠端遙控功能的核心是讓 Claude 始終在您的本機電腦上運行。您的檔案系統、MCP 伺服器、工具和專案配置都保留在您的電腦上,並且在遠端視窗中輸入「@」會自動完成本機專案的路徑。

網頁和行動介面僅是本機會話的視窗。這意味著您的電腦必須保持開啟,且 Claude 程式必須持續運行。如果筆記型電腦進入睡眠模式或網路中斷,Claude Code 會在機器重新連線後自動恢復。

您將獲得:對話、子代理和動態工作流程在終端機、瀏覽器和手機之間保持同步,因此您可以從任何裝置發送訊息。您可以從 Claude 應用程式或 claude.ai/code 附加照片或檔案。

照片會直接傳送給 Claude,而其他檔案則會下載到您的機器上,並作為「@檔案參考」傳遞。

在開始之前,請檢查以下要求:訂閱方案:需要 Pro、Max、Ultra、Team 或 Enterprise 方案,不支援 API 金鑰。對於 Team 和 Enterprise 方案,擁有者必須先在 Claude Code 管理設定中啟用遠端遙控開關。

登入:執行 claude,然後輸入 /login 透過 claude.ai 登入。端點:此功能不適用於 Amazon Bedrock、Google Cloud's Agent Platform 或 Microsoft Foundry。

如果 ANTHROPIC_BASE_URL 指向 api.anthropic.com 以外的主機,或您透過企業 Claude 應用程式閘道登入,也會失敗。

功能旗標:如果設定了 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 或 CLAUDE_CODE_DISABLE_FEATURE_FLAGS,遠端遙控將不可用。單獨允許 DISABLE_TELEMETRY 和 DO_NOT_TRACK,除非您的組織要求信任裝置。此功能需要 Claude Code v2.1.283 或更高版本。

工作區信任:在不受信任的目錄中,claude remote-control 會詢問「信任 <目錄>?[y/N]」。如果其輸入或輸出不是終端機,它會因「工作區不受信任」錯誤而退出。具有零資料保留或 HIPAA 配置的組織無法啟用此功能。

啟動會話有多種入口點,請選擇適合您操作的方式。伺服器模式會運行一個等待遠端連線的程序:執行 claude remote-control,claude rc 則是其別名。

首次使用時,它會詢問「啟用遠端遙控?(y/n)」。然後它會列印一個 URL,您可以按下空白鍵顯示手機用的 QR code。互動會話提供一個正常的終端機會話,同時也支援遠端存取,因此您可以在本機和遠端同時輸入:claude --remote-control 或 claude --remote-control "My Project",--rc 是其簡寫形式。

從現有會話開始則會繼承您的對話歷史記錄:輸入 /remote-control 或 /remote-control My Project,/rc 是其簡寫形式。在 VS Code 擴充功能和 Claude 桌面應用程式中,/remote-control 或 /rc 也適用,但 VS Code 不接受名稱或顯示 QR code。

伺服器模式的旗標參數需在 remote-control 後方使用:--name "My Project" 設定 claude.ai/code 列表中的會話標題;--spawn <mode> 設定生成模式,可選 same-dir(共享目錄)、worktree(每個按需會話一個 Git 工作樹)或 session(精確一個會話)。

--capacity <N> 設定最大並行會話數,預設為 32;--permission-mode <mode> 設定初始權限模式,例如 acceptEdits;--settings <file> 指定 JSON 設定檔路徑(v2.1.321 或更高版本)。

-c 或 --continue 恢復此目錄中上次伺服器啟動的會話;--session-id <id> 透過 ID 恢復單一會話。其他旗標包括 --verbose、--debug-file <path> 和 --[no-]create-session-in-dir。

執行 claude remote-control --help 可列印完整清單。--sandbox 和 --no-sandbox 已在 v2.1.300 中移除,現在會導致伺服器錯誤退出。若要沙盒化會話,請在設定檔中開啟沙盒功能。在 same-dir 或 worktree 模式下,在伺服器終端機中按下 w 可在兩者之間切換,您切換到的模式將成為該專案的預設設定。

一旦會話啟用,您有三種連線方式:在任何瀏覽器中開啟 Claude Code 顯示的 URL。掃描 QR code 以在 Claude 應用程式中開啟。

開啟 claude.ai/code 或 Claude 應用程式,並依名稱尋找會話。在行動應用程式中,點擊「Code」。線上會話會顯示一個帶有綠點的電腦圖示。

如果您尚未安裝應用程式,請在 Claude Code 內部執行 /mobile 以獲取一個 QR code,該 QR code 會開啟正確的應用程式商店。在互動會話中,一個 /rc active 指示器會連結到該會話。再次執行 /remote-control 可查看 URL、QR code 和中斷連線選項。

停止伺服器後恢復會話:使用 Ctrl+C 停止 claude remote-control 會使其會話停止響應。在相同目錄中,claude remote-control 會恢復所有會話,--continue 僅恢復第一個會話,而 --session-id <id> 則按 ID 恢復單一會話。

此功能在伺服器停止後約四小時內有效。對於使用 claude --remote-control 或 /remote-control 啟動的會話,請使用 claude --continue 或 claude --resume 恢復。

自動連線與推播通知:遠端遙控功能僅在您要求時啟動。若要連線所有互動會話,請執行 /config 並設定「Enable Remote Control for all sessions」,或在 ~/.claude/settings.json 中將 remoteControlAtStartup 設定為 true。

已提交的專案設定檔無法開啟此功能,但可以透過 false 將其關閉。若要接收手機推播通知,請安裝 Claude 應用程式,使用相同帳戶登入,允許通知,然後在 /config 中啟用「Push when Claude decides」或「Push when actions required」。

如果 /config 顯示「No mobile registered」,請在手機上開啟應用程式以重新整理其推播權杖。

安全性:您的會話僅發出 HTTPS 出站請求,絕不開啟入站埠。所有流量都透過 TLS 經由 Anthropic API 傳輸。

連線期間,對話記錄會儲存在 Anthropic 伺服器上,以便裝置保持同步並允許會話重新連線。執行和檔案存取仍保留在本機。disableRemoteControl 設定可完全關閉此功能。信任裝置(Trusted Devices)是一項可選的 Beta 功能,要求已註冊的裝置和不超過 18 小時的登入記錄,才能查看或操控會話。

遠端遙控或其他選項:遠端遙控和雲端會話共用 claude.ai/code 介面,但雲端會話運行在雲端基礎設施上。當您正在進行本機工作時,請使用遠端遙控。

當您不需要本機設定、尚未複製儲存庫或需要並行任務時,請使用雲端會話。文件還比較了 Dispatch(從行動應用程式發送任務,在桌機上運行)、Channels(從聊天應用程式推播事件)、Slack、自託管環境和排程任務。遠端遙控是從其他裝置操控進行中工作的最佳選擇。

常見問題:命令因錯誤退出:請使用 /login 登入。如果沒有符合資格的登入,claude remote-control 會退出,而 claude --remote-control 則會啟動並顯示失敗通知。

互動會話中連線失敗:執行 /remote-control 重新連線,除非原因顯示其他連線已接管或會話已在其他地方結束。完全不可用:檢查上述的端點和功能旗標變數。

Claude Code 專案範例:如果您想在 Claude Code 中嘗試一個專案,可以查看我們開源儲存庫中免費的代理技能「Roller Diner Hero」。這是一個網站主視覺,包含五秒鐘的生成影片,內容是一位穿著薄荷綠制服、戴著紙帽的泰迪熊女服務生,在陽光普照的 1950 年代餐廳中溜冰。

餐廳內有紅色卡座、鍍鉻高腳凳和棋盤格地板,她手裡托著一個裝有櫻桃派和奶昔的托盤。她身後有一個紅色的手寫字和一個巨大的奶油色「UP!」,她被從每一幀中剪下並繪製在它們之上。

周圍還有膠囊導航、一張蓋有「PAID」印章的帳單卡、一個星爆徽章和一個滾動的跑馬燈。您的代理會用您的文字和連結編寫一個 hero.json;建構過程會檢查每個長度並編寫一個頁面和一個嵌入,錄影機則會製作一個帶有聲音的 1080p MP4 影片。

您可以透過 npx skills add lookbkdev/lookbk-skills --skill roller-diner-hero 安裝,或使用 /plugin marketplace add lookbkdev/lookbk-skills 和 /plugin install roller-diner-hero@lookbk-skills。

請參閱安裝指南、技能頁面和儲存庫。這篇文章是在 AI 協助下撰寫,並根據技能的 SKILL.md 進行了檢查。

Share

覺得值得一看?分享給朋友。

以上為 AI 自動翻譯導讀。原文版權歸 DEV Community (Claude Code) 所有, 建議透過「閱讀原文」前往原始網站,以取得最完整資訊並支持原作者。

Newsletter

不用每天追,AI 重點每週寄給你

43 個來源、每 2 小時更新,太多看不完。電子報每週挑最值得看的幾則,附上 Max 的看法。

每週一封。Email 只用來寄電子報,每封信都能一鍵退訂。