Claude Code 平台集成

Linux 桌面版（测试版）

2 分钟阅读

Claude Desktop on Linux（测试版）

在 Ubuntu 和 Debian 上安装和更新 Claude 桌面应用

Claude 桌面应用的 Linux 支持处于测试阶段。Chat、Cowork 和 Code 标签页均可用。

Linux 上的桌面应用为你提供与 macOS 和 Windows 相同的 Chat、Cowork 和 Claude Code 体验：并行会话、可视化差异审查、集成终端和编辑器，以及实时应用预览。完整功能参考请参阅使用 Claude Code Desktop。

系统要求

Ubuntu 22.04 或更高版本，或 Debian 12 或更高版本
x86_64 或 arm64

其他满足这些要求的基于 Debian 的发行版可能可以运行，但未经过官方测试。

安装

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

添加 Anthropic 的 apt 仓库

此步骤使用 curl 下载签名密钥，全新安装的 Debian 和 Ubuntu 可能未包含 curl。如果下载命令失败并显示 sudo: curl: command not found，请先安装 curl：

sudo apt install curl

下载 Anthropic 的签名密钥：

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

注册仓库：

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's Agent Platform 或 LLM 网关的企业部署，请参阅 enterprise configuration guide 和 network configuration。

验证签名密钥

你可以确认下载的签名密钥属于 Anthropic：

gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc

指纹应为 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE。

从下载的文件安装

如果你无法使用 apt 仓库，请首先从 claude.com/download 下载适合你架构（x64 或 arm64）的 .deb 包。然后使用软件安装器打开下载的文件，或从包含下载文件的目录中使用 apt 安装：

sudo apt install ./claude-desktop_*.deb

如果 apt 报告 E: Unsupported file ./claude-desktop_*.deb given on commandline，说明模式未匹配当前目录中的 .deb 文件。确认下载已完成，然后从包含该文件的目录中再次运行命令。

以这种方式安装的 .deb 不会接收更新。要通过 apt 获取更新，请按上方所示添加仓库，或取消注释软件包写入 /etc/apt/sources.list.d/claude-desktop.list 的占位条目中的 deb 行。

更新

桌面应用不会在 Linux 上自动更新。更新通过系统的常规包更新到达：

sudo apt update && sudo apt upgrade

你的发行版的图形化软件更新器也会获取新版本。

卸载

sudo apt remove claude-desktop

这会连同应用一起移除签名密钥，因此如果你在安装期间添加了仓库条目，也请将其移除：

sudo rm /etc/apt/sources.list.d/claude-desktop.list

Linux 测试版尚未包含的功能

Computer Use：应用和屏幕控制在 Linux 上不可用。
Dictation：Linux 桌面应用中不支持语音输入。请改用 CLI 中的语音听写。
Quick Entry 全局热键：在 X11 上可用。在原生 Wayland 上需要你的桌面环境的 GlobalShortcuts portal。
Fedora 和 RHEL：目前仅支持基于 Debian 的发行版。未来会增加对其他发行版的支持。

对于桌面应用中尚不可用的任何功能，CLI 运行相同的 Claude Code 引擎并支持更广泛的 Linux 发行版；请参阅系统要求。