⚙️

安裝與環境設定

Part 1：安裝 Claude CLI 工具

Node.js npm 安裝驗證設定第一次執行

📋 前置需求

✅ 必要條件

Node.js 18 或更新版本
npm（隨 Node.js 安裝）
API 金鑰（Part 0）
終端機存取權限

💻 支援系統

Windows 10/11
macOS 12+
Linux（Ubuntu、Debian 等）

📥 Step 1：安裝 Node.js

前往 Node.js 官網下載

📍 下載網址https://nodejs.org/

選擇 LTS 版本（長期支援版）下載

驗證安裝

🖥️ 在終端機輸入node --version npm --version

✅ 成功：會顯示版本號，如 v18.19.0 和 10.2.3

📦 Step 2：安裝 Claude CLI

使用 npm 全域安裝

🖥️ 執行指令npm install -g @anthropic-ai/claude-code

💡 說明：

-g 表示全域安裝，可以在任何目錄使用
安裝過程可能需要幾分鐘
如果遇到權限問題，macOS/Linux 可以加 sudo

驗證安裝成功

🖥️ 檢查版本claude --version

🔑 Step 3：設定 API 金鑰

確認你在 Part 0 設定的環境變數還在

🪟 Windows PowerShellecho $env:ANTHROPIC_API_KEY

🍎 macOS / Linuxecho $ANTHROPIC_API_KEY

⚠️ 如果沒有顯示金鑰：請回到 Part 0 重新設定環境變數

💡 或者使用 claude 登入：

登入指令claude login

🚀 Step 4：第一次執行

啟動 Claude CLI

🖥️ 執行claude

或直接執行一個指令：

🖥️ 快速測試claude "你好，請用一句話介紹自己"

🤖 Claude 回覆我是 Claude，由 Anthropic 開發的 AI 助手，專門協助回答問題、撰寫內容和解決各種任務。

🎉 恭喜！你已經成功設定好 Claude CLI 了！

📁 了解工作目錄

Claude CLI 會以你當前所在的目錄為工作目錄

🖥️ 檢查當前目錄# Windows cd # macOS / Linux pwd

💡 重要概念：

Claude 可以存取當前目錄下的檔案
建議在專案資料夾中執行 Claude
避免在系統根目錄執行

⚡ 常用啟動方式

🔄 互動模式

進入對話模式claude

進入持續對話模式，可以多次互動

⚡ 單次執行

執行單一指令claude "你的問題"

執行完畢後直接退出

💡 提示：互動模式適合持續工作，單次執行適合快速查詢

❓ 安裝常見問題

Q：npm install 時權限不足？

A (macOS/Linux)：sudo npm install -g @anthropic-ai/claude-code

Q：找不到 claude 指令？

A：重新開啟終端機，或確認 npm 全域目錄在 PATH 中

Q：API 金鑰無效？

A：確認金鑰正確複製，沒有多餘空格或換行

🎓

Part 1 總結

✅ 你完成了

安裝 Node.js
使用 npm 安裝 Claude CLI
設定 API 金鑰
第一次執行 Claude

📝 回家作業

用 claude 問 3 個問題
試試互動模式和單次執行
在不同資料夾執行看看

下一單元：Part 2 - 基本指令操作