Claude Code 安裝教學：從 Node.js 到第一個任務，完整安裝指南【2026】

Claude Code 安裝教學：從 Node.js 到第一個任務，完整安裝指南【2026】

Admin·
Claude Code 教學 · · 8 分鐘閱讀

Claude Code 讓你在終端機直接與 Claude 對話，自動執行程式碼、修改檔案、執行指令。本 Claude Code 安裝教學涵蓋 macOS、Windows、Linux 的完整安裝步驟，包括 API 金鑰配置與 CLAUDE.md 設定。即使你沒有編程基礎，也能在 10 分鐘內完成所有設定，馬上開始你的第一個任務。

01安裝前置需求：Node.js 與 Claude 訂閱方案確認

⚠️
安裝前確認：需要 Node.js 18+ 和 Claude Pro 訂閱（或 API Key）

在開始 Claude Code 安裝教學前，你需要準備幾項基本軟體與帳號。這些都是必須的，請逐一確認。

1. Node.js 環境

Claude Code 需要 Node.js 18 以上版本執行。首先檢查你的電腦是否已安裝 Node.js：

node -v

如果看到 v18.0.0 或更高版本，你已經準備好了。如果沒有顯示版本號或版本過舊，前往 nodejs.org 下載 LTS 版本安裝。

同時確認 npm 版本：

npm -v

npm 應該是 9 以上。如果版本太舊，執行 npm install -g npm 升級。

為什麼需要 Node.js？ Claude Code 是一個命令列工具，底層使用 Node.js 運行。它不是網頁應用，而是直接在你的終端機裡執行的程式。

2. Claude 訂閱方案或 API 金鑰

使用 Claude Code 有兩種方式：

  • Claude Pro / Max 訂閱（推薦新手）：月費 $20 美金起，無需設定 API 金鑰，直接登入 claude.ai 帳號使用。
  • Anthropic API 金鑰（開發者）：按使用次數計費，需要在 console.anthropic.com 申請，安全性高但需多步驟設定。

選擇其中一種方式即可。如果你不確定，建議先用 Claude Pro 訂閱試試，因為安裝步驟更簡單。

檢查清單
  • ✓ Node.js 18 以上（執行 node -v 確認）
  • ✓ npm 9 以上（執行 npm -v 確認）
  • ✓ Claude Pro/Max 訂閱 或 Anthropic API 金鑰
  • ✓ 終端機軟體（macOS: Terminal、Windows: PowerShell 或 Windows Terminal）

02安裝 Claude Code：npm 安裝步驟（macOS / Windows / Linux）

⚡
一行指令安裝：npm install -g @anthropic-ai/claude-code

現在開始安裝 Claude Code 本體。所有平台的安裝指令都相同，差異在於特殊情況的處理。

通用安裝步驟（所有平台）

1. 打開終端機

macOS：按 Command + Space，輸入「Terminal」開啟。Windows：搜尋「PowerShell」或「Windows Terminal」並以系統管理員身份執行。

2. 執行安裝指令

複製並貼上以下指令：

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

這個指令會從 npm 官方倉庫下載 Claude Code 並安裝到全域目錄，讓你在任何資料夾裡都能使用 claude 指令。

3. 等待安裝完成

安裝通常需要 30-60 秒。你會看到許多文字滾過螢幕，這很正常。不要中斷該過程。

4. 確認安裝成功

執行以下指令檢查版本：

claude --version

如果看到版本號（例如 1.2.3），代表 Claude Code 安裝教學的第一階段已完成。

macOS 額外注意事項

某些 macOS 電腦可能出現權限錯誤（EACCES: permission denied）。如果發生這種情況，有兩個解決方案：

方案 A：使用 sudo（快速但需輸入密碼）

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

方案 B：使用 nvm 管理 Node（推薦長期方案）

安裝 nvm（Node Version Manager），它會自動處理權限問題：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

重啟終端機後，再執行無 sudo 的安裝指令。

Windows 額外注意事項

Windows 使用者需注意以下兩點：

1. 以系統管理員身份執行 PowerShell

在 Windows 搜尋欄輸入「PowerShell」，右鍵選擇「以系統管理員身份執行」。否則 npm 全域安裝會失敗。

2. 執行原則錯誤

如果看到「執行原則不允許執行指令碼」的錯誤，執行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

輸入 Y 確認後，再重新執行安裝指令。

Linux 安裝（Ubuntu / Debian / Fedora）

Linux 使用者的安裝最簡單。如果出現權限錯誤，可能需要調整 npm 全域目錄：

mkdir ~/.npm-global npm config set prefix '~/.npm-global' export PATH=~/.npm-global/bin:$PATH

然後執行標準安裝指令。若要永久生效，將最後一行加入 ~/.bashrc 或 ~/.zshrc。

03帳號驗證：API 金鑰設定或 claude.ai 登入

本節重點：兩種驗證方式——claude.ai 登入或 API 金鑰，各有優缺

安裝完成後，你需要告訴 Claude Code 你的身份。有兩種驗證方式，選擇其中一種即可。

方式 A：使用 Claude Pro / Max 訂閱（推薦新手）

如果你已訂閱 Claude Pro 或 Claude Max，登入最簡單：

1. 執行登入指令

claude

或使用 claude auth 明確要求登入。

2. 瀏覽器自動開啟

預設瀏覽器會開啟 claude.ai 登入頁面。使用你的 Claude 帳號和密碼登入。

3. 授權 Claude Code

頁面會詢問是否允許 Claude Code 存取你的帳號。點擊「允許」或「Authorize」。

4. 驗證成功

回到終端機，你會看到「Logged in as your-email@example.com」的訊息。現在你已準備好使用 Claude Code。

方式 B：使用 Anthropic API 金鑰（開發者）

如果你沒有 Claude Pro 訂閱，可以申請 Anthropic API 金鑰。這種方式按使用次數計費，通常較便宜，但需要多個設定步驟。

1. 申請 API 金鑰

前往 console.anthropic.com，使用 Google 或 Anthropic 帳號登入。點擊「API Keys」或「Keys」，然後「Create Key」申請新金鑰。

2. 複製金鑰

金鑰通常以 sk-ant- 開頭。複製整個金鑰，妥善保管。如果遺失或外洩，請立即刪除該金鑰並申請新的。

3. 設定環境變數（macOS / Linux）

打開終端機，執行：

export ANTHROPIC_API_KEY=sk-ant-your-actual-key-here

將 sk-ant-your-actual-key-here 替換為你複製的真實金鑰。

4. 永久設定環境變數（macOS / Linux）

上述方法只在該終端機工作階段有效。若要永久生效，編輯 shell 設定檔：

nano ~/.zshrc

（或 ~/.bashrc，取決於你用的 shell）。在檔案末尾加入上述 export 指令，按 Ctrl+X、Y、Enter 存檔。重啟終端機即生效。

5. 設定環境變數（Windows PowerShell）

在 PowerShell 執行：

$env:ANTHROPIC_API_KEY = "sk-ant-your-actual-key-here"

同樣將金鑰替換為真實值。若要永久設定，使用進階系統設定 → 環境變數，新增 ANTHROPIC_API_KEY。

6. 驗證連線

執行 claude 測試連線。如果看到「Authenticated」或類似訊息，代表設定成功。

安全提示：永遠不要將 API 金鑰分享給他人或上傳到 GitHub。金鑰就像密碼，外洩會讓他人冒充你的身份使用 API。

04建立 CLAUDE.md：讓 Claude Code 理解你的專案

💡
效率關鍵：一份好的 CLAUDE.md 能讓 Claude Code 的準確度提升 50%+

Claude Code 雖然強大，但它初次面對你的專案時一無所知。CLAUDE.md 是一個特殊檔案，讓你告訴 Claude 關於你專案的重要資訊。每次執行任務時，Claude Code 會自動讀取這個檔案，以更好地理解你的需求。

什麼是 CLAUDE.md？

CLAUDE.md 是一個純文字 Markdown 檔案，放在你專案的根目錄。它包含專案說明、檔案結構、常用指令、命名規範等。想象它是給 Claude 的「專案說明書」，讓 Claude 更快上手。

建立 CLAUDE.md 的步驟

1. 進入你的專案資料夾

cd /path/to/your/project

2. 建立 CLAUDE.md 檔案

touch CLAUDE.md

（Windows 使用 New-Item -Name CLAUDE.md -ItemType File）

3. 用文字編輯器開啟並編輯

使用任何文字編輯器（VS Code、Sublime Text、記事本等）打開 CLAUDE.md，複製以下範本並修改內容。

CLAUDE.md 範本

以下是一個適用於大多數專案的範本。根據你的實際情況調整：

# 專案名稱：我的待辦清單應用 ## 專案說明 這是一個 React + Node.js 的待辦清單 Web 應用。 - 前端：React 18 + Vite - 後端：Express.js + MongoDB - 用途：幫助使用者管理日常任務 ## 目錄結構 ``` project-root/ ├── src/ │ ├── components/ # React 元件 │ ├── pages/ # 頁面元件 │ ├── utils/ # 工具函式 │ └── styles/ # CSS 樣式表 ├── server/ # 後端程式碼 │ ├── routes/ # API 路由 │ ├── models/ # 資料庫模型 │ └── controllers/ # 業務邏輯 ├── public/ # 靜態資源 ├── package.json # 專案配置 └── README.md # 專案文檔 ``` ## 常用指令 - `npm install` - 安裝依賴 - `npm run dev` - 啟動開發伺服器（前端 http://localhost:5173） - `npm run server` - 啟動後端伺服器（http://localhost:5000） - `npm test` - 執行測試 - `npm run build` - 打包生產版本 ## 編碼規範 - 使用 ES6+ 語法 - 變數名用駝峰式（camelCase） - 元件名用帕斯卡式（PascalCase） - 每行代碼不超過 80 字元 - 使用 2 空格縮排 ## 不可修改的檔案 - `.env` - 環境變數，機密資訊 - `package-lock.json` - 依賴鎖定版本 - 資料庫備份檔案 ## 已知問題與注意事項 - Windows 使用者需確認已安裝 Git Bash - 若資料庫連線失敗，檢查 MongoDB 服務是否啟動 - 某些舊瀏覽器可能不支援某些 CSS 功能

推薦的 CLAUDE.md 包含內容

  • 專案說明：這個專案做什麼？用什麼技術棧？
  • 目錄結構：各資料夾的用途
  • 常用指令：如何啟動、測試、部署
  • 命名規範：變數、函式、檔案如何命名
  • 編碼風格：縮排、分號、引號等約定
  • 不可修改的檔案：哪些檔案 Claude 不應該改動
  • 已知問題：常見錯誤與解決方法
提示：CLAUDE.md 越詳細，Claude Code 表現越好。花 10 分鐘寫好它，後續能省下數小時的溝通時間。

05第一個任務：實際操作示範

本節重點：從讀取檔案到生成程式碼，實際操作示範

現在你已完成 Claude Code 安裝教學的所有準備工作。讓我們嘗試第一個真實任務，感受 Claude Code 的威力。

任務範例 1：分析專案結構

假設你有個專案，想快速了解各個檔案的用途。執行：

claude "分析這個專案的目錄結構，告訴我各檔案夾和重要檔案的用途"

Claude Code 會：

  1. 讀取你的 CLAUDE.md
  2. 掃描專案檔案結構
  3. 生成詳細的分析報告
  4. 如果需要修改，詢問你的許可

任務範例 2：建立新檔案

假設你想在 src/utils/ 下建立一個日期格式化工具：

claude "在 src/utils/ 建立 formatDate.js，支援以下功能： - 將日期物件轉換為 YYYY-MM-DD 格式 - 支援自訂日期格式（可選） - 包含錯誤處理 - 附上使用範例"

Claude Code 會：

  1. 根據 CLAUDE.md 理解你的專案編碼規範
  2. 生成符合規範的程式碼
  3. 建立 formatDate.js 檔案
  4. 顯示建立的內容，等待你確認

如何確認或拒絕操作

當 Claude Code 準備進行修改時，會顯示預覽。你可以：

  • 按 Enter 或輸入 y 確認修改
  • 按 N 拒絕修改
  • 按 Ctrl+C 中止整個任務

你絕對掌握主控權，Claude Code 不會未經許可進行任何修改。

任務範例 3：執行指令

你也可以要求 Claude 執行指令。例如：

claude "執行 npm test 並解釋結果"

Claude Code 會執行測試，分析結果，並用簡單的語言解釋發生了什麼。

第一個任務建議：從簡單的閱讀類任務開始（例如分析檔案）。熟悉後再嘗試修改檔案的任務。這樣能更好地理解 Claude Code 的工作流程。

06安裝常見問題排除

🐛
遇到安裝問題？這裡整理了最常見的 6 個錯誤與解法

即使依照本 Claude Code 安裝教學的步驟，某些情況下仍可能遇到問題。以下是最常見的錯誤與解決方法。

錯誤訊息 原因 解決方法
command not found: claude 全域安裝路徑未加入 PATH 環境變數 執行 npm config get prefix 確認 npm 全域路徑，將其加入 PATH。或重新安裝：npm install -g @anthropic-ai/claude-code
Error: EACCES permission denied 無寫入 npm 全域目錄的權限 使用 sudo：sudo npm install -g @anthropic-ai/claude-code，或使用 nvm 管理 Node 版本
AuthenticationError API 金鑰無效、未設定或已過期 重新檢查環境變數 echo $ANTHROPIC_API_KEY，或重新登入 claude auth
RateLimitError API 使用次數超過速率限制 等待幾分鐘後重試。如頻繁出現，升級 Claude Pro 訂閱或檢查 API 額度
ModuleNotFoundError 某些依賴未正確安裝 執行 npm install -g @anthropic-ai/claude-code --force 強制重新安裝
終端機完全卡住 Claude Code 進程當機或卡在無限迴圈 按 Ctrl+C 強制中止。若無效，關閉終端機重新開啟。最後手段：執行 killall -9 claude

進階故障排除

檢查 Claude Code 安裝版本

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

完全重新安裝

npm uninstall -g @anthropic-ai/claude-code npm cache clean --force npm install -g @anthropic-ai/claude-code

檢查網路連線

Claude Code 需要網路來與 Anthropic 伺服器通訊。確認你的網路連線正常，防火牆沒有阻擋 HTTPS 連線。

查看詳細日誌

claude --debug "你的任務"

加上 --debug 旗標會顯示詳細的調試資訊，有助於診斷問題。

?常見問題 FAQ

本節重點：Claude Code 新手最常問的 8 個問題，一次解答
Claude Code 一定要有 Pro 方案才能用嗎？

不一定。你可以選擇 Claude Pro ($20/月) 或使用 Anthropic API 金鑰（按使用次數計費，通常更便宜）。API 金鑰方式稍微複雜一些，但機制更彈性。新手推薦先用 Pro 試試，熟悉後可改用 API。

Claude Code 支援哪些作業系統？

支援 macOS、Windows 和 Linux。只要安裝了 Node.js 18+，就能執行 Claude Code 安裝教學的步驟。各系統的安裝過程略有不同（權限、終端機名稱等），但核心指令完全相同。

安裝後能在 VS Code 或其他 IDE 裡使用 Claude Code 嗎？

Claude Code 原生設計為命令列工具。不過有第三方擴充功能可將 Claude Code 整合到 VS Code（例如 GitHub Copilot 的替代品）。但官方推薦直接在終端機中使用，因為這樣能完全掌握進度和確認每個操作。

CLAUDE.md 不建立可以嗎？

可以，但強烈不建議。沒有 CLAUDE.md，Claude 會對你的專案一無所知，導致建議不夠精準、效率下降。花 10 分鐘建立一份好的 CLAUDE.md，能大幅提升後續任務的成功率和品質。

Claude Code 能修改我電腦上的任意檔案嗎？

理論上可以，但實務上 Claude Code 只能存取你開啟它的資料夾及其子資料夾。你也能隨時拒絕任何修改提議。安全上，Claude Code 不會未經你的明確同意進行任何寫入操作。

如果 Claude Code 執行了錯誤的指令怎麼辦？

按 Ctrl+C 立即中止。如果已執行完畢，你可以手動撤銷修改（例如 git checkout、rm 刪除等）。建議在重要專案上使用 Git，這樣能輕鬆回退任何不想要的改動。

Claude Code 安裝教學後，下一步該做什麼？

建議依序進行：1) 建立 CLAUDE.md，2) 嘗試簡單的讀取任務（例如分析檔案），3) 嘗試小規模修改（新增一個小功能），4) 逐步信任並委派更複雜的任務。每次交互都能幫你更好地理解 Claude Code 的工作方式。

Claude Code 如何保護我的程式碼和隱私？

你選擇的驗證方式決定了隱私等級。使用 claude.ai 登入時，程式碼內容會傳送到 Anthropic 伺服器進行處理。使用 API 金鑰時，程式碼同樣需要傳送以供 AI 分析。Anthropic 會根據其隱私政策處理你的資料。如對隱私有疑慮，建議在使用前閱讀官方隱私政策。

準備好了嗎？開始你的第一個 Claude Code 任務
本教學涵蓋了安裝到設定的全部步驟。現在就打開終端機，執行 npm install，體驗 AI 驅動開發的未來。

最後更新：2026-04-02 | 預計閱讀時間：8 分鐘

AI

相關文章

Claude Cowork Slack 教學：AI 幫你摘要頻道、撰寫訊息【2026 最新教學】

Claude Cowork Notion 教學：AI 讀寫你的筆記與資料庫【2026 最新教學】

Claude Cowork Gmail 教學：AI 幫你整理信箱、自動擬稿回覆【2026 最新教學】