如何從官方網站安裝 Claude Code

Claude Code 是什麼？為什麼要在終端機中使用？#

對沒有軟體開發背景、剛開始接觸氛圍編碼的人來說，終端機幾乎總是令人害怕。它看起來像駭客電影中的黑色視窗，但實際上只是一個輸入指令的地方。Claude Code 正是需要終端機，才能開啟並修改你的檔案、自己執行檢查，同時由你用文字描述任務。

Anthropic 對這項產品的描述如下。

它和熟悉的聊天工具差別很簡單。在瀏覽器中，你得在聊天視窗和編輯器之間手動來回複製程式碼。Claude Code 會直接進入專案資料夾，讀取所需檔案、進行修改，並告訴你改了什麼。決定與核准仍由你負責；它替你處理機械性的工作。

如果你真的不想使用終端機，Anthropic 也提供有一般視窗介面的桌面應用程式，以及可直接在瀏覽器執行的網頁版 claude.ai/code。不過，功能最強大、最靈活的選項是終端機版本，本文將全面介紹這個版本。

Claude Code 的官方網站在哪裡？應該下載什麼？#

初學者最先會困惑的是 Claude Code 的官方網站在哪裡，以及要點選什麼才能下載。以下整理了 Anthropic 所有官方網址，讓你不必猜測。

你不會像安裝一般程式那樣，從網站下載安裝程式，這和許多人的預期不同。你要透過終端機指令安裝，指令會下載適用於系統的版本。本文提供 Mac、Windows 和 Linux 的確切指令。

常見的陷阱之一是名稱：人們常把它拼錯成 clode code、clade code、слод код 或 clode design。產品名稱是 Claude Code，其中有 au。搜尋官方網站時請記住這點：拼法相近的網域屬於其他人。

也要記住 npm 套件的確切名稱。正式套件是 @anthropic-ai/claude-code，前面有 @anthropic-ai/ 前綴。Anthropic 自己使用沒有前綴的短名稱 claude-code，作為指向同一套件的官方連結。簡單來說：發布者應該是 Anthropic，而安裝時使用的名稱則帶有前綴。

安裝需求：電腦規格#

Claude Code 的需求不高：繁重工作由 Anthropic 的伺服器處理，你的電腦只負責傳送要求並接收回應。

特別說明 Node.js，因為這方面有許多誤解。Anthropic 自己推薦的原生安裝程式完全不需要 Node.js：它會以單一獨立檔案的形式安裝。只有透過 npm 安裝 Claude Code 時才需要 Node.js，而且需要 22 以上版本。較舊的文章會寫「Node 18 以上」，那已經過時；請以 22+ 為準。

使用主要版本需要終端機。如果你不想使用終端機，可以安裝有一般視窗介面的桌面應用程式，或使用 claude.ai/code 網頁版。終端機版本的功能仍較強大，因此本文接下來會說明如何安裝該版本。

安裝 Claude Code 就像拿到一項工具，但單靠它往往會產生幻覺：忘記你的專案、編造內容，並在任務做到一半時失去脈絡。三項要素結合起來，才能讓它可靠：AI 分身、第二大腦和脈絡工程。這三大支柱能避免 AI 產生幻覺。

如何在 macOS 上安裝 Claude Code？#

開啟「終端機」（每台 Mac 都有：按 Cmd+Space 開啟 Spotlight，輸入「終端機」），然後貼上這一行：

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

這個指令會從 Anthropic 的官方網址下載安裝程式並安裝 Claude Code。不需要 Node.js。原生安裝方式也很方便，因為它會自動更新。

如果你已經在使用 Homebrew，也可以選擇另一種方式：

brew install --cask claude-code

兩者的差異在於更新方式：原生安裝程式會自動更新，Homebrew 則不會，你必須手動執行 brew upgrade claude-code 指令更新。程式本身相同，因此選擇你習慣的方式即可。如果不確定，就用第一種方式。

如何在 Windows 上安裝 Claude Code？#

首先，確認你目前使用哪一種環境。Windows 有兩種 Shell，各自使用不同指令。開啟視窗並查看提示字元開頭：PS C:\> 代表 PowerShell，只有 C:\> 而沒有 PS 則代表命令提示字元（CMD）。

PowerShell（最簡單的開啟方式是按右鍵點選「開始」按鈕，然後選擇「終端機」）：

irm https://claude.ai/install.ps1 | iex

命令提示字元（CMD）：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

第三種選項是使用內建的 WinGet 套件管理員：

winget install Anthropic.ClaudeCode

如果你已經在 WSL（Windows 內的 Linux）中設定好環境，請直接在 WSL 內使用與 Linux 相同的指令安裝 Claude Code。WSL 有一個與 Node 有關的注意事項，稍後會在常見錯誤一節說明。

如何在 Linux 上安裝 Claude Code？#

適用於各種常見發行版的基本方法都相同，使用獨立安裝程式即可：

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

不需要 Node.js；程式會以單一檔案的形式提供，之後也會自行更新。

如果你習慣只透過系統套件管理員安裝程式，可以加入 Anthropic 的官方儲存庫：Debian 和 Ubuntu 使用 apt、Fedora 和 RHEL 使用 dnf、Alpine 使用 apk。這些儲存庫都有金鑰簽署，並提供 stable 和 latest 通道。對初學者來說，這樣做有些複雜，因此細節請參考來源一節的文件；一般情況下，我建議使用上面的指令。

平價伺服器可能會遇到一個問題。如果電腦的可用記憶體很少，安裝可能會顯示 Killed（代碼 137）並停止，表示系統因記憶體不足而終止程序。解決方法是新增 swap 檔案：Claude Code 安裝時需要約 512 MB 的可用記憶體。

如何首次啟動 Claude Code？#

首次啟動需要幾分鐘，流程如下。

1. 前往專案資料夾

   在終端機中使用 cd path-to-project 指令前往要處理的資料夾，然後輸入 claude。

2. 登入帳戶

   瀏覽器會開啟登入視窗。如果沒有自動開啟，按 c 複製連結，並手動貼到瀏覽器中。如果瀏覽器顯示一組代碼（在 WSL 和遠端伺服器上可能會發生），請將代碼貼回終端機。

3. 等待確認

   登入後，終端機會顯示 Login successful，並要求你按 Enter。

4. 提出第一個問題

   詢問一些關於專案的簡單問題，例如「這個專案是做什麼的？」Claude 會讀取檔案並回答。

5. 核准第一次變更

   當你要求它修改內容時，Claude 會顯示建議的變更並請你確認。你可以按 Shift+Tab 切換存取模式。

建議一開始就學會工作階段內幾個基本指令：/help會列出指令、/clear會清除對話記錄、/exit會結束工作階段（連按兩次 Ctrl+D 也可以）。輸入 /help，Claude 也會自行顯示這些資訊。

使用訂閱方案或 API 金鑰登入：該選哪一種？#

登入時首先會遇到這個問題。

登入方式有兩種，付款方式也不同。

若要使用訂閱方案登入，只要使用你的 Claude.ai 帳戶即可。若要使用 API 金鑰登入，請從 Claude Console（platform.claude.com）取得金鑰；使用期間會從預付餘額扣款。將金鑰設為 ANTHROPIC_API_KEY 環境變數後，Claude Code 就不會每次都開啟瀏覽器。

你可以在工作階段中使用 /login 切換帳戶，並使用 /logout 登出。

但沒有付費存取權限就無法啟動 Claude Code。如果你還沒有帳戶，請先確認註冊時要使用哪個電子郵件地址：之後無法更改。

如何確認安裝正確？#

一開始有三個指令值得記住。

第一個用來檢查版本：

claude --version

安裝正常時，會以 X.Y.Z (Claude Code) 的格式回覆。確切數字會隨版本而變；重要的是指令有傳回版本號。如果顯示「command not found」，那是另一個問題，下一節會說明。

第二個是診斷指令，在發生問題時使用。

第三個是在工作階段內使用的 /status：它會顯示登入方式、連結的電子郵件或組織，以及存取權限是否已過期。claude update則會立即安裝最新更新，不必等待背景更新。

為什麼安裝後找不到 claude 指令？#

這是初學者最常提出的問題，聽起來比實際情況更嚇人。終端機不會搜尋整台電腦來找指令；它只會檢查 PATH 中的資料夾。Claude Code 會將自己放在 ~/.local/bin/claude（Mac 和 Linux）或 %USERPROFILE%\\.local\\bin\\claude.exe（Windows），如果該資料夾不在 PATH 中，終端機就看不到這個程式。

在 Mac 和 Linux 上，把該資料夾加入清單即可。開啟 Shell 的設定檔（Zsh 使用 ~/.zshrc，Bash 使用 ~/.bashrc），並在檔案結尾加上這一行：

export PATH="$HOME/.local/bin:$PATH"

然後關閉並重新開啟終端機（或執行 source ~/.zshrc）。之後就能找到 claude。

常見的安裝與首次啟動錯誤#

以下依序說明，這些內容都來自 Anthropic 的官方疑難排解指南。

1. 透過 npm 安裝時使用了舊版 Node。 @anthropic-ai/claude-code 套件需要 Node.js 22 以上版本。在 Windows 上，npm 可能會因為指令碼遭停用的訊息而失敗，這是 PowerShell 的原則阻止指令碼執行。在 WSL 中，常見錯誤是 exec: node: not found：WSL 使用的是 Windows 版 Node，而不是 Linux 版。如果 npm 發生問題，請改用原生安裝程式，不需要 Node。
2. Shell 與安裝程式不相符。 'irm' is not recognized表示你把 PowerShell 指令貼到命令提示字元。The token '&&' is not a valid statement separator表示相反情況：你在 PowerShell 中執行了 CMD 指令。A parameter cannot be found that matches parameter name 'fsSL'表示你在 PowerShell 中執行了 Mac/Linux 指令。查看提示字元開頭：PS C:\是 PowerShell，C:\是 CMD。
3. 舊 API 金鑰覆蓋了訂閱方案。 如果訂閱仍有效，但環境中還設定著舊金鑰，你會看到 API Error: 400 ... This organization has been disabled。金鑰的優先順序高於訂閱登入。使用 unset ANTHROPIC_API_KEY 移除金鑰（PowerShell 請使用 Remove-Item Env:ANTHROPIC_API_KEY），檢查 ~/.zshrc 和 ~/.bashrc，然後輸入 /status。
4. 效能較弱的伺服器記憶體不足。 安裝會以 Killed 和代碼 137 停止，表示 RAM 不足。你需要約 512 MB 的可用記憶體；新增 swap 就能解決。
5. 安裝程式傳回了其他內容。 錯誤 syntax error near unexpected token '<'，或出現 <!DOCTYPE html>，表示安裝網址傳回的是網頁，而不是安裝指令碼，通常是因為所在區域、企業防火牆或暫時性服務中斷。可以改用其他方式（Homebrew、WinGet），或等幾分鐘再試一次。

遇到以上任何錯誤，第一步都相同：執行 claude doctor。它會指出哪裡出問題，並建議檢查方向。

這裡還有一個診斷時的注意事項：安裝期間出現單獨的 403，也可能是企業防火牆或 Proxy 所致。因此，如果你使用的是辦公室網路，請先確認網路是否封鎖了存取。

安裝後該做什麼：第一步#

安裝只是開始。真正的工作接著展開，而第一個會碰到的問題就是記憶。語言模型不會在不同對話之間記得你：開始新的聊天時，它只知道你放進脈絡中的內容。

因此，安裝後真正的第一步，是在專案根目錄建立 CLAUDE.md 檔案。這是一個記載專案規則和脈絡的文字檔，Claude Code 每次啟動時都會讀取。一次說明你在做什麼、專案如何組織，以及哪些事項很重要，以後就不必在每次對話中重複說明。

我會在另一篇指南中說明如何建立這個檔案並自訂 Claude：如何自訂 Claude。我也整理了一份2026 年氛圍編碼工具總覽。

大家還會問什麼？#

完整的氛圍編碼框架：AI 分身 + 第二大腦 + 脈絡工程。