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

> 逐步說明如何使用 /rc 和 QR code 將 Claude Code 連接到手機。涵蓋指令、限制、安全性，以及 6 個常見的首次執行錯誤。

Source: https://ailoot.ai/blog/zh-hant-tw/claude-code-remote-control-phone/
Canonical: https://ailoot.ai/blog/zh-hant-tw/claude-code-remote-control-phone/
Language: zh-Hant-TW
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-052
Revision: sha256-65400a642c1cee3f9e36b1ee06c179b0ddb967e392f67a95cb0125e18ef46a98


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

本節重點

在終端機執行 `claude --rc`，按 Space，然後用手機上的 Claude app 掃描 QR code。工作階段會在筆電上執行；手機只是查看它的視窗。它適合夜間執行任務及在沙發上工作，但不適合認真編輯程式碼。你需要 v2.1.51 以上版本，以及 Pro 或 Max 訂閱。

</div>



更多操作說明請參閱 [Ailoot 文件](https://ailoot.ai/docs/)。

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

本節重點

Remote Control 是筆電上的 Claude Code 與手機上的 Claude app 或 claude.ai/code 瀏覽器之間的橋接功能。工作階段在你的電腦上執行；手機只是操作介面。指令執行與本機工具留在電腦上；訊息或工具結果所包含的內容仍會經過 Anthropic。當你安排了長時間任務，又想繼續指揮它、不必一直坐在筆電前時，就會需要這項功能。

</div>

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

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

[Remote Control 官方文件](https://code.claude.com/docs/en/remote-control#connection-and-security) 區分了本機執行與網路傳輸：指令及檔案系統操作在你的電腦執行，對話則透過 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 需要什麼

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

本節重點

你需要 Claude Code 2.1.51 以上版本，以及 Pro、Max、Team 或 Enterprise 訂閱。API 金鑰無法使用。網路必須能透過連接埠 443 對外連線，且不能經過攔截流量的 Proxy。在終端機透過 claude.ai 執行一次 `/login` 登入後，就能開始使用。Team／Enterprise 方案還需要管理員在組織設定中啟用開關。

</div>

完整需求表：

| 項目 | 最低版本／需求 |
|----|----|
| Claude Code CLI | v2.1.51（發布日期 24.02.2026） |
| VS Code 擴充功能 | v2.1.79 |
| 推播通知 | v2.1.110 |
| 訂閱方案 | Pro、Max、Team 或 Enterprise |
| API 金鑰 | 無法使用——僅限透過 `/login` 進行 OAuth 登入 |
| 網路 | 透過連接埠 443 對外進行 HTTPS 連線 |
| OS | macOS、Linux、WSL |
| 工作區信任 | 至少在專案資料夾中執行一次 `claude` |
| Team／Enterprise | 管理員已在管理設定中啟用 Remote Control |

使用以下指令檢查版本：

```bash
claude --version
```

如果低於 2.1.51，請更新：

```bash
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 種方式

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

本節重點

啟動 Remote Control 有三種方式：不帶其他參數的 `claude remote-control` 指令會啟動遠端工作階段伺服器；`claude --rc` 旗標會啟動已啟用 Remote Control 的一般工作階段；在使用中的工作階段輸入 `/rc` 斜線指令，則會將它轉換為遠端工作階段。對多數任務而言，第二種方式較方便。

</div>

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

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

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

2.  #### 啟動伺服器

    ```bash
    claude remote-control
    ```

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

3.  #### 從手機連線

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

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

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

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

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

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

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

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

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

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

```
/remote-control
```

或較短的寫法：

```
/rc
```

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

## QR code：10 秒內連接手機

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

本節重點

在終端機啟動 Remote Control 後，按 Space 顯示 QR code。用手機（iOS 或 Android）開啟 Claude app，也可以直接使用相機掃描。工作階段會在 app 或 claude.ai/code 瀏覽器中開啟。在 app 的同一個畫面中，工作階段會出現在清單裡，旁邊的綠點表示它「在線上」。

</div>

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 處理並回傳答覆。

<figure>
<blockquote>
<p>你可以同時透過兩種介面工作：對話會在所有已連線的裝置間同步——你可以隨意從終端機、瀏覽器或手機輸入內容。</p>
</blockquote>
<figcaption>— Anthropic Docs, https://code.claude.com/docs/en/remote-control</figcaption>
</figure>

### Claude 的推播通知功能

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

如果沒有收到推播通知：

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

本節重點

Remote Control 真正的好處，是不必為了按一下核准按鈕而回到筆電前。沒有人打算用手機做完整的程式開發。以下是作者每週都會使用的五種情境：檢視通宵執行的結果、在地鐵上核准步驟、午餐期間執行長時間任務、在咖啡館做架構決策，以及在 worktree 中執行平行工作階段。

</div>

### 情境 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。在筆電上啟動：

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

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

<div class="aside" data-semantic="callout" role="note" aria-label="Attention">

注意

伺服器模式的資源用量會隨同時執行的工作階段數量增加。使用 16 GB RAM 時，同時執行四個 Claude 工作階段就會明顯感受到負載。請依照電腦的負荷能力決定執行數量。

</div>

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

本節重點

聊天訊息和工具結果會經過 Anthropic，其中可能包含原始碼或機密。本機執行不會阻止這類資訊外洩。連線只會透過連接埠 443 向外建立，使用短效憑證，並以 TLS 加密。筆電不會開啟任何連入連接埠，遠端手機也無法直接存取你的檔案系統。

</div>

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

<figure>
<blockquote>
<p>本機 Claude Code 工作階段只會發出對外 HTTPS 要求，絕不會在你的電腦上開啟連入連接埠。啟動 Remote Control 時，工作階段會向 Anthropic API 註冊，並輪詢 API 以取得工作。</p>
</blockquote>
<figcaption>— Anthropic Docs, https://code.claude.com/docs/en/remote-control</figcaption>
</figure>

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

### 實際傳送至 Anthropic 的內容

| 資料類型 | 所在位置 |
|----|----|
| 原始碼檔案 | 儲存在本機；對話中包含的片段與差異仍會傳送 |
| `.env`、機密資料、API 金鑰 | 若被讀入提示或工具結果便可能外洩；本機儲存不是存取限制 |
| 本機 MCP 伺服器及其設定 | 在本機執行；回傳內容可能進入對話 |
| Claude 連線的資料庫 | 留在設定的主機上；查詢結果可能進入對話 |
| 你傳給 Claude 的訊息文字 | Anthropic API，之後會收到回覆 |
| Claude 回覆的文字 | Anthropic API，之後傳到你的手機 |
| Claude 顯示給你的檔案差異 | 透過 Anthropic API（與一般 Claude.ai 工作階段相同） |
| 透過 `@` 匯入的圖片和檔案 | 透過 Anthropic API |

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

### 憑證說明

<figure>
<blockquote>
<p>連線會使用多個短效憑證，每個憑證各有一種用途，效期也彼此獨立。</p>
</blockquote>
<figcaption>— Anthropic Docs, https://code.claude.com/docs/en/remote-control</figcaption>
</figure>

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

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

<div class="aside" data-semantic="callout" role="note" aria-label="Note">

註記

如果你需要完全自主的運作方式（「Claude 自己決定並連續工作 14 小時，不需要核准」），那是另一項功能：`/goal` 模式。請閱讀 [Claude Code 的 /goal 指南](https://ailoot.ai/blog/zh-hant-tw/goal-mode-claude-code-codex/)。Remote Control 的用途不同：讓你可以從任何地方指揮工作，但不會增加自主性。

</div>

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

本節重點

Remote Control 本身只解決了一半的問題：它讓你可以透過手機查看工作階段。另一半是設定 Claude 知道什麼時候該停下來詢問，什麼時候可以自行繼續。你可以透過 CLAUDE.md、任務開始時的詳細提示，以及 `/goal` 模式來設定。這樣一來，只有在重要時刻才會收到推播，而不是每 10 分鐘一次。

</div>

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



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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

本節重點

首次連線最常見的問題有：「Remote Control environments are not available」——因為設定了 API 金鑰；QR code 太小，手機無法掃描；防火牆封鎖連接埠 443；Claude Code 版本太舊；推播通知沒有聲音；或是在 Claude Desktop 中使用 Remote Control 失敗。每個問題都能在 1–2 分鐘內修好。

</div>

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

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

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

**解決方法：**

```bash
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 後沒有反應，或顯示「無法讀取」。

<strong>原因：</strong>你的終端機顯示的 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）的公司電腦上。

<figure>
<blockquote>
<p>網路或 Proxy 問題：防火牆或 Proxy 可能會封鎖對外 HTTPS 要求。Remote Control 必須能透過連接埠 443 存取 Anthropic API。</p>
</blockquote>
<figcaption>— Anthropic Docs, https://code.claude.com/docs/en/remote-control</figcaption>
</figure>

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

```bash
claude remote-control --verbose
```

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

### 問題 4. Claude Code 版本太舊

檢查：

```bash
claude --version
```

如果低於 2.1.51，請更新：

```bash
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）。

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

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

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

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

本節重點

Remote Control 是操作本機 Claude 工作階段的官方同步視窗。透過 Anthropic Channels 使用 Telegram 機器人，則是由「外部事件提示 Claude」的回應式管道。用手機連線的 SSH+tmux 是通用 Shell，但 Mac 進入睡眠時會斷線，而且在 6 吋螢幕上檢視差異非常吃力。依照任務選擇：用 Remote Control 指揮工作階段，用 Channels 回應事件，需要任意 Shell 時則用 SSH+tmux。

</div>

### 比較表

| 項目 | Remote Control | Channels（TG／Discord） | SSH + tmux |
|----|----|----|----|
| 由誰啟動 | 我開啟工作階段 | 外部事件觸發 Claude | 我連線 |
| 介面 | 完整的 claude.ai/code UI | 聊天訊息 | 手機上的終端機 |
| 工作階段執行位置 | 我的電腦 | 我的電腦 | 伺服器 |
| 檢視差異 | 方便（原生 UI） | 在聊天中以文字顯示 | 字體極小 |
| CLI 支援 | 僅限 Claude Code | 透過機器人執行任何指令 | 任何指令 |
| 價格 | 包含於 Pro／Max | 免費（Channels 外掛） | 免費 |
| 網路中斷時的反應 | 自動重新連線 | 回應式（推播） | 切換時會斷線 |
| 工作階段結束時機 | 關閉終端機／網路中斷超過 10 分鐘 | 機器人持續執行 | tmux 會保留工作階段 |

### 什麼時候該選哪種方式

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

<figure>
<blockquote>
<p>Channels：從 Telegram 或 Discord 等聊天 app，或你自己的伺服器接收推播事件。適合回應外部事件，例如 CI 失敗或聊天訊息。</p>
</blockquote>
<figcaption>— Anthropic Docs, https://code.claude.com/docs/en/remote-control</figcaption>
</figure>

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

本節重點

在一個半月內，Anthropic 為 Remote Control 推出了八項專屬修正與改進：環境中存在 API 金鑰時封鎖功能；修正權杖輪替期間 MCP 連接器的重新導向問題；在達到上限時，以適當的升級提示取代「Opening your options」；以固定顯示的頁尾膠囊取代啟動訊息；修正 SDK 工作階段中的推播通知；以及在首次連線時顯示適當的錯誤訊息。截至 2026 年 6 月 3 日，目前版本為 2.1.162。

</div>

完整修正時間表：

| 版本 | 日期 | 變更內容 |
|----|----|----|
| v2.1.51 | 24.02.2026 | 首次推出 Remote Control |
| v2.1.79 | 2026 年 3 月 | 支援 VS Code 擴充功能 |
| v2.1.110 | 2026 年 4 月 | 推播通知成為正式功能 |
| v2.1.126 | 01.05.2026 | 達到速率限制時，以適當升級提示取代空白的「Opening your options...」 |
| v2.1.139 | 11.05.2026 | 存在 `ANTHROPIC_API_KEY` 或 `apiKeyHelper` 時封鎖 Remote Control |
| v2.1.140 | 12.05.2026 | 管理設定會使用強制重新整理的權杖重試 401 |
| v2.1.141 | 13.05.2026 | 修正工作執行階段權杖輪替期間因 401 導致的 MCP 連接器失敗 |
| v2.1.149 | 22.05.2026 | 修正 SDK 工作階段中錯誤顯示「Mobile push not sent」的問題 |
| v2.1.151 | 27.05.2026 | Remote Control 改為固定顯示的頁尾膠囊 |
| v2.1.152 | 27.05.2026 | 修正 `/remote-control` 停在「connecting...」的問題 |
| v2.1.154 | 28.05.2026 | 已啟用時，自動完成會顯示「Disconnect」 |
| v2.1.162 | 03.06.2026 | 目前版本；全面改進指標、平行工具處理等功能 |

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section takeaway">

本節重點

若要讓 Remote Control 第一次就可靠運作，請完成以下七個步驟。它們能處理 90% 的首次執行問題，並讓你在啟動後五分鐘內，透過手機核准第一則推播通知。

</div>

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 分鐘。

<div class="section" role="doc-bibliography" aria-label="Sources">

### 來源

- [透過 Remote Control 從任何裝置繼續本機工作階段 - Claude Code Docs](https://code.claude.com/docs/en/remote-control) — Anthropic 官方文件，也是指令、需求和限制的主要來源。
- [Claude Code Changelog](https://code.claude.com/docs/en/changelog) — 從 2.1.51 到 2.1.162 的版本紀錄，包含所有 Remote Control 修正。

</div>





準備好後，來認識 [Ailoot](https://ailoot.ai/) 吧。

## 常見問題：Claude Code Remote Control：2026 年如何用 QR code 在手機上寫程式

### Remote Control 能讓整段對話都不經過雲端嗎？

不能。指令和檔案系統操作在本機執行，但訊息、回覆、差異和工具活動會透過 Anthropic 同步。內容若包含程式碼片段或機密，這些資料仍可能離開電腦。

### 使用 Remote Control 時為什麼電腦必須保持開機？

手機只是電腦上 Claude Code 程序的操作介面。該程序必須持續執行，電腦也必須可連線；開啟手機 app 不會把本機執行環境搬到雲端 VM。


## Ailoot · 公司及其專案組合

Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。

公司及其專案組合：數百萬客戶，每月銷售額達數十億。

Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。