使用 Claude Code Desktop

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.

• 使用差異檢查檢查和評論變更，然後透過 CI 監控產生的 PR
• 在嵌入式瀏覽器中預覽您執行的應用程式，同時 Claude 驗證其自己的變更
• 排列窗格，將聊天、差異、預覽、終端機和檔案編輯器並排放置
• 提出側邊問題，使用會話的內容而不會偏離主題
• 連接外部工具，例如 GitHub、Slack 和 Linear
• 讓 Claude 開啟應用程式並控制您的螢幕
• 在您的機器上、雲端或 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 儲存庫設定中啟用才能運作。

​

安排您的工作區

​

在終端機中執行命令

​

開啟和編輯檔案

​

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

• Attach as context：將檔案新增到您的下一個提示
• Open in：在已安裝的編輯器（如 VS Code、Cursor 或 Zed）中開啟檔案
• Show in Finder（在 macOS 上），Show in Explorer（在 Windows 上）：開啟包含資料夾
• Copy path：將絕對路徑複製到您的剪貼簿

​

切換檢視模式

​

快捷鍵

​

檢查使用情況

​

讓 Claude 使用您的電腦

​

何時應用電腦使用

• 如果您有服務的連接器，Claude 會使用連接器。
• 如果任務是 shell 命令，Claude 會使用 Bash。
• 如果任務是瀏覽器工作且您已設定Chrome 中的 Claude，Claude 會使用它。
• 如果以上都不適用，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
    }
  ]
}

​

環境配置

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

​

本機會話

​

遠端會話

​

SSH 會話

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

​

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

{
  "sshConfigs": [
    {
      "id": "shared-dev-vm",
      "name": "Shared Dev VM",
      "sshHost": "user@dev.example.com",
      "sshPort": 22,
      "sshIdentityFile": "~/.ssh/id_ed25519",
      "startDirectory": "~/projects"
    }
  ]
}

​

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

{
  "sshHostAllowlist": ["*.devboxes.example.com", "bastion.example.com"]
}

​

企業配置

​

管理員主控台控制

• 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 和 CLAUDE.local.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。企業部署可以配置 Vertex AI 和閘道提供者，透過受管設定。對於 Bedrock 或 Foundry，請使用 CLI。
• Linux：桌面應用程式僅在 macOS 和 Windows 上可用。在 Linux 上，請使用 CLI。
• 內嵌程式碼建議：Desktop 不提供自動完成樣式的建議。它透過對話提示和明確的程式碼變更進行工作。
• Agent teams：多代理協調可透過 CLI 和 Agent SDK 使用，不在 Desktop 中。

​

疑難排解

​

檢查您的版本

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

​

Code 標籤中的 403 或驗證錯誤

1. 從應用程式選單登出並重新登入。這是最常見的修復。
2. 驗證您有有效的付費訂閱：Pro、Max、Team 或 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 更新僅適用於新的終端機會話。
• 並行安裝錯誤：如果您看到有關另一個安裝進行中的錯誤，但實際上沒有，請嘗試以管理員身份執行安裝程式。

​

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

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

​

仍然卡住？

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