Linux 上的 Claude Desktop（測試版）
在 Ubuntu 和 Debian 上安裝和更新 Claude 桌面應用程式
Linux 上的桌面應用程式提供與 macOS 和 Windows 相同的 Chat、Cowork 和 Claude Code 體驗：平行工作階段、視覺化差異檢視、整合式終端機和編輯器，以及即時應用程式預覽。請參閱使用 Claude Code Desktop以取得功能參考。
需求
- 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 儲存庫安裝，以便更新透過您系統的定期套件更新到達。開啟終端機並執行每個步驟中的命令。
新增 Anthropic 的 apt 儲存庫
此步驟使用 curl 下載簽署金鑰，並使用 gpg 驗證它，新鮮的 Debian 和 Ubuntu 安裝可能不包含這些工具。如果任一命令報告 command not found，請先安裝兩者：
sudo apt install curl gnupg
下載 Anthropic 的簽署金鑰：
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc https://downloads.claude.ai/claude-desktop/key.asc
命令成功時不列印任何內容，失敗時列印 curl: 錯誤。遺失或錯誤的金鑰會導致 apt update 稍後失敗並顯示 NO_PUBKEY BAA929FF1A7ECACE，因此請在繼續之前確認金鑰已下載且屬於 Anthropic：
gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc
gpg 列印的指紋應為 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE。如果 gpg 報告無法開啟檔案或包含無效的 OpenPGP 資料，表示下載失敗或傳回了錯誤的內容：確認您的網路可以到達 downloads.claude.ai，然後重新執行下載命令。
註冊儲存庫：
echo "deb [arch=amd64,arm64 signed-by=/usr/share/keyrings/claude-desktop-archive-keyring.asc] https://downloads.claude.ai/claude-desktop/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-desktop.list
安裝套件
sudo apt update && sudo apt install claude-desktop
啟動並登入
從您的應用程式啟動器啟動 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 套件。此命令在儲存庫索引中查詢您的架構的最新套件，然後將其下載到目前目錄：
curl -fLO "https://downloads.claude.ai/claude-desktop/apt/stable/$(curl -s "https://downloads.claude.ai/claude-desktop/apt/stable/dists/stable/main/binary-$(dpkg --print-architecture)/Packages" | grep '^Filename: pool/main/c/claude-desktop/claude-desktop_' | sort -V | tail -n 1 | cut -d' ' -f2)"
如果命令失敗並顯示 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 安裝它：
sudo apt install ./claude-desktop_*.deb
如果 apt 報告 E: Unsupported file ./claude-desktop_*.deb given on commandline，表示該模式與目前目錄中的 .deb 檔案不符。確認下載已完成，然後從包含該檔案的目錄再次執行命令。
安裝 .deb 也會在 /etc/apt/sources.list.d/claude-desktop.list 註冊 Anthropic 的 apt 儲存庫，因此未來的更新會透過您系統的 定期套件更新 到達。
更新
桌面應用程式在 Linux 上不會自動更新。更新透過您系統的定期套件更新到達：
sudo apt update && sudo apt upgrade
您的發行版本的圖形軟體更新程式也會取得新版本。
解除安裝
sudo apt remove claude-desktop
解除安裝套件也會移除它所註冊的儲存庫項目和簽署金鑰。如果您在新增 Anthropic 的 apt 儲存庫步驟中自行新增了儲存庫項目，也請將其移除：
sudo rm /etc/apt/sources.list.d/claude-desktop.list
疑難排解
無法找到 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 附帶libc62.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 發行版本；請參閱系統需求。