Claude Code 17 min read ★ Featured

用手機控制你的 Mac 寫程式：Claude Code Remote Control 完整教學（含 push 推播 + 全自動配置）

上課中、騎車紅燈、躺床滑手機，順手叫 Mac 跑一個 task。Claude Code 在 2026/02 推出的 Remote Control 把這件事做成五分鐘設定的標配。本文從零教到推播，包含一個官方文件沒寫的隱藏設定。

#Claude Code #Remote Control #Push 推播 +3 tags
本文目錄 · 12

# 用手機控制你的 Mac 寫程式：Claude Code Remote Control 完整教學（含 push 推播 + 全自動配置）

上課中、騎車紅燈、躺床滑手機，順手叫 Mac 跑一個 task。Claude Code 在 2026/02 推出的 Remote Control 把這件事做成五分鐘設定的標配。本文從零教到推播，包含一個官方文件沒寫的隱藏設定。

TL;DR

Remote Control = 手機接管 Mac 上的 Claude Code session。指令還是 Mac 跑（你的檔案、MCP、plugin 都還在），但對話介面同步到 iPhone / Android / 任何瀏覽器。Pro / Max 訂閱免費附贈，CLI ≥ 2.1.51 即可。

最快的設定路徑：

  • iPhone 裝 Claude app，登入跟 CLI 同一個帳號

  • Mac 任意 Claude Code session 打 /rc

  • 手機掃 QR code（或從 app 底下「Code」tab 點進去）

    • 進階：在 ~/.claude/settings.json 加兩行，從此每個新 session 自動 ready，長 task 完成主動推播。

    這東西到底解決什麼問題

    我每天的工作流是：Mac 在家開著、跑很多長 task（影片上傳、Maven build、Spring Boot 起服、blog 寫作）。

    過去的尷尬：

    • 上課中 task 卡住，不能切回 Mac 看
    • 躺床想到一個主題，懶得起床開電腦
    • 出門才發現 build 還沒跑完，手機只能乾等
    Remote Control 把這個 gap 補起來。它不是把 Claude 搬上雲端，是讓你的手機變成 Mac 那台 Claude 的第二個鍵盤。Mac 還在執行（檔案、MCP、plugin、credentials 全部都在），手機只是另一個輸入輸出介面。 Claude Code GitHub repo

    跟 Claude Code on the web 差在哪

    兩者都是「不在 Mac 前面也能用 Claude Code」，但設計目的差很多。

    問題Remote ControlClaude Code on the web
    Claude 跑在哪你的 MacAnthropic 雲端 VM
    看得到本機檔案嗎✅ 全部❌ 只能 clone GitHub repo
    MCP server 用得到嗎✅ 你本機裝什麼就有什麼部分支援
    Mac 關機可以用嗎❌ Session 死✅ 雲端跑著
    適合場景接著手邊做到一半的工作出差只有 iPad、想開新任務
    結論：Remote Control 是日常的延伸，web 版是特殊情境的補充。我自己 95% 用 Remote Control。

    前置條件

    項目需求
    CLI 版本≥ 2.1.51（push 推播要 ≥ 2.1.110）
    訂閱Pro（$20/月）/ Max（$100-200/月）。API key 不行
    登入方式claude.ai OAuth。ANTHROPIC_API_KEY 環境變數要 unset
    手機 appiPhone 從 App Store / Android 從 Play Store 找「Claude by Anthropic」
    Mac 與手機帳號必須同一個 Google / Email 登入
    先驗證版本： 
    claude --version

    不到 2.1.51 就升級：

    npm i -g @anthropic-ai/claude-code@latest
# 或 brew upgrade claude-code（如果你是 brew 裝的）

    五分鐘 setup

    Step 1 — 手機裝 app + 登入同帳號

    App Store 搜「Claude by Anthropic」（出版商：Anthropic）。注意：不要被一堆第三方 app（Happy、CloudCLI）吸過去，官方 app 才是 Remote Control 的接收端。

    裝完用 Mac 同一個帳號登入。

    小提醒：不確定 Mac 上登的是哪個帳號？在任意 Claude Code session 打 /status 會顯示。

    Step 2 — Mac 端打配對指令

    任意一個 active 的 Claude Code session（甚至你正在跟它聊天的這個 session 都行）打：

    /rc

    或全名 /remote-control。會印兩個東西：

    • Session URL（瀏覽器點開可用）
    • QR code（手機掃用）
    如果你想給 session 取個名字方便手機那邊辨識： 
    /remote-control "ami clinical 開發中"

    不取的話會自動用 hostname + 隨機詞（例如 BobMac-graceful-unicorn）。

    Step 3 — 手機掃 QR / 找 session

    掃 QR：app 會打開但不會自動跳到 session。你要：

  • 點底下 navigation bar 的 Code tab（不是預設的 Chat）

  • 列表裡找你剛建立的 session（旁邊有電腦 icon + 綠色狀態點 = online）

  • 點進去就接管了

    • 從這秒開始，這個 session 在 Mac terminal 跟手機是雙向同步的。Mac 那邊看得到你手機打的字，手機那邊看得到 Mac 端的回應跟工具呼叫。

    Step 4 — 驗證真的接管 Mac

    在手機 session 打：

    你跑在哪台機器？pwd 一下，然後 ls 看看

    如果回的路徑是你 Mac 上的目錄（不是 /workspace 之類雲端 VM 路徑）→ 確認真的在控制 Mac。

    Anthropic Cookbook

    打開 push 推播

    光是同步還不夠。真正改變工作流的是「Mac 跑長 task → 手機叮一聲」。

    開啟方式

    在 Mac 任意 Claude Code session 打：

    /config

    找到 Push when Claude decides → 切成 true。

    怎麼觸發推播

    兩種方式：

  • Claude 自己決定：長 task 完成、需要你決策（permission prompt、ambiguous request）時自動推

  • 你主動要求：在 prompt 結尾加「notify me when done」之類字眼

    • 實際例子：

    跑這個 Spring Boot integration test，跑完通知我

    Mac 跑 5 分鐘 → 跑完手機叮一聲。你看通知就知道結果，不用每隔幾分鐘切回 Mac 看。

    推播沒進來怎麼辦

    症狀解法
    /config 顯示 No mobile registered開手機 Claude app（讓它 refresh push token），下次 RC 連線時自動清掉警告
    iOS 完全收不到設定 → 通知 → Claude → 確認允許；關掉 Focus mode
    Android 延遲嚴重系統設定 → 電池最佳化 → 把 Claude 排除

    一次設定，永久自動：兩個 hidden key

    預設行為有兩個小麻煩：

  • 每次開新 terminal 跑 claude 都要再打 /rc 才有 RC

  • 每次都要進 /config 確認推播沒被關掉

    • 官方文件沒寫對應的 JSON key（只寫了反向的 disableRemoteControl）。但其實兩個都有 hidden key 可以一勞永逸寫進設定檔。

    直接抄這兩行

    編輯 ~/.claude/settings.json，在 top-level 加兩個 key：

    {
  "remoteControlAtStartup": true,
  "agentPushNotifEnabled": true
}

    對應關係

    settings.json keyUI 標籤（在 /config 裡）效果
    remoteControlAtStartup: trueEnable Remote Control for all sessions每個新 session 自動開 RC，不用打 /rc
    agentPushNotifEnabled: truePush when Claude decides任務完成 / 需要決策時推播到手機

    為什麼官方文件沒寫

    我猜測：這兩個是 /config 互動 toggle 對應的儲存 key，UI 端設計成藏在 toggle 後面，手動編輯不在 supported workflow 內。但實際讀 binary 確認 100% 有效（下一篇文章會講怎麼挖出來）。

    副作用（要知道）

    開全自動 RC 之後，每個 terminal 開的 Claude 都會佔一個 RC session 名額。你手機 Code tab 會列一堆。這是 feature，不是 bug：可以當「Mac 上有哪些 Claude 在跑」的儀表板。

    但如果你常開 5、6 個 session 跑不同事，list 會亂。建議搭配 --name 用：

    cd ~/workspace/ami-clinical
claude --name "ami clinical"

    我自己最常用的三個情境

    情境 1：上課中跑長 task

    職訓局上課中，學員問問題前，我先在 Mac 開 task：

    跑 mvn clean install，然後跑完報整理摘要 LINE 給我，notify me when done

    繼續講課。10 分鐘後 LINE 收到摘要，下課直接 review。

    情境 2：通勤想到一個 blog 主題

    捷運上想到「想寫一篇 X 工具的踩坑文」，手機開 Code tab 找在家 Mac 那個 session：

    /blog-create X 工具踩坑

    Mac 開始查證 + 寫 outline，30 分鐘到家文章已經 70% 完成。

    情境 3：build 跑了一半要出門

    剛開始 /yc-plugin:youtube-upload 上傳 5GB 影片，老婆要我接小孩。出門路上手機看進度，傳完手機推播 video URL，直接 LINE 給合作夥伴。

    必踩的四個坑

    坑 1：Mac 睡眠 = session 死

    最常見的踩坑。Mac 闔上不接電源 → 預設 1 分鐘進入睡眠 → RC session 自動斷。

    解法：

    # 暫時讓 Mac 不睡（指令存活時不睡）
caffeinate -d

    或系統設定 → 電池 → 闔上時不睡眠（有電源時）。

    坑 2：斷網超過 10 分鐘 = session 永久死

    Mac 還醒著但 WiFi 切換、VPN 重連時間太久 → 過 10 分鐘 session 自動 timeout，process 結束。

    解法：回 Mac 重打 /rc，conversation 還在但 RC channel 要重建。

    坑 3：/mcp、/plugin、/resume 在手機端按沒反應

    這三個指令需要 terminal 互動式 picker，手機端跑了會 silent fail。要回 Mac terminal 才能用。

    手機可用手機不可用
    /compact、/clear、/context、/usage、/recap/mcp、/plugin、/resume
    所有 plugin 已 enable 的 slash command任何要互動式選單的 command

    坑 4：Ultraplan 啟動會踢掉 RC

    /ultraplan 跟 RC 共用同一個 claude.ai/code interface，只能擇一。如果你正在 RC + 手機監控時下了 /ultraplan，RC 會被踢斷。

    解法：要用 ultraplan 就接受 RC 暫停，跑完再 /rc 一次。

    跟其他「離開 terminal」方案的比較

    Anthropic 在 2026 上半年同時推了好幾個「不在 terminal 用 Claude Code」的方法。我整理給你選：

    方案TriggerClaude 跑在哪Setup 難度適合
    Remote Control手機 / 瀏覽器接管 session你的 Mac★手邊有事做到一半，要繼續推進
    Dispatch手機 Claude app 派任務你的 Mac (Desktop)★★出門臨時想到要 Mac 做什麼事
    Claude Code on the web開瀏覽器分配 taskAnthropic 雲端★★iPad / 沒帶電腦，要做 GitHub repo 工作
    Channels (Discord / Telegram)聊天訊息觸發你的 Mac★★★CI 失敗、IM 訊息進 → Claude 自動回應
    Slack 整合@Claude 標記Anthropic 雲端★★★團隊在 Slack 集中討論 PR
    Scheduled tasks定時觸發CLI / Desktop / 雲端★★每天早上 review、週報摘要
    選擇路線：
    • 一個人用 → Remote Control 為主，Dispatch 為輔
    • 團隊協作 → 加 Slack
    • 不在 Mac 前面要開新事 → web 版

    FAQ

    Q：免費版 Claude 用得到 Remote Control 嗎？
    不行。要 Pro（$20/月）或 Max（$100-200/月）。

    Q：API key 用戶能用嗎？
    不能。要 claude.ai OAuth 登入。如果你 shell 裡有 ANTHROPIC_API_KEY 環境變數，要 unset 掉再 /login。

    Q：手機掃 QR 之後 app 開了但沒接管 session？
    正常。掃 QR 只是 deep link 開 app，要自己進 Code tab 找 session 點進去（list 裡有電腦 icon 那個）。

    Q：兩台 Mac 都跑 RC 會衝突嗎？
    不會。每個 process 註冊獨立 session，手機 list 兩個都會看到。但要記得 --name 加標籤，不然 hostname 都看不出差異。

    Q：手機端打字傳給 Mac 安全嗎？
    通訊走 Anthropic API + TLS，跟你平常用 Claude Code 一樣的 transport。沒有開 inbound port、沒有上雲端執行。

    Q：可以離線用嗎？
    不行。Mac 端要有網路（OAuth + 跟 Anthropic API 同步），手機端也要網路。完全離線 = 雙方都退回各自獨立模式。

    Q：team / enterprise 帳號怎麼開？
    admin 要先到 claude.ai/admin-settings/claude-code 把 Remote Control toggle 打開。如果 toggle 是灰的，是 data retention policy 不相容，要 contact Anthropic support。

    延伸資源

    如果你已經在用 Claude Code、卻還沒裝手機 app，今天花十分鐘設一次，未來的你會回來感謝你。

    如果你對「為什麼我知道 remoteControlAtStartup 跟 agentPushNotifEnabled 這兩個官方沒寫的 key」好奇，下一篇我寫的是怎麼從 binary 挖出 hidden settings 的方法論，可以追蹤一下。

    author
    陳
    陳彥彤

    AI 工程師 · AI 顧問。Java 後端 8 年、AI 工程師 2 年。AI 內訓 · AI 導入顧問 · 前後端與雲端培訓。

    support

    覺得文章有用可以到 GitHub 給個 star，或是透過信箱聊聊 AI 內訓、AI 導入顧問或前後端 / 雲端培訓。

    email github
    related

    相關文章

    [Claude Code] · 20min
    Superpowers 暴衝 121k stars、Anthropic 收編,該裝嗎?跟手寫 skill 怎麼選
    obra/superpowers 7 個月 121k stars、2026/01 進 Anthropic 官方 plugin marketplace,14 個內建 skill 把資深工程師工作流(brainstorm/TDD/debug)強行套到 Claude Code 上,token -14%、首次成功率 +40%。但我自己跑兩週發現:小任務反而 +20% token、demo 前急著修 bug 被 brainstorming 拖住、Haiku 跑不動。本文拆 14 個 skill 各自解什麼、5 個踩坑、跟自己手寫 skill 的對照表(從適用任務、學習曲線、客製化彈性、維護成本四個維度比較)、Jesse Vincent 的設計哲學(讓 Claude 暫停,不是變聰明)。
    [Claude Code] · 10min
    Claude Code /powerup 完整教學：10 堂互動課程拆解（2026 最新版，本機 binary 為準）
    /powerup 是 Claude Code CLI 內建的互動教學命令，10 堂課掃過最常被忽略的進階功能：subagents、hooks、output styles、permissions、worktrees⋯⋯本文用本機 binary 為 source of truth 逐堂拆解真實內容，附完整指令對照表，新手 1 小時跑完。
    [AI 工具] · 18min
    claude-code-security-review 拆解：一份值得抄的 AI 資安審查 prompt
    Anthropic 2025-08-04 開的 MIT / Python 專案，做成 GitHub Action 在 PR diff 上跑資安審查，另附一個 /security-review slash command 可在本機 Claude Code 直接用。prompt 設計紮實（>80% 可利用性門檻、三階段方法論、結構化 JSON 輸出），但最後 push 停在 2026-02-11、79 個 open issue，而且那層 AI 誤判過濾因為寫死已退役的模型早就靜默停用了。
    ← all posts