# 影片筆記：How to Use Claude Code Terminal for Beginners

## 一句話總結

本影片教學如何在終端機（Terminal）中安裝、設定並使用 Claude Code，涵蓋從環境配置、模型選擇、操作模式切換，到透過自然語言指令建立與修改應用程式（如待辦事項清單）的完整流程，並介紹了對話管理與復原變更的技巧。

## 核心重點

1.  **安裝與驗證**：支援 Mac OS 與 Windows PowerShell，安裝完成後需透過 `cloud space dash dash version` 驗證。
2.  **登入授權**：需具備 Pro plan 訂閱，透過瀏覽器授權並複製代碼至終端機完成登入。
3.  **模型與效能設定**：
    *   模型選擇：建議一般任務使用 Sonnet，複雜任務使用 Opus 或 Fable，Haiku 速度較快但較過時。
    *   努力程度（Effort）：建議從 medium 開始，高努力程度品質較高但消耗額度快且速度慢。
4.  **操作模式**：
    *   透過 `Shift` + `Tab` 切換模式。
    *   建議從 **Plan Mode** 開始規劃，確認計劃後可切換至 **Auto Mode** 自動執行。
    *   其他模式包含 Accept Edits On、Manual Mode。
5.  **實作流程**：
    *   透過自然語言指令建立 To-do list app。
    *   可透過追加指令擴充功能（如增加截止日期、深色/淺色主題）。
    *   使用 `/clear` 清除上下文以開始新任務。
6.  **復原與幫助**：
    *   使用 `/rewind` 可回滾代碼與對話。
    *   使用 `/help` 查看所有可用命令。

## 詳細大綱

### 一、安裝與驗證
1.  **安裝步驟**：
    *   Mac OS 用戶：複製第一行命令列，開啟 Terminal 貼上並執行。
    *   Windows 用戶：複製 Windows PowerShell 命令列，開啟 PowerShell 貼上並按 Enter。
    *   安裝完成後會顯示 "installation complete"。
2.  **驗證安裝**：
    *   輸入 `cloud space dash dash version` 並按 Enter 檢查是否安裝成功。

### 二、初始化與登入
1.  **進入專案資料夾**：
    *   建立新的空資料夾。
    *   在 Terminal 使用 `CD` 命令切換至該資料夾（可透過拖曳資料夾或複製路徑貼上）。
2.  **啟動 Cloud Code**：
    *   輸入 `Cloud` 並按 Enter。
    *   首次執行會請求權限，按 Enter 繼續。
3.  **帳號登入流程**：
    *   輸入 `/login` 並按 Enter。
    *   選擇第一個選項連接具備訂閱的 Cloud 帳號（需至少為 Pro plan）。
    *   系統會開啟瀏覽器，若未開啟則需手動複製連結。
    *   在網頁點擊 "Authorize" 連接帳號。
    *   點擊 "Copy Code" 複製代碼。
    *   回到 Cloud Code 終端機貼上代碼並按 Enter，顯示 "login successful"。

### 三、模型與效能設定
1.  **選擇模型 (`/model`)**：
    *   可選模型：Sonnet, Fable, Opus, Haiku。
    *   **建議**：
        *   一般任務：從 **Sonnet** 開始。
        *   複雜任務：嘗試更強大的 **Opus** 或 **Fable**。
        *   **Haiku**：速度較快，但目前較過時。
2.  **選擇努力程度 (`/effort`)**：
    *   選項：low, medium, high, extra high, max。
    *   **高努力程度**：AI 思考時間較長，速度較慢，消耗使用額度較快，但品質較高。
    *   **低努力程度**：速度快、便宜，但品質可能較低。
    *   **建議**：從 **medium** 開始，若效果不佳再調高。

### 四、操作模式切換
透過 `Shift` + `Tab` 切換底部左側的模式：
1.  **Accept Edits On**：自動接受 Cloud Code 的編輯，但仍需對特定動作授權。
2.  **Plan Mode**：先規劃再執行。
3.  **Auto Mode On**：通過安全檢查後，自動批准大部分事項。
4.  **Manual Mode**：手動模式，每次編輯需逐一手動批准。
    *   **建議**：從 Plan Mode 開始規劃。

### 五、實作演示：建立應用程式
1.  **建立初始應用**：
    *   指令：建立一個可創建、編輯、刪除任務的 To-do list app。
    *   在 Plan Mode 下，AI 會提問（如應用類型、任務是否永久保存），回答後提交。
    *   AI 寫好計劃並準備執行，選擇 "yes, and use Auto Mode"。
    *   系統自動進入 Auto Mode，自動創建檔案、編輯代碼。
    *   完成時間約 2 分 34 秒，生成 `index.html` 等檔案。
2.  **測試與修改**：
    *   雙擊 `index.html` 運行應用。
    *   測試功能：添加任務、標記完成。
    *   **新增功能**：要求增加 "due date"（截止日期）功能。
    *   完成時間約 1 分 29 秒，刷新頁面後可見新選項。
3.  **對話管理**：
    *   若新任務與前文無關，建議使用 `/clear` 清除對話，開始新會話。
    *   **實例**：新增深色/淺色主題切換按鈕（與截止日期無關），故先使用 `/clear`。
    *   完成時間約 1 分 4 秒，頁面出現切換按鈕。

### 六、復原與幫助
1.  **復原變更 (`/rewind`)**：
    *   若不喜歡某項變更，輸入 `/rewind`。
    *   可選擇回退至對話中的特定訊息。
    *   選項包括：
        *   恢復代碼與對話（Restore code and conversation）。
        *   僅恢復對話（代碼不變）。
        *   僅恢復代碼（對話保留在請求按鈕時）。
    *   通常建議選擇「恢復代碼與對話」以完全回退。
2.  **查看命令 (`/help`)**：
    *   輸入 `/help` 並按 Enter 查看所有可用命令。
    *   可使用右箭頭鍵瀏覽命令列表，無需記住所有命令，隨用隨查。

## 工具 / 模型 / 名詞整理

*   **Cloud Code**：影片主要介紹的終端機工具。
*   **Terminal**：Mac OS 下的終端機環境。
*   **Windows PowerShell**：Windows 下的命令列環境。
*   **Mac OS**：作業系統。
*   **Cloud account**：雲端帳號。
*   **Pro plan**：雲端服務的訂閱方案等級。
*   **模型名稱**：
    *   Sonnet
    *   Fable
    *   Opus
    *   Haiku
*   **檔案名稱**：
    *   `index.html`
*   **操作模式**：
    *   Accept Edits On
    *   Plan Mode
    *   Auto Mode On
    *   Manual Mode
*   **指令前綴**：
    *   `/login`
    *   `/model`
    *   `/effort`
    *   `/clear`
    *   `/rewind`
    *   `/help`
*   **網頁按鈕文字**：
    *   Authorise
    *   Copy Code
*   **應用程式類型**：
    *   To-do list app

## 操作流程整理

1.  **安裝階段**：
    *   根據作業系統（Mac 或 Windows）複製對應的安裝命令。
    *   在終端機執行安裝命令。
    *   執行 `cloud space dash dash version` 驗證安裝。
2.  **設定階段**：
    *   建立專案資料夾並使用 `CD` 命令進入。
    *   輸入 `Cloud` 啟動程式。
    *   輸入 `/login` 進行登入：
        *   選擇具備 Pro plan 的帳號。
        *   在瀏覽器點擊 "Authorize"。
        *   複製代碼並貼回終端機。
    *   輸入 `/model` 選擇模型（建議 Sonnet 或 Opus）。
    *   輸入 `/effort` 設定努力程度（建議 medium）。
3.  **開發階段**：
    *   使用 `Shift` + `Tab` 切換至 **Plan Mode**。
    *   輸入自然語言指令描述需求（例如：建立 To-do list app）。
    *   回答 AI 的提問。
    *   確認計劃後，選擇 "yes, and use Auto Mode"。
    *   等待系統自動創建檔案與編輯代碼。
    *   測試生成的應用程式（如雙擊 `index.html`）。
    *   若需新增功能（如 due date），直接輸入指令，系統會自動修改。
    *   若需處理無關的新任務，先輸入 `/clear` 清除上下文。
4.  **維護階段**：
    *   若對變更不滿，輸入 `/rewind` 選擇回滾選項。
    *   若忘記指令，輸入 `/help` 查看列表。

## 值得注意的限制或風險

1.  **模型選擇影響**：
    *   Haiku 模型被描述為「速度較快，但目前較過時」。
    *   高努力程度會消耗較快的使用額度，且速度較慢。
2.  **訂閱門檻**：
    *   登入步驟中明確指出需具備至少為 **Pro plan** 的訂閱才能連接帳號。
3.  **操作模式風險**：
    *   **Auto Mode On** 雖自動批准大部分事項，但仍需通過安全檢查。
    *   **Manual Mode** 需逐一手動批准，效率較低但控制權較高。
4.  **版本檢查指令疑義**：
    *   影片提及的驗證指令為 `cloud space dash dash version`，與常見慣例 `cloud --version` 不同，需嚴格遵循影片指示。

## 逐字稿辨識疑點

*   **cloud space dash dash version**：逐字稿中描述為輸入此指令，通常版本檢查指令為 `cloud --version`，此處保留逐字稿描述。
*   **Cloud Code Terminal**：逐字稿提及安裝 "Cloud Code Terminal"，保留原稱。
*   **slash login**：指代輸入 `/login` 指令。
*   **slash model**：指代輸入 `/model` 指令。
*   **slash effort**：指代輸入 `/effort` 指令。
*   **slash clear**：指代輸入 `/clear` 指令。
*   **slash rewind**：指代輸入 `/rewind` 指令。
*   **slash help**：指代輸入 `/help` 指令。
*   **Shift-Tab**：指代按鍵組合 `Shift` + `Tab`。
*   **Accept Edits On**：模式名稱。
*   **Plan Mode**：模式名稱。
*   **Auto Mode On**：模式名稱。
*   **Manual Mode**：模式名稱。
*   **Authorise**：網頁按鈕文字，逐字稿拼寫為 "Authorise"。
*   **Copy Code**：網頁按鈕文字。
*   **To-do list app**：應用程式類型描述。

## 可延伸追問

1.  在 Plan Mode 下，AI 提問的具體內容有哪些範例？
2.  Auto Mode 通過安全檢查的具體標準是什麼？
3.  `/rewind` 回滾後，之前的對話歷史是否會完全消失？
4.  不同模型（Sonnet, Opus, Fable, Haiku）在價格與速度上的具體差異數據為何？
5.  若瀏覽器未自動開啟授權連結，手動複製連結的具體步驟為何？