SSD Nodes Learn 🎉 VPS $5.50/月起
指南 Matt Connor作者： Matt Connor · 已更新 2026-08-13

Claude Linux 桌面版與 CLI 安裝指南

了解 Linux 目前可原生執行的 Claude 介面：apt beta 桌面應用程式、Claude Code CLI 與編輯器外掛，並確認各功能適用的付費方案。

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

Claude 在 Linux 上透過 4 個獨立介面執行。截至 2026 年 8 月，這 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 控制畫面上的應用程式；以及語音聽寫。Anthropic 將這 2 項功能都列為尚未在 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 而失敗。

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

sudo apt update && sudo apt install claude-desktop

請從應用程式啟動器啟動，或在終端機執行 claude-desktop。使用你的 claude.ai 帳戶登入；如果公司已設定組織的 SSO（單一登入），也可以透過該方式登入。桌面應用程式不接受 Claude Console API key；以 key 為基礎的驗證是 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 工作或 pipeline 中使用。
  • 它可透過 claude mcp add 連接 MCP (model context protocol) 伺服器，讓模型取得檔案系統以外的工具。
  • 它可在完全沒有圖形桌面的環境中執行，而你租用的每一台 VPS (virtual private server) 都會是這種環境。

最後一點就是伺服器指南需要介紹 CLI 的原因。租用的伺服器只有 SSH (secure shell)，沒有其他介面，因此終端機是唯一能與你一同存在於該環境中的操作介面。以這種方式執行有自己的規則，在 VPS 中透過 tmux 執行 Claude Code 會完整說明這些規則，而使用 Claude 處理日常 systemd 管理工作則涵蓋適合交給它的工作。

編輯器整合介於兩者之間。VS Code extension 需要 VS Code 1.94.0 或更新版本，並會在編輯器中提供圖形面板，讓你檢視差異與執行計畫。該面板會附帶一份私有的 CLI 副本，不會將 claude 加入你的 PATH，因此在整合式終端機中輸入 claude 時，仍需要先獨立安裝 CLI。以 VS Code 為基礎的編輯器可從 Open VSX registry 安裝相同的 extension，另有 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。截至套件版本 2.1.198，npm 套件要求 Node.js 22 或更新版本。在較舊的 Node.js 上，npm 會輸出 EBADENGINE 警告而不會失敗。這是因為該套件會將相同的原生 binary 作为每個平台的相依套件引入，並將其連結到適當位置。

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

請勿搭配 sudo 執行該命令。文件警告不要使用 sudo npm install -g，因為這會在全域 npm prefix 中留下由 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，且會在背景自動更新。機器上的每位使用者都會取得獨立副本，版本也彼此分開。

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

如果是以自己的帳號登入機器，請選擇每位使用者安裝，這涵蓋大多數 VPS 工作。如果是共用伺服器或 machine image，請選擇套件安裝；這樣所有人都使用同一個版本，並依照你的排程更新。使用原生安裝時，~/.claude/settings.json 中的兩項設定會決定更新行為：

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

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

透過 SSH 登入，並保持工作階段存活

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

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

tmux new -s claude
claude

使用 Ctrl-b 再按 d 脫離工作階段，稍後以 tmux attach -t claude 返回。

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

如果工作階段必須在無人看管的情況下啟動，claude setup-token 會開啟相同的瀏覽器授權流程，並將有效期限一年的 OAuth token 輸出到終端機。它不會儲存 token，因此請複製 token，並依需求設定。

export CLAUDE_CODE_OAUTH_TOKEN=your-token

該 token 需要付費方案，而且只能提出 model requests。請將它視為有效期限一年的密碼。應將它儲存於何處，以及如何防止 agent 讀回該 token，是 避免 AI agent 取得 secrets 的主題。

小型伺服器還會遇到另一個限制。安裝需要約 512 MB 的可用記憶體，而文件記載的執行硬體需求為 4 GB RAM 以上。因此，在 1 GB instance 上，kernel 的 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 是 kernel 用作溢位記憶體的磁碟空間。它比 RAM 慢很多，但足以完成安裝。

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

swapon 僅會在本次開機啟用該檔案。如果希望重新開機後仍然啟用，請將一行 /swapfile 加入 /etc/fstab。在讓 agent 於執行中的伺服器上執行命令前，還需要鎖定哪些設定，是 在 VPS 上安全執行 Claude Code 的主題。

Linux 上 Claude 憑證的存放位置

在 Linux 上，/login 會以檔案模式 0600 將憑證寫入 ~/.claude/.credentials.json。macOS 會將相同的憑證存放在加密的 Keychain 中，因此在 Mac 上養成的使用習慣不適用於 Linux：在 Linux 上，token 是 home directory 中的純文字檔案，任何以你的使用者身分執行的程序都能讀取。設定 CLAUDE_CONFIG_DIR 後，檔案會改存到該目錄下。

這會帶來兩個後果。/home 的備份包含有效的登入憑證，因此將該備份複製到共用機器，等同於把你的帳戶交給所有能讀取它的人。從已登入的機器建立 machine image，也會將該登入憑證帶到從中複製的每個執行個體。在建立 snapshot 前執行 /logout。

同時持有 subscription 和 API key 時，憑證優先順序容易造成問題。當 shell 中設定了 ANTHROPIC_API_KEY，Claude Code 會在你核准後使用它，因此 subscription 會閒置不用，而 API key 則按 token 計費。/status 會顯示目前使用中的憑證，unset ANTHROPIC_API_KEY 會讓你返回 subscription 登入。

登入狀態會過期。距離過期不到三天時，啟動訊息會顯示 Your login expires in 3 days，且該警告不會阻擋請求。過期後，每個請求都會失敗並顯示 Login expired · Please run /login。在讓未受管理的 session 執行整個週末前，請先了解這點，因為該 session 會停止進度，且無法自行恢復。

一個 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 extension 不會建立該檔案，因為 extension 會將 CLI 副本保留在 extension 目錄中。

Error loading shared library libstdc++.so.6。 安裝程式為 glibc 系統選取了 musl 建置版本。系統中存在 musl cross-compilation 套件，且偵測結果誤判時，就會發生這種情況。執行 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/ 的 symbolic link；舊版 local npm 安裝位於 ~/.claude/local/ 下，而 npm -g ls @anthropic-ai/claude-code 會顯示 global npm 安裝。移除不需要的版本，因為 PATH 中較前面的過期副本，會讓已修正的錯誤看起來仍未修正。

目前狀態查詢位置

本指南中的所有版本號碼與日期，都是 2026 年 8 月的狀態快照。真正維持不變的是整體架構：4 種介面、付費介面共用 1 次登入，以及 CLI 應安裝在使用者帳號還是整台機器上的選擇。

FAQ

Linux 有 Claude desktop app 嗎？

有。截至 August 2026，Linux 版仍在 beta 階段，支援 amd64 或 arm64 架構上的 Ubuntu 22.04 或更新版本，以及 Debian 12 或更新版本。先加入 Anthropic 的 apt repository 和簽署金鑰，再使用 sudo apt install claude-desktop 安裝。之後新版本會隨一般系統升級一併提供。Linux 版具備與 macOS app 相同的分頁，包括 Claude Code 分頁。目前 Linux 版尚未支援 Computer Use 和語音聽寫；Fedora 與 RHEL 也沒有可用套件，因此這些發行版請使用 CLI 或瀏覽器中的 claude.ai。

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

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

如何透過 SSH 登入 Claude Code？

執行 claude，程式會顯示授權 URL。請在自己的電腦上以瀏覽器開啟該 URL，不要在伺服器上開啟。登入後，瀏覽器會顯示 login code，而不是重新導向，因為瀏覽器無法連線至 Claude Code 在遠端機器 loopback address 上啟動的 callback listener。請在 Paste code here if prompted prompt 貼上該 code。若工作階段啟動時沒有使用者在場，請執行 claude setup-token，並在需要的地方將顯示的 token 設為 CLAUDE_CODE_OAUTH_TOKEN。

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

儲存在 ~/.claude/.credentials.json，檔案模式為 0600；若設定了該變數，則儲存在 CLAUDE_CONFIG_DIR。Linux 不會使用 keychain，與 macOS 不同，因此任何以你的使用者身分執行的程序都能讀取該檔案。因此，/home backup 或 machine image 會包含可用的登入狀態。建立 snapshot 或複製系統前，請先執行 /logout。如果環境中也設定了 ANTHROPIC_API_KEY，在你核准後，它的優先權會高於儲存的 subscription login；/status 會顯示目前使用中的登入方式。

我的 Claude Pro subscription 同時涵蓋 CLI 和 web app 嗎？

涵蓋。Pro、Max、Team 或 Enterprise plan 使用同一個帳戶登入 claude.ai、desktop app、CLI 和 VS Code extension。免費的 claude.ai plan 不包含 Claude Code，因此 terminal CLI 需要付費 plan 或 Claude Console account。API 會由 Console account 依 token 另行計費；Console account 與 subscription 是不同的產品。

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