SSD Nodes Learn Hosting plans →
指南 Matt Connor作者： Matt Connor · 更新于 2026-08-25

Claude Linux 桌面应用与 CLI 安装指南

了解 Claude 在 Linux 上的原生支持：通过 apt 安装 beta 桌面应用，使用 Claude Code CLI、编辑器插件和 Web 版，并确认各功能对应的付费套餐。

Claude 目前哪些部分可在 Linux 上原生运行

Claude 在 Linux 上通过 4 个独立界面运行。截至 2026 年 8 月，这 4 个界面都可在普通的 Ubuntu 或 Debian 计算机上运行。桌面应用可从 Anthropic 的 apt 软件源安装，目前处于 beta 阶段。Claude Code CLI（命令行界面）是一个编译后的二进制文件，支持的发行版比桌面应用更多。claude.ai Web 应用只需要浏览器，API 则是一个由您从自己的代码调用的 HTTPS 端点。

macOS 和 Windows 具备的两个功能在 Linux 桌面 beta 中尚不可用：Computer Use，即 Claude 控制屏幕上的应用；以及语音听写。Anthropic 的文档说明这两个功能目前都无法在 Linux 上使用。CLI 自带语音听写功能，因此缺少该功能的是桌面应用，而不是 Claude 本身。

可用性会变化，因此请将本页视为对这些界面的说明，并在据此规划前确认当前状态。最后一节列出了需要查看的页面。

在 Ubuntu 或 Debian 上安装 Claude 桌面应用

文档要求使用 Ubuntu 22.04 或更高版本，或 Debian 12 或更高版本，架构为 x86_64（dpkg 称其为 amd64）或 arm64。其他基于 Debian 的发行版可能也能运行，但未经测试。Fedora 和 RHEL 目前还没有软件包，因此在这些系统上应使用 CLI 或浏览器。

请从 apt 软件源安装，不要使用下载的 .deb 文件。Linux 应用没有自己的更新程序，因此新版本只能通过软件包管理器获取；注册软件源后，apt upgrade 才能发现这些版本。

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 --show-keys 应输出指纹 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE。注册软件源前请先进行比对，因为未经检查的签名密钥等于盲目信任该密钥。如果 gpg 报告文件不包含有效的 OpenPGP 数据，说明下载失败，之后 apt update 也会失败，并显示 NO_PUBKEY BAA929FF1A7ECACE。

注册软件源只需向 /etc/apt/sources.list.d/claude-desktop.list 写入一行 deb。请从 Anthropic 的 Linux 安装页面 code.claude.com/docs/en/desktop-linux 复制该行，并确保内容与页面上的完全一致。软件源地址是本流程中最可能发生变化的部分，凭记忆输入命令会导致之后看到 E: Unable to locate package claude-desktop。粘贴前请先阅读这一行：arch=amd64,arm64 说明 apt 在其他架构上找不到任何内容，signed-by= 指向刚才检查过的密钥环文件，从而仅在此软件源中信任该密钥，而不会让 apt 对读取的其他内容也信任它。

sudo apt update && sudo apt install claude-desktop

请从应用启动器启动，或在终端中运行 claude-desktop。使用 claude.ai 账户登录；如果公司已配置组织的 SSO（单点登录），也可以通过该方式登录。桌面应用不接受 Claude Console API 密钥；基于密钥的身份验证是 CLI 的功能。

E: Unable to locate package claude-desktop 表示 apt 从未读取该软件源。cat /etc/apt/sources.list.d/claude-desktop.list 应显示你写入的 deb 行，dpkg --print-architecture 应输出 amd64 或 arm64，因为其他架构没有发布软件包。之后，更新会随系统其他更新一起从 sudo apt update && sudo apt upgrade 获取。

浏览器中独有的功能

claude.ai 可在任何发行版的当前浏览器中运行。因此，在 Fedora、RHEL、Arch、openSUSE 以及其他没有软件包的系统上，都可以使用它。浏览器还提供网页版 Claude Code。会话在 Anthropic 的云端运行，而不是在您的计算机上运行，并且始终使用您的订阅凭据。

需要了解的是，浏览器版本的限制也正是它的用途所在。云端会话无法读取您自己服务器上的文件，也无法在服务器上运行命令。任何需要访问您计算机的操作，都必须在该计算机上安装软件，也就是 CLI 或桌面应用。

CLI 提供而 Web 应用不具备的功能

在一个目录中启动 claude，它就会处理该目录。这就是区别，其他功能都由此而来。

  • 它会读取和编辑工作目录中的文件，并在应用每项修改前显示修改内容。
  • 它会运行您批准的 shell 命令，因此可以在服务器本机上构建项目、运行测试套件、读取日志或检查服务。
  • 它无需交互式会话即可运行：claude -p "read the nginx error log and summarise it" 输出一个回答后退出，适合从 cron 作业或管道中调用。您可以自行设置回答的格式，因为 输出样式会修改每次回答背后的系统提示，既可以让脚本运行保持简洁，也可以让交互式会话提供详细说明。
  • 它通过 claude mcp add 连接 MCP（模型上下文协议）服务器，为模型提供文件系统之外的工具。
  • 它可以在完全没有图形桌面的环境中运行，而您租用的每台 VPS（虚拟专用服务器）都属于这种环境。

CLI 对服务器指南很重要，原因就在最后一点。租用的服务器只有 SSH（安全 Shell），没有其他界面，因此终端是唯一可以与您一起使用的操作界面。以这种方式运行有其自身的规则，在 VPS 的 tmux 中运行 Claude Code对此有完整说明，使用 Claude 处理日常系统管理工作则介绍了适合交给它的任务。

编辑器集成介于两者之间。VS Code 扩展需要 VS Code 1.94.0 或更高版本，并在编辑器中提供带有差异查看和计划审核功能的图形面板。该扩展为面板捆绑了 CLI 的私有副本，不会将 claude 放入您的 PATH，因此在集成终端中输入 claude 时，仍需单独安装 CLI。基于 VS Code 构建的编辑器可从 Open VSX 注册表安装同一扩展，此外还有 JetBrains 插件。

在 Linux 上运行 Claude Code 需要 Node.js 吗？

使用推荐的安装方式不需要。原生安装程序会下载已编译的二进制文件，该二进制文件不依赖 Node.js 运行。

curl -fsSL https://claude.ai/install.sh | bash
claude --version

claude --version 应输出类似 2.1.211 (Claude Code) 的版本号。如果输出异常，请运行 claude doctor。该命令只输出安装和设置文件的只读诊断信息，不会启动会话。

只有使用 npm 安装时才需要 Node.js。截至软件包版本 2.1.198，npm 软件包要求 Node.js 22 或更高版本。在较旧的 Node.js 上，npm 会输出 EBADENGINE 警告而不是安装失败。这是因为该软件包会将相同的原生二进制文件作为按平台提供的依赖项引入，并将其链接到相应位置。

npm install -g @anthropic-ai/claude-code

不要将其与 sudo 一起运行。文档不建议使用 sudo npm install -g，因为这会在全局 npm 前缀中创建由 root 所有的文件，导致下一次非特权安装或更新因权限问题失败。当 npm 全局目录不可写时，后台自动更新会停止工作，claude doctor 会列出解决方法。

Anthropic 还为 Debian、Fedora、RHEL 和 Alpine 发布了带签名的软件包仓库，因此 sudo apt install claude-code 的工作方式与桌面软件包基本相同，并使用其专用签名密钥 https://downloads.claude.ai/keys/claude-code.asc。

应按用户安装还是系统范围安装？

原生安装是按用户安装。它会在 ~/.local/bin/claude 放置一个指向 ~/.local/share/claude/versions/ 的启动器符号链接，无需 root，并在后台自动更新。计算机上的每个用户都会获得一份独立副本，且版本可以不同。

通过软件包管理器安装是系统范围安装。所有用户共用一个二进制文件，需要 root，并且不会通过 Claude Code 自动更新。使用 sudo apt update && sudo apt upgrade claude-code 升级它；这是您在该主机上为其他软件执行的同一个命令。

如果您以自己的账户登录计算机，请选择按用户安装；这适用于大多数 VPS 场景。如果是在共享服务器或机器镜像上，请选择软件包安装。这样所有用户使用同一版本，并且可按您的计划升级。对于原生安装，~/.claude/settings.json 中的两个设置决定更新行为：

{
  "autoUpdatesChannel": "stable",
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

stable 通道使用大约一周前发布的版本，并跳过存在严重回归问题的版本。DISABLE_AUTOUPDATER 只会停止后台检查，因此 claude update 仍可正常工作，您可以自行决定何时安装新版本。如果服务器上有无人值守的长时间任务，这一点很重要，因为您通常不希望任务运行期间二进制文件发生变化。

通过 SSH 登录并保持会话存活

首次在租用的服务器上运行 CLI 时，会遇到两个 Linux 特有的问题。登录流程需要浏览器，但服务器没有浏览器。SSH 连接中断后，正在运行的任务也会随之终止。

tmux 可以解决第二个问题。tmux 会话属于远程计算机上的 tmux 服务器，而不属于当前连接。因此，即使连接中断，进程仍会继续运行。

tmux new -s claude
claude

先按 Ctrl-b，再按 d 即可分离会话。稍后使用 tmux attach -t claude 返回会话。

登录是第一个问题。运行 claude，命令会输出授权 URL。在您自己的计算机上用浏览器打开该 URL。登录后，浏览器会显示登录代码，而不是重定向回终端。这是因为您笔记本电脑上的浏览器无法访问 Claude Code 在远程计算机回环地址上启动的回调服务器。将该代码粘贴到终端的 Paste code here if prompted 提示符处，终端会报告 Login successful。

如果会话需要在无人值守的情况下启动，claude setup-token 会打开同样的浏览器授权页面，并将有效期为 one year 的 OAuth 令牌输出到终端。它不会在任何位置保存令牌，因此请复制令牌，并将其设置到需要的位置。

export CLAUDE_CODE_OAUTH_TOKEN=your-token

该令牌需要付费计划，并且只能用于发起模型请求。请将它视为有效期为 one year 的密码。如何保存令牌，以及如何阻止代理将令牌读取出来，详见让 AI 代理无法接触机密信息。

小型服务器还会遇到另一个限制。安装需要大约 512 MB 的可用内存，而文档规定运行它需要 4 GB 或更多 RAM。因此，在 1 GB 实例上，内核的内存不足终止进程会结束安装：

Setting up Claude Code...
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.

添加 swap，然后再次运行安装程序。swap 是内核用作溢出内存的磁盘空间。它比 RAM 慢得多，但足以完成安装。

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

swapon 只会在本次启动期间启用该文件。如果希望重启后继续启用，请将一行 /swapfile 添加到 /etc/fstab。在允许代理在生产服务器上运行命令之前，还需要采取哪些其他安全限制，详见在 VPS 上安全运行 Claude Code。

Linux 上 Claude 凭据的存储位置

在 Linux 上，/login 会将凭据写入 ~/.claude/.credentials.json，文件模式为 0600。macOS 会将同一凭据存储在加密的 Keychain 中，因此在 Mac 上形成的使用习惯不适用于 Linux：在 Linux 上，令牌是主目录中的普通文件，所有以您的用户身份运行的进程都可以读取它。设置 CLAUDE_CONFIG_DIR 后，文件会改为存储在该目录下。

这会带来两个后果。/home 的备份包含有效的登录凭据，因此将该备份复制到共享计算机会把您的账户交给任何能够读取它的人。使用您已登录的主机制作机器映像时，该登录凭据也会随映像复制到从中克隆的每个实例。在创建快照前运行 /logout。

同时持有订阅和 API key 的用户容易受到凭据优先级影响。当您在 shell 中设置 ANTHROPIC_API_KEY 后，Claude Code 会在您批准后使用它，因此订阅会处于闲置状态，而 API key 会按 token 计费。/status 会显示当前使用的凭据，unset ANTHROPIC_API_KEY 会让您返回订阅登录。

登录凭据会过期。过期前的三天内，启动行会显示 Your login expires in 3 days，此警告不会阻止请求。过期后，每个请求都会失败，并显示 Login expired · Please run /login。在让无人值守的会话跨周末运行前，请确认这一点，因为此类会话会停止运行，且无法自行恢复。

一份 Claude 订阅是否涵盖所有使用方式？

一份付费计划使用同一个登录账号即可覆盖所有入口。Pro、Max、Team 或 Enterprise 账号可以登录浏览器中的 claude.ai、桌面应用、CLI 和 VS Code 扩展，每次使用的都是同一份订阅。所有入口还共用同一个用量额度，因此在服务器上长时间运行 CLI 会消耗桌面应用可用的额度。如果任一入口开始拒绝执行任务，就需要确认触发的是哪个限制时间窗口，以及应如何处理。免费的 claude.ai 计划不包含 Claude Code 访问权限，因此 CLI 和桌面应用中的 Claude Code 功能需要付费计划或 Claude Console 账号。

API 是另一种产品，计费方式也不同。Console 账号会根据实际发送的 token 数量计费，适合构建服务，而不是在终端中交互使用。设置 ANTHROPIC_API_KEY 后，CLI 会改用这种计费方式。这是您主动选择的方案，不是备用方案。

价格和计划限制变化过于频繁，因此这里不重复列出当前数值。以下两个页面会跟踪最新数据：Claude Code 的实际费用和您需要哪个 Claude 计划。如果您正在比较按 token 计费和月度计划，比较 API 与订阅方案可以帮助您确定两者的盈亏平衡点。

实际会遇到的安装错误

bash: claude: command not found：安装成功后立即出现。 二进制文件位于 ~/.local/bin/claude，但该目录不在 shell 的搜索路径中。使用 echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin" 确认；缺少该条目时，它不会输出任何内容。使用 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc 为 bash 修复，然后运行 source ~/.bashrc。单独安装 VS Code 扩展不会创建该文件，因为扩展会将 CLI 副本保存在扩展目录中。

Error loading shared library libstdc++.so.6。 安装程序为 glibc 系统选择了 musl 构建版本。当系统中存在 musl 交叉编译包，且检测逻辑误判时，就会出现此问题。运行 ldd --version 2>&1 | head -1：如果输出中包含 GNU libc 或 GLIBC，表示系统使用 glibc，但获得了错误的二进制文件。请删除现有安装，然后重新运行安装程序。在 Alpine 及其他 musl 系统上，修复方法相反，即 apk add libgcc libstdc++ ripgrep。

同一台主机上存在两个 claude。 which -a claude 会列出 PATH 中的所有匹配项。本地原生安装是从 ~/.local/bin/claude 指向 ~/.local/share/claude/versions/ 的符号链接；旧版本地 npm 安装位于 ~/.claude/local/ 下；npm -g ls @anthropic-ai/claude-code 可显示全局 npm 安装。删除不需要的副本，因为 PATH 中较早出现的旧副本会让已修复的问题看起来仍未解决。

检查当前状态的位置

本指南中的所有版本号和日期均为 2026 年 8 月的快照。长期不变的是整体结构：四种使用界面，付费界面共用一个登录账号，以及一个决定 CLI 应归属于当前用户还是整台机器。

FAQ

Linux 有 Claude 桌面应用吗？

有。截至 2026 年 8 月，该应用处于 beta 阶段，支持 amd64 或 arm64 架构上的 Ubuntu 22.04 或更高版本，以及 Debian 12 或更高版本。在添加 Anthropic 的 apt 软件源及其签名密钥后，使用 sudo apt install claude-desktop 安装。这样，新版本会随正常的系统升级一起安装。Linux 版本包含与 macOS 应用相同的选项卡，包括 Claude Code 选项卡。Linux 版本目前尚不支持 Computer Use 和语音听写；Fedora 和 RHEL 没有安装包，因此在这些发行版上请使用 CLI 或浏览器中的 claude.ai。

在 Linux 上运行 Claude Code 需要 Node.js 吗？

使用推荐的安装方式不需要。curl -fsSL https://claude.ai/install.sh | bash 会下载一个编译后的二进制文件，运行时不使用 Node.js。只有安装 npm 软件包时才需要 Node.js；截至版本 2.1.198，该软件包要求 Node.js 22 或更高版本。在较旧的 Node.js 上，npm 会显示 EBADENGINE 警告，但安装仍会完成，因为它会将相同的原生二进制文件作为平台专用依赖项下载。不要使用 sudo npm install -g 安装，否则 npm 前缀中会留下属于 root 的文件，并导致后续更新失败。

如何通过 SSH 登录 Claude Code？

运行 claude，它会输出一个授权 URL。在您自己的计算机上使用浏览器打开该 URL，不要在服务器上打开。登录后，浏览器会显示登录代码，而不是执行重定向，因为浏览器无法访问 Claude Code 在远程计算机回环地址上启动的回调监听器。将该代码粘贴到 Paste code here if prompted 提示符中。对于无人值守启动的会话，运行 claude setup-token，并在需要的位置将输出的令牌设置为 CLAUDE_CODE_OAUTH_TOKEN。

Claude Code 在 Linux 上将登录信息存储在哪里？

存储在 ~/.claude/.credentials.json 中，文件模式为 0600；如果设置了该变量，则存储在 CLAUDE_CONFIG_DIR 下。与 macOS 不同，Linux 不使用钥匙串，因此任何以您的用户身份运行的进程都可以读取该文件。因此，/home 备份或机器映像会包含有效的登录信息：在创建快照或复制系统前，运行 /logout。如果环境中也设置了 ANTHROPIC_API_KEY，在您批准后，它的优先级高于存储的订阅登录信息；/status 会显示当前使用的是哪一个。

Claude Pro 订阅是否同时涵盖 CLI 和 Web 应用？

是。Pro、Max、Team 或 Enterprise 计划使用同一个账户登录 claude.ai、桌面应用、CLI 和 VS Code 扩展。免费的 claude.ai 计划不包含 Claude Code，因此终端 CLI 需要付费计划或 Claude Console 账户。API 按令牌从 Console 账户中单独计费；Console 是与订阅不同的产品。

#claude#linux#claude-code#cli#desktop