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

Claude Linux 桌面版與 CLI 安裝及方案

了解 Linux 原生支援的 4 種 Claude 介面：apt beta 桌面應用程式、Claude Code CLI、編輯器外掛與 Web/API，並確認各自適用的付費方案。

Claude 目前有哪些部分可原生執行於 Linux

Claude 在 Linux 上以 4 種獨立介面提供服務。截至 August 2026，這 4 種介面都能在一般的 Ubuntu 或 Debian 機器上運作。桌面應用程式可從 Anthropic 的 apt repository 安裝，目前處於 beta 階段。Claude Code CLI（command line interface）是編譯後的 binary，支援的 distribution 比桌面應用程式更多。位於 claude.ai 的 web app 只需要瀏覽器，API 則是由自有程式呼叫的 HTTPS endpoint。

macOS 和 Windows 提供的 2 項功能目前不在 Linux desktop beta 中：Computer Use，也就是讓 Claude 控制畫面上的應用程式；以及 voice dictation。Anthropic 將這 2 項功能都列為尚未在 Linux 上提供。CLI 有自己的 voice dictation，因此缺少這項功能的是桌面應用程式，而不是 Claude 本身。

可用性會變動，因此請將本頁視為各介面的說明，並在據此規劃前確認目前狀態。最後一節列出應查看的頁面。

在 Ubuntu 或 Debian 上安裝 Claude 桌面應用程式

文件列出的需求為 Ubuntu 22.04 或更新版本，或 Debian 12 或更新版本，平台必須是 x86_64（dpkg 稱為 amd64）或 arm64。其他以 Debian 為基礎的發行版可能可以運作，但尚未測試。Fedora 和 RHEL 目前尚未提供套件，因此請在這些系統上使用 CLI 或瀏覽器。

請從 apt repository 安裝，不要使用下載的 .deb 檔案。Linux 應用程式沒有自己的更新程式，因此新版本只能透過套件管理員取得；註冊 repository 後，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。註冊 repository 前請先比對指紋，因為未經檢查的簽署金鑰等同於盲目信任該金鑰。如果 gpg 回報檔案不含有效的 OpenPGP 資料，表示下載失敗，之後執行 apt update 也會因 NO_PUBKEY BAA929FF1A7ECACE 而失敗。

註冊 repository 只需將一行 deb 寫入 /etc/apt/sources.list.d/claude-desktop.list。請從 Anthropic 的 Linux 安裝頁面 code.claude.com/docs/en/desktop-linux 完整複製該行，內容必須與頁面顯示完全一致。repository 位址是此程序中最可能變更的部分；憑記憶輸入該行，之後就可能只能看著 E: Unable to locate package claude-desktop。貼上前請先閱讀該行：arch=amd64,arm64 會使其他架構的 apt 找不到任何套件，而 signed-by= 指向你剛才檢查過的 keyring 檔案，將該金鑰的信任範圍限制在這個 repository，而不是信任 apt 讀取的所有內容。

sudo apt update && sudo apt install claude-desktop

請從應用程式啟動器啟動，或在終端機執行 claude-desktop。使用 claude.ai 帳戶登入；如果公司已設定組織的 SSO（single sign-on），也可以透過該方式登入。桌面應用程式不接受 Claude Console API key；以金鑰為基礎的驗證是 CLI 的功能。

E: Unable to locate package claude-desktop 表示 apt 從未讀取該 repository。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 job 或 pipeline 使用。您可以自行設定答案的格式，因為輸出樣式會修改每次回覆背後的 system prompt，讓腳本執行結果保持簡潔，而互動式工作階段則提供詳細說明。
  • 它可透過 claude mcp add 連線至 MCP（model context protocol）伺服器，讓模型取得超出檔案系統範圍的工具。
  • 它可在完全沒有圖形桌面的環境中執行，這正是您租用的每台 VPS（virtual private server）都會遇到的情況。

最後一點正是伺服器指南需要介紹 CLI 的原因。租用的伺服器通常只有 SSH（secure shell），沒有其他介面，因此終端機是唯一能與您一同使用的操作介面。以這種方式執行有其專屬規則，在 VPS 的 tmux 中執行 Claude Code會完整說明相關內容，而使用 Claude 處理日常系統管理工作則介紹適合交給它的工作。

編輯器整合介於兩者之間。VS Code 擴充功能需要 VS Code 1.94.0 或更新版本，並會在編輯器內提供圖形面板，讓您檢視差異與執行計畫。它會為該面板附帶一份私有的 CLI 副本，不會將 claude 放入您的 PATH，因此在整合式終端機中輸入 claude 時，仍需要獨立安裝。以 VS Code 為基礎的編輯器會從 Open VSX registry 安裝相同的擴充功能，此外也提供 JetBrains plugin。

在 Linux 上執行 Claude Code 需要 Node.js 嗎？

使用建議的安裝方式不需要。原生安裝程式會下載已編譯的 binary，而該 binary 不會在 Node.js 上執行。

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

claude --version 應輸出類似 2.1.211 (Claude Code) 的版本號碼。如果結果異常，請執行 claude doctor。此命令會輸出安裝與設定檔的唯讀診斷資訊，但不會啟動工作階段。

只有使用 npm 安裝方式時才需要 Node.js。自 package version 2.1.198 起，npm package 需要 Node.js 22 或更新版本。在較舊的 Node.js 上，npm 會輸出 EBADENGINE 警告，而不會直接失敗，因為該 package 會將相同的原生 binary 作為平台專用相依套件一併安裝，並建立連結。

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

請勿搭配 sudo 執行該命令。文件警告不要使用 sudo npm install -g，因為這會在全域 npm prefix 中建立由 root 擁有的檔案，導致下一次未提升權限的安裝或更新因權限不足而失敗。當 npm 全域目錄不可寫入時，背景自動更新會停止運作，而 claude doctor 會列出修正方式。

Anthropic 也為 Debian、Fedora、RHEL 和 Alpine 發布已簽署的 package repository，因此 sudo apt install claude-code 的運作方式與桌面 package 大致相同，並使用位於 https://downloads.claude.ai/keys/claude-code.asc 的專用 signing key。

應以每位使用者安裝，還是全系統安裝？

原生安裝程式會以每位使用者為範圍安裝。它會在 ~/.local/bin/claude 建立一個指向 ~/.local/share/claude/versions/ 的 launcher symlink，不需要 root，並在背景自動更新。機器上的每位使用者都會有獨立的副本，且版本可各自不同。

套件管理器安裝則是全系統安裝。所有使用者共用同一個 binary，需要 root，且不會透過 Claude Code 自動更新。請使用 sudo apt update && sudo apt upgrade claude-code 升級，這與您在該機器上管理其他項目時已使用的指令相同。

如果機器由您自行登入使用，請選擇每位使用者安裝；這涵蓋大多數 VPS 工作。如果是共用伺服器或 machine image，請選擇套件安裝。如此可讓所有人使用同一個版本，並依您的排程更新。原生安裝的更新行為由 ~/.claude/settings.json 中的 2 個設定決定：

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

stable channel 會使用約 1 週前的 release，並略過有重大 regression 的 release。DISABLE_AUTOUPDATER 只會停止背景檢查，因此 claude update 仍可運作，您也能自行決定何時套用新版本。對於在無人值守情況下執行長時間工作的伺服器，這點很重要，因為您通常不希望 binary 在工作執行期間自行變更。

透過 SSH 登入，並維持工作階段連線

第一次在租用的伺服器上執行 CLI 時，會遇到 2 個 Linux 特有的問題。登入流程需要瀏覽器，但伺服器上沒有瀏覽器。SSH 連線中斷時，正在執行的工作也會一併中斷。

tmux 可以解決第二個問題。tmux 工作階段屬於遠端機器上的 tmux 伺服器，而不是你的連線，因此連線中斷後，處理程序仍會繼續執行。

tmux new -s claude
claude

按 Ctrl-b，再按 d 即可脫離工作階段。之後可用 tmux attach -t claude 重新連回。

登入是第一個問題。執行 claude，指令會輸出授權 URL。在自己的電腦上用瀏覽器開啟該 URL。登入後，瀏覽器會顯示登入碼，而不是重新導向回去，因為筆記型電腦上的瀏覽器無法連線到 Claude Code 在遠端機器 loopback 位址上啟動的回呼伺服器。將該登入碼貼到終端機的 Paste code here if prompted 提示字元後，終端機會顯示 Login successful。

如果工作階段必須在無人監看時啟動，claude setup-token 會開啟相同的瀏覽器授權流程，並將有效期為 1 年的 OAuth token 輸出到終端機。它不會將 token 儲存到任何位置，因此請複製 token，並在需要的位置設定它。

export CLAUDE_CODE_OAUTH_TOKEN=your-token

該 token 需要付費方案，且只能用來提出模型要求。請將它視為有效期為 1 年的密碼。如何儲存它，以及如何避免代理程式將它讀回，是 避免 AI 代理程式取得機密 的主題。

小型伺服器還會遇到另一個限制。安裝需要約 512 MB 的可用記憶體，而文件記載的執行硬體需求是 4 GB RAM 以上。因此，在 1 GB 執行個體上，核心的 out-of-memory killer 會終止安裝程序：

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 上，token 是位於家目錄中的純文字檔案，任何以該使用者身分執行的程序都能讀取。設定 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 extension，而且每次使用的都是同一個訂閱。所有介面也共用同一個使用額度，因此你在伺服器上執行一次長時間的 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 repository 和簽署金鑰，再使用 sudo apt install claude-desktop 安裝，之後新版本會隨一般系統升級一併取得。Linux 版本具備與 macOS 應用程式相同的分頁，包括 Claude Code 分頁。目前 Linux 版本尚未支援 Computer Use 和語音聽寫；Fedora 和 RHEL 也沒有套件，因此這些發行版請使用 CLI 或瀏覽器中的 claude.ai。

在 Linux 上執行 Claude Code 需要 Node.js 嗎？

不需要，建議的安裝方式不需要 Node.js。curl -fsSL https://claude.ai/install.sh | bash 會下載編譯完成的 binary，執行時不使用 Node.js。只有安裝 npm package 時才需要 Node.js；截至版本 2.1.198，該套件要求 Node.js 22 或更新版本。若 Node.js 版本較舊，npm 會顯示 EBADENGINE 警告，但安裝仍會完成，因為相同的原生 binary 會以平台專用相依套件的形式一併下載。請勿使用 sudo npm install -g 安裝，否則 npm prefix 中會留下 root 擁有的檔案，導致後續更新失敗。

如何透過 SSH 登入 Claude Code？

執行 claude，畫面會顯示授權 URL。請在自己的電腦上開啟該 URL，不要在伺服器上開啟。登入後，瀏覽器會顯示登入代碼，而不是重新導向，因為它無法連線到 Claude Code 在遠端電腦 loopback 位址上啟動的 callback listener。請將該代碼貼到 Paste code here if prompted 提示字元。若工作階段啟動時沒有使用者在場，請執行 claude setup-token，並在需要的位置將顯示的 token 設定為 CLAUDE_CODE_OAUTH_TOKEN。

Claude Code 在 Linux 上將登入資訊儲存在哪裡？

儲存在 ~/.claude/.credentials.json，檔案模式為 0600；若設定該變數，則儲存在 CLAUDE_CONFIG_DIR。Linux 不使用 keychain，與 macOS 不同，因此任何以您使用者身分執行的處理程序都能讀取該檔案。因此，/home 備份或機器映像檔會包含有效的登入資訊：建立 snapshot 或複製系統前，請執行 /logout。若環境中也設定了 ANTHROPIC_API_KEY，在您核准後，它的優先權會高於儲存的訂閱登入資訊；/status 可顯示目前使用中的登入方式。

我的 Claude Pro 訂閱也涵蓋 CLI 和網頁應用程式嗎？

涵蓋。Pro、Max、Team 或 Enterprise 方案可讓您使用同一個帳戶登入 claude.ai、桌面應用程式、CLI 和 VS Code extension。免費的 claude.ai 方案不包含 Claude Code，因此終端機 CLI 需要付費方案或 Claude Console 帳戶。API 由 Console 帳戶依 token 另行計費；Console 是不同於訂閱方案的產品。

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