Linux 桌面版（beta）

Linux 版桌面应用提供与 macOS、Windows 相同的 Chat、Cowork 和 Claude Code 体验：并行会话、可视化 diff 评审、集成终端和编辑器、实时应用预览。功能参考见「桌面版」页。Linux 支持处于 beta。

要求

• 基于 Debian 的发行版：Ubuntu 22.04 或更高版本，或 Debian 12 或更高版本
• x86_64 或 arm64

满足要求的其他 Debian 系发行版可能可用，但没有官方测试。非 Debian 系发行版（如 Fedora、Arch）请改用 CLI。在 Windows 上用 WSL 2 工作的话，安装 Windows 桌面应用并在你的发行版里运行会话（见「WSL 里的桌面版」页）。

Cowork 的要求

Cowork 是用于 Dispatch 和较长智能体工作的桌面标签页。在 Linux 上，Cowork 在桌面应用用 QEMU 和 KVM 托管的虚拟机里运行这些任务，需要：

• 硬件虚拟化：在固件设置里打开，否则 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」并显示安装命令
• 访问 /dev/kvm：用 sudo usermod -aG kvm $USER 把你的用户加入 kvm 组，然后注销并重新登录。有些桌面环境不需要组就让登录用户访问 /dev/kvm，但 Cowork 还需要只有 kvm 组成员能打开的 /dev/vhost-vsock，所以即使 /dev/kvm 已经能用也要加入这个组

应用在启动时检查一次这些要求：安装包之后重启应用，加入组之后注销并重新登录。如果 /dev/vhost-vsock 缺失，且运行中的内核在 /lib/modules 下没有模块目录，Cowork 标签页会报告内核不包含所需的虚拟化支持，且无法手动添加（这种组合在 ChromeOS 和某些容器里常见）。

安装

从 Anthropic 的 apt 仓库安装，更新就通过系统的常规软件包更新到达。

1. 添加 Anthropic 的 apt 仓库：先用 curl 下载签名密钥并用 gpg 验证（全新的 Debian 和 Ubuntu 可能没带这两个，先 sudo apt install curl gnupg）：

   sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc https://downloads.claude.ai/claude-desktop/key.asc
   gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc

   gpg 打印的指纹应当是 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE；缺失或错误的密钥会让之后的 apt update 以 NO_PUBKEY BAA929FF1A7ECACE 失败。然后注册仓库：

   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

2. 安装包：

   sudo apt update && sudo apt install claude-desktop

3. 启动并登录：从应用启动器启动 Claude，或在终端运行 claude-desktop，用你的 Anthropic 账号登录。Linux 版与 macOS 和 Windows 一样：用 claude.ai 订阅或通过组织的 SSO 登录。桌面版不直接接受 Claude Console API Key，需要 API Key 认证请用 CLI。把桌面版路由到 Agent Platform 或 LLM 网关的企业部署，见「Claude Desktop on 3P」和网络配置。

从下载的文件安装

无法使用 apt 仓库时，可以直接从仓库的包池下载 .deb。官方给出了一条先在仓库索引里查找你架构的最新包再下载的 curl 命令；失败并提示 Remote file name has no length 说明查找没有返回包路径（可能是网络阻止了 downloads.claude.ai，或你的架构没有包，仓库只发布 amd64 和 arm64）。要在不注册 Anthropic apt 仓库的情况下安装，先创建 /etc/default/claude-desktop 并写入 CLAUDE_DESKTOP_ADD_REPO="false"；没有仓库时 apt 不会推送新版本，要更新就重新下载并重装，或之后注册仓库。然后用软件安装器（如 GNOME Software）打开下载的文件，或在含该文件的目录里：

sudo apt install ./claude-desktop_*.deb

不带那个设置时，安装 .deb 也会在 /etc/apt/sources.list.d/claude-desktop.list 里注册 Anthropic 的 apt 仓库，之后更新随系统常规软件包更新到达。

更新与卸载

桌面应用在 Linux 上不会自己更新，更新随系统的常规软件包更新到达：

sudo apt update && sudo apt upgrade

卸载：sudo apt remove claude-desktop，它会同时移除注册的仓库条目和签名密钥；如果仓库条目是你手动添加的，还要 sudo rm /etc/apt/sources.list.d/claude-desktop.list。

排障

• Unable to locate package claude-desktop：添加仓库后要运行 sudo apt update；用 cat /etc/apt/sources.list.d/claude-desktop.list 确认条目已写入；用 dpkg --print-architecture 确认架构是 amd64 或 arm64；再次 apt update 看有无与 downloads.claude.ai 相关的网络或密钥错误。仓库可达仍找不到包时，改从下载的文件安装
• 未满足的依赖：libc6 (>= 2.34) 说明你的发行版太旧（Ubuntu 20.04 带的是 2.31，需升级到 Ubuntu 22.04 或 Debian 12 以上）；所有缺失依赖都显示带 :amd64 或 :arm64 后缀的 not installable，说明下载的 .deb 架构与机器不符
• Running as root without --no-sandbox is not supported：你以 root 启动了它，改用普通用户登录后启动
• Cowork 不可用：按提示修复对应要求后重启应用：缺 QEMU 就安装消息里列出的 QEMU 和 UEFI 固件包；缺硬件虚拟化就在固件设置里打开；没有 /dev/kvm 权限就把用户加入 kvm 组并重新登录；缺 vhost_vsock 内核模块就运行 sudo modprobe vhost_vsock 再重启（只对本次启动有效，要每次启动都加载，运行 echo vhost_vsock | sudo tee /etc/modules-load.d/vhost_vsock.conf）

Linux beta 还没有的功能

• Computer Use：Linux 上不支持应用和屏幕控制
• 听写：Linux 桌面应用里没有语音输入，改用 CLI 里的语音听写
• Quick Entry 全局快捷键：在 X11 上可用；原生 Wayland 上需要桌面环境的 GlobalShortcuts portal
• Fedora 和 RHEL：目前只支持基于 Debian 的发行版，更多发行版的支持将在以后提供

桌面应用里还没有的功能，CLI 运行同一个 Claude Code 引擎，且支持更多 Linux 发行版。