入門篇 · 第 2 章
安裝 Claude Code
前一章你已經會打開終端機了。這一章我們就把那位「住在電腦裡的工程師」請進來。安裝其實只要貼上一行指令、按 Enter 等它跑完——下面三個系統都有手把手步驟,照著做,不用懂背後原理。
2.1 先看全貌:安裝方式有三種
安裝 Claude Code 的方法不只一種,但你只要選一種做就好,不用全做。先用一張表認識它們,看完你就知道自己該走哪條路。
原生安裝(官方首選,建議大多數人用這個)
複製官方的一行指令,貼到終端機按 Enter 就裝好。最大的好處是它會自己在背景偷偷更新,你不用手動升級。Mac、Linux、Windows 都有對應的一行指令。
套件管理員(已經有在用 Homebrew / WinGet 的人)
如果你電腦已經裝了 Homebrew(Mac)、WinGet(Windows)或用 apt/dnf/apk(Linux)管理軟體,可以用它們來裝,方便跟你其他軟體一起管理。缺點:這種方式不會自動更新,要自己手動升級。
npm(給已經有 Node.js 開發環境的人)
如果你本來就是用 Node.js 寫程式、已經裝好 npm,也可以用它安裝。但官方現在已經不把它當首選了——原因下面說。
那為什麼官方現在主推「原生安裝」、不再優先推薦 ?
為什麼官方不再優先推薦 npm?
早期 Claude Code 是透過 npm 安裝的,但 npm 全域安裝常常卡在「權限」問題(裝的時候跳一堆 permission 錯誤),對新手很不友善。原生安裝沒有這個困擾,而且會自動更新,所以官方把它列為首選。值得一提:就算你用 npm 裝,裝進來的其實是「同一個」原生程式,npm 只是外面包了一層——所以沒有 Node.js 的人,完全不需要為了 Claude Code 特地去裝 Node.js。
想知道原理:為什麼官方不建議用 npm?
npm 裝進來的其實是同一個原生程式,只是外面多包一層;而且用 sudo npm 全域安裝常卡權限、有安全風險,所以官方建議直接用原生安裝。
懶得選?跟著做這個就對了
如果你不確定,直接用 2.2 的「原生安裝」一行指令。它官方首選、會自動更新、新手最少踩雷。下面 2.2 起就按系統手把手帶你做。
2.2 原生安裝:貼一行指令就好
這是官方首選、也是最推薦新手用的方式。動作只有一個:把對應你系統的那一行指令,整行複製、貼到、按 Enter,剩下交給它。裝好後它會在背景自動更新,你之後不用再管升級的事。
下面用分頁切換你的系統。Windows 請直接看 2.3:Windows Terminal → PowerShell 是本書唯一的新手路線。WSL 不需要安裝,也不在本章的 Windows 流程裡;不要把 WSL 的 Linux 指令和 PowerShell 指令混著貼。
分頁會整頁跟著切
跟第 1 章一樣,下面範例右上角的 Windows/Mac/Linux 分頁,切一個、整頁都會跟著切,翻到別章也記得你的選擇。先選好你的系統,往下照那一欄做。
動手之前,先掃一眼最低門檻,心裡有個底就好,不用真的一項項去查:
| 項目 | 最低門檻 |
|---|---|
| 🍎 macOS | 13.0(Ventura)以上 |
| 🪟 Windows | 10(版本 1809)以上,或 Server 2019 以上 |
| 🐧 Linux | Ubuntu 20.04、Debian 10、Alpine Linux 3.19 以上(其他發行版通常也能跑,官方沒有逐一列出而已) |
| 硬體 | 記憶體 4GB 以上,處理器 x64 或 ARM64 皆可 |
| 網路與地區 | 安裝與登入都需要能連上網路;所在地區也要在 Anthropic 支援的國家清單內,否則會卡在登入那一步 |
版本號這種東西官方會一直往前推,上面列的是寫這篇當下的門檻,正確數字以 code.claude.com/docs/en/setup 最新公告為準。這幾年買的電腦大概都不會卡在這一關,看過就好,安心往下做。
-
動手做
選你的作業系統
在下面的分頁點一下你正在用的系統(Windows/Mac/Linux),它會切換到對應的指令。切一個、整頁都會跟著切。
-
動手做
把指令整行複製,貼到終端機按 Enter
點右上角「複製」鈕拿到整行指令,貼進你的終端機視窗,按下 Enter,剩下交給它自己跑。
Windows 請不要在這裡找另一套 Linux 指令;開 Windows Terminal,選 PowerShell 分頁,接著看下一節 2.3。WSL 是既有公司/專案環境才需要的進階選項,不能和這條 PowerShell 路線混用。
# Mac:複製整行,貼到「終端機」按 Enter curl -fsSL https://claude.ai/install.sh | bash# Linux:複製整行,貼到終端機按 Enter curl -fsSL https://claude.ai/install.sh | bash想知道原理:這行 curl 在做什麼?
這行會從官方網址下載安裝程式並執行,把 Claude Code 放進你的電腦。它是獨立程式,不需要先裝 Node.js,而且之後會自動在背景更新。
-
確認它裝好了
指令跑完後,終端機通常會印出安裝完成的訊息。看到類似下面這樣,就代表成功了。
預期會看到# 大致會看到這類「安裝完成」訊息(實際文字依版本略有不同) Claude Code installed successfully Run claude to get started
裝好之後
跑完之後,最後一步是「真正啟動它」。在你想工作的專案資料夾裡,打一個字:
claude
「會自動更新」是什麼意思?
用原生安裝裝好的 Claude Code,會在你每次開啟時、以及執行中定期,自己到背景檢查並下載新版本,下次啟動就生效。換句話說,裝完這一次,以後升級你都不用管。(用套件管理員或 npm 裝的則要自己手動更新,2.5 會說。)
順手記住:它裝到哪裡去了
不用現在就去挖這些路徑,但先眼熟一下,之後設定 PATH、抓 bug、或想解除安裝時都用得到。原生安裝主要動到兩個地方:
| 放什麼 | 在哪裡 |
|---|---|
| 主程式本體 | 🍎🐧 ~/.local/bin/claude 🪟 %USERPROFILE%\.local\bin\claude.exe |
| 設定與快取 | ~/.claude/ 與 ~/.claude.json(🪟 Windows 對應到你的使用者資料夾底下) |
如果裝完打 claude 出現「找不到指令」,十之八九是~/.local/bin 這個位置還沒被系統的搜尋路徑記住——下面 2.6 有對症下藥的做法。
Windows Terminal 的 PowerShell 使用者:建議順手裝個 Git for Windows
如果你是在 Windows Terminal 的 PowerShell 分頁原生使用(不是 WSL),官方建議另外裝一個免費的 Git for Windows(到 git-scm.com 下載),這樣 Claude Code 能用到比較完整的指令工具。沒裝也能用,它會改用 PowerShell 替代。新手現在可以先記著,之後需要再裝。
想知道原理:裝了 Git for Windows,Claude Code 卻還是找不到?
偶爾會遇到 Git for Windows 明明裝了、卻沒被自動偵測到的狀況(通常是裝在非預設路徑)。這時可以在第 8 章會細講的個人設定檔 settings.json 裡手動指路,加一段 "env": { "CLAUDE_CODE_GIT_BASH_PATH": "C:\Program Files\Git\bin\bash.exe" },把路徑換成你實際安裝 bash.exe 的位置就好。現在用不到沒關係,之後卡在這裡時回來翻就好。
想裝特定版本,或搶先用還在測試的頻道?
官方的安裝腳本其實吃一個額外參數,可以指定頻道或版本號。例如 Mac/Linux 想改裝比較保守的 stable 頻道:curl -fsSL https://claude.ai/install.sh | bash -s stable;想釘住某個確切版本,把 stable 換成版本號即可,例如 bash -s 2.1.89。多數人用預設的 latest 就好,這招是留給「想穩定別亂跳版」或「想搶先玩新功能」的人。裝完之後想換頻道也不用重灌,2.5 會教你怎麼在既有安裝上直接切換。
2.3 Windows 怎麼裝:Windows Terminal → PowerShell
Windows 新手不要同時選 PowerShell、CMD、WSL 三條路。只做這件事:開 Windows Terminal,選 PowerShell 分頁,再貼本節唯一的安裝指令。 這樣就不會因為跨殼複製而卡住。
一秒確認:Windows Terminal 裡的 PowerShell
Windows Terminal 開啟後,游標前面看到 PS C:\Users\你的名字> 就是正確的 PowerShell 分頁。看到 CMD 或 Linux/WSL 分頁時,先切回 PowerShell;它們不是本節的備用指令入口。
怎麼開 Windows Terminal 的 PowerShell 分頁(給忘記的人)
- 按鍵盤左下角的 Windows 鍵(或點開始按鈕)。
- 直接打字搜尋
Windows Terminal,一般開啟即可,不需要「以系統管理員身分執行」。 - 在分頁下拉選單選 PowerShell,確認游標開頭有
PS。
在 Windows Terminal 的 PowerShell 裡(開頭有 PS)
# Windows Terminal 的 PowerShell(游標開頭有 PS)只用這行
irm https://claude.ai/install.ps1 | iex
不要用 CMD 或 WSL 當成失敗時的下一步
若這行出錯,先保留錯誤訊息、確認自己仍在 Windows Terminal 的 PowerShell 分頁,並看 2.6 的安全排查;不要改貼 CMD 指令、不要臨時安裝 WSL、也不要把兩種環境的路徑混在一起猜。
WSL 是既有環境才需要的進階選項
本書不要求 Windows 新手安裝 WSL。只有公司或既有專案已明確指定 WSL 時,才在那個環境中完整遵循該專案的 Linux 文件;安裝、啟動、路徑和設定都留在 WSL 裡,不與 Windows Terminal 的 PowerShell 共用或混貼。
2.4 另一條路:用套件管理員
如果你電腦已經在用「套件管理員」來裝軟體(Mac 的 Homebrew、Windows 的 WinGet、Linux 的 apt/dnf/apk),可以改用它們安裝,好處是跟你其他軟體一起管理。沒在用這些工具的新手,可以直接跳過這節,回到 2.2 的原生安裝就好。
套件管理員裝的不會自動更新
跟原生安裝不一樣,用套件管理員裝的 Claude Code 不會自己更新,要你自己定期手動升級(升級指令在每個分頁下面,2.5 也會整理)。如果你想要「裝完就不用管」,請用 2.2 的原生安裝。
Windows 上用 WinGet 安裝(在 Windows Terminal 的 PowerShell 分頁執行):
# 安裝(WinGet)
winget install Anthropic.ClaudeCode
# 之後要升級時,手動執行這行
winget upgrade Anthropic.ClaudeCode
Mac 上用 Homebrew()安裝:
# 安裝(Homebrew)
brew install --cask claude-code
# 之後要升級時,手動執行這行
brew upgrade claude-code
Linux 依你的發行版選一種。下面是 Debian/Ubuntu 的 apt 範例:
# Debian / Ubuntu(apt):先設定官方套件來源,再安裝
sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
-o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
| sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code
# 之後升級
sudo apt update && sudo apt upgrade claude-code
Fedora/RHEL(dnf):
# Fedora / RHEL(dnf):設定來源後安裝
sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code
# 之後升級
sudo dnf upgrade claude-code
Alpine Linux(apk):
# Alpine(apk):下載金鑰、加入來源後安裝
wget -O /etc/apk/keys/claude-code.rsa.pub \
https://downloads.claude.ai/keys/claude-code.rsa.pub
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add claude-code
# 之後升級
apk update && apk upgrade claude-code
Alpine(musl)另外要補兩個套件,不然常出現「找不到共享函式庫」的錯誤
Alpine 用的 musl 跟一般 Linux 常見的 glibc 是不同的底層函式庫,Claude Code 內建的部分二進位檔預設吃 glibc。裝完 claude-code 後,記得再補:apk add libgcc libstdc++ ripgrep;如果啟動後出現類似 Error loading shared library libstdc++.so.6 的錯誤,多半就是漏了這步。另外建議在 settings.json 的 env 底下加一行 "USE_BUILTIN_RIPGREP": "0",改用系統裝的 ripgrep,跳過內建版在 musl 上常見的相容性問題。
已經有 Node.js?也可以用 npm 裝
如果你本來就有 Node.js,也可以用 npm 全域安裝:npm install -g @anthropic-ai/claude-code,升級則是 npm install -g @anthropic-ai/claude-code@latest。請千萬不要在前面加 (sudo npm install -g)——官方明確警告這會造成權限與安全問題。Node.js 的版本門檻官方會不時往上調(寫這篇時最新要求是 22 以上),實際數字以安裝時的提示或 npm 頁面為準;版本不夠通常只會印一句警告,不一定會擋下安裝。沒有 Node.js 的人不必為它特地安裝,用 2.2 原生安裝更省事。
想知道原理:npm 裝的 claude 跟原生安裝的是同一包嗎?
是同一支程式,npm 只是外層的搬運工。@anthropic-ai/claude-code 這個套件實際上會依你的系統再抓一個對應平台的原生二進位檔(例如 Mac Apple Silicon 會抓 @anthropic-ai/claude-code-darwin-arm64),claude 指令執行時完全不會呼叫 Node.js——這也是為什麼前面說「沒有 Node.js 不用特地為它安裝」。升級時記得用 npm install -g @anthropic-ai/claude-code@latest,不要用 npm update -g,後者容易被舊版號規則卡住、升不到真正最新版。
2.5 確認安裝成功、查版本、更新
裝完別急著走,花十秒確認它真的裝好了。最簡單的方法:請它報出自己的版本號。三個系統都一樣,打這行:
建議執行:驗證裝好沒
claude --version
如果它印出一串版本號(例如 2.x.x),恭喜,安裝成功。如果它回你 command not found(找不到指令)或 'claude' 不是內部或外部命令,代表還沒裝好或路徑沒設好——別慌,直接看 2.6。
更完整的體檢
想更仔細檢查安裝與設定有沒有問題,可以用官方內建的「體檢指令」。它會幫你看一遍環境、告訴你哪裡需要修:
claude doctor
看懂 claude doctor 的回覆,比背指令更重要
它常見的幾種回覆,先認得長相,照它給的建議做就好,不用自己土法煉鋼猜:
Multiple installations detected:偵測到電腦上不只一套 Claude Code(例如原生安裝+npm 都裝過)。它會列出各自裝在哪,挑一個留下、其餘移除——下面 2.6 有詳細做法。Configuration mismatch:目前實際跑的安裝方式,跟設定檔裡記錄的對不上(例如「Running native / Configured npm-local」)。通常也是多重安裝造成的,一併照 2.6 清理。Ripgrep: not working:內建的搜尋工具 ripgrep 有問題,常見於 Alpine/musl 系統或檔案權限跑掉的情況。回 2.4 的 Alpine 補充處理,或檢查安裝過程有沒有把檔案權限弄壞。
想再深入一點:安裝的健康度其實分三層,各自回答不同層次的問題——claude --version 只確認「程式存在、能執行」;claude doctor 是終端機層級的唯讀診斷,檢查安裝完整度、設定檔語法、遠端控制資格;到了 Claude Code 對話裡面打 /doctor,則是功能更完整的互動版,能力所及還會順手幫你修好。三層各司其職,卡住時由淺到深查,不用一次就跳去重灌。
關於更新
你需不需要手動更新?看你當初怎麼裝
- 原生安裝(2.2):會自動在背景更新,你什麼都不用做。想立刻更新到最新版可以打
claude update。 - 套件管理員(2.4):不會自動更新,要自己跑升級指令(Homebrew:
brew upgrade claude-code/WinGet:winget upgrade Anthropic.ClaudeCode/apt 等見 2.4)。 - npm:不會自動更新,跑
npm install -g @anthropic-ai/claude-code@latest升級。
想確認更新有沒有成功?
再打一次 claude doctor,它會告訴你最近一次更新的結果。平常完全不用盯著它,這是給「覺得卡在舊版本」時的檢查工具。
進階:切換更新頻道,或乾脆關掉自動更新
原生安裝預設走 latest 頻道,功能最新最快拿到,但也可能先踩到剛出的問題。如果你想要「穩一點、晚個一週左右再拿到新版、也會自動跳過已知有嚴重問題的版本」,可以切到 stable 頻道。方法是在 Claude Code 對話裡打 /config,找到「Auto-update channel」切換;或直接編輯 settings.json 加一行 "autoUpdatesChannel": "stable"。想連背景自動檢查都關掉,設定環境變數 DISABLE_AUTOUPDATER=1 即可,但注意這只關「自動」檢查,claude update 這類手動更新指令還是能用;真的要連手動更新都封死,才需要 DISABLE_UPDATES(比較少見,通常是團體統一版本管控才會用到)。
被自動更新跳到不合用的版本?回頭釘住一個舊版就好
用 claude install 這個指令可以直接切到指定頻道或版本,不用重新跑一次安裝腳本:claude install stable 切到 stable 頻道,或 claude install 2.1.118 釘住某個確切版本號。跟前面 2.2 提過的安裝腳本參數(bash -s stable)效果類似,只是這個是「裝好之後」隨時可以下的指令。
進階:解除安裝與清理(會刪除檔案)
這一節是進階/企業管理情境,不是「程式卡住就先試試看」的修法。刪除路徑、設定或登入資料是不可逆操作;一般個人使用者先跑 claude doctor,保留錯誤訊息並依官方或 IT 指示處理,不要自行猜路徑、不要複製網路上的 rm -rf/刪除指令,也不要為了排錯清空設定資料夾。
原生安裝的移除(進階/企業)
先由 claude doctor、which -a claude(Windows 用 where.exe claude)確認實際安裝位置,再依官方或公司 IT 核准的卸載步驟處理。不要靠猜測刪除 ~/.claude、.local 或任何設定路徑;那些位置可能含登入狀態、個人設定或其他工具資料。
npm 安裝的移除(僅限你確定當初就是用 npm 安裝)
先以 claude doctor 確認安裝來源;確定是 npm 管理的版本,才使用 npm 自己的移除方式。它不會替你判斷其他原生安裝或公司管理版本,不能當成萬用清理指令。
移除後 claude 還能動?先盤點,不要逐一猜路徑刪除
通常是另一種安裝方式留下的版本,例如原生版和 npm 版同時存在。🍎🐧 用 which -a claude、🪟 在 Windows Terminal 的 PowerShell 用 where.exe claude 列出位置,保留結果交給官方文件或 IT 逐一判讀;不要直接刪「看起來像」的檔案。VS Code 外掛、JetBrains 外掛、桌面版 App 也可能共用或重新建立設定資料,尤其不要把 ~/.claude/ 當成可隨意清空的快取。
想知道原理:官方怎麼保證我下載的安裝檔沒被動過手腳?
每個版本發布時,官方會附一份簽過名的 manifest.json,裡面列出各平台二進位檔的 SHA256 checksum,可以用 GPG 驗證這份清單本身沒被竄改——官方公布的金鑰指紋是 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE(金鑰可能更新,正確指紋以官方頁面為準)。🍎 macOS 版另外有 Apple 公證(用 codesign --verify 驗)、🪟 Windows 版有 Authenticode 簽章(用 Get-AuthenticodeSignature 驗)。這套機制是 2.1.89 版之後才有的,一般使用者平常用不到,但如果你在意「這個裝進電腦的東西到底乾不乾淨」,這是可以自己動手查的路。
2.6 卡關了?對症下藥
安裝偶爾會卡關,這很正常,多半是小問題。下面把新手最常遇到的幾種狀況列出來,照著對。如果你的狀況不在這、或想看完整清單,最後有官方疑難排解頁的連結。
打 claude 說「找不到指令」(command not found)
最常見。通常是安裝成功了,但系統的「搜尋路徑()」還沒包含 Claude Code。最快的解法:把終端機整個關掉、重新開一個,再打一次 claude --version。多數情況這樣就好了。
Windows 報錯、或 irm 無法辨識
先回 2.3 確認你是從 Windows Terminal 開的 PowerShell 分頁,游標前有 PS;不要改去 CMD 或 WSL 尋找另一串指令。保留完整錯誤訊息,再依官方疑難排解對照。
下載失敗、連不上、卡很久(企業/校園網路進階情境)
可能是網路、防火牆、地區限制,或公司 Proxy/私有 CA 憑證造成的。不要自行猜測或從網路複製 HTTPS_PROXY/HTTP_PROXY/NODE_EXTRA_CA_CERTS 的值,也不要為了通過安裝而關閉憑證驗證。 這些值和憑證檔必須由公司 IT/校方提供,且要依其核准流程設定;個人使用者先保留錯誤訊息、跑 claude doctor,再查官方疑難排解或詢問網管。
npm 裝完跑 claude 出錯
npm 安裝偶有權限或相依套件問題。最省事的做法:改用 2.2 的原生安裝,它沒有這些 npm 特有的麻煩。
比較少見,但踩到會一頭霧水的狀況
下面幾種比較偏特殊環境(VPS、Docker、舊機器、WSL1),一般在自己筆電上裝很少遇到,但真的撞上會完全摸不著頭緒,先眼熟起來,之後真的碰到就不會慌。
在低記憶體的 VPS/雲端小主機上安裝,畫面只印一個 Killed
本質是系統記憶體不夠,安裝到一半被作業系統的 OOM(記憶體不足保護)機制強制砍掉,安裝大概需要 512MB 以上的可用記憶體。解法是先加一塊暫時的 swap 空間(例如 2GB)騰出餘裕,或先關掉其他吃記憶體的程式,再重跑一次安裝指令。
明明是 64 位元的電腦,卻報「不支援 32 位元 Windows」
通常不是電腦真的不支援,而是不小心開到 32 位元的 PowerShell 捷徑。回 Windows Terminal 的分頁下拉選單,選沒有 x86 字樣的 64 位元 PowerShell 後再試;不放心的話可以打 [Environment]::Is64BitOperatingSystem 確認作業系統本身是不是 64 位元(多數情況會回 True)。
Linux 上出現「找不到共享函式庫」(Error loading shared library)
常是系統用的底層函式庫(glibc)和安裝程式判斷的(musl)兜不起來。先用 ldd --version 確認自己是 glibc 還是 musl 系統,別急著照搬 Alpine 的 musl 解法(2.4 有寫)——兩邊的修法不一樣。
在 Docker 容器裡安裝或執行,行為怪怪的
兩個常見雷區:一是用 root 從根目錄直接跑安裝腳本,會掃描整個檔案系統、容器直接 hang 住——先切到暫存目錄(如 /tmp)再裝就好;二是容器裡沒裝 ripgrep/fzf 時,Claude Code 可能會「靜默」以正常結束碼直接退出、畫面上什麼錯誤都不印,很難聯想到是缺套件。遇到怪異的沉默失敗,先確認這兩個工具都在容器裡。
WSL(不是 WSL2)跑 claude 出現 Exec format error
這是 WSL1 對原生二進位檔的已知相容性問題,不是你裝錯。最乾淨的解法是把該發行版轉成 WSL2(指令大致是 wsl --set-version 加上發行版名稱和版本號 2),轉完問題通常就消失了。
完整疑難排解:官方頁一站搞定
上面沒對到你的狀況?官方有一頁「安裝與登入疑難排解」,把所有錯誤訊息對應的解法都列好了(含 PATH 設定、Windows 32 位元、公司憑證、登入 OAuth 等)。先在終端機跑一次 claude doctor 看它怎麼說,再對照官方頁:code.claude.com/docs/en/troubleshoot-install(連結見章末「官方出處」)。
真的卡住,可以先繞過終端機
如果終端機怎麼都裝不起來、又急著用,官方還有桌面版 App 和 VS Code 外掛這些圖形介面選項,不用碰命令列也能用 Claude Code。下一節 2.7 就介紹這些選擇。
2.7 不只終端機:VS Code、JetBrains、桌面版、瀏覽器版
這份教學主要教你在「終端機」裡用 Claude Code,因為那是最完整、功能最齊全的方式。但如果你平常就在某個編輯器裡工作,或根本不想碰命令列,還有幾個入口可以選。先認識它們,再給你「怎麼選」的建議。
VS Code 外掛(最受歡迎的圖形介面)
如果你用 VS Code(或 Cursor 等分支),可以裝官方外掛,把 Claude Code 變成編輯器裡的一個面板:改檔前並排顯示差異讓你確認、用 @ 標記檔案、保留對話紀錄。在 VS Code 按 Ctrl/Cmd+Shift+X 搜「Claude Code」就能裝。注意:外掛自帶一份程式給面板用,但如果你還想在 VS Code 的內建終端機打 claude,仍要另外做一次 2.2 的原生安裝。
JetBrains 外掛(IntelliJ/PyCharm/WebStorm 等)
如果你用 JetBrains 系列 IDE(IntelliJ IDEA、PyCharm、WebStorm、PhpStorm、GoLand、Android Studio…),到 JetBrains Marketplace 搜「Claude Code」裝外掛。它跟 VS Code 外掛不同:不自帶程式,所以你要先做完 2.2 的原生安裝,再裝這個外掛。
桌面版 App(完全不想碰終端機的人)
官方有獨立的桌面 App(Mac、Windows,也支援 Linux),用圖形介面安裝、操作,全程不用打任何指令,也不需要另外裝 Node.js 或 CLI。裡面分三個分頁:Chat(純對話,不碰你的檔案)、Cowork(丟給雲端虛擬機在背景自己跑,你可以先去忙別的)、Code(本機/遠端/SSH 都能接,逐步審核每一筆修改再放行,最接近終端機版的體驗)。最適合長輩、或只想趕快開始用、暫時不想學命令列的人。到官方下載頁取得(🪟 Windows 上如果要接本機專案,也需要先裝 Git;🍎 Mac 大多內建就有)。
瀏覽器版(Claude Code on the web,雲端執行)
在桌機瀏覽器(也可搭配 Claude 手機 App)打開就能用,工作跑在 Anthropic 的雲端伺服器上,關掉瀏覽器也不會中斷,還能用手機 App 看進度,使用時需要連結你的 GitHub 儲存庫。目前主要面向付費方案,實際開放範圍與條件以官方公告為準。它不是裝在你電腦上,跟前面幾種「裝在本機」的方式本質不同。
JetBrains 外掛在 WSL2 連不上,跳「No available IDEs detected」?
八九不離十是 WSL2 的網路模式或 Windows 防火牆擋住了 WSL2 跟 Windows 端 IDE 之間的通訊(WSL1 因為直接借用主機網路,不會有這個問題)。修法二選一:在 Windows 防火牆為 WSL2 的子網段開一條放行規則;或者如果你是 Windows 11 22H2 以後的版本,在 .wslconfig 設定 networkingMode=mirrored 改用「鏡像網路」模式,再執行 wsl --shutdown 重啟一次 WSL 讓設定生效。
所以我該選哪個?
- 想學最完整、跟著這份教學走 → 用終端機(就是 2.2 裝的那個)。本教學後面都以終端機為主。
- 平常就在 VS Code/JetBrains 裡寫東西 → 裝對應外掛,邊寫邊用最順手。
- 完全不想碰命令列、想趕快開始 → 用桌面版 App。
- 想在任何電腦的瀏覽器、或讓它在雲端幫你跑 → 試瀏覽器版(需付費方案 + GitHub)。
不用急著全部試一遍。先挑一個開始,之後隨時能換。
恭喜,工程師報到了
你已經把 Claude Code 裝進電腦、也知道怎麼確認它活著。下一章我們就要正式啟動並登入,讓它真正開始替你工作。安裝這關過了,後面都是有趣的部分。