# Claude Code 環境安裝手冊
> 本手冊協助學員在上課前完成 Claude Code 開發環境建置。
> 預計作業時間：15–20 分鐘
---
## Step 1：接受組織邀請
1. 開啟來自 Anthropic 的 **組織邀請信**
2. 點擊 **「Accept Invite」**
3. 若尚未有帳號，系統會引導你註冊（用收到邀請的那個 Email）
4. 註冊/登入完成後，即自動加入組織
> 📸 _【截圖：邀請信 → Accept Invite 頁面】_
---
## Step 2：安裝 Claude Code CLI
### macOS
開啟「終端機」（Terminal），貼上以下指令：
```bash
curl -fsSL https://claude.ai/install.sh | bash
```
### Windows
開啟 **PowerShell**，貼上以下指令：
```powershell
irm https://claude.ai/install.ps1 | iex
```
或者開啟 **CMD（命令提示字元）**：
```cmd
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```
> ⚠️ 貼上指令後畫面可能會停頓幾分鐘，看起來像當掉了，這是正常的！請耐心等待，不要關掉終端機，過一會兒就會開始下載安裝。
---
## Step 3：驗證安裝
請重開終端機後，並在終端機輸入：
```bash
claude --version
```
看到版本號就代表安裝成功。
> ⚠️ **Windows 常見問題**：安裝完成後如果輸入 `claude` 顯示「不是內部或外部命令」，代表路徑沒有被自動加入環境變數。請依以下步驟處理：
> 1. 按下鍵盤上的 **Windows 鍵**，搜尋並開啟「**編輯系統環境變數**」
> 2. 在彈出的視窗中，點擊下方的「**環境變數**」按鈕
> 3. 在「**使用者變數**」區塊中，找到名為 **Path** 的項目，點選它後按「**編輯**」
> 4. 點擊右側的「**新增**」，然後貼上路徑：`C:\Users\你的使用者名稱\.local\bin`（請替換成你的實際使用者名稱）
> 5. 連續按下「**確定**」關閉所有視窗
> 6. **關閉終端機，重新開啟**後再試一次
---
## Step 4：首次啟動與登入
在終端機輸入：
```bash
claude
```
首次啟動會依序出現以下步驟：
### 4-1. 選擇主題
選擇終端機的顯示主題，建議選 **1. Dark mode**（依你的終端機背景色決定）。
### 4-2. 選擇登入方式
終端機會詢問你要用哪種方式登入，選擇 **Anthropic Console（API）**。
### 4-2. 瀏覽器登入
瀏覽器會自動開啟登入頁面，用你接受邀請時的帳號登入。
> ⚠️ 如果瀏覽器沒有自動開啟，終端機會提示你按 `c` 複製登入連結，手動貼到瀏覽器即可。
### 4-3. 選擇組織
登入後選擇組織 **rocket**。
### 4-4. 登入成功
瀏覽器授權完成後，回到終端機會顯示「Login successful. Press Enter to continue…」，按 **Enter** 繼續。
### 4-5. 安全提示（Security notes）
會出現安全注意事項，閱讀後按 **Enter** 繼續。
### 4-7. 終端機設定（Terminal setup）
詢問是否啟用建議的終端機設定，選 **1. Yes, use recommended settings**。
### 4-8. 信任資料夾（Trust folder）
進入工作目錄時會詢問是否信任此資料夾，這裡先選 **2. No, exit**。
> ⚠️ 預設會抓你目前所在的整個目錄（例如你的家目錄），Claude Code 會有權限讀寫裡面所有檔案，太危險！請先退出，等 Step 5 建好獨立的測試資料夾後再進入。
---
## Step 5：安裝驗證 — 實際操作
確認 Claude Code 能正常運作：
### 5-1. 建立測試資料夾
```bash
mkdir claude-test
cd claude-test
```
### 5-2. 啟動 Claude Code
```bash
claude
```
### 5-3. 信任資料夾
會出現 Accessing workspace 提示，顯示目前的資料夾路徑（例如 `C:\Users\ASUS\claude-test`）。
這次選 **1. Yes, I trust this folder**，因為這是你剛剛自己建立的測試資料夾。
> 📸 _【截圖：trust folder — claude-test】_
### 5-4. 請 Claude 寫一個 BMI 計算函式
在 Claude Code 對話框輸入：
```
請在 all.js 建立一個 BMI 計算函式，輸入身高（公分）和體重（公斤），回傳 BMI 值
```
### 5-5. 權限確認
Claude 要建立 `all.js` 時會跳出權限確認，詢問是否允許寫入檔案。按 **y** 確認即可。
> 📸 _【截圖：Write 權限確認畫面】_
### 5-6. 確認結果
Claude 會自動建立 `all.js` 並寫入程式碼。打開 `claude-test` 資料夾，看到 `all.js` 檔案裡有 BMI 函式就代表一切正常！🎉
---
## 常見問題
### Q：安裝後輸入 `claude` 沒反應？
試試重新開啟終端機，或執行：
```bash
which claude
```
確認路徑有正確設定。
### Q：瀏覽器登入後，終端機沒有反應？
稍等幾秒，認證資訊需要回傳。如果超過 30 秒沒反應，按 `Ctrl + C` 取消後重新執行 `claude`。
### Q：登入時看不到組織選項？
確認你是用收到邀請信的同一個 Email 登入。如果還是看不到，請聯繫講師確認邀請狀態。
---
## 課前檢查清單
- [x] 已收到 Anthropic 邀請信並完成註冊
- [x] 已安裝 Claude Code CLI（`claude --version` 有輸出版本號）
- [x] 已完成登入認證（選擇了正確的組織）
- [x] 已完成安裝驗證（成功產出 `all.js`）
> 以上全部完成後，就準備好上課了！有任何問題請提前聯繫講師。
Sign in via Google
Sign in via Facebook
Sign in via X(Twitter)
Sign in via GitHub
Sign in via Dropbox
Sign in with Wallet
Connect another wallet