Claude Code Mac 桌面應用程式 + 遠端控制：CLI 使用者指南

Q: 我可以在同一個專案上同時執行 CLI 與桌面應用程式嗎？

可以。它們共用設定（CLAUDE.md、~/.claude.json、MCP 伺服器、掛鉤、技能）但維護獨立的工作階段歷史記錄。2 您可以在 iTerm 中執行 claude 工作階段,並在桌面應用程式中執行 Code 分頁工作階段,兩者都指向相同的 ~/Projects/blakecrosley.com,兩者都寫入 git。如果您不使用 worktree,請小心平行寫入。

Q: Remote Control 適用於 & task（背景）語法嗎？

& task 與 Remote Control 是不同的介面。& task 將工作傳送到雲端工作階段。Remote Control 從另一個裝置連線到本機工作階段。它們都可能出現在 claude.ai/code 的工作階段清單中,但雲端工作階段在 Anthropic 基礎架構上執行,而 Remote Control 工作階段在您的機器上執行。1

Q: 我可以將 Remote Control 與第三方供應商（Bedrock、Vertex、Foundry）一起使用嗎？

不行。Remote Control 需要 claude.ai 驗證。如果您設定了 CLAUDE_CODE_USE_BEDROCK、CLAUDE_CODE_USE_VERTEX 或 CLAUDE_CODE_USE_FOUNDRY,資格檢查將失敗,顯示「Remote Control is not yet enabled for your account」。請取消設定並重新執行。1

Q: --remote-control 與 claude remote-control 有何不同？

claude --remote-control（或 --rc）會在您的終端機中啟動正常的互動式工作階段,並啟用 Remote Control。您可以在本機輸入,同時也可以從另一個裝置輸入。claude remote-control（沒有旗標,子命令）是伺服器模式：終端機變成沒有本機提示的伺服器,只有連線狀態。兩者預設都建立一個遠端工作階段;伺服器模式可以透過 --capacity 或 --spawn 提供多個。1

Q: 桌面應用程式具有像 CLI 一樣的技能、外掛與掛鉤嗎？

有。它們是相同的技能、外掛與掛鉤。桌面應用程式與 CLI 一樣讀取 ~/.claude/settings.json 與專案層級的 .claude/settings.json。點擊提示框旁邊的 + 按鈕來瀏覽已安裝的外掛與技能。外掛在遠端（雲端）工作階段中不可用,但在本機桌面工作階段中運作正常。2

Q: 為什麼 /mcp 在我的手機上無法運作？

/mcp 開啟一個需要僅限終端機 UI 進行選取的互動式選擇器。它僅限本機。/plugin 與 /resume 也是如此。1 任何產生文字輸出的命令（/compact、/clear、/context、/usage、/extra-usage、/exit、/recap、/reload-plugins）都可從行動裝置與網頁使用。

Claude Code Mac 桌面應用程式與 claude remote-control 子命令從相反的方向解決同一個問題。桌面應用程式提供一個視窗，包含三個分頁（Chat、Cowork、Code），以及一個您可以圍繞程式碼安排的工作區。Remote Control 則提供完全相反的東西：在本機上完全沒有視窗,只有一個程序將您的本機工作階段提供給手機上的 Claude 應用程式或任何瀏覽器中的 claude.ai/code。¹

如果您是從終端機的 claude 開始使用的,這兩種介面起初看起來都很奇怪。為什麼當 TUI 已經夠好時,我還會想要 GUI？為什麼當我的 Mac 就在這裡時,我還會想從手機操控它？兩個問題的答案相同：您的本機環境就是您無法移動的部分。檔案系統、MCP 伺服器（Yurei、Cloudflare、GitHub）、Xcode、程式碼簽署身分、您的 Yurei socket、您的 ~/.claude/projects/ 歷史記錄。所有這些都存在於這台機器上。桌面應用程式與 Remote Control 是從其他地方存取該環境的兩種方式：另一個視窗、另一個裝置、沙發上、會議中。

這篇文章是我切換時希望自己有的參考資料。內容涵蓋三種模式（本機 CLI、雲端、本機 + Remote Control）、各種設定方式、各處可用的斜線命令、推播通知的故事,以及桌面應用程式與終端機 claude 的具體差異。對限制誠實以告。沒有廢話。

TL;DR

從 claude.ai/code 看起來相似但執行方式截然不同的三種模式：本機 CLI、雲端工作階段（從終端機執行 claude --remote、Desktop 中的 Remote 環境,或在 claude.ai/code 開啟新工作階段）、以及 本機 + Remote Control。只有第一種與第三種能存取您的檔案系統、MCP 伺服器與 Xcode。¹²
Mac 桌面應用程式的 Code 分頁是圖形化的 Claude Code 工作階段：與 CLI 共用相同的引擎、相同的 ~/.claude.json 設定、相同的 CLAUDE.md、相同的 MCP 伺服器。但它有自己的窗格佈局、側邊聊天與工作階段側邊欄。²
claude remote-control（伺服器模式）讓程序在本機持續執行,並讓您從任何裝置連線。claude --remote-control 是啟用 Remote Control 的互動式工作階段。/remote-control 則是在現有工作階段內以斜線命令形式啟用相同功能。¹
iOS 應用程式推播通知透過 /config →「Push when Claude decides」啟用（v2.1.110+）。Claude 會在長時間任務完成或需要您輸入時推播。¹³
對於原生 macOS 或 iOS 建置,本機 CLI 或本機 + Remote Control 是唯一真正可行的環境。雲端工作階段無法執行 Xcode、無法簽署、看不到您的本機 Yurei socket。²

重要的三種模式

相同的 claude.ai/code 網址、相同的 iOS 應用程式圖示,背後卻是三個完全不同的執行環境。

1. 本機 CLI

這是終端機中的 claude。程序在您的 Mac 上執行。工作階段儲存在磁碟的 ~/.claude/projects/<project-path>/<session-id>.jsonl,而非您的 Anthropic 帳戶。⁴ 您的 iPhone 看不到它。沒有遠端介面。

您可以獲得：

完整的檔案系統存取：~/Projects、~/.claude/,以及使用者具有讀寫權限的任何位置
您所有的 MCP 伺服器：Yurei (/tmp/yurei.sock)、Cloudflare、GitHub、Supabase、Playwright 等
Xcode、模擬器（xcrun simctl）、程式碼簽署身分、App Store Connect
本機安裝的外掛、技能與掛鉤
語音模式（/voice）
每一個 CLI 旗標（--worktree、--rc、--print、--output-format 等）

您無法獲得：從另一個裝置查看或操控工作階段的任何方式。

對於 Mac 應用程式建置（Return、Get Bananas、Water,以及 App Intents 與 MCP 伺服器文章中的應用程式）,本機 CLI 完美運作。本機 + Remote Control（下方第 3 節介紹）也是如此：兩者都將 Claude 程序保留在您的 Mac 上,因此都能存取 Xcode、模擬器與簽署。雲端工作階段才是無法執行 Apple 工具鏈的選項。

2. 雲端工作階段

這是從終端機執行 claude --remote "task"、啟動桌面應用程式工作階段時選擇 Remote,或前往 claude.ai/code 並在那裡開啟新工作階段。Claude Code 程序在 Anthropic 託管的雲端基礎架構上執行,而非您的機器。²（較舊的文件與 shell 慣例有時會以 & task 作為相同結果的簡寫;請將明確的 --remote 旗標視為標準形式。）

您可以獲得：

跨機器與裝置的持久性：可從您的 iPhone、iPad、瀏覽器查看
在您關閉應用程式或關閉筆電後仍持續執行
Anthropic 託管環境,無需本機設定
多儲存庫支援：雲端工作階段可將多個 GitHub 儲存庫複製到同一個工作區²

您無法獲得：

無法存取 ~/Projects 的檔案系統
沒有本機 MCP 伺服器（Yurei socket、本機 Cloudflare 快取指令碼、.mcp.json 中的自訂 MCP 都無法存取）
沒有 Xcode、沒有模擬器、無法簽署
看不到您的 ~/.claude/ 設定或技能（只有複製的儲存庫 .claude/ 中的內容）
無法 @mention 檔案（@ 自動完成從本機專案抓取;雲端工作階段沒有此功能）²

使用情境：不依賴 Apple 工具鏈、自成一體的編碼任務。開啟 PR 審查、執行測試套件、重構檔案、編寫 Python 指令碼。任何只需要 git + 標準 Linux + Python/Node 的工作。

3. 本機 + Remote Control

這是第三個選項,也是大多數 CLI 使用者忽略的選項。啟用方式有三種：claude remote-control（伺服器模式）、claude --remote-control（或 --rc,啟用 Remote Control 的互動式工作階段）,或從現有工作階段內執行 /remote-control。Claude Code 程序持續在您的 Mac 上執行,具備完整本機存取權,但同時也向 Anthropic API 註冊,讓您可以從 iPhone、iPad 或瀏覽器操控它。¹

您可以獲得：本機 CLI 的一切,加上一支可以下指令的手機。對話會在所有連線裝置之間保持同步。您可以從 Mac 終端機傳送訊息、在 iPhone 上看到、在 iPhone 上輸入後續訊息、在終端機看到回應。本機程序仍在執行工作;您的手機只是一個視窗。

您必須放棄的：一小組特定的斜線命令。文件明確指出 /mcp、/plugin 與 /resume 為僅限本機使用（它們各自會開啟需要終端機的互動式選擇器）。文件也明確列出能產生文字輸出且可從行動裝置與網頁使用的命令：/compact、/clear、/context、/usage、/exit、/extra-usage、/recap、/reload-plugins。¹

這是原生 macOS 或 iOS 應用程式建置的答案。您能取得 Xcode、取得 MCP、取得 Yurei socket,同時獲得手機可見性。

設定 Mac 桌面應用程式

桌面應用程式與 CLI 並非替代關係。它們是同一引擎的兩個用戶端。您可以在同一台機器上同時執行兩者,甚至在同一個專案上。各自追蹤自己的工作階段歷史記錄,但共用 CLAUDE.md、~/.claude.json、MCP 伺服器、掛鉤與技能。²

從 claude.com/download 下載。安裝。使用您的 claude.ai 帳戶登入。應用程式有三個分頁：²

Chat 用於一般 Claude 對話
Cowork 用於 Dispatch（長時間執行的任務,可選擇從手機傳訊）
Code 用於具圖形介面的 Claude Code

我們關心的是 Code 分頁。在側邊欄中點擊 + New session。在提示區域中設定四個選項：²

環境：Local（這台 Mac）、Remote（Anthropic 雲端）或 SSH（您管理的遠端機器）
專案資料夾：Claude 工作的目錄
模型：Sonnet 4.6、Opus 4.6、Opus 4.7 或其他
權限模式：Ask、Auto-accept edits、Plan、Auto 或 Bypass permissions

輸入您的提示,按 Enter。從這裡開始,使用感覺像是聊天應用程式：訊息堆疊、工具呼叫呈現為可摺疊的卡片,當檔案變更時會出現差異統計指示器（+12 -1）。點擊指示器即可開啟差異檢視器,進行逐檔審查與行級註解。²

對於本機工作階段,提示框中的 @ 鍵會自動完成專案中的檔案路徑：與 CLI 的 @ 提及方式相同。對於遠端工作階段,@ 會被停用,因為雲端程序無法存取您的本機檔案。²

開始前的需求

任何 Remote Control 工作階段的四個前置條件：¹

Claude Code v2.1.51 或更新版本（以 claude --version 檢查）。
訂閱：Pro、Max、Team 或 Enterprise。API 金鑰不受支援。在 Team 與 Enterprise 中,管理員必須先在 claude.ai/admin-settings/claude-code 中啟用 Remote Control 切換。
驗證：如尚未登入,執行 claude 並使用 /login(claude.ai 選項)。來自 claude setup-token 或 CLAUDE_CODE_OAUTH_TOKEN 環境變數的僅推論用權杖無法運作。
工作區信任：在您的專案目錄中至少執行一次 claude 並接受工作區信任對話框。

啟動 Remote Control 工作階段的四種方式

目前的文件列出了四個呼叫介面（三個來自 CLI,加上一個 VS Code 命令）。Mac 桌面應用程式不是 Remote Control 主機;Remote Control 由 claude(CLI)或 VS Code 擴充功能託管。¹

伺服器模式：`claude remote-control`

cd ~/Projects/blakecrosley.com
claude remote-control

終端機變成伺服器。沒有互動式提示。它會顯示工作階段網址,以及（如果您按下空白鍵）QR 碼。從另一個裝置開啟網址或掃描 QR 碼即可連線。工作階段啟用期間,終端機會顯示連線狀態與工具活動。

實用旗標：¹

--name "My Project"：在 claude.ai/code 可見的自訂工作階段標題
--remote-control-session-name-prefix <prefix>：覆蓋自動命名（預設為您機器的主機名稱,產生類似 myhost-graceful-unicorn 的名稱）
--spawn same-dir（預設）：所有工作階段共用目前的工作目錄
--spawn worktree：每個工作階段獲得自己的 git worktree（需要 git 儲存庫）;在執行階段按 w 即可在 same-dir 與 worktree 之間切換
--spawn session：單一工作階段模式,拒絕額外連線;僅在啟動時設定
--capacity N：最大並行工作階段數（預設 32,無法與 --spawn=session 結合使用）
--sandbox / --no-sandbox：切換檔案系統與網路隔離（預設關閉）

當您想啟動工作階段後離開時,伺服器模式是正確的選擇。終端機現在是守護程序,不是工作區。

互動式：`claude --remote-control`

claude --remote-control
# 或更短
claude --rc

與一般互動式工作階段相同,但啟用了 Remote Control。您可以在本機輸入訊息,同時也可以從 claude.ai/code 或 iOS 應用程式輸入。對話保持同步。可選用：claude --rc "Project Name"。

當您想在終端機繼續工作但同時也想要手機可見性時,使用此方式。這是最常見的情況。

斜線命令：`/remote-control`

已經在工作階段中,並想專門在這個對話上啟用 Remote Control？輸入 /remote-control(或 /rc)。目前的對話歷史會延續,並出現工作階段網址 + QR 碼。傳入名稱：/remote-control My Project。

--verbose、--sandbox 與 --no-sandbox 旗標不適用於斜線形式：僅適用於 claude remote-control(伺服器模式)。

VS Code 擴充功能

在 Claude Code VS Code 擴充功能中,在提示框中輸入 /remote-control(或 /rc),或使用 / 開啟命令選單並選取它。需要 Claude Code v2.1.79 或更新版本。¹ 提示框上方會出現顯示連線狀態的橫幅。點擊 Open in browser 直接跳到工作階段,或在 claude.ai/code 的工作階段清單中找到它。透過點擊橫幅上的關閉圖示或再次執行 /remote-control 即可中斷連線。

VS Code 命令不接受名稱引數,也不顯示 QR 碼。工作階段標題會從對話歷史或第一個提示衍生。

永遠開啟：`/config` →「Enable Remote Control for all sessions」

如果您希望每個互動式 claude 工作階段預設都註冊一個遠端工作階段,執行 /config 並將 Enable Remote Control for all sessions 切換為 true。¹ 每個互動式程序會獲得一個遠端工作階段。多個執行個體 → 多個工作階段。對於從單一程序進行多個並行工作階段,伺服器模式仍是正確工具。

推播通知的故事

當有趣的事情發生時推播到您的手機。設定包含四個步驟：¹³

安裝 iOS 或 Android 的 Claude 應用程式。在 Claude Code 中,如果您還沒有,/mobile 會顯示下載 QR 碼。
使用您在終端機 Claude Code 中使用的相同 Claude 帳戶登入。
接受作業系統的通知權限提示。
在終端機中,執行 /config 並啟用 Push when Claude decides(v2.1.110+)。

之後,Claude 會自行決定何時推播。兩種情況會觸發：長時間執行的任務完成,或 Claude 需要您的輸入才能繼續。您也可以在提示中明確要求一次：notify me when the tests finish。沒有逐事件設定：要嘛開啟,要嘛關閉。

如果您切換設定為開啟但看不到通知,最常見的修正方式是：在手機上開啟 Claude 應用程式,讓它能重新整理推播權杖。在那之前,/config 畫面會顯示 No mobile registered。iOS Focus 模式與 Android 電池最佳化也可能延遲或抑制傳遞;在 iOS 上請檢查「設定 → 通知 → Claude」,或在 Android 上將 Claude 應用程式從電池最佳化中排除。¹

額外背景：另一個 push-notification 工具(也是 v2.1.110+)讓 Claude 自己決定在工作階段期間傳送通知,而不僅是在任務結束時。它與相同的 Remote Control 介面搭配使用,無需額外設定。³

遠端可用的斜線命令

這是大多數 CLI 使用者最關心的部分。當您在手機而非終端機上輸入時,哪些可以運作？

從任何已連線用戶端可用(終端機、瀏覽器、iOS 應用程式)：¹

/compact、/clear：上下文管理
/context、/usage、/extra-usage：使用量與上下文檢查(v2.1.113+ 為 /extra-usage 新增 Remote Control 支援)
/exit、/recap、/reload-plugins
所有非選擇器文字輸入(一般提示、產生文字輸出的一般斜線命令)

僅限本機(僅終端機)：¹

/mcp：開啟互動式選擇器
/plugin：開啟互動式選擇器
/resume：需要呈現帶有選取 UI 的工作階段清單

模式：任何在終端機需要清單加鍵盤選取的命令都僅限本機。任何文字進、文字出的命令都可從行動裝置或網頁使用。

某些命令具有版本特定的 Remote Control 支援。 /extra-usage 僅在 v2.1.113 及更新版本中從 Remote Control 用戶端運作:較舊版本會默默失敗。⁵ 如果命令在您的手機上的行為與在 Mac 上不同,值得檢查 claude --version。

權限模式略有不同

桌面應用程式有五種權限模式;CLI 在那五種之上還有 dontAsk：²

模式	行為	CLI？	桌面？
Ask permissions（`default`）	每次編輯/命令前詢問	✓	✓
Auto accept edits（`acceptEdits`）	自動接受檔案編輯 + 安全的檔案系統命令;其餘的會詢問	✓	✓
Plan mode（`plan`）	讀取/探索、提出計畫、不編輯原始碼	✓	✓
Auto（`auto`）	背景安全檢查、較少提示	✓	✓
Bypass permissions（`bypassPermissions`）	不提示。等同於 CLI `--dangerously-skip-permissions`。Anthropic 的指引：僅在沙箱容器或 VM 中使用。	✓	✓（設定中啟用）
`dontAsk`	僅預先核准的工具	✓	✗

dontAsk 僅限 CLI。其他都對應到傳送按鈕旁的 UI 控制項。CLI 旗標 --dangerously-skip-permissions 對應 Bypass permissions,您必須透過「設定 → Claude Code →『Allow bypass permissions mode』」選擇加入。²

Auto 模式在 Team/Enterprise/API 上需要 Claude Sonnet 4.6、Opus 4.6 或 Opus 4.7;在 Max 上需要 Opus 4.7。Pro 方案或第三方供應商不可用。²

Cowork 分頁與 Dispatch（相鄰但不相同）

桌面應用程式的 Cowork 分頁是另一個具有重疊人機工程的功能。Dispatch 是「從手機傳送任務給 Claude,由它決定要自己處理任務,還是在您的 Mac 上產生 Code 工作階段」。²

配對只需一次：安裝 Claude 行動應用程式,透過 Cowork 分頁將其連結到您的 Mac。之後,您就可以傳簡訊給 Dispatch 任務（「修復登入錯誤,開啟 PR」),它會路由工作。錯誤修復、相依性更新、測試執行與 PR 建立通常會以 Code 工作階段的形式在您的 Mac 上結束,並在側邊欄中帶有 Dispatch 標誌。研究、文件編輯與試算表工作則停留在 Cowork 中。

由 Dispatch 產生的 Code 工作階段的應用程式核准權限會在 30 分鐘後到期(而一般 Code 工作階段則持續整個工作階段),因此長時間執行的 Dispatched 任務可能會重新提示您之前已核准的應用程式權限。²

Dispatch 需要 Pro 或 Max。Team 或 Enterprise 不可用。

這不是 Remote Control。Dispatch 是「傳送任務讓 Claude 自主執行」;Remote Control 是「操控已在執行的工作階段」。它們在文件中被記錄為獨立介面：Remote Control 由 CLI 或 VS Code 託管,Dispatch 產生 Desktop Code 工作階段：而文件目前未描述兩者結合。請根據您是想委派(Dispatch)還是操控(Remote Control)來選擇。

從 CLI 帶過來的東西

桌面應用程式讀取與 CLI 相同的設定檔：²

您專案中的 CLAUDE.md 與 CLAUDE.local.md
~/.claude.json(全域)與 .mcp.json(每專案)用於 MCP 伺服器
在 ~/.claude/settings.json 或 .claude/settings.json 中定義的掛鉤與技能
settings.json 中的權限規則
所有可用的模型

CLI 旗標 → 桌面對應：²

CLI	桌面
`--model sonnet`	傳送按鈕旁的模型下拉式選單
`--resume`、`--continue`	在側邊欄中點擊工作階段
`--permission-mode`	傳送按鈕旁的模式選擇器
`--dangerously-skip-permissions`	Bypass permissions(設定中啟用)
`--add-dir`	遠端工作階段中的 + 按鈕用於新增儲存庫
`--allowedTools`、`--disallowedTools`	沒有逐工作階段的 UI;設定檔規則仍適用
`--verbose`	Transcript 下拉式選單中的 Verbose 檢視模式
`--print`、`--output-format`	不可用：Desktop 僅為互動式
`ANTHROPIC_MODEL` 環境變數	模型下拉式選單
`MAX_THINKING_TOKENS` 環境變數	本機環境編輯器

值得注意的一個設定陷阱：Claude Desktop 聊天應用程式(僅限聊天的用戶端,使用 claude_desktop_config.json)與 Claude Code Desktop(我們在討論的開發人員用戶端)是不同的產品。為聊天應用程式設定的 MCP 伺服器不會出現在 Code 分頁中。Code 讀取 ~/.claude.json 與 .mcp.json,而非 claude_desktop_config.json。²

CLI → 桌面：何時遷移

桌面應用程式在 CLI 不擅長的三件事上表現出色：²

平行工作階段並排：每個 Code 分頁工作階段在 <project-root>/.claude/worktrees/ 獲得自己的 Git worktree。使用 Ctrl+Tab / Ctrl+Shift+Tab 切換。在一個工作階段中執行重構,同時在另一個工作階段中執行測試套件,並以視覺方式而非透過 ANSI 跳脫碼審查它們。
視覺差異審查：點擊 +12 -1 指示器。對行進行註解。使用 Cmd+Enter 將註解提交回 Claude。比在終端機中閱讀內聯差異更好。
內嵌預覽窗格：Claude 可以啟動開發伺服器,並在內嵌瀏覽器中開啟正在執行的應用程式、擷取螢幕截圖、點擊四處,並驗證自己的變更。每個專案預設啟用自動驗證(在 .claude/launch.json 中切換,或透過 Preview 下拉式選單)。²

CLI 在以下方面仍然勝出：腳本(--print、--output-format)、自動化(cron 工作、CI)、tmux/screen 工作流程,以及任何需要 dontAsk 權限模式的工作。

要將 CLI 工作階段移至 Desktop 而不遺失上下文,請在終端機中執行 /desktop。儲存工作階段、在桌面應用程式中開啟、結束 CLI。²

限制與陷阱

文件中的真實情況：¹

每個互動式程序一個遠端工作階段。在伺服器模式之外,每次 claude 呼叫支援一個遠端工作階段。需要多個？使用 claude remote-control(伺服器模式)。
本機程序必須持續執行。 Remote Control 由 claude CLI 程序或 VS Code 擴充功能託管。關閉終端機、結束 VS Code 或終止 claude 程序,遠端工作階段就會結束。沒有從終端機分離的模式。¹
超過 10 分鐘的網路中斷會終止工作階段。Mac 可以是喚醒狀態,但無法連到網路超過 10 分鐘;程序會結束,您必須重新啟動。
Ultraplan 中斷 Remote Control。兩者都佔用 claude.ai/code 介面,且一次只能連線一個。
Auto 模式需要近期模型。 Max 上的 Opus 4.7;Team/Enterprise/API 上的 Sonnet 4.6、Opus 4.6 或 Opus 4.7。Pro 不支援。
API 金鑰與僅推論權杖無法運作。 Remote Control 需要完整範圍的 claude.ai OAuth 登入。如果設定了 ANTHROPIC_API_KEY,請取消設定。如果您透過 claude setup-token 或 CLAUDE_CODE_OAUTH_TOKEN 驗證,請執行 claude auth login 以重新整理。
Team 與 Enterprise 管理員必須啟用它。預設關閉。切換在 claude.ai/admin-settings/claude-code → Remote Control。某些資料保留設定會使切換無法使用。

最常見的「為什麼這沒有運作」失敗：使用者使用僅推論權杖登入。錯誤「Remote Control requires a full-scope login token」對應該情況。修復:claude auth login 並選擇 claude.ai 選項。¹

其他值得了解的疑難排解情況

官方文件涵蓋幾種會讓初學者花費實際時間的失敗模式。摘要如下：¹

「Remote Control requires a claude.ai subscription」：您未透過 claude.ai 進行驗證。如果設定了 ANTHROPIC_API_KEY,請先取消設定,然後執行 claude auth login。
「Unable to determine your organization for Remote Control eligibility」：快取的帳戶資訊已過時。執行 claude auth login 重新整理。
「Remote Control is not yet enabled for your account」：檢查環境中是否有 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC、DISABLE_TELEMETRY、CLAUDE_CODE_USE_BEDROCK、CLAUDE_CODE_USE_VERTEX 或 CLAUDE_CODE_USE_FOUNDRY。Remote Control 需要 claude.ai 驗證;第三方供應商無法運作。取消設定後執行 /logout 然後 /login。
「Remote Control is disabled by your organization’s policy」：根據文件有三個原因：(a) 您使用 API 金鑰或 Console 帳戶(請使用 claude.ai OAuth)、(b) Team/Enterprise 管理員尚未啟用切換、(c) 由於與 Remote Control 不相容的資料保留設定,管理員切換變灰(聯絡 Anthropic 支援)。
「Remote credentials fetch failed」：使用 --verbose 重新執行以查看根本錯誤：claude remote-control --verbose。通常是未登入的情況、防火牆阻擋對 Anthropic API 在 443 上的對外 HTTPS,或更早的工作階段建立失敗(尋找 Session creation failed: see debug log)。
工作區信任對話框：如果 Remote Control 啟動失敗且沒有明顯錯誤,請在專案目錄中至少執行一次 claude 並接受工作區信任對話框。在 Remote Control 註冊工作階段之前,這個步驟是必需的。

CLI 使用者的決策樹

面對實際任務時,根據工作需求選擇模式：

工作需要 Apple 工具鏈（Xcode、模擬器、簽署）嗎？
├── 是 → 本機 CLI 或 本機 + Remote Control
│         （雲端無法存取工具鏈）
│
└── 否 → 它需要您的本機 MCP 伺服器（Yurei、Cloudflare 等）嗎？
         ├── 是 → 本機 CLI 或 本機 + Remote Control
         │
         └── 否 → 您需要從手機監控或操控它嗎？
                  ├── 是 → 本機 + Remote Control,或 雲端工作階段
                  │         （如果任務歷時數小時,雲端較佳）
                  │
                  └── 否 → 本機 CLI 即可

Mac/iOS 應用程式開發:我大多數的應用程式所做的事:每次都落在最上面那一支。雲端工作階段無法 xcodebuild、無法與模擬器通訊、無法簽署。對於 Get Bananas 的 MCP 擴充功能、我以 Yurei 驅動的人口普查指令碼,或 Apple 生態系叢集工作,Apple 工具鏈相依性是無可避免的。本機 + Remote Control 是唯一同時提供該工具鏈與手機可見介面的途徑。

常見問題

我可以在同一個專案上同時執行 CLI 與桌面應用程式嗎？

可以。它們共用設定（CLAUDE.md、~/.claude.json、MCP 伺服器、掛鉤、技能）但維護獨立的工作階段歷史記錄。² 您可以在 iTerm 中執行 claude 工作階段,並在桌面應用程式中執行 Code 分頁工作階段,兩者都指向相同的 ~/Projects/blakecrosley.com,兩者都寫入 git。如果您不使用 worktree,請小心平行寫入。

當我的 Mac 進入睡眠時,Remote Control 工作階段會發生什麼事？

當您的機器恢復連線時,工作階段會自動重新連線。如果您的 Mac 是喚醒狀態但無法連到網路超過約 10 分鐘,工作階段會逾時,您必須以 claude remote-control 啟動新工作階段。¹

Remote Control 適用於 `& task`（背景）語法嗎？

& task 與 Remote Control 是不同的介面。& task 將工作傳送到雲端工作階段。Remote Control 從另一個裝置連線到本機工作階段。它們都可能出現在 claude.ai/code 的工作階段清單中,但雲端工作階段在 Anthropic 基礎架構上執行,而 Remote Control 工作階段在您的機器上執行。¹

我可以將 Remote Control 與第三方供應商（Bedrock、Vertex、Foundry）一起使用嗎？

不行。Remote Control 需要 claude.ai 驗證。如果您設定了 CLAUDE_CODE_USE_BEDROCK、CLAUDE_CODE_USE_VERTEX 或 CLAUDE_CODE_USE_FOUNDRY,資格檢查將失敗,顯示「Remote Control is not yet enabled for your account」。請取消設定並重新執行。¹

`--remote-control` 與 `claude remote-control` 有何不同？

claude --remote-control（或 --rc）會在您的終端機中啟動正常的互動式工作階段,並啟用 Remote Control。您可以在本機輸入,同時也可以從另一個裝置輸入。claude remote-control（沒有旗標,子命令）是伺服器模式：終端機變成沒有本機提示的伺服器,只有連線狀態。兩者預設都建立一個遠端工作階段;伺服器模式可以透過 --capacity 或 --spawn 提供多個。¹

桌面應用程式具有像 CLI 一樣的技能、外掛與掛鉤嗎？

有。它們是相同的技能、外掛與掛鉤。桌面應用程式與 CLI 一樣讀取 ~/.claude/settings.json 與專案層級的 .claude/settings.json。點擊提示框旁邊的 + 按鈕來瀏覽已安裝的外掛與技能。外掛在遠端（雲端）工作階段中不可用,但在本機桌面工作階段中運作正常。²

為什麼 `/mcp` 在我的手機上無法運作？

/mcp 開啟一個需要僅限終端機 UI 進行選取的互動式選擇器。它僅限本機。/plugin 與 /resume 也是如此。¹ 任何產生文字輸出的命令（/compact、/clear、/context、/usage、/extra-usage、/exit、/recap、/reload-plugins）都可從行動裝置與網頁使用。

有免費方案嗎,還是這一切都需要訂閱？

Remote Control 在 Pro、Max、Team 與 Enterprise 方案中可用。API 金鑰不受支援。在 Team 與 Enterprise 上,管理員必須先在 claude.ai 管理設定中啟用 Remote Control 切換,使用者才會看到該功能。¹ 桌面應用程式本身可免費下載,但需要 claude.ai 登入才能使用。

最簡短的版本：本機 CLI 是基礎。桌面應用程式是同一基礎的圖形化用戶端。/remote-control 是讓基礎可從手機存取的橋樑。 根據工作需求與您所在的位置進行選擇。

參考資料

Anthropic,「Continue local sessions from any device with Remote Control」。claude remote-control、claude --remote-control、/remote-control、推播通知、需求、疑難排解矩陣與限制的權威參考。本文全文引用。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩
Anthropic,「Use Claude Code Desktop」。三分頁結構（Chat、Cowork、Code）、工作階段啟動設定、權限模式、差異檢視、預覽窗格、透過 Git worktrees 的平行工作階段、「Coming from the CLI？」比較表、Dispatch、電腦使用。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩
GitHub Releases for Claude Code v2.1.105–v2.1.112：透過 Remote Control 的推播通知（v2.1.110+）、/recap + Session Recap、/ultrareview、/less-permission-prompts、Max 上 Opus 4.7 的 Auto Mode、PreCompact 掛鉤可阻擋。請參閱 v2.1.110 發行說明了解推播通知工具公告。 ↩↩↩
本機工作階段儲存慣例：~/.claude/projects/<sanitized-project-path>/<session-id>.jsonl。工作階段是隨工作階段進度附加的 JSONL 檔案。僅本機程序可見;不會同步至 Anthropic 帳戶。 ↩
/extra-usage Remote Control 用戶端支援於 v2.1.113 新增。請參閱 Claude Code release history。較舊版本只能從本機終端機使用。 ↩

Claude Code Mac 桌面應用程式 + 遠端控制：CLI 使用者指南

重要的三種模式

1. 本機 CLI

2. 雲端工作階段

3. 本機 + Remote Control

設定 Mac 桌面應用程式

開始前的需求

啟動 Remote Control 工作階段的四種方式

伺服器模式：`claude remote-control`

互動式：`claude --remote-control`

斜線命令：`/remote-control`

VS Code 擴充功能

永遠開啟：`/config` →「Enable Remote Control for all sessions」

推播通知的故事

遠端可用的斜線命令

權限模式略有不同

Cowork 分頁與 Dispatch（相鄰但不相同）

從 CLI 帶過來的東西

CLI → 桌面：何時遷移

限制與陷阱

其他值得了解的疑難排解情況

CLI 使用者的決策樹

常見問題

我可以在同一個專案上同時執行 CLI 與桌面應用程式嗎？

當我的 Mac 進入睡眠時,Remote Control 工作階段會發生什麼事？

Remote Control 適用於 `& task`（背景）語法嗎？

我可以將 Remote Control 與第三方供應商（Bedrock、Vertex、Foundry）一起使用嗎？

`--remote-control` 與 `claude remote-control` 有何不同？

桌面應用程式具有像 CLI 一樣的技能、外掛與掛鉤嗎？

為什麼 `/mcp` 在我的手機上無法運作？

有免費方案嗎,還是這一切都需要訂閱？

參考資料

相關文章

兩個MCP伺服器讓Claude Code變成iOS建置系統

為 Claude Code 打造自訂技能：完整教學指南

用十個大腦思考：我如何將多智能體審議作為決策工具

重要的三種模式

1. 本機 CLI

2. 雲端工作階段

3. 本機 + Remote Control

設定 Mac 桌面應用程式

開始前的需求

啟動 Remote Control 工作階段的四種方式

伺服器模式：claude remote-control

互動式：claude --remote-control

斜線命令：/remote-control

VS Code 擴充功能

永遠開啟：/config →「Enable Remote Control for all sessions」

推播通知的故事

遠端可用的斜線命令

權限模式略有不同

Cowork 分頁與 Dispatch（相鄰但不相同）

從 CLI 帶過來的東西

CLI → 桌面：何時遷移

限制與陷阱

其他值得了解的疑難排解情況

CLI 使用者的決策樹

常見問題

我可以在同一個專案上同時執行 CLI 與桌面應用程式嗎？

當我的 Mac 進入睡眠時,Remote Control 工作階段會發生什麼事？

Remote Control 適用於 & task（背景）語法嗎？

我可以將 Remote Control 與第三方供應商（Bedrock、Vertex、Foundry）一起使用嗎？

--remote-control 與 claude remote-control 有何不同？

桌面應用程式具有像 CLI 一樣的技能、外掛與掛鉤嗎？

為什麼 /mcp 在我的手機上無法運作？

有免費方案嗎,還是這一切都需要訂閱？

參考資料

相關文章

兩個MCP伺服器讓Claude Code變成iOS建置系統

為 Claude Code 打造自訂技能：完整教學指南

用十個大腦思考：我如何將多智能體審議作為決策工具

伺服器模式：`claude remote-control`

互動式：`claude --remote-control`

斜線命令：`/remote-control`

永遠開啟：`/config` →「Enable Remote Control for all sessions」

Remote Control 適用於 `& task`（背景）語法嗎？

`--remote-control` 與 `claude remote-control` 有何不同？

為什麼 `/mcp` 在我的手機上無法運作？