Claude Code Remote Control：2026 年如何用 QR code 在手機上寫程式

更多操作說明請參閱 Ailoot 文件。

Remote Control 是什麼？為什麼要用手機寫程式？#

Anthropic 在 2026 年 2 月 24 日推出 Remote Control。Anthropic 將它描述為能從任何裝置繼續本機工作階段的方式。

簡單來說：像平常一樣在終端機啟動工作階段，接著開啟 Remote Control。在手機上開啟 Claude app → Code 分頁 → 就會看到帶有綠點的工作階段。點一下，就能閱讀並回覆。你可以任意搭配使用筆電、手機和瀏覽器撰寫內容，所有裝置都會同步。

Remote Control 官方文件 區分了本機執行與網路傳輸：指令及檔案系統操作在你的電腦執行，對話則透過 Anthropic 同步。

這是它與 Claude Code on the web 的主要差異；後者的工作階段會在 Anthropic 雲端 VM 上執行。使用 Remote Control 時，Claude 仍在你的硬體上運作，能使用你的所有 Git 儲存庫、環境變數和資料庫金鑰。手機只是讓你與 Claude 對話的螢幕。

為什麼氛圍編碼者可能會需要它

以下是作者每週都會使用的三種實際情境：

1. 通宵執行大型重構。 交代 Claude 為新 API 更新 40 個檔案，然後離開筆電。早上躺在沙發上用手機檢視差異，並說：「接受前 12 個；其餘的分開給我看。」不必打開筆電。
2. 通勤途中核准步驟。 你在地鐵上時，Claude 推播通知：「需要你決定資料綱要遷移方案。」打開通知，閱讀兩個選項，然後寫下：「採用第一個選項；不要動測試。」你搭車時，工作階段會繼續進行。
3. 同時觀看直播或參加會議。 Zoom 會議期間，你可以用手機確認第二個 Claude 工作階段是否已經建好測試版本，不必切換離開視訊通話。

執行 Remote Control 需要什麼#

完整需求表：

使用以下指令檢查版本：

claude --version

如果低於 2.1.51，請更新：

npm install -g @anthropic-ai/claude-code@latest

如果環境中設定了 ANTHROPIC_API_KEY、CLAUDE_CODE_OAUTH_TOKEN 或 apiKeyHelper，Remote Control 就無法啟動。從 v2.1.139（11.05.2026）起，Anthropic 明確規定，只要存在這些變數，就會封鎖此功能。執行 unset ANTHROPIC_API_KEY，然後再次透過 /login 登入。

如何啟動 Remote Control：2 分鐘內的 3 種方式#

方法 1. 伺服器模式——專用的遠端工作階段伺服器

1. 在專案資料夾中開啟終端機

   執行一次 cd，前往要工作的目錄。如果是新資料夾，像平常一樣執行 claude，完成 Workspace Trust 對話框。

2. 啟動伺服器

   claude remote-control
   

   終端機會保持執行。底部會顯示工作階段 URL 和「Press space to show QR」提示。伺服器正在等待連線。

3. 從手機連線

   按 Space，QR code 就會出現。用 Claude app 或 iPhone 相機掃描，即可開啟工作階段。

選用：設定工作階段名稱和參數：

claude remote-control --name "Refactor API" --spawn worktree --capacity 4

• --name — 在手機工作階段清單中顯示的名稱。
• --spawn worktree — 每個新工作階段都會在自己的 Git worktree 中開啟，避免平行工作階段互相干擾。
• --capacity 4 — 伺服器上同時執行的遠端工作階段上限為 4 個。預設值為 32。

方法 2. 互動模式——在我的工作階段上啟用 Remote Control

claude --remote-control
# 或較短的寫法：
claude --rc

這會在終端機啟動一般互動式工作階段，並啟用 Remote Control。你可以同時透過筆電和手機與 Claude 對話；整段對話會在同一個工作階段中同步。

與伺服器模式不同，這只有一個工作階段。如果你大多時候會在電腦上工作，只想在離開座位時用手機備用，這種方式很適合。

方法 3. 在使用中的工作階段輸入 /rc

已經在 Claude Code 中工作了嗎？不必結束工作階段，只要輸入：

/remote-control

或較短的寫法：

/rc

工作階段就會轉為遠端模式，而且不會遺失上下文。如果你在任務進行到一半時才發現需要離開，這種方式很有用。

QR code：10 秒內連接手機#

1. 安裝 Claude app

   如果還沒有安裝，請在 Claude Code 輸入 /mobile。畫面會出現 QR code，讓你從 App Store 或 Google Play 下載 app。這比手動搜尋更快。

2. 在終端機顯示工作階段 QR code

   執行 claude --rc 或 claude remote-control 後，按 Space。QR code 會直接顯示在終端機中。

3. 用手機掃描

   開啟 Claude app → 相機，或使用標準的 iPhone 相機（Android 相機也能掃描）。如果掃描失敗，請放大終端機視窗、改用 iTerm2 或 Windows Terminal，或複製 QR code 上方的 URL，手動貼到瀏覽器中。

4. 啟用推播通知

   在工作階段輸入 /config，並啟用「Push when Claude decides」。Claude Code 必須是 2.1.110 以上版本。

手機上會看到什麼

Claude app 會開啟 Code 分頁。工作階段會出現在清單中，旁邊有電腦圖示和綠點（在線上）。點一下即可進入。

之後就像使用 claude.ai/code 一樣：你可以查看 Claude 的訊息和檔案差異、核准或拒絕，也可以要求修改。你可以提出新的要求。內容都會送到你的電腦，由本機 Claude 處理並回傳答覆。

Claude 的推播通知功能

Claude 會在判斷有需要時傳送推播通知。預設情況下有兩種：長時間任務完成，或 Claude 需要你做決定。你也可以明確要求：「測試通過時通知我」，它就會傳送通知。

如果沒有收到推播通知：

• iOS：檢查「設定」→「通知」→「Claude」。專注模式可能會讓通知靜音。
• Android：關閉 Claude app 的電池最佳化。
• 如果 /config 顯示「No mobile registered」，請至少開啟一次 Claude app，讓它更新推播權杖。

在沙發上工作：5 種實用情境#

情境 1. 在沙發上檢視通宵執行的結果

睡前交代 Claude 一項任務，例如：「用新的 lint 規則檢查整個儲存庫，修正所有非關鍵問題，剩下的標記為 TODO。」執行 claude --rc，並讓終端機保持開啟。

早上拿著手機躺在沙發上。開啟 Claude app → 找到帶有綠點的工作階段 → 看到裡面有 87 個 commit 的差異。逐一檢視，對有疑慮的地方寫下「還原這個；我會手動修正」，對沒有問題的地方則說「全部接受」。早上 7 點不必「走到筆電前」。

情境 2. 通勤途中核准遷移步驟

早上開始執行耗時很長的資料庫綱要遷移。9:30 在地鐵上收到推播：「找到兩種遷移方案，需要你決定。」點開通知閱讀，選一個方案，再補充：「完整測試執行完畢前，不要刪除舊資料表。」Claude 就會繼續執行。

沒有 Remote Control 的話，Claude 會在那裡停下來，默默等待。等你抵達並打開筆電時，已經浪費了 40 分鐘。

情境 3. 離開座位也能繼續——午餐期間執行長時間任務

午餐前，請 Claude「更新所有端點的文件」，然後前往咖啡館。25 分鐘後收到推播：「完成了，請檢查。」點一下「接受」，然後繼續喝湯。沒有 Remote Control 的話，你不是得在筆電前坐 25 分鐘盯著它，就是回來後才發現 Claude 遇到需要決定的地方，整段時間什麼也沒做。

這一點很重要。Remote Control 不會讓 Claude 更自主，它只是讓你可以從任何地方連上它。Claude 遇到的決策點越少，你收到的推播通知就越少。因此，任務指示要寫得更具體：「照這種方式做；遇到這些情況時，就那樣做；如果真的不清楚，就停下來傳送推播。」

情境 4. 在咖啡館做架構決策

Claude 在重構途中找到兩種遷移方式，並請你選擇。如果你不在電腦旁，就用手機開啟提議的差異，選一個選項，再加上註解：「但不要動 user_settings 資料表——我下週會刪掉它。」工作階段會繼續進行。

在 worktree 模式（--spawn worktree）下尤其好用：每個平行任務都在自己的分支，不會互相干擾。你可以在手機上像切換聊天室一樣切換工作階段。

情境 5. 同時執行多個 worktree 工作階段

一種強大的做法是結合伺服器模式和多個 worktree。在筆電上啟動：

claude remote-control --spawn worktree --capacity 4

從手機開始不同分支中的工作階段：一個建立新功能，另一個修正清單中的錯誤，第三個執行回歸測試。它們都會在筆電上平行執行，彼此不會阻塞。

安全性：哪些內容留在你的電腦，哪些會被傳送#

連接敏感專案之前，先決定哪些內容可進入提示與工具輸出，並把正式環境機密放在代理可存取環境之外；資料傳輸表不能證明某個工作階段絕不洩漏機密。

簡單來說：你的筆電會詢問 Anthropic：「有訊息要給我嗎？」收到回覆後，就在本機處理。外部沒有人能開啟連入連接埠連到你的電腦。公司防火牆不需要特別設定就能允許這項連線。

實際傳送至 Anthropic 的內容

Remote Control 增加同步介面，並非離線推論模式。Anthropic 會依資料使用政策儲存連線工作階段的對話紀錄，包括訊息、回覆與工具活動。請同時審查傳給模型的資料，以及已連線裝置的存取權。

憑證說明

換句話說，多個短效權杖會在你的筆電、Anthropic 和手機之間流通，而不是使用一個長效權杖。即使其中一個遭到入侵，也不代表攻擊者能取得所有權杖。

還有一項重要限制：Remote Control 不支援 --dangerously-skip-permissions。每次工具呼叫（Bash、Write、Edit）仍需要等待你核准。這是刻意設計的，目的是避免手機功能變成「無人監督、自動駕駛的筆電」。

啟動 Remote Control 後，調整設定，別讓 Claude 每 10 分鐘打斷你一次#

/rc 是讓你透過手機查看工作階段的便利方式。但如果 Claude 每 10 分鐘就寫「我不懂該怎麼做」，問題不在手機，而在於你一開始是否清楚設定規則，這就是上下文工程。

6 個首次執行時的問題及解決方法#

問題 1.「Remote Control environments are not available for your account」

這是 anthropics/claude-code 儲存庫中最常見的抱怨（issue #29449，以及十多個重複回報）。你對「enable Remote Control?」回答 y 後，CLI 回傳錯誤，之後也不再提供重試選項。

原因幾乎都一樣：環境中設定了 ANTHROPIC_API_KEY 或 CLAUDE_CODE_OAUTH_TOKEN。Remote Control 只能透過 /login 進行完整 OAuth 登入，不能使用金鑰。

解決方法：

unset ANTHROPIC_API_KEY
unset CLAUDE_CODE_OAUTH_TOKEN
unset apiKeyHelper

# 檢查環境是否乾淨：
env | grep -i anthropic
env | grep -i claude

# 再次登入：
claude
/logout
/login

透過瀏覽器完成 /login 後，Remote Control 應該就能啟動。

問題 2. 手機無法掃描 QR code

手機相機對準 QR code 後沒有反應，或顯示「無法讀取」。

原因：你的終端機顯示的 QR code 太小或對比度不足。

解決方法：

1. 將終端機視窗放大至全螢幕。
2. 如果使用 Apple Terminal，請改用 iTerm2（或 Warp）。如果使用 Windows，請使用 Windows Terminal，而不是 CMD。
3. 將終端機字體縮小 1–2 點，讓 QR code 顯示得更大。
4. 如果仍然無效，請複製 QR code 上方的 URL，並在手機瀏覽器中開啟。

問題 3. 防火牆封鎖連接埠 443

這通常發生在使用攔截流量的 Proxy（Zscaler 或含 MITM 的企業 VPN）的公司電腦上。

解決方法：先啟用詳細記錄，擷取具體錯誤：

claude remote-control --verbose

如果看到「certificate verification failed」，代表有 MITM 攔截，需要聯絡網路管理員。如果看到「connection refused」／「timeout」，請管理員允許對外存取 *.anthropic.com:443。

問題 4. Claude Code 版本太舊

檢查：

claude --version

如果低於 2.1.51，請更新：

npm install -g @anthropic-ai/claude-code@latest

VS Code 擴充功能至少需要 v2.1.79。推播通知需要 v2.1.110。

問題 5. 沒有收到推播通知

情況：Remote Control 正常運作，但 Claude 完成長時間任務時，手機沒有任何通知。

檢查清單：

1. 在工作階段執行 /config。如果顯示「No mobile registered」，請至少在手機上開啟一次 Claude app，讓它更新推播權杖。
2. iOS：「設定」→「通知」→「Claude」→ 確認通知已啟用，且沒有被專注模式靜音。
3. Android：開啟電池設定，將 Claude 排除在電池最佳化之外。
4. 如果 iOS 的「通知摘要」已開啟，推播可能已送達，但會出現在每小時的摘要中。請關閉 Claude 的通知摘要。

問題 6. Claude Desktop 讓 /remote-control 無法使用

如果你在 Claude Desktop app 中執行 /remote-control，會看到「Remote Control requires a full-scope login token」錯誤（GitHub issue #48378）。

原因：Claude Desktop 注入了權限受限的 OAuth 權杖（僅供推論使用）。

解決方法：在一般的系統終端機中執行 Claude Code，不要使用 Claude Desktop 內建的終端機。這是已知限制，Anthropic 正在修正。

額外問題：長時間工作階段的自動重新連線會悄悄停止

症狀：Remote Control 工作階段執行 30–60 分鐘後，手機會在沒有任何提示的情況下悄悄斷線（issue #34255）。手動修復方式：/remote-control → Disconnect → 再次啟動。這不太理想，但這項功能仍處於研究預覽階段。

光是 2026 年 5 月，Anthropic 就為 Remote Control 推出了八項專屬修正——這項功能正積極改善中。你可以提出意見；合理預期大多數問題會在幾個月內消失。

Remote Control、Telegram 機器人和 SSH+tmux 的比較#

比較表

什麼時候該選哪種方式

• Remote Control —「離開筆電，繼續指揮工作」的預設做法。提供完整 UI、裝置同步，且不需要第三方服務。
• Channels（Telegram 機器人） — 當你想讓 CI 失敗、新的客戶抱怨或聊天訊息自動提示 Claude 展開調查時使用。這是「事件 → Claude 回應」，而不是「我用手機指揮 Claude」。詳情請參閱 Telegram 與 Claude Code 指南。
• SSH + tmux — 當你需要在手機上使用任意 Shell 執行自己的指令時使用，例如部署版本、查看記錄或重新啟動服務。這是 Claude Code 以外的通用 Shell。一次性任務可透過 Termux／Blink 使用。
• 其他程式設計代理 — Anthropic Remote Control 僅供 Claude Code 使用。Claude 與替代方案的比較請參閱 Cursor 與 Claude Code 比較。

因此，Anthropic 官方文件依照用途區分這兩項功能：Remote Control 用於控制；Channels 用於回應事件。

Remote Control 在 2026 年 5 月至 2026 年 6 月的新變更#

完整修正時間表：

一個月內有八項 Remote Control 專屬修正，對研究預覽階段的功能來說很常見。Anthropic 顯然正在回應使用者意見，並修補各種邊緣案例。

如果這項功能的運作不太正常，第一步是檢查版本並更新。問題很可能已經修正。

檢查清單：5 分鐘內完成設定並開始使用#

1. 檢查 Claude Code 版本

   執行 claude --version，版本應為 2.1.51 或更新版本。如果不是，請執行 npm install -g @anthropic-ai/claude-code@latest。

2. 從環境中移除 API 金鑰

   執行 unset ANTHROPIC_API_KEY 和 unset CLAUDE_CODE_OAUTH_TOKEN。接著透過瀏覽器執行 /logout → /login。

3. 在手機上安裝 Claude app

   在 Claude Code 工作階段中執行 /mobile，顯示 App Store／Google Play 的下載 QR code。

4. 啟動 Remote Control

   執行 claude --rc，或在工作階段中輸入 /rc。畫面會出現 URL 和「Press space to show QR」提示。

5. 用手機掃描 QR code

   在終端機按 Space → 使用相機或 Claude app。如果無法掃描，請放大終端機視窗。

6. 啟用推播通知

   /config →「Push when Claude decides」。如果顯示「No mobile registered」，請至少開啟一次 Claude app。

7. 開始長時間任務，然後離開座位

   把提示寫得具體：「照這種方式做；在這些情況下採取那種做法；遇到不確定的情況就傳送推播。」然後透過手機和推播通知繼續工作。

在一個實際案例中，從零開始到在沙發上進行第一次對話，花了 3–5 分鐘。

準備好後，來認識 Ailoot 吧。