SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor

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

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

目前哪些 Claude 组件可在 Linux 上原生运行

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

macOS 和 Windows 提供的三项功能在 Linux 桌面 beta 中缺失或受限:Computer Use,即让 Claude 控制屏幕上的应用;语音听写;以及 Quick Entry 全局快捷键。Anthropic 文档说明,Linux 不支持 Computer Use 和听写功能。Quick Entry 快捷键可在 X11 会话中运行,但在原生 Wayland 会话中需要桌面环境提供 GlobalShortcuts portal;如果没有该 portal,快捷键不可用。echo $XDG_SESSION_TYPE 会输出 x11 或 wayland,并说明您属于哪种情况。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(单点登录),也可以通过组织的 SSO 登录。Anthropic 的 Linux 安装页面列出了这两种登录方式,并将 API 密钥用户引导至 CLI。Anthropic 还单独记录了同一应用的第二种部署模式:配置推理提供商(Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry、LLM 网关或直接使用 Anthropic API)后,登录界面会提供跳过 Anthropic 身份验证的选项,由该提供商负责 Chat、Cowork 和 Code 的推理与计费。这些文档给出了托管配置的 Linux 路径 /etc/claude-desktop/managed-settings.json;Linux 安装页面目前也链接到第三方部署文档。在没有 Claude Desktop 配置的设备上,Claude Desktop 3.1623.1 或更高版本还会在标准登录界面提供 Use your Claude API account,您可以使用 Claude Console 登录,或直接输入 API 密钥,无需预先配置。在 Claude Desktop 4.23118.0 或更高版本中,如果组织在计算机登录时禁止其他账户,即使没有设备管理,该链接也会被隐藏。

在本机运行的 Cowork 任务使用虚拟机,因此必须启用硬件虚拟化,并将您的用户加入 kvm 组(运行 sudo usermod -aG kvm $USER,然后注销并重新登录)。并非所有 Cowork 任务都在本地运行。自 October 6, 2026 起,Pro、Max 和 Ultra 计划中的新 Cowork 任务会在 Anthropic 云端运行,且无法通过设置将其保留在本机;已启用统一 Chat 和 Cowork 体验的 Team 和 Enterprise 组织也会在云端运行任务。在这些计划中,虚拟机只影响已经在本机启动的任务;对于必须留在本地的新任务,Anthropic 建议在桌面应用中使用 Claude Code。

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、桌面应用或已配置的 self-hosted runner。只要桌面应用处于打开状态,Cowork 云会话就可以访问已连接的本地文件夹。

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

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

  • 它会读取和编辑当前工作目录中的文件,并在 Manual 模式下应用编辑前征求确认。Auto 模式会在后台执行安全检查后应用编辑;除非设置或策略改变这一行为,否则它是当前交互式会话的内置默认模式。使用 claude --permission-mode default 启动,以便自行审查操作。
  • 它会在当前会话的权限模式下运行 shell 命令,因此可以在服务器本机上构建项目、运行测试套件、读取日志或检查服务。
  • 它可以在无交互会话的情况下运行:claude -p "read the nginx error log and summarise it" 输出一个回答后退出,适合从 cron 任务或流水线中调用。在 Claude Code 2.1.302 或更高版本中,如果未设置权限模式,这类运行会以 Manual 模式启动;除非提供审批机制,否则需要批准的操作会被拒绝。传入 --permission-mode auto 后,可让分类器审查这些操作。回答的形式由您设置,因为输出样式会修改每次回复背后的系统提示词,因此脚本运行可以保持简洁,而交互式会话则可以提供详细说明。
  • 它通过 claude mcp add 连接 MCP(模型上下文协议)服务器,为模型提供文件系统之外的工具。
  • 它可以在完全没有图形桌面的环境中运行,而您租用的 VPS(虚拟专用服务器)都属于这种环境。

这就是服务器指南需要介绍 CLI 的原因。租用的服务器只有 SSH(安全 Shell),没有其他界面,因此终端是唯一能与服务器交互的界面。以这种方式运行有其自身的规则,在 tmux 中的 VPS 上运行 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。截至 October 2026,npm 软件包要求 Node.js 22 或更高版本。在较旧的 Node.js 上,npm 会输出 EBADENGINE 警告而不是安装失败,因为该软件包会将同一个原生二进制文件作为平台依赖项引入,并将其链接到相应位置。

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

在 npm 12 中,postinstall 步骤默认会被跳过,导致 claude 无法运行。如果 npm --version 以 12 启动,请使用上面的原生安装程序,或在重新安装前将 Claude Code 添加到用户 npm 配置中的 allow-scripts。

不要使用 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。通过该 URL 登录后,浏览器会显示登录代码,而不是返回 localhost。在终端的 Paste code here if prompted 提示处粘贴该代码,终端会报告 Login successful。

如果会话必须在无人监控的情况下启动,claude setup-token 会打开相同的浏览器授权流程,并在终端中打印有效期一年的 OAuth 令牌。它不会将令牌保存到任何位置,因此请复制令牌,并将其设置到需要使用的位置。

export CLAUDE_CODE_OAUTH_TOKEN=your-token

该令牌需要付费方案,并且只能发起模型请求。请将它作为有效期一年的密码处理。令牌应保存在哪里,以及如何防止代理将其读取出来,详见防止 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 中,但如果 Keychain 拒绝写入,则会回退到同一个明文文件。在 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 订阅是否涵盖所有使用方式?

除部分 Enterprise 方案外,一个付费方案可通过同一登录凭据涵盖所有使用端。Pro、Max、Ultra 或 Team 账户可用于登录浏览器中的 claude.ai、桌面应用、CLI 和 VS Code 扩展,每次使用的都是同一个订阅。新的 Enterprise 方案或自助开通的 Enterprise 方案(不包括面向 HIPAA 的组织)也是如此,其单个 Enterprise seat 包含 Claude Code。

旧版 Enterprise 方案则使用不同的 seat 类型。在这类方案中,Claude Code 使用端需要 Chat + Claude Code seat,或者旧版按 seat 计费方案中的 Premium seat;Chat-only 或 Standard seat 不包含这些使用端。面向 HIPAA 的 Enterprise 组织同样使用独立的 Chat 和 Chat + Claude Code seat 类型。在面向 HIPAA 的 Enterprise 方案中,Claude Code 需要 Chat + Claude Code seat;终端和 Claude Desktop 的 Code 标签页要获得 BAA 覆盖,还需要启用 HIPAA 配置或适用的 zero data retention 覆盖。VS Code 和 JetBrains 扩展以及云端会话不在 HIPAA 配置的覆盖范围内。

在 Pro、Max、Ultra、Team 和按 seat 计费的 Enterprise 方案中,所有使用端共用同一使用额度。因此,在服务器上运行一次耗时较长的 CLI 任务,会减少桌面应用剩余的可用额度。当某个使用端开始拒绝执行任务时,需要确认命中了哪个额度周期,以及应如何处理。按用量计费的 Enterprise 方案没有会耗尽的包含额度:所有使用端从第一个 token 开始都按 API 费率计费。

免费的 claude.ai 方案不包含 Claude Code 访问权限。没有付费方案时,CLI 可以使用 Claude Console 账户登录;如果组织使用 Amazon Bedrock、Google Cloud's Agent Platform 或 Microsoft Foundry,也可以通过相应提供商进行身份验证,无需浏览器登录。使用 claude.ai 订阅或 SSO 登录时,桌面应用中的 Claude Code 功能需要付费方案。上文介绍的单独配置的第三方模式,以及在提供该选项时、非托管设备上的 Claude API 账户选项,可以让桌面应用改用 Console 或提供商计费。

API 是另一种产品,计费方式也不同。Console 账户会根据实际发送的 token 按量计费,更适合构建服务,而不是在终端中手动输入。设置 ANTHROPIC_API_KEY 会让 CLI 切换到这种计费路径,这是主动选择,而不是备用方案。在标准模式下,桌面应用通过 OAuth 登录;在第三方模式下,它使用自身配置中的凭据。

价格和方案限额变化过于频繁,无法在此完整列出。以下两个页面会跟踪当前数值:Claude Code 的实际费用和所需的 Claude 方案。如果您正在比较按 token 计费和月度方案,API 与订阅方案的费用比较会说明两者的盈亏平衡点。

实际会遇到的安装错误

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

Error loading shared library libstdc++.so.6。 可能是安装程序下载了错误的二进制文件变体,通常是在 glibc 系统上下载了 musl 构建版本;也可能是 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 中较早出现的旧副本会导致已修复的问题看起来仍未修复。

当前状态检查位置

Claude API 账户的登录策略、无人值守权限默认值、SSH 登录流程和凭据存储已于 November 7, 2026 完成检查;本指南中的其他版本号和日期仍是 October 2026 的快照。保持不变的是整体结构:四个入口,付费入口共用一次登录,以及一个决定——CLI 归属于您的用户账户,还是整台机器。

FAQ

Linux 是否有 Claude 桌面应用?

有。截至 2026 年 10 月,该应用处于 beta 阶段,支持 amd64 或 arm64 架构上的 Ubuntu 22.04 或更高版本,以及 Debian 12 或更高版本。在添加 Anthropic 的 apt 软件源及其签名密钥后,使用 sudo apt install claude-desktop 安装。这样,新版本会随常规系统升级一起获取。Linux 版本包含与 macOS 应用相同的选项卡,包括 Claude Code 选项卡。Linux 版本暂不支持 Computer Use 和语音听写。Quick Entry 全局快捷键可在 X11 上运行,但在原生 Wayland 会话中需要桌面环境提供 GlobalShortcuts portal。Fedora 和 RHEL 没有对应的软件包,因此在这些发行版上请使用 CLI 或浏览器中的 claude.ai。

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

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

如何通过 SSH 登录 Claude Code?

运行 claude,然后复制终端粘贴提示上方显示的独立授权 URL。在您自己的计算机上用浏览器打开该 URL,不要在服务器上打开。通过该 URL 登录后,浏览器会显示登录代码,而不是返回 localhost。将该代码粘贴到 Paste code here if prompted 提示符处。对于无人值守启动的会话,运行 claude setup-token,并在需要的位置将输出的令牌设置为 CLAUDE_CODE_OAUTH_TOKEN。

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

登录信息存储在 ~/.claude/.credentials.json 中,文件模式为 0600;设置该变量后,也可以存储在 CLAUDE_CONFIG_DIR 下。Linux 不使用密钥链。macOS 通常使用加密的 Keychain,但如果 Keychain 拒绝写入,则会回退到相同的明文文件。任何以您的用户身份运行的进程都可以读取 Linux 凭据文件。因此,/home 备份或机器映像会包含有效的登录信息。创建快照或复制系统前,请运行 /logout。如果环境中同时设置了 ANTHROPIC_API_KEY,在您批准该凭据后,它的优先级高于存储的订阅登录信息;/status 会显示当前使用的登录方式。

我的 Claude Pro 订阅是否同时涵盖 CLI 和 Web 应用?

是。Pro、Max、Ultra 或 Team 计划可让您使用同一个账户登录 claude.ai、桌面应用、CLI 和 VS Code 扩展。Enterprise 计划也支持这一点,但较早的 Enterprise 计划和支持 HIPAA 的 Enterprise 计划仅在相应席位包含 Claude Code 时提供该功能,例如 Chat + Claude Code 席位。支持 HIPAA 的组织使用独立的 Chat 和 Chat + Claude Code 席位类型,只有 Chat + Claude Code 席位包含 Claude Code。免费的 claude.ai 计划不包含 Claude Code。因此,终端 CLI 需要付费计划、Claude Console 账户,或组织使用的云提供商,例如 Amazon Bedrock、Google Cloud's Agent Platform 或 Microsoft Foundry。桌面应用支持订阅登录或 SSO 登录,也支持已配置的第三方推理服务。在未配置 Claude Desktop 的设备上,3.1623.1 或更高版本还提供 Claude API 账户选项,可使用 Console 登录或 API 密钥,无需预先配置。在 4.23118.0 或更高版本中,如果组织在计算机登录时阻止其他账户,即使未进行设备管理,该链接也会隐藏。API 按令牌计费,费用从 Console 账户单独结算。Console 账户与订阅属于不同产品。

这篇文章对您有帮助吗?