# 影片筆記：10 Things They Didn't Tell You About Claude Code

## 一句話總結
本影片詳細介紹了 Claude Code 的架構、運作機制（觀察-規劃-執行-驗證迴圈）、多平台部署選項、模型與成本策略，以及針對企業級的合規性追蹤、權限管理與政策邊界設定。

## 核心重點
1.  **核心定義與運作**：Claude Code 是針對「程式碼庫」（Code base）設計的代理程式輔助工具。其核心運作遵循「觀察 (Observe) -> 規劃 (Plan) -> 執行 (Act) -> 驗證 (Verify)」的迴圈機制，並透過 `Task` 工具追蹤進度。
2.  **工具集與功能**：提供 `Read`, `Edit`, `Write`, `Bash`, `Glob`, `Grip`, `Agent`, `Web Search`, `Web Fetch`, `Task` 等工具。特別區分了檔案搜尋 (`Glob`) 與檔案內容搜尋 (`Grip`)，以及網頁搜尋 (`Web Search`) 與網頁抓取 (`Web Fetch`) 的差異。
3.  **部署與執行環境**：支援四種運行場所：終端機 (Terminal)、IDE (如 VS Code, Cursor, Antigravity)、雲端代理程式 (Agent in the cloud)，以及桌面/行動裝置應用。
4.  **模型策略與成本**：
    *   區分生產環境與開發/高階問題使用的模型。
    *   提及多種模型選項：Hyco, Sonnet, Opus, NeoFable, MIFOS, Fable, Haiku, Deep Seek, GLM。
    *   支援透過設定檔 (ZSHRC) 自訂模型，並可設定備用模型 (Fallback)，如使用 OpenRouter 或本地模型。
    *   `Fable` 模型僅限用於規劃與驗證階段。
    *   `Effort` 參數會影響成本與效能。
5.  **企業級功能**：
    *   針對顧問與服務提供者，解決本地 vs. 雲端部署的架構問題。
    *   整合 AWS Bedrock, Google Vertex AI, Microsoft Azure AI Foundry。
    *   提供企業級功能：Managed Agents, Cloud Teams, Enterprise。
    *   支援 SSO, SCIM Provisioning, RBAC。
    *   透過 `Androfi` 合規性 API 提供完整的可追溯性 (Traceability)，記錄誰、何時、使用了何種工具及執行了何種操作，以便回溯。
    *   IT 部門可設定政策邊界 (Guardrails)，例如限制存取特定網域。
6.  **學習資源**：提供從初級到進階的專屬教室資源、認證徽章 (Badge) 及七天免費試用。

## 詳細大綱

### 1. Claude Code 基礎與架構
*   **定義**：針對包含檔案的資料夾（Code base）設計的代理程式輔助工具。
*   **工具解析**：
    *   基本工具：Read, Edit, Write, Bash。
    *   搜尋工具：
        *   `Glob`：搜尋檔案路徑。
        *   `Grip`：搜尋檔案內容（疑似 Grep 的變體或特定工具）。
        *   `Web Search`：搜尋網頁資訊。
        *   `Web Fetch`：抓取網頁內容。
    *   任務管理：`Task` 用於追蹤進度。
*   **運作迴圈 (The Loop)**：
    *   代理程式透過「觀察 -> 規劃 -> 執行 -> 驗證」的循環運作。
    *   強調「規劃模式 (Plan mode)」的重要性。
    *   子代理程式 (Helper agents) 擁有獨立的迴圈。

### 2. 執行環境與部署
*   **終端機 (Terminal)**：命令列介面操作。
*   **IDE 整合**：
    *   支援 VS Code, Cursor, Antigravity。
*   **雲端與應用**：
    *   雲端代理程式 (Agent in the cloud) 與 Agent SDK。
    *   桌面與行動裝置應用。
    *   提及 `Cloud P` 與 `Telegram` 作為可能的整合或平台。

### 3. 模型選擇、設定與成本策略
*   **模型選項**：
    *   提及模型：Hyco, Sonnet (4.6, 4.8), Opus (4.7, 4.8), NeoFable, Haiku, Deep Seek, GLM, MIFOS, Fable。
    *   `Fable` 的限制：僅限用於規劃與驗證階段。
*   **設定與備用**：
    *   透過 `ZSHRC` 檔案進行模型設定。
    *   備用策略 (Fallback)：可設定 OpenRouter、本地模型或 GLM 作為備用。
*   **成本影響**：
    *   `Effort` 參數直接影響成本與效能。
    *   區分生產環境與高階模型的使用場景。

### 4. 企業級應用與合規性
*   **架構問題**：企業客戶最常詢問本地部署 vs. 雲端部署的差異。
*   **雲端供應商整合**：
    *   Amazon Bedrock
    *   Google Vertex AI
    *   Microsoft Azure AI Foundry
*   **企業級功能**：
    *   Managed Agents, Cloud Teams, Enterprise。
    *   關鍵術語：SSO (Single Sign On), SCIM Provisioning, RBAC (Role-Based Access Control)。
*   **資訊存取控制**：
    *   不同團隊（如行銷、財務）可設定不同的資料夾存取權限。
*   **合規性與可追溯性 (Traceability)**：
    *   透過 `Androfi` 合規性 API，供合規、安全及 IT 部門即時獲取資訊。
    *   完整追蹤記錄：誰使用了 Claude Code、執行了什麼操作、發生了什麼事、使用了哪些工具。
    *   目的：若出現問題，可進行回溯追蹤。
*   **政策邊界 (Guardrails)**：
    *   IT 部門可設定額外政策，例如限制使用 Claude Code 時不得存取特定網域或尋找特定資訊。
*   **認證與資源**：
    *   社區培訓、Cloud Code 認證、徽章 (Badge)。
    *   專屬教室資源：涵蓋從初級到進階 (beginner to pro) 的內容。
    *   七天免費試用 (seven day free trials)。

## 工具 / 模型 / 名詞整理
*   **Claude Code**：影片核心討論的代理程式輔助工具。
*   **Anthropic API** (逐字稿中出現為 antraffic api, antraffic)：API 介面。
*   **Terminal**：終端機。
*   **IDE**：Integrated Development Environment。
*   **VS Code**：Visual Studios。
*   **Cursor**：IDE 名稱。
*   **Antigravity**：IDE 名稱。
*   **Agent SDK**：代理程式開發套件。
*   **Entropic API** (疑點)：逐字稿原文，可能指 Anthropic API 或特定 SDK。
*   **OpenClaw**：產品名稱。
*   **Cloud P**：產品名稱。
*   **Telegram**：通訊軟體或整合平台。
*   **模型列表**：
    *   Hyco
    *   Sonnet (4.6, 4.8)
    *   Opus (4.7, 4.8)
    *   NeoFable
    *   Haiku
    *   Deep Seek (透過 OpenRouter)
    *   GLM
    *   MIFOS
    *   Fable (僅限規劃與驗證)
*   **OpenRouter**：模型路由服務。
*   **ZSHRC**：設定檔。
*   **Amazon Bedrock**：雲端供應商服務。
*   **Google Vertex AI**：雲端供應商服務。
*   **Microsoft Azure AI Foundry**：雲端供應商服務。
*   **Anthropic Console**：管理控制台。
*   **Managed Agents**：企業級功能。
*   **Cloud Teams**：企業級功能。
*   **Enterprise**：企業級功能。
*   **SSO**：Single Sign On。
*   **SCIM Provisioning** (逐字稿中出現為 Skim provisioning)：系統跨域身份管理配置。
*   **RBAC**：Role-Based Access Control。
*   **Androfi**：提供合規性 API 的服務或產品。
*   **Compliance API**：合規性 API。
*   **Cloud Code badge**：認證徽章。

## 操作流程整理
1.  **初始化與設定**：
    *   在終端機或 IDE 中啟動 Claude Code。
    *   透過 `ZSHRC` 檔案設定預設模型或備用模型 (Fallback)。
2.  **執行代理程式迴圈**：
    *   使用者提出需求。
    *   代理程式進入「觀察 -> 規劃 -> 執行 -> 驗證」迴圈。
    *   使用 `Task` 工具追蹤進度。
    *   若涉及子代理程式，啟動獨立迴圈。
3.  **工具調用**：
    *   根據需求調用 `Read`, `Edit`, `Write`, `Bash` 等工具。
    *   使用 `Glob` 搜尋檔案，`Grip` 搜尋內容。
    *   使用 `Web Search` 或 `Web Fetch` 處理網路資訊。
4.  **企業級管理 (IT/合規部門視角)**：
    *   透過 `Androfi` 合規性 API 監控使用情況。
    *   設定政策邊界 (Guardrails)，限制特定網域存取。
    *   根據團隊角色 (RBAC) 設定資料夾存取權限。
    *   若發生問題，透過可追溯性記錄進行回溯。
5.  **學習與認證**：
    *   參與從初級到進階的專屬教室資源。
    *   獲取 Cloud Code 認證與徽章。
    *   利用七天免費試用進行評估。

## 值得注意的限制或風險
1.  **模型版本與名稱不確定性**：
    *   影片中提及的模型版本（如 Sonnet 4.6/4.8, Opus 4.7/4.8）及模型名稱（Hyco, NeoFable, MIFOS, Fable）需查證是否為實際存在的版本或名稱。
    *   `Fable` 模型僅限用於規劃與驗證，不能用於執行階段，這是一項限制。
2.  **成本影響**：
    *   `Effort` 參數會影響成本，使用者需注意設定以控制開支。
3.  **企業合規性依賴**：
    *   企業級功能依賴 `Androfi` 合規性 API 及雲端供應商（AWS, Google, Azure）的整合，若這些服務不可用或配置錯誤，可能影響合規性追蹤。
4.  **政策邊界限制**：
    *   IT 部門設定的政策邊界（如限制網域存取）可能影響代理程式的功能範圍。

## 逐字稿辨識疑點
*   **antraffic / antraffic api**：逐字稿多次出現此拼寫，推測為 Anthropic 或 Anthropic API 的聽寫錯誤，但依規則標記為「需查證」。
*   **Entropic API**：逐字稿提到 "Agent SDK will fetch Entropic API"，此名稱與常見 AI API 名稱不符，標記為「需查證」。
*   **Skim provisioning**：逐字稿提到 "Skim provisioning allows you to add people..."，推測為 SCIM (System for Cross-domain Identity Management) Provisioning 的聽寫錯誤，但依規則標記為「需查證」。
*   **Clot / Clot code**：逐字稿中出現 "type Clot", "power up Clot", "launch clod code"，推測為 Cloud Code 的聽寫錯誤，但依規則標記為「需查證」。
*   **Grip**：逐字稿區分 Glob 與 Grip，指出 Grip 搜尋檔案內容。需確認此為特定工具名稱或聽寫錯誤（通常為 Grep）。
*   **MIFOS**：逐字稿提到 "MIFOS and Fable"，需確認此模型名稱是否正確。
*   **NeoFable**：逐字稿提到 "NeoFable"，需確認此模型名稱是否正確。
*   **Hyco**：逐字稿提到 "Hyco"，需確認此模型名稱是否正確。
*   **Opus 4.7 / Opus 4.6 / Opus 4.8**：模型版本號需查證是否為實際存在的版本。
*   **Sonnet 4.6 / Sonnet 4.8**：模型版本號需查證是否為實際存在的版本。
*   **Antigravity**：作為 IDE 名稱出現，需查證是否為現有產品。
*   **OpenClaw**：作為產品名稱出現，需查證是否為現有產品。
*   **Cloud P**：作為產品名稱出現，需查證是否為現有產品。
*   **Androfi**：逐字稿中出現 "Androfi provides compliance API"，此名稱較不常見，需查證是否為特定產品名稱或聽寫錯誤。
*   **cloud certified**：語法上略顯不完整，可能指 "Cloud Certified" 或相關認證課程。
*   **cloud code badge**：指稱 Cloud Code 的徽章，需確認是否為官方認證名稱。
*   **cloud code beginner to pro**：指稱課程等級，需確認是否為正式課程名稱。
*   **seven day free trials**：語法上通常為 "seven-day free trial"，此處為複數形式，保留原樣。

## 可延伸追問
1.  **模型版本確認**：Sonnet 4.6/4.8 和 Opus 4.7/4.8 是否為 Anthropic 官方發布的版本？Hyco, NeoFable, MIFOS 是否為內部或特定合作夥伴模型？
2.  **工具細節**：`Grip` 工具與標準的 `Grep` 命令有何具體差異？`Fable` 模型在規劃與驗證階段的具體表現如何？
3.  **企業整合細節**：`Androfi` 合規性 API 的具體功能與架構為何？如何與 AWS Bedrock, Google Vertex AI, Microsoft Azure AI Foundry 進行技術整合？
4.  **成本優化**：`Effort` 參數的具體數值範圍及其對成本的影響比例為何？如何最佳化備用模型 (Fallback) 策略以平衡成本與效能？
5.  **產品存在性**：`Antigravity`, `OpenClaw`, `Cloud P` 是否為現有的開發工具或產品？若為聽寫錯誤，正確名稱為何？