網誌 · AI 工具 · 發佈

Claude Code 怎麼安裝與登入:終端機、桌面與雲端三種方式

Claude Code 的安裝與登入分兩步:先確認帳號類型(Pro、Max、Ultra、Team、Enterprise、Console,或經受支援的雲端廠商接入;免費版 claude.ai 不含存取權限),再依入口安裝。終端機用官方原生指令,安裝完成後執行 claude --version 能印出版本號即代表成功,首次執行 claude 會引導你在瀏覽器登入;桌面應用程式與網頁入口依頁面提示操作。文中列出系統需求、Windows 原生與 WSL 的差別、驗證指令和排解順序。

Claude Code 是 Anthropic 的程式設計助手(能讀取專案檔案、修改程式碼、執行指令的 AI 助手)。要用它,先確定兩件事:從終端機、桌面應用程式還是網頁進入,以及手上的帳號類型是否被官方支援。終端機入口用官方指令安裝,執行 claude --version 能印出版本號即為安裝成功;第一次在專案目錄執行 claude 會提示你在瀏覽器完成登入(官方快速入門、進階安裝說明)。

一、先確認帳號,再動手安裝

官方在認證一節統一寫明:Claude Code 需要 Pro、Max、Ultra、Team、Enterprise 或 Console 帳號,免費版 claude.ai 帳號不包含 Claude Code 的存取權限。除了這些訂閱與 Console 帳號,還可以透過受支援的雲端廠商接入:Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry。如果所在組織自建了 Claude apps gateway(應用閘道,管理員統一設定好的登入入口),管理員會預先設定閘道位址,輸入 /login 會直接開啟 Cloud gateway 頁面,用企業 SSO(單一登入)登入。

這裡有一個容易混淆的差別:能登入 claude.ai,不等於能用 Claude Code。免費帳號可以註冊和聊天,但要用它,帳號類型要落在上面這幾類裡。Console 帳號首次登入時,官方會自動建立一個名為「Claude Code」的工作區,用來集中統計這部分費用。

二、系統需求:先核對一遍再下載

項目 官方要求
作業系統 macOS 13.0+;Windows 10 1809+ 或 Windows Server 2019+;Ubuntu 20.04+;Debian 10+;Alpine Linux 3.19+
硬體 4 GB 以上記憶體;x64 或 ARM64 處理器
網路 需要連網
終端機 Bash、Zsh、PowerShell 或 CMD
所在地 Anthropic 支援的國家/地區

另有兩項相依性要知道:ripgrep(搜尋工具)通常隨 Claude Code 一起提供,官方寫明搜尋失敗時另看排解說明;Git 是選用相依性,裝了 Git 的話,claude plugin eval 和從 macOS、Linux、WSL 上傳本機儲存庫到雲端工作階段都要求 git 2.31 或以上版本,可以用 git --version 先看版本。

所在地這一條是官方寫明的執行條件,本文只依官方支援的地區說明,不涉及任何繞過地區限制的做法。

三、三種入口怎麼選

官方把網頁入口、桌面應用程式和終端機都列為使用方式,另有 VS Code、JetBrains 等編輯器入口。與安裝、登入最直接相關的是前三種:

入口 適合的情況 怎麼開始 登入與帳號
終端機 CLI(命令列介面) 專案在本機、習慣敲指令 依系統執行官方安裝指令,進入專案目錄執行 claude 首次執行依瀏覽器提示登入,憑證會保存
桌面應用程式 不想開終端機,想要圖形介面 從官方文件的桌面應用程式入口下載 macOS、Windows 或 Linux 版本 依應用程式內提示操作;帳號要求見第一節
網頁雲端 想直接在瀏覽器裡用,或把本機儲存庫交給雲端工作階段 開啟 claude.ai/code 以頁面提示為準;從 macOS、Linux、WSL 上傳本機儲存庫需要 git 2.31 或以上版本

選擇的時候看兩件事:專案在哪、你願不願意開終端機。專案在本機、要頻繁改檔案,終端機最直接;不想碰命令列,桌面應用程式是官方提供的圖形入口;只想在瀏覽器裡用,或者要把本機儲存庫傳到雲端工作階段,就走網頁入口。官方另外把從沒使用過終端機的人引到一份終端機入門指南,裡面講怎麼開啟終端機、怎麼貼上指令,第一次安裝可以先看它。

四、終端機安裝:一條指令,三步核對

  1. 開啟終端機。macOS 和 Linux 用系統終端機;Windows 用 PowerShell 或 CMD。判斷方法:提示字元是 PS C:\\ 就是 PowerShell,只有 C:\\ 就是 CMD。
  2. 依系統選指令(原生安裝,官方標註為推薦): - macOS、Linux、WSL(Windows 裡的 Linux 子系統):curl -fsSL https://claude.ai/install.sh | bash - Windows PowerShell:irm https://claude.ai/install.ps1 | iex - Windows CMD:curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  3. 安裝完成後新開一個終端機視窗,執行 claude --version。印出版本號、後面帶 (Claude Code),就代表裝好了。官方特別說明:安裝指令在下載過程中不會顯示進度,停在那裡不動不等於失敗。

提示找不到指令時,官方給的解釋是安裝目錄還沒加入 PATH(系統尋找指令的目錄清單),並另外寫了修復 PATH 的說明,不必急著重新安裝。

同一件事還有幾個官方管道,依系統和使用習慣選擇:

  • Homebrew:brew install --cask claude-code。官方有兩個 cask(Homebrew 的安裝包形式),claude-code 跟隨穩定通道,claude-code@latest 跟隨最新通道;用 Homebrew 安裝的預設不會自動更新。
  • WinGet:winget install Anthropic.ClaudeCode,同樣預設不會自動更新。
  • Debian、Fedora、RHEL、Alpine:用 apt、dnf 或 apk 這幾個系統套件管理器安裝,官方提供帶簽章的軟體來源。
  • npm(Node.js 的套件管理器):npm install -g @anthropic-ai/claude-code,需要 Node.js 22 或以上版本;官方明確提醒不要用 sudo npm install -g。

Windows:原生還是 WSL

方式 沙箱(把指令限制在隔離環境裡執行) 適合的情況
原生 Windows 不支援 Windows 原生專案和工具
WSL 2 支援 Linux 工具鏈,或需要沙箱執行指令
WSL 1 不支援 WSL 2 無法使用時

原生 Windows 安裝不需要管理員權限。官方建議安裝 Git for Windows,這樣 Claude Code 才能使用 Bash 工具;沒安裝時它會改用 PowerShell 作為執行指令的 shell 工具。如果 Claude Code 找不到 Git Bash,可以在 settings.json 裡用 CLAUDE_CODE_GIT_BASH_PATH 指定路徑。用 WSL 的話,要在 WSL 終端機裡安裝和啟動 claude,不是在 PowerShell 或 CMD 裡安裝;WSL 也不需要 Git for Windows。

Alpine 和其他 musl 系發行版另有一道門檻:安裝指令需要 bash 和 curl,執行還需要 libgcc、libstdc++ 和 ripgrep。Alpine 預設不帶 bash 和 curl,官方給的做法是先 apk add bash curl libgcc libstdc++ ripgrep,再在 settings.json 裡把 USE_BUILTIN_RIPGREP 設為 0。

五、登入:帳號類型對了,瀏覽器授權一次就夠

安裝完成後進入專案目錄執行 claude:

cd /path/to/your/project
claude

第一次執行會提示登入。訂閱帳號或 Console 帳號依提示在瀏覽器完成認證即可。如果你已經設定過 ANTHROPIC_API_KEY 環境變數(一種把金鑰放在系統環境裡、供程式讀取的做法),並在它詢問是否使用這個金鑰時同意,它會跳過登入提示、直接使用金鑰。登入成功後憑證會保存,不用每次重新登入;以後想換帳號或重新認證,在執行中的工作階段裡輸入 /login。

進入工作階段後,提示字元上方會顯示版本、目前模型和工作目錄;輸入 /help 查看可用指令,/resume 繼續先前的對話。按 Shift+Tab 可以切換目前工作階段的權限模式(permission mode,決定哪些操作要先詢問你)。

六、安裝完成先驗證,再決定要不要手動更新

安裝完成後不要只看安裝腳本有沒有報錯,用兩個指令核對:

  • claude --version:印出版本號,表示指令能被找到並且能執行。
  • claude doctor:唯讀診斷,不啟動工作階段,會列出安裝健康狀態、設定檔驗證錯誤,以及附有建議的警告。

更新策略取決於安裝方式。原生安裝會在背景自動更新,下載安裝完成後於下次啟動時生效;用 Homebrew、WinGet 和 Linux 套件管理器安裝的預設要手動更新,分別是 brew upgrade claude-code(或 brew upgrade claude-code@latest)、winget upgrade Anthropic.ClaudeCode,以及各套件管理器自己的升級指令。想立刻更新、不等下一次背景檢查,請執行 claude update。

官方還有發行通道:latest 是預設通道,新功能第一時間收到;stable 通常落後約一週,會跳過有重大回歸的版本。可以在 /config 的 Auto-update channel 裡切換,也可以在 settings.json 寫 autoUpdatesChannel;用 Homebrew 安裝的以 cask 名稱區分通道,不會讀取這個設定。

七、怎麼確認安裝的是官方檔案

官方每次發行都會提供 manifest.json(清單檔案),裡面列出各平台二進位檔的 SHA256 校驗值,並用 Anthropic 的 GPG 金鑰(一種用於驗證檔案來源和完整性的簽章機制)簽章,驗證了這個簽章就等於驗證了它列出的每個二進位檔。macOS 的二進位檔由「Anthropic PBC」簽章並經 Apple 公證,Windows 的二進位檔由「Anthropic, PBC」簽章;Linux 的二進位檔不另外做程式碼簽章,用清單的簽章或套件管理器的軟體來源簽章來確認完整性。

八、卡住時依照這個順序排解

  1. 找不到 claude:先確認安裝目錄有沒有加入 PATH,官方把這種情況單獨列為「Fix your PATH」。
  2. Windows 指令報錯:先確認目前是 PowerShell 還是 CMD,兩種終端機的指令不能混用。看到 The token '&&' is not a valid statement separator,表示在 PowerShell 裡執行了 CMD 指令;看到 'irm' is not recognized,表示在 CMD 裡執行了 PowerShell 指令。換到對應的終端機再執行一次。
  3. 安裝腳本報錯:遇到 syntax error near unexpected token '<'、403 或其他錯誤,官方建議對照「Troubleshoot installation」找到對應的修復和替代安裝方式。
  4. 網路問題:系統需求裡寫明需要連網,官方另有網路設定說明;依那裡的設定排解,不要靠反覆重新安裝解決。
  5. 解除安裝後還能執行:官方說明這通常代表還有第二份安裝,或舊安裝程式留下的 shell 別名,先找出來刪掉再重新安裝。

原生安裝的解除安裝方式是刪掉執行檔和版本目錄(macOS、Linux、WSL 用 rm -f ~/.local/bin/claude 和 rm -rf ~/.local/share/claude,Windows 用對應的 PowerShell 刪除指令);用 Homebrew、WinGet、npm 安裝的分別用 brew uninstall --cask、winget uninstall、npm uninstall -g。要注意:刪掉 ~/.claude 會連同設定、允許的工具、MCP(讓外部工具接入 Claude Code 的設定)和工作階段歷史一起清掉,官方提醒先把桌面應用程式、VS Code 擴充套件、JetBrains 外掛解除安裝乾淨,否則它們下次執行又會把這個目錄建回來。

如果你同時也在比較 ChatGPT 各檔訂閱怎麼選,站內的 ChatGPT 訂閱費用總覽 依使用情境整理了選擇順序,也可以直接看 ChatGPT 充值套餐 的檔位說明,作為另一條參考。

Ken|充值貓 TopupCat 營運負責人

內容由充值貓內容團隊整理,Ken 以營運負責人身份署名。查看作者資料

相關閱讀

相關商品:ChatGPT Go · ChatGPT Plus · ChatGPT Pro · 充值教學 · 常見問題 · 自助排解