如何在桌面端使用 Claude Code——專業指南

Anthropic 本月推出了 Claude Code 的桌面版預覽——這是一款原生桌面應用，將 Anthropic 的代理式（agentic）程式設計工作流程從終端帶入圖形介面，並內建支援同時執行多個、相互隔離的並行程式設計工作階段。桌面預覽版旨在與 Claude Code 的網頁與行動版本並肩運行，聚焦兩個實用的開發者問題：在同一個存放庫上同時運行多個 AI 代理而不互相干擾，以及更容易從同一個圖形介面啟動本機或雲端工作階段。

什麼是桌面版的 Claude Code？

Claude Code on Desktop 是原生（預覽版）桌面應用程式，讓開發者能使用 GUI（而非僅限 CLI）在本機或 Anthropic 的安全雲端基礎設施上運行 Claude Code 工作階段。它把 Claude Code 的核心代理式程式設計能力與桌面便利性結合：工作階段管理、本機環境整合、以及一鍵啟動網頁工作階段。此應用明確定位為 Claude Code 的 CLI 與網頁產品的配套；它捆綁穩定的 Claude Code 執行環境並為你管理版本，以維持一致且穩定的體驗。

為什麼這很重要？過去，AI 程式設計工具要嘛純粹在終端中運行（開發者熟悉 CLI 工作流程），要嘛純粹在雲端（瀏覽器 UI）。桌面應用彌合了這個鴻溝，既能提供低延遲的本機執行，又能在需要隔離的雲端運算或企業管控時無縫切換至 Anthropic 託管的（網頁）工作階段。桌面預覽特別值得注意的是支援多工作階段並行——你可以在同一個存放庫上同時運行多個獨立的 Claude Code 代理，每個都在自己的 Git worktree（隔離的分支工作空間）中運作，避免相互衝突。這是許多團隊會立刻覺得有用的主打功能。

桌面版與網頁版、CLI 版的關係是什麼？

Claude Code 起源於命令列工具，後來擴展到網頁與行動介面；桌面預覽是在這些基礎上構建。桌面應用鏡像了許多網頁端可用的能力（啟動工作階段、連接存放庫、可視化進度），但更聚焦本機工作流程的人機工學——桌面 UX、原生安裝、以及透過 worktrees 與本機 Git 存放庫更緊密的整合——讓工作階段能同時運行而不互相干擾檔案狀態。

也請參閱 Claude Code Web：What it is and how to use it

Claude Code 桌面版的 7 個優秀功能

1) 多工作階段並行

Claude Code for Desktop 支援同時運行多個獨立的 Claude 工作階段。這表示你可以讓一個工作階段專注於修復錯誤、另一個撰寫測試、第三個生成文件——全部同時執行，而不是排隊在單一工作階段中。此並行能力加速工作流程，讓你能同時委派不同任務。

例如：

假設你有一個名為 my-app 的專案，並希望：

在一個視窗中讓 Claude 修改首頁；
在另一個視窗中讓 Claude 最佳化資料庫邏輯。

Claude Desktop 會自動為你建立：

~/.claude-worktrees/my-app/homepage/
~/.claude-worktrees/my-app/database/

兩個獨立的副本（不衝突）。這就像同時運行兩個開發分支，由 Claude 分別處理。

2. .worktreeinclude：讓 Claude 知曉被忽略的檔案

有時你的專案包含像是 .env 或 .local 的檔案，通常會被 .gitignore 忽略，不會複製到 Claude 的工作目錄。列在 .gitignore 的檔案不會自動複製到新的 worktrees。Claude 提供一種新機制：你可以在專案根目錄建立 .worktreeinclude 檔，告訴它哪些檔案需要被複製——一份類似 .gitignore 的清單，指定哪些被忽略的檔案應該複製到新建立的 worktrees（例如本機 .env 檔或開發者特定設定）。只有同時出現在 .worktreeinclude 與 .gitignore 的檔案才會被複製，避免意外複製已被追蹤的檔案。這對於在不提交到 Git 的情況下，保留每個工作階段的機密或環境檔案至關重要。

例如：

.env
.env.local

.env.production

**/.claude/settings.local.json

這表示：當 Claude 建立工作目錄時，這些檔案也會被複製。

注意：

只有同時存在於 .gitignore 與 .worktreeinclude 的檔案才會被複製；
避免意外複製重要的已追蹤檔案。

3) 啟動並與網頁／雲端工作階段同步

桌面應用可以作為網頁／雲端工作階段的啟動器——也就是你可以從桌面 UI 啟動基於雲端的 Claude Code 工作階段，並在本機監控或引導它們。這種混合模式在你想要本機控制的便利性、同時利用雲端託管的擴充性或權限模型時非常實用。

注意：

在雲端運行時，Claude 的任務會在 Anthropic 的安全伺服器上執行。
在本機與雲端環境之間切換是無縫的。
要建立工作階段，只需選擇「remote environment」。

4) 啟動並與網頁／雲端工作階段同步

桌面應用可以作為網頁／雲端工作階段的啟動器——也就是你可以從桌面 UI 啟動基於雲端的 Claude Code 工作階段，並在本機監控或引導它們。這種混合模式在你想要本機控制的便利性、同時利用雲端託管的擴充性或權限模型時非常實用（本機適合快速任務，雲端適合風險較高或資源密集的任務）。

5) 捆綁版本與企業設定

桌面版包含一個捆綁的、穩定的 Claude Code 執行環境，首次啟動時會下載且自動管理。企業管理員可在需要時停用本機 Claude Code 使用（isClaudeCodeForDesktopEnabled 企業政策）。桌面安裝程式支援常見的企業部署格式（Windows 使用 MSIX、macOS 使用 PKG），管理員可以控制更新與擴充功能的存取。這些管控旨在讓大型團隊更容易採用。

注意：

應用程式會在首次開啟時自動下載；
桌面應用會自動管理版本更新；
它會自動清理舊版本以保持系統整潔；
即使你的電腦已安裝 CLI 版本，它仍會使用自己的版本（以獲得更高穩定性）。
桌面版優先考量穩定性與相容性；CLI（命令列版）可能更新更快，但新功能不一定會立即同步至桌面版。

6) 自訂環境變數

Claude Desktop 允許你像 .env 檔一樣設定變數。

這些變數只在 Claude 工作階段內生效，非常適合專案設定。

例如：

API_KEY=abcd123
DEBUG=true
CERT="-----BEGIN CERT-----
MIIE...
-----END CERT-----"

7) 與本機工具與環境整合

在運行本機工作階段時，桌面應用會擷取你的 shell $PATH，讓工作階段程序能使用你依賴的 node、npm、yarn、Python 或其他 CLI 工具。它也提供以 .env 格式新增自訂環境變數的 UI，並以遮罩方式保護值的安全。這使在代理式工作階段中運行測試或建置更順暢，因為代理可以呼叫與你終端相同的工具鏈。

如何安裝桌面版的 Claude Code？

本節以最小摩擦介紹安裝流程。以下說明適用於桌面預覽版，並指引你前往標準安裝程式。

先決條件與帳戶設定

Anthropic 帳戶與工作區：Claude Code 連接至 Anthropic Console。你需要在 Claude Console 完成 OAuth 流程，並依 Anthropic 的工作區模型擁有有效的計費或研究預覽存取。Claude Code 使用 Console 中的內部工作區追蹤用量；你無法為該工作區建立 API 金鑰——它由 Claude Code 用途所管理。
Git 與存放庫就緒：確認已安裝 Git，且你要操作的專案是 Git 存放庫（或初始化 Git）。桌面應用期望有效的存放庫以使用 worktrees 等功能；如果你開啟未初始化 Git 的資料夾，將不會建立 worktree。
作業系統細節：macOS 與 Linux 安裝通常為原生二進位；Windows 使用者建議使用 WSL，以在許多工作流程中獲得完整的命令相容性。若遇到 PATH 或發行版問題，社群指南涵蓋進階 Windows/WSL 設定。

安裝步驟（簡版）

開啟 Claude 下載頁面，選擇正確平台的安裝程式。
執行安裝程式（macOS 使用 PKG，Windows 使用 MSIX 或 EXE）。企業部署請使用提供的 MSIX/PKG 套件以集中化部署。
啟動 Claude Desktop 應用並使用你的 Anthropic/Claude 帳戶登入。你的對話與偏好會在桌面、網頁與行動端同步。
首次啟動時，應用會下載捆綁的 Claude Code 執行環境。請允許該下載完成；這是必要的，並確保使用穩定、受管的版本。

安裝後檢查

• 開啟 Settings > Environments，確認桌面應用已擷取你的 shell $PATH。
• 選擇是否啟用本機工作階段（若你的機器與政策允許），或是你的工作流程將改為建立網頁工作階段。

可選的安裝方法

原生安裝程式（推薦）：使用原生作業系統安裝程式，獲得最簡單、最整合的體驗。
Homebrew（macOS）：適合以 Homebrew 管理應用的 macOS 使用者。
NPM 或腳本式安裝程式：適合更自動化或腳本化的設定（CI 或佈署），或適用於偏好簡易安裝腳本的 Linux 發行版。

安裝：macOS、Linux、WSL（推薦流程）

從 Claude Code 下載頁面取得桌面預覽安裝程式（產品內文檔提供安裝連結）。
執行安裝並開啟 Claude 桌面應用。
透過應用內的 Claude Console 流程完成 OAuth 登入。
在桌面設定中配置預設 worktree 位置與本機／遠端執行偏好。
從 UI 開啟專案資料夾或複製存放庫開始使用。

開啟終端，若你信任來源，執行 Anthropic 提供的安裝腳本（這是常見且便利的推薦選項）。範例（意譯）：

# macOS / Linux / WSL (example convenience installer)
curl -fsSL https://claude.ai/install.sh | bash

或者，如果你偏好在 macOS 使用 Homebrew：

brew install --cask claude-code

安裝：Windows

WSL：

安裝 WSL（常見為 Ubuntu）並設置乾淨的 WSL 環境。解決 PATH 與互通性問題，以便桌面應用的 WSL 整合能存取該發行版。
在 WSL 中安裝 Git 與 Claude 可能需要的語言執行環境（node、python 等），以便進行本機運行。
在 Windows 安裝或運行桌面應用，將其指向你的 WSL 專案目錄（或在支援的情況下於 WSL 內啟動桌面應用），並遵循相同的 OAuth 流程。

PowerShell 範例（意譯）：

# PowerShell (example convenience installer)
irm https://claude.ai/install.ps1 | iex

CMD 範例（意譯）：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

我如何在日常中使用桌面版 Claude Code？

推薦的工作階段建立模式是什麼？

短期獨立任務 vs 長期重構

對於短、小且範圍明確的任務（修 bug、單檔修改、微小重構），為每個任務建立一個工作階段，讓 Claude 產出聚焦的提交。迅速審查並合併。
對於長期工作（大型重構、功能開發），可考慮建立一個工作階段，頻繁建立檢查點，並利用桌面 UI 的進度控件來引導或暫停工作。讓工作階段在功能分支上進行，以避免意外合併。

在存放庫中維護一份 CLAUDE.md 或提示範本，以標準化工作階段的提示方式（上下文、要執行的測試、風格規則）。這項實踐可降低變異性，幫助 Claude 在不同工作階段中產出一致的結果。許多團隊會將標準提示或防護欄存放在存放庫中，以確保代理行為可預期。

啟動與命名工作階段

開啟桌面應用並選擇或複製一個存放庫。
點選「New Session」（或同等）並給予工作階段具描述性的名稱（例如 bugfix/cs-142 或 add-tests-login）。命名有助於你在 UI 中區分同時進行的工作階段。
選擇本機或遠端執行模式，挑選目標分支（或讓代理在新的 worktree 中建立分支），然後開始工作階段。應用會自動為該工作階段建立專用的 Git worktree。

引導代理：提示與任務

使用清晰、範圍明確的提示。例如：「找出 AuthService 的失敗單元測試，並建立不改變既有公開 API 的修正；運行測試並回報結果。」
對於漸進式任務，先請 Claude 產出計畫（簡短清單），再逐步要求具體程式碼變更。漸進式進展可降低幻覺風險，也讓差異更易於審查。Anthropic 在最佳實務中推薦此方法。

觀察進度與互動

桌面 UI 會在代理工作時顯示操作日誌與差異。你可以暫停工作階段、變更指示或取消正在執行的作業。當代理提出編輯時，UI 會顯示檔案差異與變更說明。你可在提交前核准、編輯或拒絕所提差異。

提交、分支與 PR 流程

一旦你核准變更，桌面應用可以提交到工作階段的 worktree 分支。之後你可以推送到遠端，並透過 UI 開啟拉取請求（若已授權 GitHub 存取）。每個工作階段的分支在合併前維持隔離，讓人工審查更簡潔。

Git 隔離與多工作階段並行究竟如何運作？

Git worktrees：隔離機制

Anthropic 的桌面版使用 Git worktrees，為每個工作階段建立與獨立分支綁定的存放庫工作目錄副本。worktrees 比完整複製更輕量——它們在適當情況下共享相同的 .git 中繼資料，但提供獨立的工作目錄，因此並行編輯不會互相衝突或洩漏。桌面版會把這些自動建立的 worktrees 放在可設定的目錄中（預設為 ~/.claude-worktrees）。此設計讓代理式作業的並行性更安全。

為何選擇 worktrees 而非複製

worktrees 建立更快，且更容易與相同的基礎 Git 歷史關聯，同時仍提供必要的檔案系統分離，以避免跨工作階段污染。對多數工作流程而言，這比多個完整複製更合適；不過，如果你需要完全隔離的執行環境與不同依賴項，仍可考慮使用獨立複製或容器。

協調與衝突處理

由於每個工作階段在隔離的分支／worktree 中運作，衝突被降至最低。若兩個工作階段獨立修改同一段邏輯程式碼，且後續都合併到同一目標分支，正常的 Git 合併衝突處理就會適用——這也是進行人工審查與解決的正確時機。Anthropic 的模式刻意將提交以可審查的 PR 呈現，確保人類始終參與合併流程。

常見疑難排解與限制

如果工作階段無法啟動或卡住

確認存放庫存取權杖有效且未受速率限制。
檢查 worktrees 目錄（例如 ~/.claude-worktrees）的本機磁碟空間與權限。
檢視桌面應用日誌中的錯誤訊息；該應用通常提供診斷視圖或日誌檔。

如果工作階段彼此污染

確認桌面應用有建立獨立的 worktrees（檢查 ~/.claude-worktrees 目錄或在應用偏好設定中查看 worktree 位置）。
若你看到共享狀態，請確保你使用的是最新的桌面預覽版或查閱 Anthropic 的文檔——此版本特別針對工作階段隔離進行改進。

如果被忽略的檔案在工作階段不可用

將檔名加入你的 .worktreeinclude 設定（或桌面 UI 的同等設定），以便應用安全地將工作階段所需的被忽略檔案（例如 .env）複製到每個 worktree。避免在未妥善管理機密的情況下，將機密存放於或暴露自 worktrees。

結論

Claude Code 的桌面預覽代表代理式程式設計工具在開發者工作流程中一個有意義的演進：它保留了 AI 代理的速度與表達力，同時解決了當多個代理需要在同一代碼庫上操作時的多項實務協作問題。無論你將它用於單一開發者生產力，或在團隊中協調多個代理任務，理解 Git worktrees、.worktreeinclude、以及本機與網頁工作階段的區別，將使你在桌面預覽版的第一週更為高效。

準備好使用 Claude Code CLI 了嗎？請參考 API guide 以取得詳細說明。

開發者可透過 CometAPI 存取 Claude Opus 4.5 API 等，且最新的模型版本始終與官方網站同步更新。開始之前，請在 Playground 探索模型能力，並參考 API guide 取得詳細說明。存取前請先登入 CometAPI 並取得 API 金鑰。CometAPI 提供遠低於官方的價格，協助你完成整合。

準備出發？→ Free trial of Claude opus 4.5！

想了解更多技巧、指南與 AI 新聞，請在 VK、X 與 Discord 關注我們！