使用 Claude Code Desktop

• 視覺化差異檢查，包含內嵌註解
• 即時應用程式預覽，搭配開發伺服器
• 電腦使用，在 macOS 上開啟應用程式並控制您的螢幕
• GitHub PR 監控，具有自動修復和自動合併
• 並行會話，具有自動 Git worktree 隔離
• Dispatch 整合：從您的手機傳送任務，在此處取得會話
• 排程任務，按照定期排程執行 Claude
• 連接器，用於 GitHub、Slack、Linear 等
• 本機、SSH 和雲端環境

​

開始會話

• 環境：選擇 Claude 執行的位置。選擇 Local 用於您的機器、Remote 用於 Anthropic 託管的雲端會話，或用於您管理的遠端機器的 SSH 連線。請參閱環境配置。
• 專案資料夾：選擇 Claude 工作的資料夾或儲存庫。對於遠端會話，您可以新增多個儲存庫。
• 模型：從傳送按鈕旁的下拉式選單中選擇模型。會話開始後，模型會被鎖定。
• 權限模式：從模式選擇器中選擇 Claude 擁有多少自主權。您可以在會話期間變更此設定。

​

使用程式碼

​

使用提示框

​

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

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

​

選擇權限模式

​

預覽您的應用程式

• 直接在嵌入式瀏覽器中與執行中的應用程式互動
• 觀看 Claude 自動驗證自己的變更：它會擷取螢幕截圖、檢查 DOM、點擊元素、填寫表單，並修復它發現的問題
• 從會話工具列中的 Preview 下拉式選單啟動或停止伺服器
• 透過在下拉式選單中選擇 Persist sessions，在伺服器重新啟動時保留 Cookie 和本機儲存，這樣您就不必在開發期間重新登入
• 編輯伺服器配置或一次停止所有伺服器

​

使用差異檢查檢查變更

• macOS：按 Cmd+Enter
• Windows：按 Ctrl+Enter

​

檢查您的程式碼

​

監控提取請求狀態

• 自動修復：啟用後，Claude 會透過讀取失敗輸出並進行迭代，自動嘗試修復失敗的 CI 檢查。
• 自動合併：啟用後，Claude 會在所有檢查通過後合併 PR。合併方法是壓縮。自動合併必須在您的 GitHub 儲存庫設定中啟用才能運作。

​

讓 Claude 使用您的電腦

​

何時應用電腦使用

• 如果您有服務的連接器，Claude 會使用連接器。
• 如果任務是 shell 命令，Claude 會使用 Bash。
• 如果任務是瀏覽器工作且您已設定Chrome 中的 Claude，Claude 會使用它。
• 如果以上都不適用，Claude 會使用電腦使用。

​

啟用電腦使用

• Accessibility：讓 Claude 點擊、輸入和滾動
• Screen Recording：讓 Claude 看到您螢幕上的內容

​

應用程式權限

• Denied apps：在此處新增應用程式以拒絕它們而不提示。Claude 可能仍會透過允許應用程式中的操作間接影響被拒絕的應用程式，但它無法直接與被拒絕的應用程式互動。
• Unhide apps when Claude finishes：當 Claude 工作時，您的其他視窗會被隱藏，以便它僅與批准的應用程式互動。當 Claude 完成時，隱藏的視窗會被恢復，除非您關閉此設定。

​

管理會話

​

使用會話並行工作

​

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

​

在另一個介面中繼續

• Claude Code on the Web：將您的本機會話傳送到遠端繼續執行。Desktop 推送您的分支、產生對話摘要，並使用完整上下文建立新的遠端會話。然後您可以選擇存檔本機會話或保留它。這需要乾淨的工作樹，不適用於 SSH 會話。
• Your IDE：在目前工作目錄的支援 IDE 中開啟您的專案。

​

來自 Dispatch 的會話

​

擴展 Claude Code

​

連接外部工具

​

使用 skills

​

安裝 plugins

​

配置預覽伺服器

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 3000
    }
  ]
}

​

自動驗證變更

{
  "version": "0.0.1",
  "autoVerify": false,
  "configurations": [...]
}

​

配置欄位

何時使用 program 與 runtimeExecutable

​

連接埠衝突

• true：Claude 自動尋找並使用空閒連接埠。適合大多數開發伺服器。
• false：Claude 失敗並出現錯誤。當您的伺服器必須使用特定連接埠時使用此選項，例如 OAuth 回呼或 CORS 允許清單。
• 未設定（預設）：Claude 詢問伺服器是否需要該確切連接埠，然後儲存您的答案。

​

範例

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "web",
      "runtimeExecutable": "yarn",
      "runtimeArgs": ["dev"],
      "port": 3000
    }
  ]
}

{
  "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
    }
  ]
}

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "server",
      "program": "server.js",
      "args": ["--verbose"],
      "port": 4000
    }
  ]
}

​

排程定期任務

​

比較排程選項

• 本機任務：在您的機器上執行。它們可以直接存取您的本機檔案和工具，但桌面應用程式必須開啟且您的電腦保持清醒才能執行。
• 遠端任務：在 Anthropic 管理的雲端基礎設施上執行。即使您的電腦關閉，它們也會繼續執行，但針對儲存庫的新複製而不是您的本機簽出工作。

​

頻率選項

• Manual：無排程，僅在您點擊 Run now 時執行。適合儲存您按需觸發的提示
• Hourly：每小時執行一次。每個任務從整點獲得最多 10 分鐘的固定偏移，以錯開 API 流量
• Daily：顯示時間選擇器，預設為上午 9:00 本機時間
• Weekdays：與 Daily 相同，但跳過星期六和星期日
• Weekly：顯示時間選擇器和日期選擇器

​

排程任務如何執行

​

錯過的執行

​

排程任務的權限

​

管理排程任務

• Run now：立即啟動任務，無需等待下一個排程時間
• Toggle repeats：暫停或恢復排程執行，而無需刪除任務
• Edit：變更提示、頻率、資料夾或其他設定
• Review history：查看每次過去的執行，包括因您的電腦睡眠而被跳過的執行
• Review allowed permissions：從 Always allowed 面板查看和撤銷此任務的已儲存工具批准
• Delete：移除任務並存檔它建立的所有會話

​

環境配置

• Local：在您的機器上執行，直接存取您的檔案
• Remote：在 Anthropic 的雲端基礎設施上執行。即使您關閉應用程式，會話也會繼續。
• SSH：在您透過 SSH 連接的遠端機器上執行，例如您自己的伺服器、雲端虛擬機器或開發容器

​

本機會話

​

遠端會話

​

SSH 會話

• Name：此連線的友善標籤
• SSH Host：user@hostname 或在 ~/.ssh/config 中定義的主機
• SSH Port：如果留空則預設為 22，或使用您的 SSH 配置中的連接埠
• Identity File：您的私鑰的路徑，例如 ~/.ssh/id_rsa。留空以使用預設金鑰或您的 SSH 配置。

​

企業配置

​

管理員主控台控制

• Desktop 中的 Code：控制您組織中的使用者是否可以在桌面應用程式中存取 Claude Code
• 網路上的 Code：為您的組織啟用或停用網路會話
• 遠端控制：為您的組織啟用或停用遠端控制
• 停用略過權限模式：防止您組織中的使用者啟用略過權限模式

​

受管設定

​

裝置管理原則

• macOS：使用 Jamf 或 Kandji 等工具透過 com.anthropic.Claude 偏好設定網域配置
• Windows：透過 SOFTWARE\Policies\Claude 的登錄配置

​

驗證和 SSO

​

資料處理

​

部署

• macOS：透過 MDM（例如 Jamf 或 Kandji）使用 .dmg 安裝程式分發
• Windows：透過 MSIX 套件或 .exe 安裝程式部署。有關企業部署選項（包括無聲安裝），請參閱為 Windows 部署 Claude Desktop

​

來自 CLI？

​

CLI 標誌等效項

​

共用配置

• CLAUDE.md 檔案在您的專案中由兩者使用
• MCP servers 在 ~/.claude.json 或 .mcp.json 中配置的在兩者中都有效
• Hooks 和 skills 在設定中定義的適用於兩者
• Settings 在 ~/.claude.json 和 ~/.claude/settings.json 中是共用的。settings.json 中的權限規則、允許的工具和其他設定適用於 Desktop 會話。
• Models：Sonnet、Opus 和 Haiku 在兩者中都可用。在 Desktop 中，在開始會話之前從傳送按鈕旁的下拉式選單中選擇模型。您無法在活動會話期間變更模型。

​

功能比較

​

Desktop 中不可用的內容

• 第三方提供者：Desktop 直接連接到 Anthropic 的 API。改用 CLI 搭配 Bedrock、Vertex 或 Foundry。
• Linux：桌面應用程式僅在 macOS 和 Windows 上可用。
• 內嵌程式碼建議：Desktop 不提供自動完成樣式的建議。它透過對話提示和明確的程式碼變更進行工作。
• Agent teams：多代理協調可透過 CLI 和 Agent SDK 使用，不在 Desktop 中。

​

疑難排解

​

檢查您的版本

• macOS：點擊選單列中的 Claude，然後點擊 About Claude
• Windows：點擊 Help，然後點擊 About

​

Code 標籤中的 403 或驗證錯誤

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

​

啟動時螢幕空白或卡住

1. 重新啟動應用程式。
2. 檢查待處理的更新。應用程式在啟動時自動更新。
3. 在 Windows 上，檢查「事件檢視器」中的 Windows 日誌 → 應用程式 下的當機日誌。

​

「無法載入會話」

​

會話找不到已安裝的工具

​

Git 和 Git LFS 錯誤

​

Windows 上的 MCP servers 無法運作

​

應用程式無法退出

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

​

Windows 特定問題

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

​

Intel Mac 上的 Cowork 標籤不可用

​

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

git fetch origin <branch-name>
git checkout <branch-name>

​

仍然卡住？

• 在 GitHub Issues 上搜尋或提交錯誤
• 造訪 Claude 支援中心