Skip to main content
Linux 上的 Claude 桌面應用程式處於測試版。
Linux 上的桌面應用程式提供與 macOS 和 Windows 相同的 Chat、Cowork 和 Claude Code 體驗：平行工作階段、視覺化差異檢視、整合式終端機和編輯器，以及即時應用程式預覽。請參閱使用 Claude Code Desktop以取得功能參考。

​
需求

  • Debian 衍生發行版本：Ubuntu 22.04 或更新版本，或 Debian 12 或更新版本
  • x86_64 或 arm64
其他符合這些需求的 Debian 衍生發行版本可能可以運作，但未經官方測試。在非 Debian 衍生的發行版本上，例如 Fedora 或 Arch，請改為執行 CLI。如果您在 Windows 上使用 WSL 2，請安裝 Windows 桌面應用程式並在您的發行版本內執行工作階段；請參閱 Claude Code Desktop in WSL。

​
Cowork 需求

Cowork 是 Dispatch 和更長時間代理工作 的桌面標籤。在 Linux 上，Cowork 在桌面應用程式使用 QEMU 和 KVM 託管的虛擬機器中執行這些工作。若要使用 Cowork，您的機器需要：
  • 硬體虛擬化：在您的韌體設定中開啟。沒有它，Cowork 標籤會報告「Cowork requires hardware virtualization (KVM)」。
  • QEMU 和 UEFI 韌體：x86_64 上的 qemu-system-x86、ovmf 和 virtiofsd，或 arm64 上的 qemu-system-arm、qemu-efi-aarch64 和 virtiofsd。apt install claude-desktop 預設會將它們安裝為建議的套件。如果您使用 --no-install-recommends 安裝，或您的系統是跳過建議套件的最小映像，Cowork 標籤會報告「Cowork requires QEMU」並顯示要執行的 apt install 命令。Ubuntu 22.04 沒有 virtiofsd 套件；應用程式在那裡使用捆綁的副本。
  • 存取 /dev/kvm：使用 sudo usermod -aG kvm $USER 將您的使用者新增到 kvm 群組，然後登出並重新登入。某些桌面環境會授予已登入的使用者存取 /dev/kvm 的權限而不需要群組，但 Cowork 也需要 /dev/vhost-vsock，只有 kvm 群組成員可以開啟。即使 /dev/kvm 已經對您有效，也要加入群組。
應用程式在啟動時檢查這些需求一次：安裝套件後重新啟動它，加入群組後登出並重新登入。如果 /dev/vhost-vsock 遺失且您執行的核心在 /lib/modules 下沒有模組目錄，Cowork 標籤會報告核心不包含 Cowork 需要的虛擬化支援，且無法手動新增。這種組合在 ChromeOS 和基於容器的 Linux 環境中很常見。

​
安裝

從 Anthropic 的 apt 儲存庫安裝，以便更新透過您系統的定期套件更新到達。開啟終端機並執行每個步驟中的命令。
1

新增 Anthropic 的 apt 儲存庫

此步驟使用 curl 下載簽署金鑰，並使用 gpg 驗證它，新鮮的 Debian 和 Ubuntu 安裝可能不包含這些工具。如果任一命令報告 command not found，請先安裝兩者：
下載 Anthropic 的簽署金鑰：
命令成功時不列印任何內容，失敗時列印 curl: 錯誤。遺失或錯誤的金鑰會導致 apt update 稍後失敗並顯示 NO_PUBKEY BAA929FF1A7ECACE，因此請在繼續之前確認金鑰已下載且屬於 Anthropic：
gpg 列印的指紋應為 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE。如果 gpg 報告無法開啟檔案或包含無效的 OpenPGP 資料，表示下載失敗或傳回了錯誤的內容：確認您的網路可以到達 downloads.claude.ai，然後重新執行下載命令。註冊儲存庫：
2

安裝套件

3

啟動並登入

從您的應用程式啟動器啟動 Claude，或從終端機執行 claude-desktop，然後使用您的 Anthropic 帳戶登入。Linux 應用程式的登入方式與 macOS 和 Windows 上相同：使用 claude.ai 訂閱，或透過您組織的 SSO。Desktop 不直接接受 Claude Console API 金鑰；請使用 CLI 進行 API 金鑰驗證。對於將 Desktop 路由到 Google Cloud 的 Agent Platform 或 LLM 閘道的企業部署，請參閱 Claude Desktop on 3P 和 網路配置。

​
從下載的檔案安裝

如果您無法透過 apt 儲存庫安裝，請直接從儲存庫的套件池下載 .deb 套件。此命令在儲存庫索引中查詢您的架構的最新套件，然後將其下載到目前目錄：
如果命令失敗並顯示 Remote file name has no length，表示查詢未傳回套件路徑。這可能表示無法擷取儲存庫索引，例如當您的網路阻止 downloads.claude.ai 時，或該架構不存在套件。確認您的網路可以到達 downloads.claude.ai，且 dpkg --print-architecture 列印 amd64 或 arm64；儲存庫不會為其他架構發佈套件。 若要在不註冊 Anthropic 的 apt 儲存庫的情況下安裝，請先建立 /etc/default/claude-desktop，其中包含 CLAUDE_DESKTOP_ADD_REPO="false" 這一行。沒有儲存庫，apt 不會提供新版本；若要更新，請重新執行下載命令並重新安裝，或稍後 註冊儲存庫。 然後使用您的軟體安裝程式（例如 GNOME Software）開啟下載的檔案，或從包含下載檔案的目錄使用 apt 安裝它：
如果 apt 報告 E: Unsupported file ./claude-desktop_*.deb given on commandline，表示該模式與目前目錄中的 .deb 檔案不符。確認下載已完成，然後從包含該檔案的目錄再次執行命令。 安裝 .deb 也會在 /etc/apt/sources.list.d/claude-desktop.list 註冊 Anthropic 的 apt 儲存庫，因此未來的更新會透過您系統的 定期套件更新 到達。

​
更新

桌面應用程式在 Linux 上不會自動更新。更新透過您系統的定期套件更新到達：
您的發行版本的圖形軟體更新程式也會取得新版本。

​
解除安裝

解除安裝套件也會移除它所註冊的儲存庫項目和簽署金鑰。如果您在新增 Anthropic 的 apt 儲存庫步驟中自行新增了儲存庫項目，也請將其移除：

​
疑難排解

​
無法找到 claude-desktop 套件

如果 sudo apt install claude-desktop 失敗並顯示 E: Unable to locate package claude-desktop，表示 apt 找不到您新增的儲存庫。請檢查以下項目：
  • 新增儲存庫後執行 sudo apt update。apt install 本身在您上次執行 apt update 之後新增的儲存庫中看不到。
  • 確認儲存庫項目已寫入。cat /etc/apt/sources.list.d/claude-desktop.list 應該顯示來自新增 Anthropic 的 apt 儲存庫步驟的 deb 行。如果檔案為空或遺失，請再次執行該步驟。
  • 確認您的架構受支援。dpkg --print-architecture 應該列印 amd64 或 arm64。儲存庫不會為其他架構發佈套件。
  • 再次執行 sudo apt update 並檢查其輸出中是否有與 downloads.claude.ai 相關的錯誤。該處的網路或金鑰錯誤表示儲存庫已新增但無法連線或驗證。
如果儲存庫已就位且可連線，但仍找不到套件，請改為從下載的檔案安裝。

​
未滿足的相依性

如果 apt 停止並顯示 The following packages have unmet dependencies 或 Unsatisfied dependencies，請閱讀它所列出的相依性：
  • libc6 (>= 2.34)：您的發行版本比套件支援的版本更舊。Ubuntu 20.04 附帶 libc6 2.31。升級至 Ubuntu 22.04 或更新版本，或 Debian 12 或更新版本。
  • 所有遺失的相依性都顯示 not installable 並帶有 :amd64 或 :arm64 後綴：您下載的 .deb 是針對與您機器不同的架構。執行 dpkg --print-architecture 並下載相符的 .deb，或從 apt 儲存庫安裝，它會為您的架構選擇套件。

​
以 root 身份執行而不使用 --no-sandbox 不受支援

如果 claude-desktop 以此訊息結束，表示您以 root 身份啟動它。以一般使用者身份登入並從該處啟動它。

​
Cowork 無法使用

如果 Cowork 索引標籤顯示以下其中一則訊息，請修正它所列出的需求，然後重新啟動應用程式：
  • Cowork 需要 QEMU：安裝訊息所列出的 QEMU 和 UEFI 韌體套件。
  • Cowork 需要硬體虛擬化 (KVM)：在您的韌體設定中開啟硬體虛擬化。
  • Claude 沒有使用虛擬化的權限 (/dev/kvm)：將您的使用者新增至 kvm 群組，然後登出並重新登入。
  • Cowork 需要 vhost_vsock 核心模組：執行 sudo modprobe vhost_vsock，然後重新啟動應用程式。這只會為目前的開機載入模組。若要在每次開機時載入它，請執行 echo vhost_vsock | sudo tee /etc/modules-load.d/vhost_vsock.conf。

​
Linux 測試版中尚未提供的功能

  • Computer Use：應用程式和螢幕控制在 Linux 上不可用。
  • Dictation：語音輸入在 Linux 桌面應用程式中不可用。請改用 CLI 中的語音聽寫。
  • Quick Entry 全域快捷鍵：在 X11 上運作。在原生 Wayland 上，它需要您的桌面環境的 GlobalShortcuts 入口。
  • Fedora 和 RHEL：目前僅支援 Debian 衍生發行版本。將來會支援其他發行版本。
對於桌面應用程式中尚未提供的任何功能，CLI 執行相同的 Claude Code 引擎並支援更廣泛的 Linux 發行版本；請參閱系統需求。