# 影片筆記：Claude Code Tutorial for Non-Coders

## 一句話總結
本影片由 David DeWinter 與 Anthropic 合作，演示非程式設計師如何透過 Visual Studio Code 中的 **Claude Code** 擴充功能，建立具備 Excel 讀取、拖曳更新及跨資料夾操作功能的銷售管線管理應用程式，並對比了 Claude Code 與 Claude Codework 在權限、可見度與安全性上的差異。

## 核心重點
1.  **打破迷思**：Claude Code 不僅限於開發者使用，它是一個具備寫程式能力的通用 AI 代理程式。
2.  **Claude Code vs. Claude Codework**：
    *   **Claude Code**：提供高可見度（可查看文件）、跨資料夾存取（無需額外授權）、強大的環境功能（如 `/slash rewind` 回滾、明確的 Plan Mode）。適合追求效率與完整控制的使用者，但防護較少。
    *   **Claude Codework**：擁有更多安全防護（Guardrails），適合對安全性敏感或不想處理複雜權限設定的使用者，但在跨資料夾操作和開發體驗上較為受限。
3.  **紅旗警告**：由於 Claude Code 對電腦擁有接近完整的存取權限且防護較少，若使用者對「永久刪除」等風險感到不安，則不建議使用。
4.  **實戰成果**：成功建立了一個銷售管線（Sales Pipeline）管理應用，能讀取 Excel、顯示交易階段，並支援拖曳更新狀態及同步回 Excel。

## 詳細大綱

### I. 前言與迷思澄清
*   **講者介紹**：David DeWinter，與 Anthropic 合作。
*   **核心觀念**：澄清「Claude Code 僅供開發者使用」的迷思。
*   **定義**：Claude Code 是通用 AI 代理程式，剛好會寫程式。
*   **與 Codework 的關係**：Codework 基於相同引擎，但擁有更多防護機制（Guardrails）。

### II. 建立應用程式的準備工作
*   **選擇正確的專案**：
    *   保持小型、專注。
    *   確保對他人有實際用途（例如將 Excel/Google Sheets 中的複雜流程轉為軟體）。
    *   **範例**：銷售管線（Sales Pipeline）管理，涉及資料整理、文件歸檔與帳戶研究。
*   **安裝與設定**：
    *   下載並安裝 Visual Studio Code (VS Code)。
    *   在 VS Code 側邊欄搜尋並安裝官方由 Anthropic 製作的 **Claude Code** 擴充功能。
    *   開啟次要側邊欄，選擇 Claude Code，關閉中間視窗以專注於資源管理器（Explorer view）。

### III. 提示工程（Prompting）與互動
*   **撰寫提示詞**：
    *   明確聲明「我不是開發者」（I'm not a developer）。
    *   使用 `@` 符號引用資料夾內的檔案（例如 `@ salespipeline.xlsx`）。
    *   描述需求：顯示按階段分組的交易、讀取檔案、拖曳更新階段、更新 Excel。
    *   要求 AI 進行訪談以釐清需求（Interview me about anything else you need to know）。
*   **模式切換（Modes）**：
    *   **Plan Mode（計畫模式）**：在執行前顯示計畫，防止錯誤方向。透過點擊右下角手形圖示或按 `Shift + Tab` 切換。
    *   **Manual Mode（手動模式）**：每次變更前請求批准。
    *   **Edit automatically（自動編輯）**：自動處理檔案變更，但執行自訂工具時仍需許可。
    *   **Auto Mode（自動模式）**：除非認為有風險，否則自動批准動作。

### IV. 實作過程與功能演示
*   **回答問題**：針對 AI 提出的問題進行回答（例如卡片欄位、最後更新時間、拖曳功能、備份 Excel）。
*   **審查計畫**：
    *   使用「告訴 Claude 該做什麼」（Tell Claude what to do）框來詢問術語（如 OpenPi Excel 的含義）。
    *   批准計畫後，設定為自動接受編輯（Auto accept edits）並切換至 Auto Mode 以加速完成。
*   **應用程式運作**：
    *   透過 `.bat` 檔案開啟應用程式。
    *   驗證功能：拖曳交易至新階段，Excel 檔案同步更新（包含狀態與最後更新日期）。

### V. 新增功能：跨資料夾操作
*   **需求**：當交易移至「活躍（Active）」階段時，需將對應資料夾移至共享驅動器的活躍資料夾，並建立子資料夾。
*   **Claude Code 優勢（理由二）**：
    *   可直接存取電腦上完全不同的資料夾。
    *   相較於 Codework 需暫停並手動將資料夾加入許可清單，Code 更流暢。
*   **執行結果**：成功建立資料夾結構並移動檔案。

### VI. Claude Code 的三大優勢與環境功能
1.  **可見度（Visibility）**：在應用程式內直接查看所有建立的文件（Codework 無此功能）。
2.  **跨資料夾存取（Cross-folder Access）**：無需額外授權即可操作不同資料夾。
3.  **更好的環境（Harness/Environment）**：
    *   提供斜線命令（Slash commands）。
    *   **`/slash rewind`**：回滾程式碼與對話至過去某個時間點。
    *   **`/slash goal`**：持續提示直到達成精確目標。
    *   明確的 Plan Mode（Codework 無此明確模式）。

### VII. 應用程式分享與紅旗警告
*   **分享方式**：
    *   個人使用：雙擊開啟。
    *   團隊使用：複製檔案至 teammate 機器，或與 IT 團隊討論部署。
    *   避免問題：避免在每台機器上單獨修復問題。
*   **與 Codework 的對比總結**：
    *   Codework 需手寫計畫、手動授予資料夾權限、無檔案檢視、無回滾功能。
    *   Code 使這些過程更平滑。
*   **不使用 Claude Code 的大紅旗（Big Red Flag）**：
    *   Claude Code 擁有接近完整的電腦存取權限，防護少於 Codework。
    *   若使用者對 Codework 中的「永久刪除」問題感到不安，或無法判斷安全性，則不適合使用 Code。

## 工具 / 模型 / 名詞整理
*   **Claude Code**：影片主要介紹的工具，AI 程式碼代理程式。
*   **Claude Codework**（逐字稿提及）：另一款 AI 工具，具有更多防護機制。
*   **Anthropic**：Claude 的開發公司。
*   **Visual Studio Code (VS Code)**：推薦使用的程式碼編輯器，用於安裝擴充功能。
*   **Excel**：範例中使用的試算表軟體。
*   **Google Sheets**：提及可轉為軟體的現有工具。
*   **Shared Drive**：範例中使用的共享驅動器。
*   **.bat file**：範例應用程式的啟動檔案類型。
*   **OpenPi Excel**（逐字稿提及）：AI 生成的術語，講者詢問其含義。
*   **Northwind Traders**：範例中使用的公司名稱。
*   **Contoso**：範例中使用的帳戶名稱。
*   **Sales Pipeline**：範例專案名稱。
*   **Salespipeline.xl**：提示詞中提到的檔案名稱。

## 操作流程整理
1.  **環境準備**：
    *   安裝 Visual Studio Code (VS Code)。
    *   在 VS Code 側邊欄搜尋並安裝 Anthropic 官方製作的 **Claude Code** 擴充功能。
    *   開啟 Claude Code 側邊欄，關閉中間視窗，專注於資源管理器。
2.  **初始化專案**：
    *   建立小型、專注的專案資料夾。
    *   在提示中聲明「我不是開發者」。
    *   使用 `@` 引用現有檔案（如 `@ salespipeline.xlsx`）。
    *   描述需求：顯示交易階段、讀取檔案、拖曳更新、同步 Excel。
    *   選擇「Interview me about anything else you need to know」以釐清需求。
3.  **互動與模式設定**：
    *   回答 AI 提出的問題（欄位、時間、功能等）。
    *   切換至 **Plan Mode**（透過右下角手形圖示或 `Shift + Tab`）審查計畫。
    *   使用「Tell Claude what to do」框詢問術語（如 OpenPi Excel）。
    *   批准計畫後，設定為「Auto accept edits」並切換至 **Auto Mode** 以加速。
4.  **驗證與分享**：
    *   透過 `.bat` 檔案開啟應用程式。
    *   測試拖曳交易至新階段，確認 Excel 檔案同步更新。
    *   若需跨資料夾操作（如移至共享驅動器），利用 Claude Code 的跨資料夾存取功能。
    *   分享方式：個人使用直接雙擊；團隊使用複製檔案至 teammate 機器或與 IT 討論部署。

## 值得注意的限制或風險
1.  **安全性風險**：Claude Code 擁有接近完整的電腦存取權限，且防護少於 Codework。
2.  **數據刪除風險**：若使用者對「永久刪除」等風險感到不安，或無法判斷安全性，則不建議使用 Claude Code。
3.  **Codework 的限制**：Codework 需手寫計畫、手動授予資料夾權限、無檔案檢視、無回滾功能，跨資料夾操作較受限。
4.  **部署複雜性**：團隊使用時需複製檔案至 teammate 機器或與 IT 團隊討論部署，避免在每台機器上單獨修復問題。

## 逐字稿辨識疑點
*   **Codework**：逐字稿中多次出現此名稱（例如 "Claude Codework", "Cowork"），對比 "Claude Code"。需查證此是否為 Anthropic 官方產品名稱，或為聽寫錯誤/口誤。
*   **OpenPi Excel**：逐字稿中 AI 生成的術語，講者詢問其意義。需查證此是否為特定函數、庫名稱或聽寫錯誤（如 "OpenPyXL" 或其他 Excel 處理庫）。
*   **Cowork**：逐字稿後半段多次出現 "Cowork"（例如 "over Cowork", "in Cowork"），推測為 "Codework" 的聽寫錯誤，但依規則僅列為疑點。
*   **Northwind Traders**：範例中使用的公司名稱，常見於微軟範例，但需確認是否為逐字稿原意。
*   **Contoso**：範例中使用的帳戶名稱，常見於微軟範例，但需確認是否為逐字稿原意。
*   **slash rewind / slash goal / slash stickers**：這些斜線命令（Slash commands）為 Claude Code 的功能，需查證其準確的拼寫與功能描述是否與官方文件一致。
*   **Sales Pipeline**：範例專案名稱，拼寫正確，但需確認是否為通用術語或特定專案名。
*   **Salespipeline.xl**：提示詞中提到的檔案名稱，需注意副檔名是否為 `.xlsx` 或 `.xl` 的聽寫差異。

## 可延伸追問
1.  **Claude Codework 的官方狀態**：Anthropic 是否正式推出名為 "Claude Codework" 的產品？還是 "Codework" 或 "Cowork" 為逐字稿辨識錯誤？
2.  **OpenPi Excel 的真實含義**：AI 生成的 "OpenPi Excel" 具體指代什麼技術或函數？是否為 "OpenPyXL" 的誤聽？
3.  **斜線命令的準確拼寫**：`/slash rewind`、`/slash goal` 和 `/slash stickers` 是否為 Claude Code 中確切的命令名稱？
4.  **跨資料夾存取的具體限制**：Claude Code 在跨資料夾操作時，是否有特定的檔案類型或大小限制？
5.  **團隊部署的最佳實踐**：對於非技術團隊，如何安全地部署由 Claude Code 生成的應用程式？是否有官方推薦的部署指南？