> ## Documentation Index > Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Desktop 應用程式 > 充分利用 Claude Code Desktop：具有 Git 隔離的並行會話、拖放窗格佈局、整合終端機和檔案編輯器、側邊聊天、電腦使用、從您的手機 Dispatch 會話、視覺化差異檢查、應用程式預覽、PR 監控、連接器和企業配置。 Claude Desktop 應用程式有三個標籤：**Chat** 用於對話、**Cowork** 用於 [Dispatch 和更長的代理工作](https://claude.com/product/cowork)，以及 **Code** 用於軟體開發。本頁面是 Code 標籤的參考。 Universal build for Intel and Apple Silicon For x64 processors apt or .deb for Ubuntu and Debian For Windows ARM64, download the [ARM64 installer](https://claude.ai/api/desktop/win32/arm64/setup/latest/redirect?utm_source=claude_code\&utm_medium=docs). On Linux, install with apt; see [Claude Desktop on Linux](/en/desktop-linux). 安裝後，啟動 Claude，登入，然後點擊 **Code** 標籤。第一次在 Windows 上開啟時，您需要安裝 [Git for Windows](https://git-scm.com/downloads/win)；安裝後請重新啟動應用程式。如需您第一個會話的逐步說明，請參閱[快速入門指南](/zh-TW/desktop-quickstart)。 在 Code 標籤中，每個對話都是一個**會話**：它有自己的聊天歷史記錄、專案資料夾和程式碼變更，獨立於任何其他會話。側邊欄列出您的會話，並讓您並行執行多個會話。在會話中，您可以： * [使用差異檢查檢查和評論變更](#review-changes-with-diff-view)，然後[透過 CI 監控產生的 PR](#monitor-pull-request-status) * [在嵌入式瀏覽器中預覽您執行的應用程式](#preview-your-app)，同時 Claude 驗證其自己的變更 * [排列窗格](#arrange-your-workspace)，將聊天、差異、預覽、終端機和檔案編輯器並排放置 * 提出[側邊問題](#ask-a-side-question-without-derailing-the-session)，使用會話的內容而不會偏離主題 * [連接外部工具](#connect-external-tools)，例如 GitHub、Slack 和 Linear * 讓 Claude [開啟應用程式並控制您的螢幕](#let-claude-use-your-computer) * 在您的機器上、[雲端](#run-long-running-tasks-remotely)或 [SSH](#ssh-sessions) 上執行 如需[排程定期工作](/zh-TW/desktop-scheduled-tasks)、[快捷鍵](#keyboard-shortcuts)或[從您的手機傳送任務](#sessions-from-dispatch)，請參閱連結的頁面和章節。如果您已經使用基於終端機的 CLI，請參閱 [CLI 比較](#coming-from-the-cli)以了解哪些內容可以轉移。

開始會話

在發送第一條訊息之前，在提示區域中配置四項內容： * **環境**：選擇 Claude 執行的位置。選擇 **Local** 用於您的機器、**Remote** 用於 Anthropic 託管的雲端會話，或用於您管理的遠端機器的 [**SSH 連線**](#ssh-sessions)。請參閱[環境配置](#environment-configuration)。 * **專案資料夾**：選擇 Claude 工作的資料夾或儲存庫。對於遠端會話，您可以新增[多個儲存庫](#run-long-running-tasks-remotely)。 * **模型**：從傳送按鈕旁的下拉式選單中選擇[模型](/zh-TW/model-config#available-models)。您可以在會話期間變更此設定。 * **權限模式**：從[模式選擇器](#choose-a-permission-mode)中選擇 Claude 擁有多少自主權。您可以在會話期間變更此設定。 輸入您的任務並按 **Enter** 開始。每個會話都會追蹤自己的上下文並獨立進行變更。

使用程式碼

為 Claude 提供正確的上下文，控制它自主執行的程度，並檢查它所做的變更。

使用提示框

輸入您想讓 Claude 執行的操作，然後按 **Enter** 傳送。Claude 會讀取您的專案檔案、進行變更，並根據您的[權限模式](#choose-a-permission-mode)執行命令。您可以隨時中斷 Claude：點擊停止按鈕以立即中斷，或輸入更正並按 **Enter** 傳送，而不停止正在執行的操作。Claude 會在目前操作完成後立即讀取更正，並在下一步之前進行調整。 提示框旁的 **+** 按鈕可讓您存取檔案附件、[skills](#use-skills)、[連接器](#connect-external-tools)和[plugins](#install-plugins)。

將檔案和上下文新增到提示

提示框支援兩種方式來引入外部上下文： * **@mention 檔案**：輸入 `@` 後跟檔案名稱，將檔案新增到對話上下文。Claude 隨後可以讀取和參考該檔案。@mention 在雲端會話中不可用。 * **附加檔案**：使用附件按鈕將影像、PDF 和其他檔案附加到您的提示，或直接將檔案拖放到提示中。這對於分享錯誤的螢幕截圖、設計模型或參考文件很有用。

選擇權限模式

權限模式控制 Claude 在會話期間擁有多少自主權：它是否在編輯檔案、執行命令或兩者之前詢問。您可以隨時使用傳送按鈕旁的模式選擇器切換模式。從「詢問權限」開始，以查看 Claude 確切執行的操作，然後隨著您變得更加熟悉，移至「自動接受編輯」或 Plan mode。 | 模式 | 設定金鑰 | 行為 | | ------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------- | | **詢問權限** | `default` | Claude 在編輯檔案或執行命令之前詢問。您會看到差異，並可以接受或拒絕每項變更。建議新使用者使用。 | | **自動接受編輯** | `acceptEdits` | Claude 自動接受檔案編輯和常見的檔案系統命令，如 `mkdir`、`touch` 和 `mv`，但在執行其他終端機命令之前仍會詢問。當您信任檔案變更並想要更快速的迭代時，請使用此選項。 | | **Plan mode** | `plan` | Claude 讀取檔案並執行命令以探索，然後提出計畫而不編輯您的原始程式碼。適合您想要先檢查方法的複雜任務。 | | **Auto** | `auto` | Claude 執行所有操作，並進行背景安全檢查以驗證與您的請求的一致性。減少權限提示，同時保持監督。在您的「設定」→「Claude Code」中啟用。請參閱下方的[可用性要求](#auto-mode-availability)。 | | **略過權限** | `bypassPermissions` | Claude 執行時不會有任何權限提示，相當於 CLI 中的 `--dangerously-skip-permissions`。在「設定」→「Claude Code」下的「允許略過權限模式」中啟用。僅在沙箱容器或虛擬機器中使用。企業管理員可以停用此選項。 | `dontAsk` 權限模式僅在 [CLI](/zh-TW/permission-modes#allow-only-pre-approved-tools-with-dontask-mode) 中可用。 Auto mode 是在 Anthropic API 上提供給所有使用者的研究預覽版。它需要 Claude Opus 4.6 或更新版本，或 Sonnet 4.6 或更新版本。在路由 Desktop 至 Google Cloud Vertex AI 的企業部署中，Auto mode 預設為關閉，直到您[設定 `CLAUDE_CODE_ENABLE_AUTO_MODE`](/zh-TW/permission-modes#enable-auto-mode-on-bedrock-vertex-ai-or-foundry)，且僅支援 Claude Sonnet 5、Opus 4.7 和 Opus 4.8。 在 Plan mode 中開始複雜任務，以便 Claude 在進行變更之前規劃方法。一旦您批准計畫，切換到'自動接受編輯'或'詢問權限'以執行它。有關此工作流程的更多資訊，請參閱[先探索，然後計畫，然後編碼](/zh-TW/best-practices#explore-first-then-plan-then-code)。 雲端會話支援'自動接受編輯'、Plan mode 和 Auto mode。'自動接受編輯'對應於 `default` 模式：雲端會話預先批准檔案編輯，因此選擇器顯示'自動接受編輯'而不是'詢問權限'。'略過權限'不可用，因為雲端環境已經是沙箱化的。 企業管理員可以限制哪些權限模式可用。有關詳細資訊，請參閱[企業配置](#enterprise-configuration)。

預覽您的應用程式

Claude 可以啟動開發伺服器並開啟嵌入式瀏覽器來驗證其變更。這適用於前端網路應用程式以及後端伺服器：Claude 可以測試 API 端點、檢視伺服器日誌，並對其發現的問題進行迭代。在大多數情況下，Claude 在編輯專案檔案後會自動啟動伺服器。您也可以隨時要求 Claude 進行預覽。預設情況下，Claude [自動驗證](#auto-verify-changes)每次編輯後的變更。 預覽窗格也可以開啟您專案中的靜態 HTML 檔案、PDF、影像和影片。點擊聊天中的 HTML、PDF、影像或影片路徑以在預覽中開啟它。 從預覽窗格，您可以： * 直接在嵌入式瀏覽器中與執行中的應用程式互動 * 觀看 Claude 自動驗證自己的變更：它會擷取螢幕截圖、檢查 DOM、點擊元素、填寫表單，並修復它發現的問題 * 從會話工具列中的 **Preview** 下拉式選單啟動或停止伺服器 * 透過在下拉式選單中選擇 **Persist sessions**，在伺服器重新啟動時保留 Cookie 和本機儲存，這樣您就不必在開發期間重新登入 * 編輯伺服器配置或一次停止所有伺服器 Claude 根據您的專案建立初始伺服器配置。如果您的應用程式使用自訂開發命令，請編輯 `.claude/launch.json` 以符合您的設定。有關完整參考，請參閱[配置預覽伺服器](#configure-preview-servers)。 若要清除已儲存的會話資料，請在'設定'→'Claude Code'中切換 **Persist preview sessions** 關閉。若要完全停用預覽，請在'設定'→'Claude Code'中切換 **Preview** 關閉。

使用差異檢查檢查變更

Claude 對您的程式碼進行變更後，差異檢查可讓您在建立提取請求之前逐個檔案檢查修改。 當 Claude 變更檔案時，會出現一個差異統計指示器，顯示新增和移除的行數，例如 `+12 -1`。點擊此指示器以開啟差異檢視器，它在左側顯示檔案清單，在右側顯示每個檔案的變更。 若要對特定行進行註解，請點擊差異中的任何行以開啟註解框。輸入您的回饋並按 **Enter** 新增註解。在多行新增註解後，一次提交所有註解： * **macOS**：按 **Cmd+Enter** * **Windows**：按 **Ctrl+Enter** Claude 會讀取您的註解並進行要求的變更，這些變更會顯示為您可以檢查的新差異。

檢查您的程式碼

在差異檢查中，點擊右上角工具列中的 **Review code**，要求 Claude 在您提交之前評估變更。Claude 會檢查目前的差異，並直接在差異檢查中留下註解。您可以回應任何註解或要求 Claude 進行修訂。 檢查著重於高信號問題：編譯錯誤、明確的邏輯錯誤、安全漏洞和明顯的錯誤。它不會標記樣式、格式、預先存在的問題或任何 linter 會捕捉的內容。

監控提取請求狀態

開啟提取請求後，CI 狀態列會出現在會話中。Claude Code 使用 GitHub CLI 來輪詢檢查結果並顯示失敗。 * **自動修復**：啟用後，Claude 會透過讀取失敗輸出並進行迭代，自動嘗試修復失敗的 CI 檢查。 * **自動合併**：啟用後，Claude 會在所有檢查通過後合併 PR。合併方法是壓縮。自動合併必須在您的 GitHub 儲存庫設定中[啟用](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-auto-merge-for-pull-requests-in-your-repository)才能運作。 使用 CI 狀態列中的 **Auto-fix** 和 **Auto-merge** 切換來啟用任一選項。Claude Code 也會在 CI 完成時傳送桌面通知。若要在 PR 合併或關閉後自動存檔會話，請在'設定'→'Claude Code'中開啟[自動存檔](#work-in-parallel-with-sessions)。 PR 監控需要在您的機器上安裝並驗證 [GitHub CLI (`gh`)](https://cli.github.com/)。如果未安裝 `gh`，Desktop 會在您第一次嘗試建立 PR 時提示您安裝它。

安排您的工作區

Code 標籤是圍繞您可以以任何佈局排列的窗格構建的：聊天、差異、預覽、終端機、檔案、plan、tasks 和 subagent。透過其標題拖動窗格以重新定位它，或拖動窗格邊緣以調整其大小。在 macOS 上按 **Cmd+\\** 或在 Windows 上按 **Ctrl+\\** 以關閉焦點窗格。從會話工具列中的 **Views** 選單開啟其他窗格。 本節中的窗格佈局、終端機、檔案編輯器和檢視模式需要 Claude Desktop v1.2581.0 或更新版本。在 macOS 上開啟 **Claude → Check for Updates** 或在 Windows 上開啟 **Help → Check for Updates** 以更新。

在終端機中執行命令

整合終端機讓您在會話旁執行命令，而無需切換到另一個應用程式。從 **Views** 選單開啟它，或在 macOS 或 Windows 上按 **Ctrl+\`**。終端機在您會話的工作目錄中開啟，並與 Claude 共用相同的環境，因此 `npm test` 或 `git status` 等命令會看到 Claude 正在編輯的相同檔案。若要開啟第二個終端機標籤，請點擊終端機窗格標題中的 **+** 或右鍵點擊聊天中的資料夾以選擇 **Open in terminal**。終端機僅在本機會話中可用。

開啟和編輯檔案

點擊聊天或差異檢視器中的檔案路徑以在檔案窗格中開啟它。HTML、PDF、影像和影片路徑改為在[預覽窗格](#preview-your-app)中開啟。進行現場編輯並點擊 **Save** 以寫回。如果自您開啟檔案以來檔案在磁碟上已變更，窗格會警告您並讓您覆蓋或放棄。點擊 **Discard** 以還原您的編輯，或點擊窗格標題中的路徑以複製絕對路徑。 檔案窗格在本機和 SSH 會話中可用。對於遠端會話，要求 Claude 進行變更。

在其他應用程式中開啟檔案

右鍵點擊聊天、差異檢視器或檔案窗格中的任何檔案路徑以開啟上下文選單： * **Attach as context**：將檔案新增到您的下一個提示 * **Open in**：在已安裝的編輯器（如 VS Code、Cursor 或 Zed）中開啟檔案 * **Show in Finder**（在 macOS 上），**Show in Explorer**（在 Windows 上）：開啟包含資料夾 * **Copy path**：將絕對路徑複製到您的剪貼簿

切換檢視模式

檢視模式控制聊天記錄中顯示多少詳細資訊。從傳送按鈕旁的 **Transcript view** 下拉式選單切換模式，或在 macOS 或 Windows 上按 **Ctrl+O** 以循環瀏覽它們。 | 模式 | 它顯示什麼 | | ----------- | -------------------------- | | **Normal** | 工具呼叫摺疊成摘要，具有完整文字回應 | | **Verbose** | Claude 採取的每個工具呼叫、檔案讀取和中間步驟 | | **Summary** | 僅 Claude 的最終回應和它所做的變更 | 在調試 Claude 為什麼採取特定操作時使用 Verbose。當您執行多個會話並想要快速掃描結果時，使用 Summary。

快捷鍵

在 macOS 上按 **Cmd+/** 或在 Windows 上按 **Ctrl+/** 以查看 Code 標籤中可用的所有快捷鍵。在 Windows 上，對下面的快捷鍵使用 **Ctrl** 代替 **Cmd**。會話循環、終端機切換和檢視模式切換在每個平台上都使用 **Ctrl**。 | 快捷鍵 | 操作 | | ------------------------------------- | ------------- | | `Cmd` `/` | 顯示快捷鍵 | | `Cmd` `N` | 新會話 | | `Cmd` `W` | 關閉會話 | | `Ctrl` `Tab` / `Ctrl` `Shift` `Tab` | 下一個或上一個會話 | | `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | 下一個或上一個會話 | | `Esc` | 停止 Claude 的回應 | | `Cmd` `Shift` `D` | 切換差異窗格 | | `Cmd` `Shift` `P` | 切換預覽窗格 | | `Cmd` `Shift` `S` | 在預覽中選擇元素 | | `Ctrl` `` ` `` | 切換終端機窗格 | | `Cmd` `\` | 關閉焦點窗格 | | `Cmd` `;` | 開啟側邊聊天 | | `Ctrl` `O` | 循環檢視模式 | | `Cmd` `Shift` `M` | 開啟權限模式選單 | | `Cmd` `Shift` `I` | 開啟模型選單 | | `Cmd` `Shift` `E` | 開啟工作量選單 | | `1`–`9` | 在開啟的選單中選擇項目 | 這些快捷鍵僅適用於 Code 標籤。終端機型 [interactive mode 快捷鍵](/zh-TW/interactive-mode#keyboard-shortcuts)（如 `Shift+Tab` 以循環模式）不適用於 Desktop。

檢查使用情況

點擊模型選擇器旁的使用情況環以查看您目前的上下文視窗使用情況和您計畫在該期間的使用情況。上下文使用情況是按會話的；計畫使用情況在您所有 Claude Code 介面中共用。

讓 Claude 使用您的電腦

電腦使用讓 Claude 開啟您的應用程式、控制您的螢幕，並以您的方式直接在您的機器上工作。要求 Claude 在行動模擬器中測試原生應用程式、與沒有 CLI 的桌面工具互動，或自動化只能透過 GUI 運作的內容。 電腦使用是 macOS 和 Windows 上的研究預覽版，需要 Pro 或 Max 計畫。它在 Team 或 Enterprise 計畫上不可用。Claude Desktop 應用程式必須執行。 電腦使用預設為關閉。[在設定中啟用它](#enable-computer-use)，然後 Claude 才能控制您的螢幕。在 macOS 上，您還需要授予協助工具和螢幕錄製權限。 與[沙箱化 Bash 工具](/zh-TW/sandboxing)不同，電腦使用在您的實際桌面上執行，可以存取您批准的任何內容。Claude 會檢查每個操作並標記螢幕上內容的潛在提示注入，但信任邊界不同。有關最佳實踐，請參閱[電腦使用安全指南](https://support.claude.com/en/articles/14128542)。

何時應用電腦使用

Claude 有多種方式與應用程式或服務互動，電腦使用是最廣泛和最慢的。它首先嘗試最精確的工具： * 如果您有服務的[連接器](#connect-external-tools)，Claude 會使用連接器。 * 如果任務是 shell 命令，Claude 會使用 Bash。 * 如果任務是瀏覽器工作且您已設定[Chrome 中的 Claude](/zh-TW/chrome)，Claude 會使用它。 * 如果以上都不適用，Claude 會使用電腦使用。 [每個應用程式的存取層級](#app-permissions)強化了這一點：瀏覽器限制為僅檢視，終端機和 IDE 限制為僅點擊，引導 Claude 使用專用工具，即使電腦使用處於活動狀態。螢幕控制保留給其他工具無法到達的內容，例如原生應用程式、硬體控制面板、行動模擬器或沒有 API 的專有工具。

啟用電腦使用

電腦使用預設為關閉。如果您要求 Claude 執行需要它的操作而它處於關閉狀態，Claude 會告訴您如果在設定中啟用電腦使用，它可以執行該任務。 確保您有最新版本的 Claude Desktop。在 [claude.com/download](https://claude.com/download) 下載或更新，然後重新啟動應用程式。 在桌面應用程式中，前往 **Settings > General**（在 **Desktop app** 下）。找到 **Computer use** 切換並開啟它。在 Windows 上，切換立即生效，設定完成。在 macOS 上，繼續下一步。 如果您看不到切換，請確認您在 macOS 或 Windows 上使用 Pro 或 Max 計畫，然後更新並重新啟動應用程式。 在 macOS 上，在切換生效之前授予兩個系統權限： * **Accessibility**：讓 Claude 點擊、輸入和滾動 * **Screen Recording**：讓 Claude 看到您螢幕上的內容 「設定」頁面顯示每個權限的目前狀態。如果任一被拒絕，點擊徽章以開啟相關的「系統設定」窗格。

應用程式權限

Claude 第一次需要使用應用程式時，會在您的會話中出現提示。點擊 **Allow for this session** 或 **Deny**。批准在目前會話中持續，或在 [Dispatch 產生的會話](#sessions-from-dispatch)中持續 30 分鐘。 提示也顯示 Claude 對該應用程式獲得的控制級別。這些層級由應用程式類別固定，無法變更： | 層級 | Claude 可以執行的操作 | 適用於 | | :--- | :---------------- | :------- | | 僅檢視 | 在螢幕截圖中查看應用程式 | 瀏覽器、交易平台 | | 僅點擊 | 點擊和滾動，但不能輸入或使用快捷鍵 | 終端機、IDE | | 完全控制 | 點擊、輸入、拖動和使用快捷鍵 | 其他所有內容 | 具有廣泛影響力的應用程式（如終端機、Finder 或檔案總管，以及「系統設定」或「設定」）在提示中顯示額外警告，以便您知道批准它們會授予什麼。 您可以在 **Settings > General**（在 **Desktop app** 下）中配置兩個設定： * **Denied apps**：在此處新增應用程式以拒絕它們而不提示。Claude 可能仍會透過允許應用程式中的操作間接影響被拒絕的應用程式，但它無法直接與被拒絕的應用程式互動。 * **Unhide apps when Claude finishes**：當 Claude 工作時，您的其他視窗會被隱藏，以便它僅與批准的應用程式互動。當 Claude 完成時，隱藏的視窗會被恢復，除非您關閉此設定。

管理會話

每個會話都是一個獨立的對話，具有自己的上下文和變更。您可以並行執行多個會話、分支出側邊聊天、將工作傳送到雲端，或讓 Dispatch 從您的手機為您啟動會話。

使用會話並行工作

點擊側邊欄中的 **+ New session**，或在 macOS 上按 **Cmd+N** 或在 Windows 上按 **Ctrl+N**，以並行處理多個任務。按 **Ctrl+Tab** 和 **Ctrl+Shift+Tab** 以循環瀏覽側邊欄中的會話。對於 Git 儲存庫，每個會話都會使用 [Git worktrees](/zh-TW/worktrees) 獲得自己的隔離專案副本，因此一個會話中的變更不會影響其他會話，直到您提交它們。 若要同時檢視兩個會話，請在 macOS 上按住 **Cmd** 或在 Windows 上按住 **Ctrl**，然後點擊側邊欄中的會話。會話會在您已開啟的會話旁邊的第二個窗格中開啟。當分割處於活動狀態時，點擊另一個側邊欄會話會取代具有焦點的窗格。在 macOS 上按 **Cmd+\\** 或在 Windows 上按 **Ctrl+\\** 以關閉焦點窗格並返回單一會話。 Worktrees 預設儲存在 `/.claude/worktrees/` 中。您可以在「設定」→「Claude Code」下的「Worktree location」中將其變更為自訂目錄。您也可以設定一個分支前綴，該前綴會被加在每個 worktree 分支名稱前面，這對於保持 Claude 建立的分支井然有序很有用。若要在完成後移除 worktree，請將滑鼠懸停在側邊欄中的會話上，然後點擊存檔圖示。若要在 PR 合併或關閉後自動存檔會話，請在「設定」→「Claude Code」中開啟 **Auto-archive after PR merge or close**。自動存檔僅適用於已完成執行的本機會話。 若要在新 worktrees 中包含 gitignored 檔案（如 `.env`），請在您的專案根目錄中建立 [`.worktreeinclude` 檔案](/zh-TW/worktrees#copy-gitignored-files-into-worktrees)。 會話隔離需要 [Git](https://git-scm.com/downloads)。大多數 Mac 預設包含 Git。在終端機中執行 `git --version` 進行檢查。在 Windows 上，Code 標籤需要 Git 才能運作：[下載 Git for Windows](https://git-scm.com/downloads/win)、安裝它，然後重新啟動應用程式。如果您遇到 Git 錯誤，請在 [Cowork 標籤](https://claude.com/product/cowork) 中詢問 Claude 以幫助排除您的設定問題。 使用側邊欄頂部的控制項按狀態、專案或環境篩選會話，並按專案分組會話。若要重新命名會話，請點擊活動會話頂部工具列中的會話標題。若要檢查上下文使用情況，請參閱[檢查使用情況](#check-usage)。當上下文填滿時，Claude 會自動總結對話並繼續工作。您也可以輸入 `/compact` 來更早觸發總結並釋放上下文空間。有關壓縮如何運作的詳細資訊，請參閱[上下文視窗](/zh-TW/how-claude-code-works#the-context-window)。 桌面應用程式會在 Code 會話完成任務且您目前未檢視該會話時傳送作業系統通知。

在不偏離會話的情況下詢問側邊問題

側邊聊天讓您詢問 Claude 一個使用您會話上下文的問題，但不會將任何內容新增回主對話。當您想要理解一段程式碼、檢查假設或探索想法而不引導會話偏離時，請使用它。 在 macOS 上按 **Cmd+;** 或在 Windows 上按 **Ctrl+;** 以開啟側邊聊天，或在提示框中輸入 `/btw`。側邊聊天可以讀取主執行緒中到該點為止的所有內容。完成後，關閉側邊聊天並在您離開的地方繼續主會話。側邊聊天在本機和 SSH 會話中可用。

觀看背景任務

任務窗格顯示在目前會話內執行的背景工作：子代理、背景 shell 命令和[動態工作流程](/zh-TW/workflows)。從 **Views** 選單開啟它或將其拖入您的佈局。 點擊任何項目以在子代理窗格中查看其輸出或停止它。若要查看其他會話正在執行的操作，請使用[側邊欄](#work-in-parallel-with-sessions)。

遠端執行長時間執行的任務

對於大型重構、測試套件、遷移或其他長時間執行的任務，在開始會話時選擇 **Remote** 而不是 **Local**。遠端會話在 Anthropic 的雲端基礎設施上執行，即使您關閉應用程式或關閉電腦，也會繼續執行。隨時檢查以查看進度或引導 Claude 朝不同方向發展。您也可以從 [claude.ai/code](https://claude.ai/code) 或 Claude iOS 應用程式監控遠端會話。 遠端會話也支援多個儲存庫。選擇雲端環境後，點擊儲存庫藥丸旁的 **+** 按鈕，將其他儲存庫新增到會話。每個儲存庫都有自己的分支選擇器。這對於跨越多個程式碼庫的任務很有用，例如更新共用程式庫及其使用者。 有關遠端會話如何運作的更多資訊，請參閱[網路上的 Claude Code](/zh-TW/claude-code-on-the-web)。

在另一個介面中繼續

**Continue in** 選單可從會話工具列右下角的 VS Code 圖示存取，可讓您將會話移至另一個介面： * **Claude Code on the Web**：將您的本機會話傳送到遠端繼續執行。Desktop 推送您的分支、產生對話摘要，並使用完整上下文建立新的遠端會話。然後您可以選擇存檔本機會話或保留它。這需要乾淨的工作樹，不適用於 SSH 會話。 * **Your IDE**：在目前工作目錄的支援 IDE 中開啟您的專案。

來自 Dispatch 的會話

[Dispatch](https://support.claude.com/en/articles/13947068) 是與 Claude 的持久對話，存在於 [Cowork](https://claude.com/product/cowork#dispatch-and-computer-use) 標籤中。您向 Dispatch 傳送任務，它決定如何處理它。 任務可以透過兩種方式成為 Code 會話：您直接要求一個，例如「開啟 Claude Code 會話並修復登入錯誤」，或 Dispatch 決定任務是開發工作並自行產生一個。通常路由到 Code 的任務包括修復錯誤、更新相依性、執行測試或開啟提取請求。研究、文件編輯和試算表工作保留在 Cowork 中。 無論哪種方式，Code 會話都會在 Code 標籤的側邊欄中出現，帶有 **Dispatch** 徽章。當它完成或需要您的批准時，您會在手機上收到推送通知。 如果您已[啟用電腦使用](#let-claude-use-your-computer)，Dispatch 產生的 Code 會話也可以使用它。這些會話中的應用程式批准在 30 分鐘後過期並重新提示，而不是像常規 Code 會話那樣持續整個會話。 有關設定、配對和 Dispatch 設定，請參閱 [Dispatch 幫助文章](https://support.claude.com/en/articles/13947068)。Dispatch 需要 Pro 或 Max 計畫，在 Team 或 Enterprise 計畫上不可用。 Dispatch 是當您遠離終端機時與 Claude 合作的多種方式之一。請參閱[平台和整合](/zh-TW/platforms#work-when-you-are-away-from-your-terminal)以將其與遠端控制、頻道、Slack 和排程任務進行比較。

擴展 Claude Code

連接外部服務、新增可重複使用的工作流程、自訂 Claude 的行為，並配置預覽伺服器。若要在一個地方管理連接器、skills 和 plugins，請點擊側邊欄中的 **Customize**。

連接外部工具

對於本機和 [SSH](#ssh-sessions) 會話，點擊提示框旁的 **+** 按鈕，然後選擇 **Connectors** 以新增 Google Calendar、Slack、GitHub、Linear、Notion 等整合。您可以在會話之前或期間新增連接器。**+** 按鈕在雲端會話中不可用，但 [routines](/zh-TW/routines) 在 routine 建立時配置連接器。 若要管理或斷開連接器，請在桌面應用程式中前往「設定」→「Connectors」，或從提示框中的「Connectors」選單中選擇 **Manage connectors**。 連接後，Claude 可以讀取您的日曆、傳送訊息、建立問題，並直接與您的工具互動。您可以詢問 Claude 在您的會話中配置了哪些連接器。 連接器是 [MCP servers](/zh-TW/mcp)，具有圖形設定流程。使用它們可以快速與支援的服務整合。對於「Connectors」中未列出的整合，透過 [settings files](/zh-TW/mcp#installing-mcp-servers) 手動新增 MCP servers。您也可以 [create custom connectors](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp)。

使用 skills

[Skills](/zh-TW/skills) 擴展 Claude 可以執行的操作。Claude 在相關時自動載入它們，或者您可以直接呼叫一個：在提示框中輸入 `/` 或點擊 **+** 按鈕並選擇 **Slash commands** 以瀏覽可用的內容。這包括 [built-in commands](/zh-TW/commands)、您的 [custom skills](/zh-TW/skills#create-your-first-skill)、來自您程式碼庫的專案 skills，以及來自任何 [installed plugins](/zh-TW/plugins) 的 skills。選擇一個，它會在輸入欄位中突出顯示。在其後輸入您的任務並照常傳送。

安裝 plugins

[Plugins](/zh-TW/plugins) 是可重複使用的套件，可將 skills、agents、hooks、MCP servers 和 LSP 配置新增到 Claude Code。您可以從桌面應用程式安裝 plugins，而無需使用終端機。 對於本機和 [SSH](#ssh-sessions) 會話，點擊提示框旁的 **+** 按鈕，然後選擇 **Plugins** 以查看您已安裝的 plugins 及其 skills。若要新增 plugin，從子選單中選擇 **Add plugin** 以開啟 plugin 瀏覽器，它顯示來自您配置的 [marketplaces](/zh-TW/plugin-marketplaces)（包括官方 Anthropic 市場）的可用 plugins。選擇 **Manage plugins** 以啟用、停用或解除安裝 plugins。 Plugins 可以限定於您的使用者帳戶、特定專案或僅本機。如果您的組織集中管理 plugins，這些 plugins 在桌面會話中的可用方式與在 CLI 中相同。雲端會話不提供 Plugins。有關完整的 plugin 參考（包括建立您自己的 plugins），請參閱 [plugins](/zh-TW/plugins)。

配置預覽伺服器

Claude 會自動偵測您的開發伺服器設定，並將配置儲存在您開始會話時選擇的資料夾根目錄中的 `.claude/launch.json`。Preview 使用此資料夾作為其工作目錄，因此如果您選擇了父資料夾，具有自己開發伺服器的子資料夾將不會自動偵測。若要使用子資料夾的伺服器，請直接在該資料夾中開始會話，或手動新增配置。 若要自訂伺服器的啟動方式，例如使用 `yarn dev` 而不是 `npm run dev` 或變更連接埠，請手動編輯檔案或點擊 Preview 下拉式選單中的 **Edit configuration** 以在您的程式碼編輯器中開啟它。該檔案支援帶註解的 JSON。 ```json theme={null} { "version": "0.0.1", "configurations": [ { "name": "my-app", "runtimeExecutable": "npm", "runtimeArgs": ["run", "dev"], "port": 3000 } ] } ``` 您可以定義多個配置以從同一專案執行不同的伺服器，例如前端和 API。請參閱下面的 [examples](#examples)。

自動驗證變更

啟用 `autoVerify` 時，Claude 會在編輯檔案後自動驗證程式碼變更。它會擷取螢幕截圖、檢查錯誤，並在完成回應之前確認變更有效。 自動驗證預設為開啟。透過將 `"autoVerify": false` 新增到 `.claude/launch.json`，或從 **Preview** 下拉式選單切換它，按專案停用它。 ```json theme={null} { "version": "0.0.1", "autoVerify": false, "configurations": [...] } ``` 停用後，預覽工具仍然可用，您可以隨時要求 Claude 進行驗證。自動驗證使其在每次編輯後自動進行。

配置欄位

`configurations` 陣列中的每個項目接受以下欄位： | 欄位 | 類型 | 描述 | | ------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | 此伺服器的唯一識別碼 | | `runtimeExecutable` | string | 要執行的命令，例如 `npm`、`yarn` 或 `node` | | `runtimeArgs` | string\[] | 傳遞給 `runtimeExecutable` 的引數，例如 `["run", "dev"]` | | `port` | number | 您的伺服器監聽的連接埠。預設為 3000 | | `cwd` | string | 相對於您的專案根目錄的工作目錄。預設為專案根目錄。使用 `${workspaceFolder}` 明確參考專案根目錄 | | `env` | object | 其他環境變數作為鍵值對，例如 `{ "NODE_ENV": "development" }`。不要在此處放置機密，因為此檔案會提交到您的儲存庫。若要將機密傳遞到您的開發伺服器，請在 [local environment editor](#local-sessions) 中設定它們。 | | `autoPort` | boolean | 如何處理連接埠衝突。請參閱下面 | | `program` | string | 使用 `node` 執行的指令碼。請參閱 [when to use `program` vs `runtimeExecutable`](#when-to-use-program-vs-runtimeexecutable) | | `args` | string\[] | 傳遞給 `program` 的引數。僅在設定 `program` 時使用 |
何時使用 `program` 與 `runtimeExecutable`
使用 `runtimeExecutable` 搭配 `runtimeArgs` 透過套件管理器啟動開發伺服器。例如，`"runtimeExecutable": "npm"` 搭配 `"runtimeArgs": ["run", "dev"]` 執行 `npm run dev`。 當您有想要直接使用 `node` 執行的獨立指令碼時，使用 `program`。例如，`"program": "server.js"` 執行 `node server.js`。使用 `args` 傳遞其他標誌。

連接埠衝突

`autoPort` 欄位控制當您偏好的連接埠已在使用時會發生什麼： * **`true`**：Claude 自動尋找並使用空閒連接埠。適合大多數開發伺服器。 * **`false`**：Claude 失敗並出現錯誤。當您的伺服器必須使用特定連接埠時使用此選項，例如 OAuth 回呼或 CORS 允許清單。 * **未設定（預設）**：Claude 詢問伺服器是否需要該確切連接埠，然後儲存您的答案。 當 Claude 選擇不同的連接埠時，它會透過 `PORT` 環境變數將指派的連接埠傳遞給您的伺服器。

範例

這些配置顯示不同專案類型的常見設定： 此配置使用 Yarn 在連接埠 3000 上執行 Next.js 應用程式： ```json theme={null} { "version": "0.0.1", "configurations": [ { "name": "web", "runtimeExecutable": "yarn", "runtimeArgs": ["dev"], "port": 3000 } ] } ``` 對於具有前端和 API 伺服器的 monorepo，定義多個配置。前端使用 `autoPort: true`，因此如果 3000 被佔用，它會選擇空閒連接埠，而 API 伺服器需要確切的連接埠 8080： ```json theme={null} { "version": "0.0.1", "configurations": [ { "name": "frontend", "runtimeExecutable": "npm", "runtimeArgs": ["run", "dev"], "cwd": "apps/web", "port": 3000, "autoPort": true }, { "name": "api", "runtimeExecutable": "npm", "runtimeArgs": ["run", "start"], "cwd": "server", "port": 8080, "env": { "NODE_ENV": "development" }, "autoPort": false } ] } ``` 若要直接執行 Node.js 指令碼而不是使用套件管理器命令，請使用 `program` 欄位： ```json theme={null} { "version": "0.0.1", "configurations": [ { "name": "server", "program": "server.js", "args": ["--verbose"], "port": 4000 } ] } ```

環境配置

您在[開始會話](#start-a-session)時選擇的環境決定了 Claude 執行的位置以及您如何連接： * **Local**：在您的機器上執行，直接存取您的檔案 * **Remote**：在 Anthropic 的雲端基礎設施上執行。即使您關閉應用程式，會話也會繼續。 * **SSH**：在您透過 SSH 連接的遠端機器上執行，例如您自己的伺服器、雲端虛擬機器或開發容器

本機會話

桌面應用程式並不總是繼承您的完整 shell 環境。在 macOS 上，當您從 Dock 或 Finder 啟動應用程式時，它會讀取您的 shell 設定檔（如 `~/.zshrc` 或 `~/.bashrc`）以提取 `PATH` 和一組固定的 Claude Code 變數，但您在那裡匯出的其他變數不會被拾取。在 Windows 上，應用程式繼承使用者和系統環境變數，但不讀取 PowerShell 設定檔。 若要在任何平台上為本機會話和開發伺服器設定環境變數，請在提示框中開啟環境下拉式選單，將滑鼠懸停在 **Local** 上，然後點擊齒輪圖示以開啟本機環境編輯器。您在此處儲存的變數會在您的機器上加密儲存，並適用於您啟動的每個本機會話和預覽伺服器。您也可以將變數新增到 `~/.claude/settings.json` 檔案中的 `env` 金鑰，儘管這些僅到達 Claude 會話而不是開發伺服器。有關支援的變數的完整清單，請參閱[環境變數](/zh-TW/env-vars)。 [Extended thinking](/zh-TW/model-config#extended-thinking) 預設啟用，這改進了複雜推理任務的效能，但使用額外的 tokens。若要停用思考，請在本機環境編輯器中將 `MAX_THINKING_TOKENS` 設定為 `0`；這對 Fable 5 沒有影響，Fable 5 始終使用 extended thinking。在[第三方提供者](/zh-TW/third-party-integrations)上，`0` 會改為省略 `thinking` 參數，自適應推理模型可能仍會思考。在具有[自適應推理](/zh-TW/model-config#adjust-effort-level)的模型上，任何其他 `MAX_THINKING_TOKENS` 值都會被忽略，因為自適應推理控制思考深度。在 Opus 4.6 和 Sonnet 4.6 上，將 `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` 設定為 `1` 以使用固定思考預算；Fable 5、Sonnet 5 和 Opus 4.7 及更新版本始終使用自適應推理，沒有固定預算模式。

雲端會話

雲端會話即使您關閉應用程式也會在背景繼續。使用情況計入您的[訂閱計畫限制](/zh-TW/costs)，沒有單獨的計算費用。 您可以建立具有不同網路存取級別和環境變數的自訂雲端環境。在開始雲端會話時選擇環境下拉式選單，然後選擇 **Add environment**。有關配置網路存取和環境變數的詳細資訊，請參閱[雲端環境](/zh-TW/claude-code-on-the-web#the-cloud-environment)。

SSH 會話

SSH 會話可讓您在遠端機器上執行 Claude Code，同時使用桌面應用程式作為您的介面。這對於使用存在於雲端虛擬機器、開發容器或具有特定硬體或相依性的伺服器上的程式碼庫很有用。 若要新增 SSH 連線，請在開始會話前點擊環境下拉式選單，然後選擇 **+ Add SSH connection**。對話框要求： * **Name**：此連線的友善標籤 * **SSH Host**：`user@hostname` 或在 `~/.ssh/config` 中定義的主機 * **SSH Port**：如果留空則預設為 22，或使用您的 SSH 配置中的連接埠 * **Identity File**：您的私鑰的路徑，例如 `~/.ssh/id_rsa`。留空以使用預設金鑰或您的 SSH 配置。 新增後，連線會出現在環境下拉式選單中。選擇它以在該機器上啟動會話。Claude 在遠端機器上執行，可存取其檔案和工具。 遠端機器必須執行 Linux 或 macOS。桌面應用程式會在您第一次連接時自動在遠端機器上安裝 Claude Code。連接後，SSH 會話支援權限模式、連接器、plugins 和 MCP servers。

為您的團隊預先配置 SSH 連線

管理員可以透過將 `sshConfigs` 新增到[受管設定](/zh-TW/settings#settings-precedence)檔案來將 SSH 連線分發給團隊成員。以這種方式定義的連線會自動出現在每個使用者的環境下拉式選單中，並顯示為受管，因此使用者可以選擇它們，但無法在應用程式中編輯或刪除它們。 以下範例預先配置了一個在遠端主機上的 `~/projects` 中開啟的單一連線： ```json theme={null} { "sshConfigs": [ { "id": "shared-dev-vm", "name": "Shared Dev VM", "sshHost": "user@dev.example.com", "sshPort": 22, "sshIdentityFile": "~/.ssh/id_ed25519", "startDirectory": "~/projects" } ] } ``` 每個項目都需要 `id`、`name` 和 `sshHost`。`sshPort`、`sshIdentityFile` 和 `startDirectory` 欄位是選用的。使用者也可以將 `sshConfigs` 新增到他們自己的 `~/.claude/settings.json`，這是透過對話框新增的連線的儲存位置。

限制使用者可以連接的 SSH 主機

管理員可以透過將 `sshHostAllowlist` 新增到[受管設定](/zh-TW/settings#settings-precedence)檔案來限制 Desktop 的 SSH 會話到已核准的主機集合。設定後，使用者只能連接到其解析的主機名稱與其中一個模式相符的主機。將其設定為空陣列以完全停用 SSH 會話。 以下範例允許連接到 `devboxes.example.com` 下的任何主機以及單一命名的堡壘主機： ```json theme={null} { "sshHostAllowlist": ["*.devboxes.example.com", "bastion.example.com"] } ``` 模式不區分大小寫。`*` 符合任何主機，`*.example.com` 符合 `example.com` 和任何子網域。其他任何內容都是精確符合。檢查會針對透過 `ssh -G` 進行 `~/.ssh/config` 解析後的主機名稱執行，因此允許 `Host` 別名和 `ProxyCommand`/`ProxyJump` 項目，只要解析的 `HostName` 相符即可。 `sshHostAllowlist` 僅從受管設定讀取；使用者或專案設定中的值會被忽略。只有 Claude Desktop 應用程式遵守此設定；Claude Code CLI 和 IDE 擴充功能不讀取它，它也不限制透過 Bash 工具執行的 `ssh` 命令。它控制 Desktop 應用程式連接的主機，而不是網路出口，因此如果您需要硬邊界，請將其與您組織的網路或零信任控制配對。

企業配置

Teams 或 Enterprise 計畫上的組織可以透過管理員主控台控制、受管設定檔案和裝置管理原則來管理桌面應用程式行為。

管理員主控台控制

這些設定透過[管理員設定主控台](https://claude.ai/admin-settings/claude-code)配置： * **Desktop 中的 Code**：控制您組織中的使用者是否可以在桌面應用程式中存取 Claude Code * **網路上的 Code**：為您的組織啟用或停用[網路會話](/zh-TW/claude-code-on-the-web) * **遠端控制**：為您的組織啟用或停用[遠端控制](/zh-TW/remote-control) * **停用略過權限模式**：防止您組織中的使用者啟用略過權限模式

受管設定

受管設定會覆蓋專案和使用者設定，並在 Desktop 中的 Claude Code 會話時套用。您可以在您組織的[受管設定](/zh-TW/settings#settings-precedence)檔案中設定這些金鑰，或透過管理員主控台遠端推送它們。 | 金鑰 | 描述 | | ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `permissions.disableBypassPermissionsMode` | 設定為 `"disable"` 以防止使用者啟用略過權限模式。 | | `disableAutoMode` | 設定為 `"disable"` 以防止使用者啟用 [Auto](/zh-TW/permission-modes#eliminate-prompts-with-auto-mode) 模式。從模式選擇器中移除 Auto。也在 `permissions` 下接受。 | | `autoMode` | 自訂 auto 模式分類器在您的組織中信任和阻止的內容。請參閱[配置 auto 模式](/zh-TW/auto-mode-config)。 | | `sshConfigs` | 預先配置[SSH 連線](#pre-configure-ssh-connections-for-your-team)，在環境下拉式選單中顯示。使用者無法編輯或刪除受管連線。 | | `sshHostAllowlist` | 限制 [SSH 會話](#restrict-which-ssh-hosts-users-can-connect-to)連線到已解析主機名稱符合這些模式之一的主機。空陣列會停用 SSH 會話。僅從受管設定讀取。 | | `managedMcpServers` | 將 MCP 伺服器配置推送到第三方部署中的所有使用者。每個項目指定 `"http"`、`"sse"` 或 `"stdio"` 的傳輸、連線詳細資訊，以及可選的 `toolPolicy` 對應，限制該伺服器中使用者可以叫用的工具。僅在第三方 (3P) Desktop 部署中可用。透過受管設定檔案或 MDM 傳遞此金鑰，因為第三方部署不會收到管理員主控台設定。 | 哪些受管設定到達 Desktop 會話取決於該會話執行的位置。模型限制（例如 [`availableModels`](/zh-TW/model-config#restrict-model-selection)）在 Desktop 的 Claude Code 會話中的強制方式與終端 CLI 相同；請參閱[表面涵蓋範圍](/zh-TW/model-config#surface-coverage)。 * **此機器上的本機會話**：部署到磁碟的受管設定檔案適用。透過管理員主控台推送的遠端受管設定在會話使用組織登入或直接配置的 API 金鑰向 Anthropic 的 API 進行驗證時也會到達這些會話，遵循與終端 CLI 相同的[設定優先順序](/zh-TW/settings#settings-precedence)。 * **[雲端會話](#cloud-sessions)**：在 Anthropic 管理的 VM 上執行，僅接收[伺服器管理的設定](/zh-TW/server-managed-settings)。 * **[SSH 會話](#ssh-sessions)**：會話從遠端主機讀取受管設定檔案。Desktop 本身在建立連線時從本機機器的受管設定讀取 `sshConfigs` 和 `sshHostAllowlist`。 `permissions.disableBypassPermissionsMode` 和 `disableAutoMode` 也在使用者和專案設定中運作，但將它們放在受管設定中可防止使用者覆蓋它們。`autoMode` 從使用者設定、`.claude/settings.local.json` 和受管設定讀取，但不從簽入的 `.claude/settings.json` 讀取：複製的儲存庫無法注入自己的分類器規則。有關受管專用設定（包括 `allowManagedPermissionRulesOnly` 和 `allowManagedHooksOnly`）的完整清單，請參閱[受管專用設定](/zh-TW/permissions#managed-only-settings)。

裝置管理原則

IT 團隊可以透過 macOS 上的 MDM 或 Windows 上的群組原則來管理桌面應用程式。可用的原則包括啟用或停用 Claude Code 功能、控制自動更新和設定自訂部署 URL。 * **macOS**：使用 Jamf 或 Kandji 等工具透過 `com.anthropic.claudefordesktop` 偏好設定網域配置 * **Windows**：透過 `SOFTWARE\Policies\Claude` 的登錄配置

驗證和 SSO

企業組織可以要求所有使用者進行 SSO。有關計畫級別的詳細資訊，請參閱[驗證](/zh-TW/authentication)，有關 SAML 和 OIDC 配置，請參閱[設定 SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso)。

資料處理

Claude Code 在本機會話中本機處理您的程式碼，或在雲端會話中在 Anthropic 的雲端基礎設施上處理。對話和程式碼上下文會傳送到 Anthropic 的 API 進行處理。有關資料保留、隱私和合規性的詳細資訊，請參閱[資料處理](/zh-TW/data-usage)。

部署

Desktop 可以透過企業部署工具分發： * **macOS**：透過 MDM（例如 Jamf 或 Kandji）使用 `.dmg` 安裝程式分發 * **Windows**：透過 MSIX 套件或 `.exe` 安裝程式部署。有關企業部署選項（包括無聲安裝），請參閱[為 Windows 部署 Claude Desktop](https://support.claude.com/en/articles/12622703-deploy-claude-desktop-for-windows) 有關網路配置（例如代理設定、防火牆允許清單和 LLM 閘道），請參閱[網路配置](/zh-TW/network-config)。 有關完整的企業配置參考，請參閱[企業配置指南](https://support.claude.com/en/articles/12622667-enterprise-configuration)。

來自 CLI？

如果您已經使用 Claude Code CLI，Desktop 執行相同的基礎引擎，具有圖形介面。您可以在同一機器上同時執行兩者，甚至在同一專案上執行。每個都維護單獨的會話歷史記錄，但它們透過 CLAUDE.md 檔案共用配置和專案記憶。 若要將 CLI 會話移至 Desktop，請在終端機中執行 `/desktop`。Claude 儲存您的會話並在桌面應用程式中開啟它，然後退出 CLI。此命令在 macOS 和 Windows 上可用，當您使用 Claude 訂閱登入時。它不適用於 API 金鑰驗證或 Bedrock、Vertex 或 Foundry。 何時使用 Desktop 與 CLI：當您想要在一個視窗中管理並行會話、並排排列窗格或視覺化檢查變更時，使用 Desktop。當您需要指令碼、自動化或偏好終端機工作流程時，使用 CLI。

CLI 標誌等效項

此表顯示常見 CLI 標誌的桌面應用程式等效項。未列出的標誌沒有桌面等效項，因為它們是為指令碼或自動化設計的。 | CLI | Desktop 等效項 | | ------------------------------------- | ---------------------------------------------------------- | | `--model sonnet` | 傳送按鈕旁的模型下拉式選單 | | `--resume`, `--continue` | 點擊側邊欄中的會話 | | `--permission-mode` | 傳送按鈕旁的模式選擇器 | | `--dangerously-skip-permissions` | 略過權限模式。在「設定」→「Claude Code」→「允許略過權限模式」中啟用。企業管理員可以停用此設定。 | | `--add-dir` | 在遠端會話中使用 **+** 按鈕新增多個儲存庫 | | `--allowedTools`, `--disallowedTools` | 沒有各別會話等效項。[設定檔案](/zh-TW/settings)中的權限規則仍然適用。 | | `--verbose` | [Verbose 檢視模式](#switch-view-modes)在「Transcript view」下拉式選單中 | | `--print`, `--output-format` | 不可用。Desktop 僅限互動。 | | `ANTHROPIC_MODEL` 環境變數 | 傳送按鈕旁的模型下拉式選單 | | `MAX_THINKING_TOKENS` 環境變數 | 在本機環境編輯器中設定。請參閱[環境配置](#environment-configuration)。 |

共用配置

Desktop 和 CLI 讀取相同的配置檔案，因此您的設定會轉移： * **[CLAUDE.md](/zh-TW/memory)** 和 `CLAUDE.local.md` 檔案在您的專案中由兩者使用 * **[MCP servers](/zh-TW/mcp)** 在 `~/.claude.json` 或 `.mcp.json` 中配置的在兩者中都有效 * **[Hooks](/zh-TW/hooks)** 和 **[skills](/zh-TW/skills)** 在設定中定義的適用於兩者 * **[Settings](/zh-TW/settings)** 在 `~/.claude.json` 和 `~/.claude/settings.json` 中是共用的。`settings.json` 中的權限規則、允許的工具和其他設定適用於 Desktop 會話。 * **Models**：相同的[模型](/zh-TW/model-config#available-models)在兩者中都可用。在 Desktop 中，從傳送按鈕旁的下拉式選單中選擇模型。您可以在會話期間從相同的下拉式選單變更模型。 **來自 Claude Desktop 聊天應用程式的 MCP servers**：Desktop 應用程式從 `claude_desktop_config.json` 將 MCP servers 載入到 Code 標籤會話中，以及來自 `~/.claude.json` 和 `.mcp.json` 的伺服器。在 `claude_desktop_config.json` 中定義的伺服器在 Desktop 聊天表面和 Code 標籤中都可用。 獨立 CLI 不讀取 `claude_desktop_config.json`。在 macOS 和 WSL 上，執行 `claude mcp add-from-claude-desktop` 將這些伺服器複製到 `~/.claude.json`。請參閱[從 Claude Desktop 匯入 MCP servers](/zh-TW/mcp#import-mcp-servers-from-claude-desktop)以了解匯入流程和範圍選項。

功能比較

此表比較 CLI 和 Desktop 之間的核心功能。有關 CLI 標誌的完整清單，請參閱 [CLI 參考](/zh-TW/cli-reference)。 | 功能 | CLI | Desktop | | ----------------------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 權限模式 | 所有模式，包括 `dontAsk` | 詢問權限、自動接受編輯、Plan Mode、Auto 和透過「設定」略過權限 | | `--dangerously-skip-permissions` | CLI 標誌 | 略過權限模式。在「設定」→「Claude Code」→「允許略過權限模式」中啟用 | | [第三方提供者](/zh-TW/third-party-integrations) | Bedrock、Vertex AI、Foundry | Anthropic 的 API 預設。企業部署可以配置 Vertex AI 和閘道提供者。請參閱[企業配置指南](https://support.claude.com/en/articles/12622667-enterprise-configuration)。若要在 Bedrock、Vertex AI、Foundry 或自託管 LLM 閘道上執行 Code 標籤，請參閱 [Cowork on 3P research preview](https://claude.com/docs/cowork/3p/overview)。 | | [MCP servers](/zh-TW/mcp) | 在設定檔案中配置 | 本機和 SSH 會話的連接器 UI，或設定檔案 | | [Plugins](/zh-TW/plugins) | `/plugin` 命令 | Plugin 管理器 UI | | @mention 檔案 | 文字型 | 具有自動完成；本機和 SSH 會話僅 | | 檔案附件 | 不可用 | 影像、PDF | | 會話隔離 | [`--worktree`](/zh-TW/cli-reference) 標誌 | 自動 worktrees | | 多個會話 | 單獨的終端機 | 側邊欄標籤 | | 定期任務 | Cron 工作、CI 管道 | [排程任務](/zh-TW/desktop-scheduled-tasks) | | 電腦使用 | [透過 `/mcp` 在 macOS 上啟用](/zh-TW/computer-use) | [應用程式和螢幕控制](#let-claude-use-your-computer)在 macOS 和 Windows 上 | | Dispatch 整合 | 不可用 | [Dispatch 會話](#sessions-from-dispatch)在側邊欄中 | | 指令碼和自動化 | [`--print`](/zh-TW/cli-reference)、[Agent SDK](/zh-TW/headless) | 不可用 |

Desktop 中不可用的內容

以下功能僅在 CLI 或 VS Code 擴充功能中可用，除非另有說明： * **第三方提供者**：Desktop 預設連接到 Anthropic 的 API。企業部署可以透過[受管設定](https://support.claude.com/en/articles/12622667-enterprise-configuration)配置 Vertex AI 和閘道提供者。對於 Bedrock 或 Foundry，請參閱 [quickstart](/zh-TW/quickstart)。作為上述部分的例外，[Cowork on 3P research preview](https://claude.com/docs/cowork/3p/overview) 在 Bedrock、Vertex AI、Foundry 或自託管 LLM 閘道上執行 Code 標籤。 * **Linux (beta)**：Linux 桌面應用程式中尚未提供電腦使用。請參閱 [Claude Desktop on Linux](/zh-TW/desktop-linux)。 * **內嵌程式碼建議**：Desktop 不提供自動完成樣式的建議。它透過對話提示和明確的程式碼變更進行工作。 * **Agent teams**：平行 Claude Code 會話相互傳遞訊息，可在 [CLI](/zh-TW/agent-teams) 中使用，不在 Desktop 中。若要在一個會話內進行多代理工作，請使用 [dynamic workflows](/zh-TW/workflows)，它們在 Desktop 中執行。 * **Terminal-dialog 命令**：在終端機中開啟互動式面板的內建命令，例如 `/permissions`、`/config`、`/agents` 和 `/doctor`，在 Code 標籤中不可用，並回覆 `isn't available in this environment`。直接編輯[設定檔案](/zh-TW/settings)以管理權限規則和配置，或從獨立 CLI 執行命令。

疑難排解

下面的部分涵蓋桌面應用程式特定的問題。對於出現在聊天中的執行時 API 錯誤，例如 `API Error: 500`、`529 Overloaded`、`429` 或 `Prompt is too long`，請參閱[錯誤參考](/zh-TW/errors)。這些錯誤及其修復在 CLI、Desktop 和網路中是相同的。

檢查您的版本

若要查看您執行的桌面應用程式版本： * **macOS**：點擊選單列中的 **Claude**，然後點擊 **About Claude** * **Windows**：點擊 **Help**，然後點擊 **About** 點擊版本號以將其複製到您的剪貼簿。

Code 標籤中的 403 或驗證錯誤

如果在使用 Code 標籤時看到 `Error 403: Forbidden` 或其他驗證失敗： 1. 從應用程式選單登出並重新登入。這是最常見的修復。 2. 驗證您有有效的付費訂閱：Pro、Max、Team 或 Enterprise。 3. 如果 CLI 有效但 Desktop 無效，完全退出桌面應用程式（不只是關閉視窗），然後重新開啟並登入。 4. 檢查您的網際網路連線和代理設定。

啟動時螢幕空白或卡住

如果應用程式開啟但顯示空白或無反應的螢幕： 1. 重新啟動應用程式。 2. 檢查待處理的更新。在 macOS 和 Windows 上，應用程式在啟動時自動更新；在 Linux 上，透過 apt 更新，如 [Claude Desktop on Linux](/zh-TW/desktop-linux) 中所述。 3. 在 Windows 上，檢查「事件檢視器」中的 **Windows 日誌 → 應用程式** 下的當機日誌。

「無法載入會話」

如果您看到 `Failed to load session`，選定的資料夾可能不再存在、Git 儲存庫可能需要未安裝的 Git LFS，或檔案權限可能阻止存取。嘗試選擇不同的資料夾或重新啟動應用程式。

會話找不到已安裝的工具

如果 Claude 找不到 `npm`、`node` 或其他 CLI 命令等工具，請驗證工具在您的常規終端機中有效、檢查您的 shell 設定檔是否正確設定 PATH，並重新啟動桌面應用程式以重新載入環境變數。

Git 和 Git LFS 錯誤

在 Windows 上，Git 是啟動本機會話的 Code 標籤所需的。如果您看到「Git is required」，請安裝 [Git for Windows](https://git-scm.com/downloads/win) 並重新啟動應用程式。 如果您看到「Git LFS is required by this repository but is not installed」，請從 [git-lfs.com](https://git-lfs.com/) 安裝 Git LFS，執行 `git lfs install`，然後重新啟動應用程式。

Windows 上的 MCP servers 無法運作

如果 MCP server 切換沒有回應或伺服器在 Windows 上無法連接，請檢查伺服器是否在您的設定中正確配置、重新啟動應用程式、驗證伺服器程序在工作管理員中執行，並檢查伺服器日誌以查看連線錯誤。

應用程式無法退出

* **macOS**：按 Cmd+Q。如果應用程式沒有回應，使用 Cmd+Option+Esc 強制退出，選擇 Claude，然後點擊「強制退出」。 * **Windows**：使用 Ctrl+Shift+Esc 的工作管理員來結束 Claude 程序。

Windows 特定問題

* **安裝後 PATH 未更新**：開啟新的終端機視窗。PATH 更新僅適用於新的終端機會話。 * **並行安裝錯誤**：如果您看到有關另一個安裝進行中的錯誤，但實際上沒有，請嘗試以管理員身份執行安裝程式。

在 CLI 中開啟時「分支尚不存在」

遠端會話可以建立在您的本機機器上不存在的分支。點擊會話工具列中的分支名稱以複製它，然後在本機提取它： ```bash theme={null} git fetch origin git checkout ```

仍然卡住？

* 在桌面應用程式中開啟「Help → Get Support」，或直接造訪 [Claude 支援中心](https://support.claude.com/) * 對於在獨立 `claude` CLI 中也會重現的問題，請在 [GitHub Issues](https://github.com/anthropics/claude-code/issues) 上搜尋或提交錯誤 提交問題時，請包括您的桌面應用程式版本、您的作業系統、確切的錯誤訊息和相關日誌。在 macOS 上，檢查 Console.app。在 Windows 上，檢查「事件檢視器 → Windows 日誌 → 應用程式」。