你將學到什麼

本指南將帶領你了解遠端使用 Claude Code 的每一種方法——從 Anthropic 官方的 Remote Control 功能到使用 tmux、mosh 和 Tailscale 的 DIY SSH 設置。在本指南結束時，你將擁有一個可運行的行動編碼環境，讓你在桌面電腦上啟動任務後，離開辦公室，並透過手機保持完全控制。

---

Claude Code Remote Control：2026 完整指南

在 February 25, 2026，Anthropic 發佈了 Remote Control —— 讓你在終端機啟動編碼任務後，將筆記型電腦放進包包，並透過手機保持完全控制。無需 VPN，無需連接埠轉發 (port forwarding)，也無需第三方工具。Source

但官方功能只是故事的一部分。開發者社群圍繞著 Claude Code 建立了一個完整的行動編碼生態系統，從簡單的 SSH 隧道到包含推送通知和語音輸入的複雜多工具工作流。本指南將涵蓋所有這些內容。

---

Part 1: 官方 Remote Control

它是什麼

Remote Control 是 Anthropic 內建的功能，用於在不同設備上延續 Claude Code 會話。它的工作原理是讓你本地的 Claude Code 實例向 Anthropic API 註冊為伺服器，然後允許授權的客戶端（你的手機）遠端連線並控制該會話。Source

底層運作機制

安全性模型簡單且保守：

你的桌面 (Claude Code)           Anthropic API            你的手機 (Claude App)
        │                                │                          │
        ├──── 註冊會話 ──────────────────►│                          │
        │                                │                          │
        │◄─── 分配會話 URL ──────────────┤                          │
        │                                │                          │
        │     顯示 QR code               │                          │
        │                                │◄──── 掃描 QR / 驗證 ─────┤
        │                                │                          │
        │◄─── 路由訊息 ──────────────────┤──── 路由訊息 ───────────►│
        │                                │                          │
        │     (所有流量經由 TLS)         │                          │

關鍵安全特性：

• 無入站連接埠 (No inbound ports) — 你的本地機器僅發出出站 HTTPS 請求
• 無直接連線 — 你的手機永遠不會直接連線到你的桌面電腦
• TLS 加密 — 所有流量都經由 TLS 通過 Anthropic API
• 會話範圍限制 — 每個 Remote Control 會話都有一個會話唯一的 URL，且會過期

Source

設置步驟

Step 1: 更新 Claude Code

Remote Control 需要 Claude Code v2.1.51 或更高版本：

# Check your version
claude --version

# Update if needed
npm update -g @anthropic-ai/claude-code

Step 2: 開始會話

正常開始你的專案工作：

cd ~/projects/my-app
claude

Step 3: 啟用 Remote Control

在你的 Claude Code 會話中運行：

/rc
# or
/remote-control

這將啟動 Remote Control 伺服器。你的終端機將顯示：

Remote Control active
Session URL: https://code.claude.com/rc/abc123-def456
Press [space] to show QR code
Press [q] to stop Remote Control

Step 4: 從手機連線

兩個選項：

1. QR Code: 在終端機按空格鍵顯示 QR code。打開手機上的 Claude app 並掃描它。
2. URL: 複製會話 URL 並在手機的 Claude app 中打開。

你的手機現在擁有 Claude Code 會話的完全控制權。你可以發送訊息、批准文件更改並查看輸出——對話在所有連接的設備上保持同步。Source

預設啟用 Remote Control

如果你頻繁使用 Remote Control，可以為所有會話啟用它：

/mobile

如果你尚未安裝 Claude app，這將顯示安裝用的 QR code，並將「Enable Remote Control for all sessions」設置切換為 true。一旦啟用，每個 Claude Code 會話都會自動以 Remote Control 模式啟動。Source

方案要求

方案	價格	Remote Control
Free	$0	不可用
Pro	$20/month	可用
Max	$100–200/month	可用
Team	Custom	可用
Enterprise	Custom	可用

Source

Remote Control 的限制

• 需要 Claude app — 你不能使用一般的瀏覽器；必須使用 Claude 行動應用程式
• 依賴 Anthropic — 所有流量都通過 Anthropic 的伺服器；如果他們的 API 離線，Remote Control 就會失效
• 不支援離線 — 兩台設備都必須具備網路連線
• 會話超時 — 閒置的會話最終會過期
• 單一供應商 — 僅適用於 Claude 模型，如果你正在使用 OpenCode 或其他多供應商工具則不適用

---

Part 2: SSH + tmux + mosh (DIY 方法)

對於希望獲得完整終端機控制權、多供應商支持或在不穩定網路下工作的開發者來說，基於 SSH 的方法更為穩健。正如開發者 Harper Reed 所寫：「當思考如何透過手機使用 Claude Code 時，明顯的答案是從手機 ssh 進入電腦並運行 claude。」Source

為什麼需要這三種工具？

你需要兩種不同類型的韌性：

• mosh 處理不穩定的行動網路連線——WiFi 到行動網路的切換、收訊死角、手機休眠
• tmux 處理會話持久性——即使你的手機完全斷開連線，也能保持 Claude Code 會話運行

兩者結合，使行動開發真正變得可行。Source

設置技術棧

Step 1: 安裝 Tailscale (私人網路)

Tailscale 在你的設備之間建立一個私有的 WireGuard 網狀網路 (mesh)。無需連接埠轉發，無需設定路由器，也無需防火牆規則。

在你的桌面電腦上：

# macOS
brew install tailscale

# Linux
curl -fsSL https://tailscale.com/install.sh | sh

# Start Tailscale
sudo tailscale up

在你的手機上：

• 從應用程式商店安裝 Tailscale app
• 使用同一個帳號登入
• 兩台設備現在都處於同一個私人網路中

你的桌面電腦會獲得一個 Tailscale IP（例如 100.64.x.x），你的手機可以直接訪問該 IP，無論兩台設備目前使用什麼 WiFi 或行動網路。Source

Step 2: 安裝 tmux (會話持久性)

tmux 讓你的終端機會話獨立於 SSH 連線而存在。當你的手機斷開連線（螢幕鎖定、網路切換、電池耗盡）時，tmux 會話仍會繼續運行。

# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

建立一個針對行動裝置優化的 tmux 配置：

# ~/.tmux.conf

# Increase scrollback buffer
set -g history-limit 50000

# Enable mouse support (useful on mobile)
set -g mouse on

# Reduce escape-time for responsive mobile input
set -sg escape-time 10

# Status bar with useful info
set -g status-right '#H | %H:%M'

# Larger status bar for mobile readability
set -g status-style 'bg=colour235 fg=colour136'

Step 3: 安裝 mosh (連線韌性)

mosh (Mobile Shell) 使用 UDP 而非 TCP，能優雅地處理網路切換。當你的手機從 WiFi 切換到行動網路或經過隧道時，mosh 會自動重新連線。

在你的桌面電腦上：

# macOS
brew install mosh

# Ubuntu/Debian
sudo apt install mosh

在你的手機上：

• iOS: 安裝 Blink Shell 或 Termius — 兩者都原生支援 mosh
• Android: 安裝 JuiceSSH 或帶有 mosh 套件的 Termux

Step 4: 連線並啟動 Claude Code

從手機的 SSH 客戶端：

# Connect via mosh through Tailscale
mosh user@100.64.x.x

# Start or attach to a tmux session
tmux new-session -s claude
# or if session already exists:
tmux attach -t claude

# Launch Claude Code
cd ~/projects/my-app
claude

現在你擁有一個符合以下條件的 Claude Code 會話：

• 即使網路切換也能存活 (mosh)
• 即使手機斷線也能存活 (tmux)
• 可以從 Tailscale 網路中的任何設備訪問
• 適用於任何 AI 供應商，而不僅限於 Claude

斷線後重新連線

當你稍後拿起手機時：

# 如果會話仍然存活，mosh 將自動重新連線
# 如果 mosh 會話已終止，則啟動一個新會話：
mosh user@100.64.x.x

# 重新連接到你的 tmux 會話
tmux attach -t claude

你的 Claude Code 會話將停留在你離開時的狀態——同樣的對話、同樣的工作目錄、同樣的待處理更改。

---

Part 3: 使用 ntfy 發送推送通知

無論是 Remote Control 還是 SSH 設置都有一個問題：你必須不斷查看手機，確認 Claude Code 是否完成了任務。解決方案是使用推送通知。

什麼是 ntfy？

ntfy 是一個簡單的開源推送通知服務。你可以為了隱私而自行託管 (self-host)，或者使用 ntfy.sh 上的公共實例。Source

配合 Tailscale 自行託管 ntfy

為了最大程度的隱私，請在你的桌面電腦上運行 ntfy 並透過 Tailscale 訪問：

# Install ntfy
brew install ntfy  # macOS
# or
sudo apt install ntfy  # Linux

# Start ntfy server (it listens on port 80 by default)
ntfy serve --listen-http :8090

由於你的手機和桌面電腦在同一個 Tailscale 網路中，你的手機可以透過 http://100.64.x.x:8090 訪問 ntfy。數據不會離開你的私人網路。

配置 Claude Code Hooks

Claude Code hooks 讓你在特定事件發生時觸發自定義命令。設置一個 hook，當 Claude Code 需要輸入時發送通知：

// ~/.claude/settings.json
{
  "hooks": {
    "notification": {
      "command": "curl -s -d 'Claude Code needs your attention' http://100.64.x.x:8090/claude-code",
      "event": "stop"
    }
  }
}

Source

ntfy 行動應用程式設置

1. 在手機上安裝 ntfy app (iOS 或 Android)
2. 在你的自託管伺服器上訂閱主題 claude-code (http://100.64.x.x:8090/claude-code)
3. 啟用該主題的推送通知

現在，每當 Claude Code 停止並需要輸入時——無論是完成任務、遇到錯誤還是需要批准——你的手機都會收到推送通知。無需保持終端機開啟或不斷檢查。

進階通知設置

為了獲得更豐富的通知內容，你可以包含 Claude Code 的最後一條訊息：

#!/bin/bash
# ~/.claude/hooks/notify.sh

# Get the last few lines of Claude Code output
LAST_OUTPUT=$(tail -5 /tmp/claude-code-output.log 2>/dev/null || echo "Task completed")

# Send notification with context
curl -s \
  -H "Title: Claude Code" \
  -H "Priority: high" \
  -H "Tags: robot" \
  -d "$LAST_OUTPUT" \
  http://100.64.x.x:8090/claude-code

Source

---

Part 4: Happy Coder (免費開源替代方案)

Happy Coder 是一個免費的開源工具，提供了一個網頁介面來遠端控制 Claude Code，並內建了推送通知和語音輸入功能。Source

主要特性

• 免費且開源 — 除了你的 Claude Code 方案外，無需額外訂閱
• 推送通知 — 內建通知系統，無需設置 ntfy
• 語音輸入 — 在小螢幕上可以用說話代替打字
• 多代理支持 — 可與 Codex 配合 Claude Code 使用
• 基於網頁 — 適用於任何行動瀏覽器，無需安裝 App

設置

# Install Happy Coder
npm install -g happy-coder

# Start the server
happy-coder start --port 3000

# Access from your phone via Tailscale
# http://100.64.x.x:3000

Happy Coder 提供了一個針對行動端優化的網頁介面，顯示你的 Claude Code 對話，讓你發送訊息並查看文件更改——一切都透過瀏覽器完成。

---

Part 5: 完整設置比較

方法比較矩陣

功能	Remote Control	SSH + tmux + mosh	Happy Coder
設置複雜度	極低 (1 個命令)	中等 (30 分鐘)	簡單 (5 分鐘)
成本	包含在方案中	免費 (Tailscale 免費層級)	免費
網路韌性	中等	優異 (mosh)	中等
會話持久性	良好	優異 (tmux)	良好
推送通知	無	需要 ntfy 設置	內建
語音輸入	無	無	有
多供應商	僅限 Claude	任何供應商	Claude + Codex
離線能力	無	部分 (tmux 持續)	無
完整終端存取	無 (僅限聊天)	有	無 (僅限聊天)
需要手機 App	Claude app	SSH 客戶端	瀏覽器

根據使用場景推薦的設置

輕度使用者 (偶爾查看任務)： → Remote Control。一個命令，一次 QR 掃描，搞定。

日常行動開發者 (經常從手機編碼)： → SSH + tmux + mosh + ntfy。具備最強的韌性和控制力。

團隊負責人 (監控多個會話)： → Happy Coder。基於網頁，支援多個代理，內建通知。

多供應商開發者 (使用 Claude、Codex 和本地模型)： → SSH + tmux + mosh。適用於任何在終端機運行的工具。

---

Part 6: 進階配置

運行多個 Claude Code 會話

透過 tmux，你可以並行運行多個 Claude Code 會話並在它們之間切換：

# Create named sessions for different projects
tmux new-session -d -s project-api
tmux new-session -d -s project-frontend
tmux new-session -d -s project-tests

# In each session, navigate and start Claude Code
tmux send-keys -t project-api 'cd ~/projects/api && claude' C-m
tmux send-keys -t project-frontend 'cd ~/projects/frontend && claude' C-m
tmux send-keys -t project-tests 'cd ~/projects/tests && claude' C-m

# From your phone, switch between sessions
tmux switch-client -t project-api
tmux switch-client -t project-frontend

Headless Linux VM 設置

對於希望擁有專用遠端編碼環境的團隊，Claude Code Remote Control 可以透過 SSH + tmux 在 Headless Linux VM 上運行。Source

# On your cloud VM (AWS, GCP, etc.)
# Install Claude Code
npm install -g @anthropic-ai/claude-code

# Start in a tmux session
tmux new-session -s remote-claude

# Launch Claude Code
claude

# Start Remote Control
/rc

然後從手機掃描 QR code。這為你提供了一個完全由行動裝置控制的強大雲端開發環境。

結合 Remote Control 與 SSH

你可以同時使用這兩種方法以獲得最大的靈活性：

1. SSH + tmux 用於會話持久性和完整的終端機存取
2. Remote Control 在 tmux 會話中用於行動友好的聊天介面

# SSH into your machine
mosh user@100.64.x.x

# Attach to tmux
tmux attach -t claude

# Inside the session, Claude Code is running
# Enable Remote Control for phone access
/rc

現在你擁有了：

• tmux 保持會話活著
• mosh 保持 SSH 連線穩定
• Remote Control 提供精美的行動介面
• 需要時可獲得完整的終端機存取

---

Part 7: 行動中構建應用程式

行動開發工作流

Claude Code + 遠端存取的結合從根本上改變了你生產的時間和地點。一個實際的工作流：

1. 早上通勤：在手機上查看昨晚的 CI 結果，透過 Remote Control 啟動修復任務
2. 午休時間：透過 ntfy 通知查看進度，批准或重新導向更改
3. 晚上：拿起筆記型電腦，tmux 會話正停留在你離開時的狀態

行動編碼的適用場景

透過 Claude Code 進行行動編碼最適合：

• 啟動任務 — 描述你想要構建的內容，讓 Claude Code 在你離開時工作
• 代碼審查 — 在手機上閱讀 diff 並批准更改
• Bug 分類 — 調查問題並引導 Claude Code 進行修復
• 進度監控 — 查看運行時間較長的任務

它較不適合：

• 複雜的調試 — 小螢幕閱讀堆棧追蹤 (stack traces) 非常痛苦
• 視覺化工作 — CSS 和版面配置微調需要大螢幕
• 大規模重構 — 你會希望在正式的顯示器上審查廣泛的更改

使用 ZBuild 在任何地方構建

對於希望在行動中構建和迭代應用程式的開發者，ZBuild 等平台可以補充遠端 Claude Code 工作流。ZBuild 提供了一個在平板電腦上運行良好的視覺化應用程式構建器，並可與 Claude Code 配合使用來處理更複雜的後端邏輯——為你提供不需要桌面工作站的全棧開發能力。

---

Part 8: 常見問題與解決方案

常見問題及修復

問題：「你的方案無法使用 Remote Control」 解決方案：確認你使用的是 Pro, Max, Team 或 Enterprise 方案。Free 層級不支援 Remote Control。

問題：QR code 無法掃描 解決方案：確保你的 Claude app 已更新至最新版本。嘗試直接使用會話 URL 而不是掃描。

問題：mosh 連線中斷且未重新連線 解決方案：確認桌面電腦上正在運行 mosh-server (which mosh-server)。檢查兩台設備是否都連接到 Tailscale。如果不使用 Tailscale，請確保 UDP 連接埠 60000-61000 已開啟。

問題：重新連線後 tmux 會話顯示空白螢幕 解決方案：運行 tmux attach -t claude 而不是建立新會話。如果會話已終止，請查看 ~/.claude/logs/ 檢查 Claude Code 是否崩潰。

問題：未收到 ntfy 通知 解決方案：確認 ntfy 伺服器正在運行 (curl http://100.64.x.x:8090/health)。檢查 ntfy app 的訂閱 URL 是否與你的伺服器地址相符。確保手機的 Tailscale 連線處於活動狀態。

問題：手機斷線時 Claude Code 會話過期 解決方案：這會在 Remote Control 長時間閒置後發生。對於需要持續數小時的會話，請使用基於 tmux 的設置。tmux 會話不論客戶端連線狀態如何都會無限期存活。

問題：行動端打字太慢 解決方案：使用語音輸入 (Happy Coder) 或保持訊息簡短且以任務為導向。或者，在筆記軟體中準備好提示詞 (prompts) 並將其貼上到終端機。

---

Part 9: 安全性考量

Remote Control 安全性

• 所有流量都經由 Anthropic API 使用 TLS 加密
• 會話 URL 是唯一的，且在使用後會過期
• 你的機器上不會開啟任何入站連接埠
• 你的憑證和文件永遠不會離開你的機器（僅傳輸 Claude Code 的文字輸出）

SSH 安全性最佳實踐

為行動存取開放 SSH 時：

# Use key-based authentication only (disable password auth)
# In /etc/ssh/sshd_config:
PasswordAuthentication no
PubkeyAuthentication yes

# Restrict SSH to Tailscale interface only
ListenAddress 100.64.x.x

# Use a non-standard port
Port 2222

Tailscale 安全性

Tailscale 基於 WireGuard 的網狀網路提供：

• 設備之間的端到端加密
• 數據不會經過 Tailscale 的伺服器（直接連線）
• 用於簡單主機名稱解析的 MagicDNS
• 適用於團隊設置的存取控制列表 (ACLs)

---

結論

在 2026 年遠端使用 Claude Code 的方式，從極其簡單（一個 /rc 命令）到完全自定義（SSH + tmux + mosh + ntfy + Tailscale）不等。正確的設置取決於你的工作流：

• Remote Control 適用於零設置的快速行動端檢查
• SSH 技術棧 適用於在終端機工作且需要最大韌性的開發者
• Happy Coder 則是一個免費、功能豐富的中間方案

其實際影響是深遠的。開發不再被束縛在桌子前並打開筆記型電腦。你可以啟動一個任務，走開，並保持控制。無論你是在構建側邊專案 (side project)、管理團隊的代碼庫，還是使用 ZBuild 製作應用程式原型，行動端 Claude Code 存取意味著你的開發工作流隨你而行，而不是相反。

---

來源

• Claude Code Remote Control 說明文件 — Anthropic
• Remote Claude Code: 像 2000 年代初期一樣程式設計 — Harper Reed
• 在海灘使用 Claude Code: mosh, tmux, 與 ntfy — Rogs
• Claude Code Remote Control: 從手機編碼 — Medium
• 在手機上使用 Claude Code — Builder.io
• 使用 Tailscale 和 ntfy 實現完美的 Claude Code 通知 — Felipe Elias
• 從手機運行 Claude Code 的 3 種方法 — Zilliz
• 從 iPhone 運行 Claude Code — Pete Sena / Medium
• Claude Code Remote Control 發佈分析：跨設備無縫終端切換 — Blockchain News
• 在 Headless Linux VM 上使用 Remote Control — GitHub Issue #29479
• 使用 tmux 和 Bitvise 的 Claude Code 行動端設置 — GitHub Gist
• 如何在手機上使用 Claude Code — FelloAI
• Claude Code 行動端設置 — Sealos Blog