# 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），貼上以下指令：

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

### Windows

開啟 **PowerShell**，貼上以下指令：

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

或者開啟 **CMD（命令提示字元）**：

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

> ⚠️ 貼上指令後畫面可能會停頓幾分鐘，看起來像當掉了，這是正常的！請耐心等待，不要關掉終端機，過一會兒就會開始下載安裝。

---

## Step 3：驗證安裝

請重開終端機後，並在終端機輸入：

claude --version

看到版本號就代表安裝成功。
> ⚠️ **Windows 常見問題**：安裝完成後如果輸入 `claude` 顯示「不是內部或外部命令」，代表路徑沒有被自動加入環境變數。請依以下步驟處理：
> 1. 按下鍵盤上的 **Windows 鍵**，搜尋並開啟「**編輯系統環境變數**」
> 2. 在彈出的視窗中，點擊下方的「**環境變數**」按鈕
> 3. 在「**使用者變數**」區塊中，找到名為 **Path** 的項目，點選它後按「**編輯**」
> 4. 點擊右側的「**新增**」，然後貼上路徑：`C:\Users\你的使用者名稱\.local\bin`（請替換成你的實際使用者名稱）
> 5. 連續按下「**確定**」關閉所有視窗
> 6. **關閉終端機，重新開啟**後再試一次
---

## Step 4：首次啟動與登入

在終端機輸入：

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. 建立測試資料夾

mkdir claude-test
cd claude-test

### 5-2. 啟動 Claude Code

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` 沒反應？

試試重新開啟終端機，或執行：

which claude

確認路徑有正確設定。

### Q：瀏覽器登入後，終端機沒有反應？

稍等幾秒，認證資訊需要回傳。如果超過 30 秒沒反應，按 `Ctrl + C` 取消後重新執行 `claude`。

### Q：登入時看不到組織選項？

確認你是用收到邀請信的同一個 Email 登入。如果還是看不到，請聯繫講師確認邀請狀態。

---

## 課前檢查清單

- [x] 已收到 Anthropic 邀請信並完成註冊
- [x] 已安裝 Claude Code CLI（`claude --version` 有輸出版本號）
- [x] 已完成登入認證（選擇了正確的組織）
- [x] 已完成安裝驗證（成功產出 `all.js`）

> 以上全部完成後，就準備好上課了！有任何問題請提前聯繫講師。