Claude Code 實戰課程
給非技術白領專業人士的完全指南
Modules 1–3：從零開始，輕鬆上手
給讀者的一封信
你不需要懂程式。你不需要知道什麼是 API。你甚至不需要知道終端機是什麼。
這份教學假設你從來沒有打開過終端機，從來沒有輸入過指令，而且一看到黑色畫面就想關掉。
我們會一步一步、非常非常仔細地帶你走過每一個步驟。就像你最懂科技的朋友坐在你旁邊，耐心地告訴你「現在點這裡」、「現在輸入這個」。
準備好了嗎？讓我們開始吧。
MODULE 1：歡迎來到 AI 自動化的世界
為什麼你需要 Claude Code
你可能會卡在哪裡
在進入正題之前，先說說這個模組最常見的問題：
❓「我已經有 ChatGPT 了，為什麼還需要 Claude Code？」
這是最常見的問題。答案很簡單：ChatGPT 是你的顧問，Claude Code 是你的執行助理。顧問告訴你怎麼做，助理真的替你做完。讀完這個模組你就會明白差別有多大。
❓「這不是給工程師用的嗎？我一行程式都不會寫。」
完全不是。Claude Code 的設計理念就是「讓 AI 寫程式，讓你說中文」。你只需要用中文說「幫我整理這個資料夾裡的所有 Excel」，它就會自己處理好。你完全不需要理解它在後面做什麼。
❓「我怕用錯了會出什麼問題。」
完全可以理解這種擔心。我們會在整個課程中一直強調：Claude Code 在做任何「可能影響你檔案」的事情之前，都會先問你確認。它不會在你不知情的情況下亂動你的東西。
1.1 什麼是 Claude Code？用白話說清楚
想像一下你的辦公室日常。你可能用過 ChatGPT 或是 Google Gemini 來幫你潤飾一封郵件、翻譯一段文字、或是想一個活動名稱。這些 AI 工具很有用——但它們有一個根本的限制：它們只能「說」，不能「做」。
就像你打電話給一位顧問，他可以給你很棒的建議，但他沒辦法替你去執行。你掛掉電話後，所有的事情還是要自己做。
Claude Code 不一樣。
Claude Code 就像是你僱了一位全職助理，他坐在你旁邊，可以直接操作你的電腦。你說「幫我把桌面上那個資料夾裡的所有 Word 文件整理成一份摘要報告」，他就真的會：
- 打開那個資料夾
- 讀取每一份文件
- 整理內容
- 產出一份報告存在你指定的地方
你完全不需要做任何中間步驟。
1.2 ChatGPT vs Claude Code：到底差在哪裡？
下面這張表格用具體的辦公室情境來說明兩者的差異：
| 情境 | ChatGPT 能做什麼 | Claude Code 能做什麼 |
|---|---|---|
| 整理 50 份客戶訪談記錄 | 你必須一份一份複製貼上，它才能幫你摘要 | 你說「幫我整理桌面上的 interviews 資料夾」，它直接讀取全部、一次完成 |
| 製作 5 個平台的行銷文案 | 它幫你寫好後，你要手動複製到 5 個不同的檔案 | 它一次產出 5 個不同格式的文字檔，自動存到指定資料夾 |
| 比對兩份合約的差異 | 你必須把合約文字全部貼進對話框（有字數上限） | 它直接讀取你電腦上的 PDF 或 Word，幫你找出差異 |
| 批次重新命名 100 張圖片 | 它可以告訴你「怎麼用程式重新命名」，但你要自己執行 | 你說「幫我把這個資料夾的圖片按照日期重新命名」，直接完成 |
| 分析上個季度的銷售數據 | 你要把數字一行行貼進去 | 它直接讀取你的 Excel 或 CSV，幫你分析並輸出圖表 |
| 整理會議記錄並寄出摘要 | 它可以幫你寫摘要，但你要自己寄出 | 它可以讀取錄音檔轉文字，整理後（配合工具）自動寄出 |
💡 一個最直接的比喻：
- ChatGPT = 打電話給顧問，他給你建議，你自己去執行
- Claude Code = 你的助理坐在你旁邊，你說一句話，他從頭到尾幫你做完
1.3 三個真實的辦公室場景
場景一：產品經理的噩夢——50 份客戶訪談記錄
背景： 你剛做完一輪用戶研究，收到了 50 份訪談記錄，分散在桌面的一個資料夾裡。老闆要你下週一前整理出一份洞察報告。
用 ChatGPT 的做法： 你需要打開第一份文件 → 複製全文 → 貼到 ChatGPT → 等它分析 → 複製結果 → 貼到你的報告 → 關掉文件 → 打開第二份……重複 50 次。光是這個步驟，至少要花你半天。
用 Claude Code 的做法： 你打開 Claude Code，用中文輸入：
我的桌面有一個叫 "user-interviews" 的資料夾，裡面有 50 份 Word 文件，
都是客戶訪談記錄。請幫我：
1. 讀取每一份文件
2. 提取關鍵痛點和需求
3. 整理成一份有結構的洞察報告，存成 "用戶洞察報告_2026.md"
然後你去泡咖啡。回來的時候，報告已經在桌面上了。
場景二：行銷人員的日常——5 個平台，5 種格式
背景： 你需要為一個新產品發布準備 5 個平台的內容：Instagram 貼文（150字以內）、LinkedIn 文章（500字）、Facebook 貼文（有表情符號）、電子報（HTML 格式）、官網部落格（1000字，附 SEO 關鍵字）。
用 ChatGPT 的做法： 你要分別和 ChatGPT 說 5 次，複製 5 次結果，開 5 個不同的文件手動儲存……每次還要重新說明品牌語氣。
用 Claude Code 的做法： 你在 CLAUDE.md（稍後的 Module 3 會教你）裡已經寫好了公司的品牌語氣和產品資訊。然後你只要說：
根據我們的品牌指南，為「XX產品」的發布活動，
幫我生成 5 個平台的發文內容，分別存成 5 個獨立的文字檔，
放在 "launch-content" 資料夾。
完成。五個現成的文件，各自符合各平台的字數和格式要求。
場景三：業務主管的需求——比對合約差異
背景： 你有一份新的合作夥伴合約，想要和去年簽的舊版合約比較，找出有哪些條款變動了。
用 ChatGPT 的做法： 合約通常有十幾頁，ChatGPT 的輸入有字數限制。你可能需要分段貼上，而且它「看不到」你電腦上的 PDF，你要先自己複製文字。
用 Claude Code 的做法：
我有兩份 PDF 合約：
- 舊版：~/Documents/contract-2025.pdf
- 新版：~/Documents/contract-2026.pdf
請幫我比對兩份合約，找出所有有差異的條款，
整理成一份對照表，標出「舊版條款」和「新版條款」。
它直接讀取 PDF，列出所有差異，存成一份清晰的比較表。
1.4 費用方案：我需要花多少錢？
Claude Code 有幾種使用方式，費用各有不同：
| 方案 | 月費 | 適合誰 | Claude Code 使用量 |
|---|---|---|---|
| Claude Pro | 650） | 個人用戶、輕度使用者 | 每月有一定用量上限（重度使用可能會觸及上限） |
| Claude Max | 3,250） | 重度使用者、每天都用 | 用量是 Pro 的 5 倍 |
| Claude Teams | $30 美元/人/月 | 企業團隊 | 有共用功能、管理後台 |
| Anthropic API | 按用量計費 | 開發者、自動化流程 | 最靈活，但需要一點技術設定 |
💡 對大多數白領專業人士來說：從 Claude Pro（$20/月）開始就夠了。 如果你發現每天都在用而且常常撞到上限，再升級到 Max。
⚠️ 注意： 使用 Claude Code 需要有上述其中一種付費訂閱。免費版的 Claude 不包含 Claude Code 功能。
1.5 「不寫程式」到底是什麼意思？
這是最重要的觀念澄清，請仔細看：
你不需要學程式，但 Claude Code 會在背後寫程式、執行程式。
就像你開車，你不需要懂引擎的運作原理。你只需要知道「往右轉方向盤車子就往右」。
當你告訴 Claude Code「幫我把這個資料夾裡的所有 PDF 合併成一個」，背後發生的事情是：
- Claude Code 理解你的需求
- 它自己寫了一段 Python（一種程式語言）程式碼
- 它自己執行這段程式碼
- 你得到結果
你完全不需要看到那段程式碼，更不需要理解它。
✅ 模組一重點複習：
- Claude Code = AI 助理，可以真正在你電腦上執行任務
- 和 ChatGPT 的差別：一個說，一個做
- 你只需要用中文說需求，不需要寫程式
- 費用：從 $20/月的 Claude Pro 開始
MODULE 2：安裝與環境設定
保姆級教學——從頭手把手帶你完成
你可能會卡在哪裡
安裝這個步驟是最多人放棄的地方。我們在這裡把所有可能遇到的問題都列出來，讓你有心理準備：
❓「npm install 出現 permission denied，我不知道那是什麼意思」 → 別擔心，2.4 節有完整的修復步驟。
❓「Windows 要不要裝 WSL？那是什麼？」 → 2.2 節有詳細說明。簡單說：大多數 Windows 用戶現在不需要裝 WSL 了，有更簡單的方法。
❓「Node.js 版本衝突」 → 2.4 節有升級方法。
❓「公司電腦 IT 限制安裝軟體，怎麼辦？」 → 先試試看，如果真的被擋住，聯絡你的 IT 部門說明需求，或使用個人電腦。
❓「終端機在哪裡？我從來沒有打開過。」 → 這是你第一個要解決的問題，也是 2.1 節的主題。
❓「我怕打錯指令會把電腦搞壞。」 → 不會的，真的不會。繼續往下讀就知道了。
2.1 認識終端機（5 分鐘就好）
終端機是什麼？
你平常怎麼讓電腦做事？用滑鼠點選圖示、按鈕、選單。這是「圖形化介面」。
終端機就是同一件事的「文字版」。 你不用滑鼠點，改用文字輸入指令。
用一個比喻來說：
終端機就像餐廳的訂餐系統。你平常去餐廳用手指著菜單說「我要這個」（圖形化介面）。但有時候你也可以直接告訴服務生「我要一份牛肉麵、少油、不要香菜」（終端機）。效果一樣，只是溝通方式不同。
🛡️ 安全保證（請仔細閱讀）
在終端機裡打字，不會弄壞你的電腦。
如果你輸入了一個錯誤的指令，最多只會看到一段紅色的錯誤訊息（就像你輸入了一個不存在的菜單選項，服務生會說「抱歉，我們沒有這道菜」）。電腦不會爆炸，你的檔案也不會消失。
唯一需要小心的指令是刪除相關的（
rm -rf開頭的），但這些指令在這門課裡完全用不到，你也不會學到。
如何打開終端機
Mac 用戶
方法一（推薦）：
- 按下
Command + Space（同時按），打開 Spotlight 搜尋 - 輸入「Terminal」
- 按下 Enter
方法二：
- 打開 Finder
- 點選左側「應用程式」
- 找到「工具程式」資料夾
- 點開「終端機」
當終端機打開後，你會看到一個黑色（或白色）的視窗，裡面有一行文字，最後有一個閃爍的游標。這是正常的。
新打開的 Mac 終端機視窗，會顯示類似「yourname@MacBook-Pro ~ %」
Windows 用戶
方法一：使用 PowerShell（推薦）
- 按下 Windows 鍵（⊞）
- 輸入「PowerShell」
- 按下 Enter
方法二：使用命令提示字元
- 按下 Windows 鍵
- 輸入「cmd」
- 按下 Enter
💡 PowerShell 和命令提示字元的差別： PowerShell 功能更強大，也是 Windows 上安裝 Claude Code 的首選。如果你不確定用哪個，就用 PowerShell。
終端機基本指令——你只需要知道這 4 個
這 4 個指令是你在這門課裡最常用到的。其他的不用管。
1. cd（Change Directory）—— 移動到某個資料夾
就像你在 Finder/檔案總管裡雙擊進入一個資料夾，cd 是文字版的「進入資料夾」。
cd Desktop # 移動到桌面
cd Documents # 移動到文件資料夾
cd my-ai-workspace # 移動到叫 my-ai-workspace 的資料夾
cd .. # 返回上一層資料夾（兩個點代表「上一層」）2. ls（Mac）/ dir（Windows）—— 看看資料夾裡有什麼
就像你打開一個資料夾看裡面有什麼，ls 是文字版的「列出所有東西」。
Mac：
lsWindows：
dir3. pwd（Mac）/ cd（Windows）—— 我現在在哪裡？
有時候你不知道自己「在」哪個資料夾裡。這個指令告訴你完整的路徑。
Mac：
pwd→ 顯示類似：/Users/yourname/Desktop
Windows（直接輸入 cd 不加任何東西）：
cd→ 顯示類似：C:\Users\yourname\Desktop
4. mkdir（Make Directory）—— 建立新資料夾
mkdir my-ai-workspace # 建立一個叫 my-ai-workspace 的資料夾⚠️ 中文路徑警告——非常重要！
如果你的 Mac 使用者名稱（例如：
/Users/張小明/）或 Windows 使用者名稱包含中文字，在使用終端機時可能會遇到問題。建議的解決方案： 把你的工作資料夾建立在純英文路徑下。例如：
- Mac：建立在
/Users/yourname/workspace/（不要在包含中文的路徑裡）- Windows：建立在
C:\workspace\或C:\Users\[英文名]\workspace\如果你的使用者名稱本身就是中文，可以考慮建立一個英文的新使用者帳號專門用來執行 Claude Code。
2.2 安裝 Claude Code
Mac 安裝（推薦方法）
步驟一：打開終端機
按照 2.1 節的方法打開終端機。
步驟二：輸入安裝指令
在終端機裡，輸入下面這一整行指令，然後按 Enter：
curl -fsSL https://claude.ai/install.sh | bash💡 這行指令在做什麼？ 用一個日常生活的比喻：這就像你在網路上按了「立即安裝」的按鈕，只是用打字的方式。
curl：一個從網路下載東西的工具（電腦預設就有）https://claude.ai/install.sh：Anthropic 官方提供的安裝腳本（一個自動化的安裝程式）| bash：「執行剛才下載的安裝程式」
步驟三：等待安裝完成
安裝過程大約需要 1-3 分鐘，你會看到一些文字在跑。這是正常的。等到你看到類似「Installation complete」或提示符號（$ 或 %）再次出現，就代表安裝完成了。
⚠️ 提醒： 以上安裝指令以官方網站最新版本為準。如果安裝失敗，請先前往 Anthropic 官方文件 確認最新的安裝方式。
步驟四：驗證安裝成功
輸入：
claude --version如果看到類似 claude 1.x.x 的版本號碼，安裝成功！✅
Windows 安裝（原生方法——推薦）
步驟一：以系統管理員身分打開 PowerShell
- 按下 Windows 鍵
- 輸入「PowerShell」
- 在搜尋結果上按右鍵
- 選擇「以系統管理員身分執行」
- 如果出現「是否允許此應用程式對您的裝置進行變更？」，點「是」
💡 為什麼要以系統管理員身分？ 就像有些事情你需要有「主管授權」才能做，安裝新程式也需要電腦的「最高權限」（系統管理員）才能進行。
步驟二：輸入安裝指令
在 PowerShell 裡輸入：
irm https://claude.ai/install.ps1 | iex💡 這行在做什麼？ 和 Mac 的安裝指令一樣，只是語法不同。irm 是「從網路下載」，iex 是「執行」。
步驟三：安裝 Git for Windows（如果尚未安裝）
Claude Code 在 Windows 上需要 Git。如果安裝過程中提示你需要 Git，請：
- 前往 git-scm.com
- 下載並安裝（保持所有預設設定，一路點「Next」就好）
- 安裝完成後，重新執行步驟二的指令
步驟四：驗證安裝
安裝完成後，關掉 PowerShell，重新打開（不需要以系統管理員身分），然後輸入：
claude --version看到版本號碼就代表成功了。✅
Windows 安裝（備用方法：WSL）
⚠️ 什麼時候才需要用 WSL？
WSL（Windows Subsystem for Linux，Windows 的 Linux 子系統）是在 Windows 電腦上運行一個「虛擬的 Linux 系統」。
對大多數人來說，原生安裝方法（上面那個）就夠了，不需要 WSL。以下情況才考慮 WSL：
- 原生安裝方法失敗，試了很多次都不行
- 你的公司環境有特殊的安全設定
- 你之後想做更進階的自動化工作
如果你是第一次安裝，先試原生方法，不要在這裡卡住。
WSL 是什麼的比喻
想像你的 Windows 電腦是一棟辦公大樓，WSL 就是在大樓裡設置了一間「Linux 工作間」。進入這個房間後，操作方式就和 Mac/Linux 的終端機一樣了。聽起來很奇怪，但有時候某些工具在這個「小房間」裡運作更順暢。
WSL 安裝步驟
第一步：安裝 WSL
以系統管理員身分打開 PowerShell，輸入：
wsl --install電腦會自動安裝 WSL 和 Ubuntu（一種 Linux 系統）。安裝完成後需要重新啟動電腦。
第二步：設定 Ubuntu 帳號
重啟後，Ubuntu 視窗會自動打開，要求你設定一個使用者名稱和密碼：
- 使用者名稱：建議用純英文小寫，例如
gary - 密碼：你打密碼時畫面不會顯示任何字符，這是正常的安全設計，打完按 Enter
第三步：在 WSL 中安裝 Claude Code
Ubuntu 視窗打開後，輸入：
curl -fsSL https://claude.ai/install.sh | bash和 Mac 的安裝方法完全一樣。
備用方法：透過 npm 安裝（技術性備用方案）
⚠️ 只有在上面兩種方法都失敗時，才用這個方法。
這個方法需要先安裝 Node.js，步驟多一些。
第一步：安裝 Node.js
前往 nodejs.org，下載 LTS 版本（標示「推薦大多數使用者」的那個），安裝。
💡 什麼是 Node.js？ 就像某些程式需要「Java」才能運行，Claude Code 的舊安裝方式需要「Node.js」才能運作。你不需要了解它，只需要把它安裝好。
第二步：安裝 Claude Code
打開終端機，輸入：
npm install -g @anthropic-ai/claude-code如果出現「Permission denied」錯誤
輸入以下兩行指令（每行按一次 Enter）：
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'然後再試一次安裝。
2.3 帳號認證
安裝完成後，你需要連結你的 Anthropic 帳號，Claude Code 才能正常運作。
你需要的是：
以下任一種即可：
- Claude Pro 訂閱（$20/月）——claude.ai 訂閱
- Claude Max 訂閱（$100/月）——同上，升級版
- Claude Teams 訂閱——公司團隊版
- Anthropic API Key——付費 API（較為技術性，推薦非技術人員直接用前三種）
認證步驟
第一步：進入你的工作資料夾
先建立並進入你的第一個工作資料夾（這很重要，後面會解釋為什麼）：
Mac：
mkdir ~/my-ai-workspace
cd ~/my-ai-workspaceWindows：
mkdir C:\workspace\my-ai-workspace
cd C:\workspace\my-ai-workspace第二步：啟動 Claude Code
輸入：
claude按下 Enter。
第三步：瀏覽器自動打開
第一次啟動時，Claude Code 會自動打開你的預設瀏覽器，帶你到 Anthropic 的登入頁面。
- 用你的 Anthropic 帳號登入（或用 Google/GitHub 登入）
- 點選「Authorize」（授權）
- 瀏覽器顯示「You can now close this tab」
- 回到終端機，你應該看到 Claude Code 已經準備好了
如果瀏覽器沒有自動打開
有時候在公司防火牆或特定環境下，瀏覽器不會自動打開。這時候：
- 注意看終端機顯示的訊息，它通常會印出一個網址
- 把那個網址複製下來，手動貼到瀏覽器打開
- 完成授權後回到終端機
如果連網址都沒有出現，試試這個：
claude auth login2.4 常見安裝問題完整排除
遇到問題不要慌，這個表格包含了 90% 的常見情況：
問題 1：command not found: claude
症狀： 你輸入 claude，終端機回應 command not found: claude 或 'claude' is not recognized as an internal or external command
原因： 這是「環境變數 PATH 問題」。白話說就是：Claude Code 已經安裝好了，但你的電腦不知道它在哪裡。就像你僱了一個新員工，但忘記告訴前台他在哪個辦公室。
Mac 解決方法：
關掉終端機，重新打開，再試一次 claude --version。如果還是不行：
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc輸入後，再試 claude --version。
Windows 解決方法：
關掉 PowerShell，重新打開，再試。Windows 通常在安裝後需要重新啟動終端機。如果還是不行，重啟電腦試試。
問題 2：Permission denied 或 EACCES error
症狀： 安裝時看到 permission denied、EACCES、或 access denied
原因： 你的帳號沒有安裝軟體的足夠權限。
Mac 解決方法：
sudo npm install -g @anthropic-ai/claude-code（它會要求你輸入電腦密碼，輸入時畫面不會顯示，這是正常的）
Windows 解決方法： 確保你是「以系統管理員身分執行」PowerShell（參見 2.2 節步驟一）。
問題 3：Node.js version not supported 或 requires Node.js 18+
症狀： 安裝時出現版本不支援的錯誤
原因： 你的電腦上有舊版的 Node.js（低於 18 版）
解決方法：
前往 nodejs.org，重新下載最新的 LTS 版本安裝即可。安裝新版會自動覆蓋舊版。
💡 提示： Claude Code 的最低 Node.js 版本需求可能會隨更新變動，請以官方文件為準。
問題 4：Windows Git Bash 找不到
症狀： Windows 上出現 git bash not found 相關錯誤
解決方法：
先確認你已經安裝 Git for Windows（git-scm.com）。
如果安裝了但還是找不到，手動指定路徑。在 PowerShell 裡輸入：
$env:CLAUDE_CODE_GIT_BASH_PATH = "C:\Program Files\Git\bin\bash.exe"⚠️ 注意： 這個設定只在當前視窗有效。如果要永久生效，需要加到系統環境變數裡。（操作：Windows 鍵 → 搜尋「環境變數」→ 「系統內容」→「環境變數」→ 新增使用者變數）
問題 5：公司防火牆擋住
症狀： 安裝卡在某個步驟，錯誤訊息包含 certificate、proxy、network、ssl 等字眼
解決方法：
這個問題通常只有公司電腦才會遇到。有幾個選項：
- 聯絡 IT 部門：說明你需要安裝 Claude Code，請他們將
claude.ai和anthropic.com加入白名單 - 使用個人電腦：在家用個人電腦安裝，再把工作檔案帶過去處理
- 詢問是否有公司授權版本：有些公司已經有 Anthropic 的企業版授權
問題 6：WSL 裡 npm 指向 Windows
症狀： 在 WSL 裡安裝時，出現 ENOENT: no such file or directory 或路徑包含 /mnt/c/ 的奇怪錯誤
原因： WSL 有時候會誤用 Windows 版本的 npm
診斷方法：
which npm如果輸出是 /mnt/c/... 開頭的（包含 Windows 路徑），那就是這個問題。
解決方法：
sudo apt update
sudo apt install nodejs npm -y這樣會在 WSL 的 Linux 環境裡安裝原生的 npm，覆蓋掉 Windows 的版本。
2.5 驗證安裝成功
完成安裝後，用這三個步驟確認一切正常：
驗證一：版本檢查
claude --version✅ 應該看到：claude 1.x.x（有版本號碼就代表安裝成功）
驗證二：健康檢查
claude doctor這個指令會自動幫你檢查環境是否一切正常，並提示你哪裡有問題。
✅ 應該看到：各項目旁邊都是 ✓ 或 OK
⚠️ 如果看到 ✗ 或 FAIL，注意看它的說明，通常會告訴你怎麼修復。
驗證三：第一次對話測試
claude輸入任何一句話，例如：
你好！請自我介紹一下。
如果 Claude 有回應，就代表完全設定好了！✅
2.6 建立你的第一個工作資料夾
這個概念很重要，請花 2 分鐘理解。
什麼是「專案目錄」？
想像你在整理實體文件。你有一個大型文件櫃，裡面有很多個抽屜，每個抽屜對應一個專案。你做「行銷企劃A」的時候，你打開「行銷企劃A」的抽屜，所有相關文件都在裡面。
在 Claude Code 裡，「專案目錄」就是這個抽屜。Claude Code 只能看到並操作「你目前所在的資料夾」裡的東西。 這既是一種安全機制（它不會亂動你其他地方的檔案），也是一種工作方式（讓你的工作有組織性）。
建立第一個工作資料夾
Mac：
mkdir ~/my-ai-workspace
cd ~/my-ai-workspace
claudeWindows：
mkdir C:\workspace\my-ai-workspace
cd C:\workspace\my-ai-workspace
claude💡 ~ 是什麼？ 在 Mac 和 Linux 裡，~ 是你的「家目錄」的縮寫，也就是 /Users/你的名字/。所以 ~/my-ai-workspace 等於 /Users/你的名字/my-ai-workspace。
✅ 模組二重點複習：
- 終端機 = 文字版遙控器，不會把電腦搞壞
- Mac 安裝：一行 curl 指令搞定
- Windows 安裝：以系統管理員身分執行 PowerShell，一行指令搞定
- 認證：啟動後瀏覽器自動開啟，登入即可
- 遇到問題：對照 2.4 節的排除表格
MODULE 3：CLAUDE.md——打造你的 AI 記憶體
你可能會卡在哪裡
❓「CLAUDE.md 到底放在哪裡？」 → 3.1 節會說清楚。有三個位置，各有不同用途，但你只需要先學其中一個。
❓「我寫了，但 Claude 好像沒有讀到。」 → 最常見的原因是檔名大小寫錯了，或放錯了位置。3.6 節有排除方法。
❓「我不知道要寫什麼內容。」 → 3.4 節有三個完整的範本，直接複製修改就能用。
❓「Markdown 是什麼？語法搞不清楚。」 → 3.2 節用 2 分鐘教你所有你需要知道的 Markdown。就 4 個符號，真的很簡單。
3.1 什麼是 CLAUDE.md？
一個比喻
想像你是一個部門主管，今天來了一個新助理。這個助理非常聰明，學習能力很強——但他剛來，什麼都不知道：
- 不知道你們公司用哪個品牌的稱呼
- 不知道你的工作習慣（你喜歡報告用條列式還是段落）
- 不知道你負責哪些客戶
- 不知道你常用的格式要求
CLAUDE.md 就是你給這個新助理的「工作交接手冊」。
每一次你啟動 Claude Code，它都會先讀這份手冊，然後才開始工作。所以只要你把重要資訊寫進去，它每次工作都會記得這些偏好，不需要你每次重新解釋。
CLAUDE.md 的三種位置
| 位置 | 檔案路徑 | 作用範圍 | 適合放什麼 |
|---|---|---|---|
| 專案資料夾 | 你的工作資料夾/CLAUDE.md | 只影響這個專案 | 這個專案的特定規則、客戶資訊、格式要求 |
| 全域設定 | ~/.claude/CLAUDE.md | 影響所有專案 | 你的個人偏好、語言設定、通用習慣 |
| 個人設定 | 你的工作資料夾/CLAUDE.local.md | 這個專案，個人專用 | 個人備忘、不要和團隊共享的設定 |
💡 初學者建議：先只管「專案資料夾」裡的 CLAUDE.md。 當你在某個資料夾執行 Claude Code，它就會讀取那個資料夾裡的 CLAUDE.md。這是最直接的用法。
3.2 Markdown 超簡單入門（2 分鐘就夠）
CLAUDE.md 是用「Markdown」格式寫的。Markdown 是一種超簡單的文字排版方式，你只需要學 4 個符號：
| 符號 | 效果 | 範例 |
|---|---|---|
# 加空格 | 大標題 | # 我的工作設定 |
## 加空格 | 小標題 | ## 輸出格式要求 |
- 加空格 | 條列清單 | - 永遠用繁體中文 |
**文字** | 粗體 | **重要**：一律用繁體中文 |
就這樣。這 4 個符號就夠你寫出一份清晰的 CLAUDE.md 了。
3.3 如何建立 CLAUDE.md
方法一：讓 Claude 自動生成（最快）
啟動 Claude Code 後，輸入：
/init
Claude 會掃描你的工作資料夾，自動生成一份基本的 CLAUDE.md。
方法二：手動建立（推薦初學者，因為你會更清楚裡面有什麼）
Mac：
touch CLAUDE.md
open CLAUDE.md第一行建立空白文件，第二行用預設程式打開（通常是文字編輯器）。
Windows：
New-Item CLAUDE.md -ItemType File
notepad CLAUDE.md第一行建立空白文件，第二行用記事本打開。
然後你就可以照著 3.4 節的範本，貼上並修改成你自己的版本。
方法三：請 Claude 幫你量身打造
進入 Claude Code，輸入：
幫我建立一份適合行銷人員使用的 CLAUDE.md，
我主要負責社群媒體管理和內容創作，
公司是一家 B2B SaaS 新創，目標客戶是中小企業。
請直接幫我建立這個檔案。
Claude 會根據你的描述生成一份客製化的 CLAUDE.md 並存檔。
3.4 CLAUDE.md 寫作範本（三個完整範例）
範本一：PM（產品經理）的 CLAUDE.md
# PM 工作設定
## 關於我
我是一名 B2B SaaS 產品經理，負責企業管理系統產品線。
公司名稱：XX科技股份有限公司
主要協作對象：工程師、設計師、業務團隊、C-level 主管
## 語言與格式
- 所有輸出請用**繁體中文**
- 報告格式優先使用**條列式**，方便快速瀏覽
- 數字和日期格式：2026年3月15日、NT$100,000
- 英文專有名詞保留英文（如：Sprint、Backlog、KPI）
## 常用文件類型
- PRD（產品需求文件）：必須包含背景、目標用戶、功能需求、成功指標
- 週報：格式為「本週完成 / 下週計劃 / 卡關問題」
- 會議記錄：包含決議事項（Action Items）和負責人、截止日期
- User Story：格式為「作為一個[角色]，我希望[功能]，以便[目的]」
## 公司術語與慣例
- 我們的產品叫「OmniFlow」
- 客戶分級：S級（>5000萬）、A級（1000-5000萬）、B級（<1000萬）
- 內部代號：「北極星計劃」= 2026年旗艦功能開發
- 永遠不要說「用戶」，說「客戶」或「使用者」（視情境）
## 輸出長度偏好
- 主管報告：精簡，重點優先，不超過一頁 A4
- 技術文件：詳盡，附上範例
- 郵件草稿：專業但不冷漠，結尾加感謝語
## 我不喜歡的事
- 不要在未詢問的情況下提供多個版本讓我選（直接給最好的一個）
- 不要過度使用表情符號
- 不要說「當然！」、「很高興為您服務！」這類客服語氣的開場白範本二：行銷人員的 CLAUDE.md
# 行銷工作設定
## 關於我
我是一名行銷專員，負責內容行銷和社群媒體管理。
服務品牌：GreenLife 有機生活品牌（保養品+生活用品）
目標受眾：25-40歲都會女性，注重健康和永續生活
## 品牌語氣（非常重要！）
- **語調**：溫暖、真誠、有知識感，像一個懂生活的朋友
- **不要用**：過度促銷語氣（「限時優惠！馬上買！」）
- **可以用**：「你知道嗎」、「我們相信」、「一起」等親近感語言
- **避免詞彙**：「爆款」、「神器」、「逆天」等誇張詞
- **正面詞彙**：「自然」、「友善」、「永續」、「溫柔」、「日常」
## 各平台字數和格式要求
- Instagram：150字以內，3-5個 hashtag，要有情境感
- Facebook：200-400字，可以有更完整的故事
- LinkedIn：400-600字，偏向品牌價值和企業責任
- 電子報標題：30字以內，要有懸念或具體利益
- 電子報內文：300-500字，有引言、主體、行動呼籲（CTA）
- 官方網站文案：以 SEO 為導向，關鍵字自然融入
## 產品資訊
- 主打產品：玫瑰精華液（Rose Essence Serum）、燕麥舒緩乳霜
- 品牌核心訴求：成分透明、無有害添加物、台灣在地原料
- 價格區間：NT$380 - NT$1,580
- 官網：www.greenlife.com.tw
## 輸出要求
- 生成文案時，同時提供「主要版本」和「A/B 測試版本」（兩個標題）
- 一律提供 hashtag 建議
- 如果是中英混用，英文首字母大寫（GreenLife，不是 greenlife）
## 每次任務結束後請提醒我
- 是否需要對應的視覺設計描述（給設計師用）
- 最佳發文時間建議（如果是社群貼文）範本三：業務主管的 CLAUDE.md
# 業務工作設定
## 關於我
職稱：區域業務主管（北部）
產業：企業資訊安全解決方案
負責區域：台北、新北、桃園
管理人員：8名業務代表
## 工作重點
- 客戶關係維護與合約續約
- 新客戶開發（主要透過轉介紹和LinkedIn）
- 月度銷售預測和業績報告
- 提案簡報和合約談判支援
## 語言與溝通風格
- 所有輸出：**繁體中文**
- 對客戶的文件：正式但不失溫度
- 內部報告：直接、數字說話
- 電子郵件：專業，結尾用「敬上」或「謝謝」
## 客戶分類與術語
- 我們叫客戶「客戶」，不叫「用戶」或「買家」
- 大客戶（年合約>200萬）稱為「策略客戶」
- 中型客戶（50-200萬）稱為「重點客戶」
- 競爭對手：主要有 A公司 和 B公司，請了解我們的差異化優勢
- 我們的產品線：SecureShield 企業版、CloudGuard 雲端版
## 常用文件模板
- 拜訪記錄：日期/客戶名/聯絡人/討論重點/後續行動/預期時程
- 週報格式：本週拜訪客戶 / 機會管道更新 / 需要主管支援的項目
- 提案摘要：客戶痛點 → 我們的解決方案 → 可量化的效益 → 費用 → 時程
## 合約相關
- 標準合約期：一年，可選三年（享優惠）
- 付款條件：合約簽訂後30天付款
- 如果在合約中看到「自動續約」條款，請特別標出並提醒我
- 比較合約差異時，請特別注意：賠償條款、服務水平協議（SLA）、終止條款
## 我最常請 Claude 幫的事
1. 起草客戶拜訪前的背景調查報告
2. 比對合約新舊版差異
3. 根據會議記錄整理行動清單
4. 起草客戶提案摘要（Executive Summary）
5. 月度業績報告的文字撰寫3.5 /add-memory 快速新增記憶
在工作過程中，你可能會臨時想到「這件事我要讓 Claude 一直記得」。這時候你不需要去手動編輯 CLAUDE.md，可以直接用 /add-memory 指令：
使用方式：
在 Claude Code 的對話中輸入：
/add-memory 我們公司的 Slack 頻道命名規則是 #dept-team-purpose（例如 #mktg-social-planning）
或：
/add-memory 老闆叫 Marcus，他喜歡報告用 bullet points，不超過一頁
Claude 會把這個資訊存入你的記憶檔案，之後每次工作都會記得。
建議加入記憶的內容類型：
- 常用聯絡人的姓名和職稱
- 公司特有術語或縮寫
- 你的個人偏好（例如：「我喜歡先看結論，再看細節」）
- 重複出現的格式要求
- 特定客戶的背景資訊
3.6 常見問題排除
問題一：Claude 沒有讀到 CLAUDE.md
診斷步驟：
首先確認你的 CLAUDE.md 在正確的位置：
ls -la在 Mac 上，你應該能看到 CLAUDE.md 出現在清單中（注意：全大寫，.md 是小寫）。
最常見的錯誤：
| 錯誤 | 正確 |
|---|---|
claude.md（全小寫） | CLAUDE.md（全大寫） |
Claude.md（只有C大寫） | CLAUDE.md |
| 放在子資料夾裡 | 放在你執行 claude 指令的那個資料夾 |
CLAUDE.txt（副檔名錯誤） | CLAUDE.md |
⚠️ Mac 注意： Mac 的檔案系統預設「不區分大小寫」，所以 claude.md 和 CLAUDE.md 可能都能被讀到。但為了確保相容性（尤其是和其他系統或雲端協作時），請永遠使用全大寫 CLAUDE.md。
問題二：內容太長，Claude 好像沒有完整讀取
建議： CLAUDE.md 的長度最好控制在 500 字以內。太長的手冊反而會讓重要資訊被稀釋。
精簡原則：
- ✅ 用條列式，不用長段落
- ✅ 只寫會影響工作的規則，不要寫「介紹」或「背景故事」
- ✅ 把「偶爾用到的資訊」放在 CLAUDE.local.md 或直接在對話裡說
- ❌ 不要把整份公司介紹貼進去
- ❌ 不要重複說同一件事（如果寫了「用繁體中文」就不用再說「不要用簡體」）
問題三：多個 CLAUDE.md 的優先順序
如果你有多個 CLAUDE.md（例如專案目錄 + 全域），它們的讀取順序是：
- 專案目錄的 CLAUDE.md（最高優先）
- 專案目錄的 CLAUDE.local.md（個人專用設定，不會被分享給團隊）
~/.claude/CLAUDE.md（全域設定）
如果有衝突（例如全域說「用英文」，但專案說「用中文」），專案目錄的設定優先。另外，子資料夾中的 CLAUDE.md 也會被載入，但只在會話涉及該子資料夾時生效。
3.7 動手練習：建立你的第一個 CLAUDE.md
現在，讓我們把學到的東西實際做一遍。完成以下步驟：
第一步：確保你在正確的資料夾
cd ~/my-ai-workspace第二步：建立 CLAUDE.md
Mac：
touch CLAUDE.md
open -e CLAUDE.mdWindows：
New-Item CLAUDE.md -ItemType File
notepad CLAUDE.md第三步：貼入你的基本設定
根據你的工作性質，選擇 3.4 節的對應範本，複製後貼入，修改成符合你實際情況的版本。
至少要包含：
- 你的角色和公司背景（3-5行）
- 語言設定（一律繁體中文）
- 1-2個最常用的輸出格式偏好
第四步：儲存並測試
儲存文件後，回到終端機，啟動 Claude Code：
claude然後輸入：
請根據我的 CLAUDE.md 設定，簡單介紹你對我工作的了解。
如果 Claude 能正確引用你 CLAUDE.md 裡的資訊，代表設定成功！✅
✅ 模組三重點複習：
- CLAUDE.md = 給 AI 的工作交接手冊，放在你的工作資料夾根目錄
- Markdown 只需要學 4 個符號：
#、##、-、**粗體** - 建立方式：
/init自動生成，或手動建立 - 三種完整範本：PM、行銷、業務——直接修改使用
- 常見問題：注意檔名全大寫、放對位置
課程小結：模組 1-3 你學會了什麼
恭喜你完成了 Claude Code 課程的前三個模組！讓我們整理一下你現在已經掌握的能力：
| 模組 | 你學會的事 | 你現在能做的事 |
|---|---|---|
| 模組一 | 理解 Claude Code 和 ChatGPT 的本質差異 | 清楚知道什麼工作該用哪個工具 |
| 模組二 | 安裝和設定 Claude Code | 在你的電腦上成功啟動 Claude Code |
| 模組三 | 建立 CLAUDE.md 工作手冊 | 讓 Claude 記住你的偏好，不需要每次重新說明 |
下一步
完成了這三個模組的設定後，你已經準備好進入實際應用了。接下來的課程將教你：
- 模組四：你的第一個自動化任務——批次處理文件
- 模組五：自然語言工作流程——用中文說出你的需求
- 模組六：進階應用——整合你的日常工具
💡 給你的一個鼓勵：
技術工具最怕的不是「難」，而是「放棄」。很多人在安裝這個步驟就放棄了，因為遇到了一個紅色錯誤訊息就覺得「這不是給我用的」。
但你現在讀到這裡，代表你已經跨過了這道門檻。接下來的路，只會越來越輕鬆。
因為所有最難的「設定工作」已經在這三個模組裡完成了。從下一個模組開始，你要做的只是告訴 Claude Code 你想做什麼——然後讓它去做。
本教學文件版本：v1.0 | 最後更新：2026年2月 適用：Claude Code 1.x 版本 注意：範例中的年份（2024、2025）僅作為示範用途，請以實際工作情境的年份為準。
Claude Code 課程｜模組 4–6
白領人士的 AI 助理完全指南（第二部分）
這份教材是寫給從來沒有寫過程式的你。不需要任何技術背景，只需要一點點好奇心。
模組 4：Plan Mode 與安全操作 — 讓 AI 在你的監督下工作
你可能會卡在哪裡
在開始之前，我們先把大家最常碰到的疑惑列出來：
- 「Plan Mode 和一般模式有什麼差別？我用哪個比較好？」
- 「我很怕 Claude 會亂改我的重要檔案，怎麼辦？」
- 「我好像不知道什麼時候該用 Plan Mode，什麼時候直接叫它做就好？」
這三個問題，這個模組都會完整回答你。讀完之後，你會對 Claude Code 的操作有信心，知道「什麼能做、什麼要小心、出了問題怎麼救」。
4.1 三種操作模式——你是老闆，你來決定
Claude Code 有三種操作模式，用 Shift + Tab 鍵循環切換。每次切換，畫面左下角會顯示目前是哪個模式。
模式一：Normal Mode（一般模式）⭐ 預設模式
Claude 每做一個動作之前，都會先問你：「我打算這樣做，可以嗎？」
適合用在：
- 第一次嘗試某個新任務
- 操作重要的、不可回復的檔案（如合約、財務報表）
- 你想完全掌控每一個步驟
缺點： 速度最慢，要一直按「確認」
模式二：Auto-accept Mode（自動執行模式）
Claude 直接執行，不問你，一口氣做完。
適合用在：
- 你已經跑過這個流程好幾次，很熟悉結果
- 低風險任務（如整理草稿、格式轉換）
- 搭配 Plan Mode 使用：先用 Plan Mode 看過計劃，批准後切換到這個模式執行
缺點： 沒有中間確認步驟，萬一提示語描述不清楚，可能做出不是你要的結果
模式三：Plan Mode（計劃模式）⭐ 推薦白領使用
Claude 先把整個工作計劃寫出來給你看，你確認沒問題之後，才開始實際執行。
適合用在：
- 任何會動到多個檔案的工作
- 你想先了解 Claude 的「行動方案」再決定要不要做
- 任何你沒有把握的任務
優點： 安全、透明、你保有完整控制權
用餐廳來理解這三個模式
想像你去一家高級餐廳：
| 模式 | 就像是… |
|---|---|
| Normal Mode | 服務生每上一道菜都先問你：「這道海鮮湯可以上了嗎？主廚準備好了，確認嗎？」你一一批准，每道菜都在你掌控中，但吃一頓飯要花兩個小時。 |
| Auto-accept Mode | 你一坐下就跟服務生說：「今天完全 Chef’s choice，全部上，我不挑！」服務生點頭，菜就一道道上來了。省時省事，但萬一你對某樣食材過敏，可能來不及反應。 |
| Plan Mode | 服務生先把今晚的完整菜單、每道菜的食材、總價格都印出來給你看，你看完說「這道去掉、那道換成素食版」，確認之後服務生才進廚房開始做。 |
結論： 白領工作者，建議預設使用 Plan Mode + Auto-accept Mode 的組合：先用 Plan Mode 審核計劃，批准後切換 Auto-accept 執行。
4.2 如何使用 Plan Mode（手把手步驟教學）
完整操作流程：
Step 1：按 Shift + Tab，切換到 Plan Mode
連續按兩次 Shift + Tab，畫面左下角的模式指示會變成 PLAN，通常顯示為綠色字體。模式循環順序為：Normal → Auto-accept → Plan → Normal，所以從預設的 Normal 模式需要按兩次才會到 Plan 模式。
Step 2：用中文描述你要做的事
不需要說技術語言，就像在跟同事說話一樣：
「幫我把 Q4_sales 資料夾裡所有的 .xlsx 檔案，
整理成一份月度業績摘要，按月份排列，
輸出成一個新的 Excel 檔案叫做 Q4_summary.xlsx」
Step 3：Claude 產出一份計劃文件
Claude 不會立刻動你的檔案。它會先輸出一份類似這樣的計劃：
📋 執行計劃
目標：整理 Q4 業績摘要
步驟 1：掃描 Q4_sales 資料夾，列出所有 .xlsx 檔案
步驟 2：讀取每個檔案的工作表內容
步驟 3：從每個檔案提取「月份」、「業務姓名」、「業績金額」欄位
步驟 4：按月份分組，計算每月小計
步驟 5：生成新的 Excel 檔案 Q4_summary.xlsx，包含：
- Sheet 1：月度總表
- Sheet 2：個人業績明細
步驟 6：確認輸出檔案格式正確
預計影響的檔案：
讀取：Q4_sales/*.xlsx（10個檔案）
建立：Q4_summary.xlsx（新檔案，不覆蓋原始資料）
是否批准執行？
Step 4：你可以修改計劃
看完計劃，如果有什麼不對勁，直接用中文跟 Claude 說：
- 「步驟3改成只提取『業務姓名』和『業績金額』就好，不需要月份欄位」
- 「Sheet 2 不要了，只要 Sheet 1 的總表」
- 「輸出檔案改叫 2025_Q4_整理版.xlsx」
Claude 會根據你的指示修改計劃，再給你看一次。
Step 5：確認後，切換到 Auto-accept 模式執行
計劃確認沒問題後：
- 再按 Shift + Tab，切換到 Auto-accept Mode
- 輸入「OK，開始執行」或「照計劃執行」
- Claude 會按照計劃逐步完成任務
4.3 Plan Mode 實戰三個範例
範例一：整理會議記錄
情境： 你的 meetings 資料夾裡有 20 幾個 .txt 格式的會議記錄，你要整理成一份摘要文件。
你對 Claude 說：
「把 meetings 資料夾裡所有的 .txt 檔案整理成一份會議摘要，
按日期排列，每個會議列出：日期、與會人員、主要決議事項。
輸出成一個叫做 meetings_summary.docx 的 Word 檔」
Plan Mode 會產出的計劃（示意）：
步驟 1：列出 meetings 資料夾中的所有 .txt 檔案（共23個）
步驟 2：從每個檔案名稱或內文提取日期資訊
步驟 3：依日期從舊到新排序
步驟 4：讀取每個檔案，提取：
- 會議日期
- 與會人員名單
- 決議事項（以條列式整理）
步驟 5：生成 meetings_summary.docx，格式：
每個會議佔一頁，附上標準化標題
步驟 6：在文件最前面加上「目錄」頁
你審查計劃時要確認： ✅ 它只是「讀取」.txt 檔案，不會修改原始檔案 ✅ 輸出是新建立的 .docx 檔案 ✅ 整理格式符合你的需求
範例二：分析銷售數據
情境： 你有一份 sales_q4.csv，裡面有每位業務人員的每月銷售數字和目標值，你要算出達成率並生成圖表報告。
你對 Claude 說：
「讀取 sales_q4.csv，計算每個業務人員的目標達成率（實際/目標 × 100%），
找出前3名和後3名，
產出一份圖表報告，存成 performance_report.html，
用長條圖顯示每個人的達成率，達成率超過100%的用綠色，低於80%的用紅色」
Plan Mode 產出的計劃（示意）：
步驟 1：讀取 sales_q4.csv，確認欄位結構
步驟 2：計算每位業務的達成率 = 實際業績 / 目標業績 × 100%
步驟 3：排序，找出前3名（≥100%）和後3名（<80%）
步驟 4：建立長條圖：
- 綠色：達成率 ≥ 100%
- 黃色：達成率 80%–99%
- 紅色：達成率 < 80%
步驟 5：輸出為 performance_report.html（可在瀏覽器開啟）
預計讀取：sales_q4.csv
預計建立：performance_report.html（新檔案）
範例三：批次處理合約
情境： 你手上有 10 份 PDF 格式的合約，需要提取每份合約的關鍵條款，整理成一個比較表，方便法務或採購部門審閱。
你對 Claude 說：
「把 contracts 資料夾裡所有的 PDF 合約，
分別提取以下條款：
合約期限、付款方式、違約責任、保密條款
整理成一個 Excel 比較表，
每一列是一份合約，每一欄是一個條款類型」
Plan Mode 產出的計劃（示意）：
步驟 1：列出 contracts 資料夾中所有 PDF 檔案（共10個）
步驟 2：逐一讀取每個 PDF 的文字內容
步驟 3：從每個合約中辨識並提取：
- 合約期限（開始/結束日期）
- 付款方式（月付/季付等）
- 違約責任條款
- 保密條款內容摘要
步驟 4：建立 Excel 表格 contracts_comparison.xlsx：
欄位：合約檔名 | 合約期限 | 付款方式 | 違約責任 | 保密條款
步驟 5：每個欄位內容超過100字的自動截斷並標記「詳見原始文件」
預計讀取：contracts/*.pdf（10個檔案，唯讀）
預計建立：contracts_comparison.xlsx（新檔案）
小提醒： 掃描版 PDF（用掃描機掃進來的紙本）和純文字 PDF 的處理方式不同。遇到掃描版 PDF 無法讀取，見模組5的排除方法。
4.4 安全操作守則——保護你的重要檔案
原則一：重要工作，永遠先用 Plan Mode
任何會動到超過3個檔案的工作，任何涉及「刪除」、「覆蓋」動作的工作，都應該先走過 Plan Mode，確認計劃後再執行。
原則二：動工之前，先幫檔案拍「快照」
這是最重要的安全習慣。Git 版本控制就像幫你的資料夾拍照存檔——隨時可以回到之前的狀態，不管 Claude 做了什麼，你都有後路。
第一次使用，先做初始化（只需要做一次）：
在 Claude Code 的命令列輸入：
git init
git add .
git commit -m "備份：AI操作前的原始狀態"白話解釋：
git init：「開始幫這個資料夾拍照存檔」git add .：「把所有檔案都放進相機範圍」git commit -m "..."：「按下快門，拍一張，附上說明文字」
每次讓 Claude 做重大工作前，都執行一次：
git add .
git commit -m "備份：準備讓Claude整理Q4報表前"原則三：萬一出錯，這樣救回來
情況一：Claude 正在執行，我想喊停 → 按 Ctrl + C 立即中斷，Claude 會停在當下的步驟
情況二：Claude 已經做完了，但我不喜歡結果 → 如果你有事先做備份（git commit），輸入：
git checkout .這會把所有檔案恢復到最後一次備份的狀態。
⚠️ 注意： 這個操作會丟棄所有未備份的變更，而且無法復原。建議先輸入 git status 查看有哪些檔案被修改，確認真的要恢復後再執行。
情況三：只想恢復某一個特定檔案
→ 輸入（把 report.xlsx 換成你的檔名）：
git checkout report.xlsx原則四：了解哪些操作是安全的
| 操作類型 | 風險等級 | 建議 |
|---|---|---|
| 讀取檔案、分析內容 | ✅ 低風險 | 直接執行沒問題 |
| 建立新檔案 | ✅ 低風險 | 直接執行沒問題 |
| 修改現有檔案 | ⚠️ 中風險 | 先備份，用 Plan Mode |
| 刪除檔案 | 🔴 高風險 | 一定要先備份，仔細看計劃 |
| 批次操作多個檔案 | ⚠️ 中風險 | 先用 Plan Mode 確認範圍 |
| 存取網路、外部服務 | ⚠️ 中風險 | 確認你允許這個動作 |
4.5 常見問題排除
🔧 問題：我切換到 Plan Mode，但 Claude 還是直接執行了，沒有給我計劃
可能原因： 模式沒有切換成功，或者你的提示語太簡單（Claude 判斷不需要計劃）。
解決方法：
- 先確認左下角的模式指示是否顯示
PLAN - 在提示語前加上「用 Plan Mode，先列出計劃，不要直接執行：」
- 或者直接說：「列出執行步驟，等我確認再動作」
🔧 問題：Claude 給的計劃太模糊，我看不懂它要做什麼
可能原因： 你的原始指令不夠具體。
解決方法： 給指令時，盡量包含這四個要素：
- 從哪裡取資料（哪個資料夾、哪個檔案）
- 要做什麼處理（整理、計算、分析、轉換）
- 輸出成什麼（Excel、Word、PDF、HTML）
- 輸出檔案叫什麼名字、放在哪裡
🔧 問題：Claude 執行到一半出現錯誤，停下來了
解決方法：
- 先按 Ctrl + C 確保完全停止
- 閱讀錯誤訊息（通常是紅色字體），找關鍵詞
- 常見錯誤關鍵詞：
not found：找不到檔案 → 確認路徑是否正確permission denied：沒有權限 → 可能需要以系統管理員身份執行encoding error：編碼問題 → 見模組5的中文亂碼解法
- 把錯誤訊息直接貼給 Claude：「我遇到這個錯誤，請幫我找原因：[貼上錯誤]」
模組 5：文件自動化 — 讓 AI 幫你處理日常文件
你可能會卡在哪裡
- 「Claude 一直說找不到我的檔案，但我明明把檔案放在那裡了」
- 「我的檔名是中文，它好像讀不到，或輸出出來是亂碼」
- 「Claude 幫我輸出的 Excel，打開來格式全部都跑掉了」
- 「不知道怎麼告訴 Claude 我的檔案在哪裡」
這些問題其實都有解，而且解法都不難。這個模組會一次說清楚。
5.1 理解「工作目錄」概念——Claude 的視野範圍
Claude Code 的視野是有邊界的
把 Claude Code 想像成你辦公室裡的一位助理。你告訴他「去把那份報告拿過來」，他能走到的地方，只有你帶他進去的那間辦公室。他沒辦法自己去別的樓層、別的部門找東西。
Claude Code 只能看到你「啟動它時所在的資料夾」以及這個資料夾裡面的所有子資料夾。
如何確認你在哪個資料夾？
在 Claude Code 的命令列輸入：
Mac / Linux：
pwd會顯示類似：/Users/gary/Documents/工作專案
Windows：
cd會顯示類似：C:\Users\gary\Documents\工作專案
如何讓 Claude 看到不同資料夾？
方法一：在正確的資料夾啟動 Claude Code
在 Terminal（終端機）先用 cd 指令進到你要操作的資料夾，再啟動 Claude Code：
cd /Users/gary/Documents/Q4_Reports
claude方法二：使用 —add-dir 旗標（進階） 如果你已經在某個資料夾，想讓 Claude 同時看得到另一個資料夾：
claude --add-dir /Users/gary/Desktop/合約資料夾方法三：直接告訴 Claude 完整的路徑 在你的提示語裡，直接說明完整路徑：
「讀取 /Users/gary/Documents/Sales/Q4_data.xlsx，整理成摘要」
路徑基礎知識（不需要背，看懂就好）
| 概念 | 說明 | 範例 |
|---|---|---|
| 絕對路徑 | 從根目錄開始的完整路徑，從頭說到尾 | C:\Users\gary\Documents\報告.xlsx |
| 相對路徑 | 從「目前所在位置」開始計算的路徑 | reports\Q4\報告.xlsx（如果你已經在 Documents 裡） |
Mac 的資料夾位置常見範例：
- 桌面：
/Users/你的名字/Desktop - 文件：
/Users/你的名字/Documents - 下載：
/Users/你的名字/Downloads
Windows 的資料夾位置常見範例：
- 桌面：
C:\Users\你的名字\Desktop - 文件：
C:\Users\你的名字\Documents - 下載：
C:\Users\你的名字\Downloads
中文路徑問題與解法
問題： 有些工具在處理路徑含有中文字的資料夾時，會出現亂碼或找不到檔案的問題。
建議解法：
-
最簡單的方法： 在桌面或 C:\ 根目錄建立一個純英文名稱的工作資料夾，例如
AI_Work，把要操作的檔案複製進去再讓 Claude 處理。 -
如果一定要用中文路徑： 在 Terminal 輸入路徑時，把路徑用引號包起來：
cd "/Users/gary/Documents/我的工作資料夾" -
中文檔名的建議： 盡量使用英文或數字的檔名，或者在中文前後加上底線，例如
2025_Q4_銷售報表.xlsx。Claude 對英文檔名的支援最穩定。
5.2 五種常見文件處理任務——照著做就對了
任務一：PDF 轉文字摘要
情境： 老闆給你一份30頁的年度報告 PDF，要你今天下班前整理出摘要。
提示語範本：
「讀取 annual_report_2025.pdf，整理出一份200字以內的重點摘要，
用條列式格式，包含：主要業績數字、核心策略方向、主要風險事項，
輸出成 summary.txt 文字檔」
Claude 的執行步驟：
- 開啟並讀取 PDF 的文字內容
- 分析文件結構，辨識關鍵段落
- 提取你指定的三個面向的資訊
- 整理成條列式格式，控制在200字以內
- 輸出為 summary.txt
預期輸出範例：
annual_report_2025 摘要
【主要業績數字】
• 全年營收：NT$28億（年增12%）
• 淨利率：8.3%（去年7.1%）
• 新客戶數：1,240家
【核心策略方向】
• 深化東南亞市場布局
• 加速數位轉型，推行ERP升級
【主要風險事項】
• 匯率波動對出口業務影響
• 原物料成本上升壓力
常見錯誤與解法：
⚠️ 「無法讀取 PDF」 這份 PDF 可能是「掃描版」——也就是用掃描機把紙本掃進電腦的，實際上是一張圖片，不是文字檔。Claude Code 本身無法讀取圖片裡的文字。
解法： 先用 Adobe Acrobat、或免費工具 iLovePDF（https://www.ilovepdf.com）把「掃描版 PDF」做 OCR 轉換（轉成可選取文字的版本），再讓 Claude 處理。
任務二：批次處理多個發票 PDF
情境： 財務部請你把這個月收到的50張 PDF 發票，整理成一份 Excel 對帳表。
提示語範本：
「把 invoices 資料夾裡所有的 PDF 檔案，
逐一提取：發票號碼、開立日期、廠商名稱、含稅金額，
整理成 Excel 表格，存為 invoice_list_2025_12.xlsx。
如果某個欄位在特定發票裡找不到，那格填入『請手動確認』」
Claude 的執行步驟：
- 掃描 invoices 資料夾，列出所有 PDF 檔案
- 逐一讀取每份發票
- 用自然語言理解辨識4個關鍵欄位
- 建立 Excel 表格，每一列一張發票
- 無法辨識的欄位填入「請手動確認」
建議的 Excel 輸出格式：
| 檔案名稱 | 發票號碼 | 開立日期 | 廠商名稱 | 含稅金額 |
|---|---|---|---|---|
| inv_001.pdf | AB-20251201 | 2025/12/01 | 誠品文具 | 15,400 |
| inv_002.pdf | CD-20251203 | 2025/12/03 | 請手動確認 | 8,900 |
小技巧： 最後那個「請填入『請手動確認』」的指示非常重要！這樣你拿到表格後，可以快速用 Ctrl+F 搜尋「請手動確認」，知道哪些地方需要人工補充。
任務三：Word 範本 + 資料自動生成個人化文件
情境： 你有一份感謝信的 Word 範本，以及一份包含100位客戶姓名、公司、產品資訊的 CSV，你想為每位客戶自動生成一封個人化信件。
提示語範本：
「讀取 thank_you_template.docx 作為信件範本，
讀取 customers.csv（欄位：姓名、公司名稱、購買產品、購買日期），
為每位客戶生成一封個人化感謝信，
其中 [客戶姓名]、[公司名稱]、[購買產品]、[購買日期] 用對應資料替換，
每封信存成獨立的 .docx 檔案，
檔名格式：感謝信_[姓名]_[日期].docx，
全部放在 output 資料夾裡」
Claude 的執行步驟：
- 讀取 Word 範本，辨識所有需要替換的 [佔位符]
- 讀取 customers.csv，確認欄位對應
- 逐筆處理：每一列客戶資料 → 生成一封信
- 輸出100個獨立的 .docx 檔案到 output 資料夾
事先準備範本的訣竅： 你的 Word 範本裡，把需要替換的地方用方括號標記，例如：
親愛的 [客戶姓名] 先生/女士，
感謝您所在的 [公司名稱] 於 [購買日期] 選購了我們的 [購買產品]。
任務四：CSV / Excel 資料分析與視覺化
情境： 你有一份業務月報 Excel，老闆下週要看各業務的達成率分析。
提示語範本：
「讀取 sales_report_2025.xlsx（工作表名稱：月報），
計算每位業務的目標達成率（業績/目標×100%），
找出本月業績最好的前5名和後5名，
生成一份視覺化分析報告 performance_chart.html：
- 上方：排名前5的業務長條圖（綠色系）
- 下方：排名後5的業務長條圖（橘色系）
- 圖表標題：2025年12月業務達成率分析
- 每根長條上方標示百分比數字」
預期輸出： 一個可以在 Chrome 瀏覽器直接開啟的 HTML 互動式圖表，雙擊 performance_chart.html 就能看到漂亮的視覺化報告。
任務五：Email 草稿批次生成
情境： 要針對300位潛在客戶發送個人化的產品推薦 Email，每個人的推薦產品、公司規模、行業別都不同。
提示語範本：
「讀取 prospect_list.csv，欄位包含：
姓名、公司名稱、行業別、公司規模、感興趣的產品類別
為每位潛在客戶生成一封個人化的推薦 Email 草稿：
- 第一段：依行業別提到相關的行業痛點
- 第二段：推薦最符合他們需求的產品（依感興趣的產品類別）
- 第三段：依公司規模調整語氣（大型企業用正式語氣，小型企業用輕鬆語氣）
- 結尾：邀請預約15分鐘線上說明
每封 email 存成一個獨立的 .txt 檔案，
檔名：draft_[姓名]_[公司名稱].txt，
全部放在 email_drafts 資料夾」
Claude 完成後你需要做的：
- 開啟 email_drafts 資料夾，隨機抽查幾封確認品質
- 如果發現某種類型的草稿品質不好，告訴 Claude「行業別是製造業的這幾封感覺太制式，請參考 draft_王大明_ABC公司.txt 的風格重新生成」
- 批量確認後，再複製貼上到你的郵件系統發送
5.3 檔案命名與組織最佳實踐
在讓 Claude Code 處理文件之前，養成好的檔案組織習慣，可以大幅減少「找不到檔案」的問題。
推薦的資料夾結構
AI_Work/ ← 主要工作資料夾（英文命名）
├── input/ ← 所有要讓Claude處理的「原始檔案」
│ ├── invoices/ ← 發票PDFs
│ ├── contracts/ ← 合約PDFs
│ └── data/ ← Excel、CSV等資料檔
├── output/ ← Claude生成的「結果檔案」
│ ├── 2025_12_reports/ ← 按日期或專案分資料夾
│ └── templates_generated/ ← 批次生成的文件
├── templates/ ← 你的Word/Excel範本
└── archive/ ← 舊版本或處理完的原始檔案
檔案命名建議
| 建議 | 說明 | 範例 |
|---|---|---|
| 使用英文或數字 | 避免路徑問題 | Q4_sales_report.xlsx |
| 加上日期 | 方便排序和辨識 | 20251201_meeting_notes.txt |
| 避免空格 | 用底線或連字號取代 | annual_review.pdf 而非 annual review.pdf |
| 版本號放在最後 | 方便辨識最新版 | contract_v2.docx、contract_final.docx |
5.4 常見問題排除
🔧 問題：「找不到檔案」（File not found）
這幾乎都是路徑問題。按照這個順序排查：
- 確認 Claude 目前在哪個目錄：輸入
pwd（Mac）或cd（Windows） - 確認你的檔案實際上在哪裡（用 Finder 或 File Explorer 確認）
- 如果兩個位置不一樣，用
cd切換到正確的資料夾，再試一次 - 或者在提示語裡使用完整的絕對路徑：
「讀取 /Users/gary/Desktop/report.pdf」
🔧 問題：輸出的中文全部都是亂碼（□□□ 或 ????）
這是「文字編碼」問題。不同系統和軟體對中文的編碼方式不同。
解法： 在提示語裡明確指定編碼：
「輸出的文字檔案請使用 UTF-8 編碼（不要用BOM版本的UTF-8）」
如果是 Excel 開啟 CSV 出現亂碼：
「輸出的 CSV 請使用 UTF-8-BOM 編碼，這樣 Excel 可以正確顯示中文」
🔧 問題：PDF 無法讀取
先判斷你的 PDF 是哪種類型：
- 文字版 PDF： 打開 PDF 後，可以用滑鼠選取文字、可以複製貼上 → Claude 可以直接讀取
- 掃描版 PDF： 打開 PDF 後，文字選不起來、看起來像照片 → 需要先做 OCR 轉換
掃描版 PDF 的解法：
- 使用 Adobe Acrobat 的「辨識文字」功能（OCR）
- 或使用免費線上工具：iLovePDF（https://www.ilovepdf.com/ocr-pdf）
- 轉換後再讓 Claude 處理
🔧 問題：Excel 輸出來格式全部都跑掉了
解法一： 明確指定 Excel 格式版本
「輸出為 .xlsx 格式（Excel 2016以上版本相容）」
解法二： 指定需要保留的格式細節
「保留表頭的粗體格式，金額欄位使用千分位格式（如 1,234,567），
日期欄位格式為 YYYY/MM/DD」
解法三： 先輸出 CSV 確認資料對了，再要求轉換格式
「先輸出 CSV 版本，讓我確認資料正確後，再告訴你轉成 Excel」
5.5 沙盒實戰練習 — 用假資料動手做
📂 在開始之前： 請先下載並解壓縮「
sandbox-practice.zip」練習資料包。裡面的所有資料都是假的，你可以放心操作、隨便搞壞都沒關係——重新解壓縮就能恢復原狀。接下來的每一個練習，都會用到這個資料包裡的檔案。請在終端機裡先
cd進入解壓縮後的資料夾：cd sandbox-practice
練習 A：Excel 資料分析 — 業績報表篩選與摘要
使用檔案： 01-Excel練習/2025年度業績報表.xlsx
檔案內容說明： 這份 Excel 包含 2025 年全年度業務部的月業績資料，共約 146 筆記錄。欄位有：月份、業務員、區域、產品、成交數、營收（萬）、成本（萬）、毛利率。
任務目標： 讓 Claude 幫你分析哪些業務員表現最好、哪些區域營收最高。
Step 1：先看看資料長什麼樣子
在 Claude Code 裡輸入：
「讀取 01-Excel練習/2025年度業績報表.xlsx，
告訴我這份資料有幾筆記錄、欄位有哪些、資料的時間範圍」
💡 為什麼先這樣做？ 在讓 AI 做任何分析之前，先確認它「看到」的資料跟你預期的一樣。如果它把標題列當成資料、或者欄位名稱抓錯了，後面的分析就會全部歪掉。
Step 2：做基本的業績分析
確認資料沒問題後，輸入：
「用 01-Excel練習/2025年度業績報表.xlsx 這份資料，幫我做以下分析：
1. 計算每位業務員的全年度總營收，按照金額從高到低排名
2. 計算每個區域（北區、中區、南區、東區）的總營收佔比
3. 找出毛利率最高的前5筆交易
結果輸出成一份新的 Excel 檔案 業績分析結果.xlsx，
裡面有三個分頁：『業務員排名』、『區域分析』、『高毛利交易』」
你應該會看到的結果：
- Claude 讀取了原始 Excel，辨識出標題列在第3行
- 自動用 pandas 做了樞紐分析
- 產出了一份包含三個分頁的新 Excel
Step 3：加碼挑戰——生成視覺化圖表
「根據剛才的分析結果，生成一份 HTML 視覺化報告 業績儀表板.html，包含：
- 各業務員年度營收的水平長條圖（從高到低）
- 四個區域營收佔比的圓餅圖
- 每月營收趨勢的折線圖
圖表標題和標籤用繁體中文」
練習 B：Excel 資料分析 — 出勤異常偵測
使用檔案： 01-Excel練習/2025年1月出勤紀錄.xlsx
檔案內容說明： 12 位員工一整個月的出勤打卡紀錄，共 276 筆。欄位：日期、姓名、部門、上班打卡、下班打卡、遲到(分鐘)、加班(小時)、備註。
任務目標： 找出遲到次數最多的人、加班最多的部門，並生成一份出勤摘要報告。
在 Claude Code 裡輸入：
「讀取 01-Excel練習/2025年1月出勤紀錄.xlsx，幫我做出勤分析：
1. 統計每位員工的遲到次數和總遲到分鐘數，列出遲到超過3次的人
2. 統計每個部門的平均加班時數
3. 找出有「備註」欄位不為空的紀錄（通常是請假或特殊情況）
輸出成 出勤分析_2025年1月.xlsx，
包含三個分頁：『遲到統計』、『加班統計』、『特殊紀錄』」
💡 職場實用情境： 如果你是 HR 或部門主管，每個月都要做出勤彙整。這個過程一旦用 Claude 跑通一次，以後每個月只要換一份新的出勤 Excel 進來就能自動產出報告。
練習 C：Excel 資料清洗 — 客戶名單整理
使用檔案： 01-Excel練習/客戶名單2025.xlsx
檔案內容說明： 20 家客戶的資料，欄位：客戶編號、公司名稱、聯絡人、職稱、電話、Email、地區、合約狀態、年營收(萬)、最後聯繫日。
任務目標： 清洗資料並產出兩份實用的輸出——需要跟進的客戶清單，以及到期提醒。
在 Claude Code 裡輸入：
「讀取 01-Excel練習/客戶名單2025.xlsx，幫我做以下處理：
1. 找出合約狀態為『即將到期』或『已過期』的客戶，
列出公司名稱、聯絡人、Email、合約狀態
2. 找出『最後聯繫日』距離今天超過180天的客戶（太久沒聯繫的）
3. 按照地區分組，統計每個地區的客戶數量和平均年營收
輸出成 客戶追蹤清單.xlsx，包含三個分頁：
『合約到期提醒』、『需要回訪』、『地區分析』」
練習 D：Excel 費用分析 — 報銷審核輔助
使用檔案： 01-Excel練習/2025年Q1費用報銷.xlsx
檔案內容說明： Q1 季度約 96 筆費用報銷紀錄。欄位：日期、申請人、部門、費用類別、說明、金額、發票號碼、審核狀態。
在 Claude Code 裡輸入：
「讀取 01-Excel練習/2025年Q1費用報銷.xlsx，幫我做費用分析：
1. 按照費用類別（差旅費、交際費、辦公用品等）統計 Q1 總金額
2. 按照部門統計每個部門的報銷總額
3. 找出審核狀態為『待審核』的項目清單
4. 找出金額超過 10,000 的大額報銷明細
輸出成 Q1費用分析報告.xlsx，
包含四個分頁：『類別統計』、『部門統計』、『待審核清單』、『大額明細』。
類別統計那頁，金額數字用千分位格式，最後加一列總計」
💡 小技巧： 注意這個提示語的最後一句——「金額數字用千分位格式，最後加一列總計」。這種格式要求可以在提示語裡直接寫清楚，Claude 就會照做。不需要你自己去 Excel 裡調格式。
練習 E：Word 文件批次處理 — 會議紀錄摘要彙整
使用檔案： 02-Word文件練習/ 資料夾（6 份會議紀錄 + 4 份備忘錄）
檔案內容說明：
會議紀錄_20250114_年度預算規劃.docx— 1月年度預算規劃會議會議紀錄_20250306_客戶回饋分析.docx— 3月客戶回饋分析會議會議紀錄_20250324_行銷活動檢討.docx— 3月行銷活動檢討會議會議紀錄_20250412_Q4業績檢討.docx— 4月Q4業績檢討會議會議紀錄_20250418_跨部門協作流.docx— 4月跨部門協作流程會議會議紀錄_20250421_新產品上市策.docx— 4月新產品上市策略會議 （檔名被截斷是刻意模擬的，因為某些系統會限制檔名長度）- 另有 4 份公司備忘錄
任務目標： 一次讀完 6 份會議紀錄，提取所有「決議事項」和「待辦事項」，彙整成一張追蹤清單。
Step 1：先讓 Claude 預覽所有檔案
「讀取 02-Word文件練習/ 資料夾裡所有的 .docx 檔案，
列出每個檔案的檔名和前100個字的預覽」
Step 2：批次提取關鍵資訊
「讀取 02-Word文件練習/ 裡所有開頭是『會議紀錄』的 .docx 檔案，
從每一份文件中提取以下資訊：
- 會議日期
- 會議主題
- 主要出席者
- 決議事項（條列）
- 待辦事項（包含負責人和期限，如果文件中有寫的話）
把結果整理成一份 Excel 表格 會議追蹤總表.xlsx：
- 分頁1『會議摘要』：每一列是一場會議，欄位是上面提到的各項資訊
- 分頁2『所有待辦事項』：匯整所有會議的待辦事項，包含來源會議、負責人、內容、期限、完成狀態（預設填『未完成』）」
💡 這就是文件自動化的威力： 如果你每個月有 10-20 場會議，手動整理這些資訊要花好幾個小時。用 Claude 只要幾分鐘就能產出一份結構化的追蹤清單。
Step 3（加碼）：生成一份 Word 摘要文件
「根據剛才提取的六份會議紀錄內容，
生成一份 Word 文件 2025年Q1會議摘要總報告.docx，格式如下：
標題：2025年 Q1 會議摘要總報告
每場會議一個段落，包含：
- 會議名稱（粗體）
- 日期
- 重點摘要（3-5句話）
- 關鍵決議
最後附上一個『所有待辦事項追蹤表』的表格」
練習 F：PDF 合併 — 多區域月報整合
使用檔案： 03-PDF合併練習/ 資料夾（8 份 PDF 月報）
檔案內容說明：
月報_2025年1月_北區.pdf、月報_2025年1月_中區.pdf、月報_2025年1月_南區.pdf、月報_2025年1月_東區.pdf月報_2025年2月_北區.pdf、月報_2025年2月_中區.pdf、月報_2025年2月_南區.pdf、月報_2025年2月_東區.pdf
任務目標： 練習用不同方式合併 PDF——按月份、按區域、或全部合在一起。
Step 1：按月份合併
「把 03-PDF合併練習/ 資料夾裡的 PDF 檔案，按照月份合併：
- 2025年1月的四個區域合成一份：合併月報_2025年1月.pdf
- 2025年2月的四個區域合成一份：合併月報_2025年2月.pdf
合併順序：北區 → 中區 → 南區 → 東區」
Step 2：按區域合併
「同樣的 PDF 檔案，這次按照區域合併：
- 北區兩個月合成一份：合併月報_北區.pdf
- 中區兩個月合成一份：合併月報_中區.pdf
- 南區、東區也各合一份
合併順序：1月 → 2月」
Step 3（加碼）：合併後加上目錄
「把 03-PDF合併練習/ 裡的全部8份 PDF 合併成一份 2025年Q1完整月報.pdf，
順序是：1月北區、1月中區、1月南區、1月東區、2月北區...
在第一頁加上一個簡單的目錄，列出各份報告對應的頁碼」
💡 職場實用情境： 每個月各分公司各交一份報告，你要合併成一份呈給老闆。手動用 Adobe Acrobat 要一個一個拖拉排序，用 Claude 一句話搞定。
練習 G：批次改檔名 — 中文檔名翻譯與標準化
使用檔案： 04-批次改檔名練習/ 資料夾（25 個中文檔名的 .txt 檔案）
檔案內容說明： 25 個中文命名的檔案，模擬辦公室裡常見的各種文件：
第一季業績總表.txt、第二季業績總表.txt…合約範本_保密協定.txt、合約範本_勞動合約.txt…員工通訊錄（最新版）.txt出差申請表（空白）.txt請假單（範本）.txt- …等等
任務目標： 批次將中文檔名改成英文命名 + 統一格式。
Step 1：先看看現在有哪些檔案
「列出 04-批次改檔名練習/ 資料夾裡所有的檔案名稱」
Step 2：批次重新命名
「把 04-批次改檔名練習/ 裡面的所有檔案批次重新命名，規則如下：
1. 檔名翻譯成英文（用底線取代空格）
2. 所有字母小寫
3. 去掉括號和特殊符號
4. 檔名前面加上日期前綴 2025_
例如：
- 第一季業績總表.txt → 2025_q1_sales_summary.txt
- 合約範本_保密協定.txt → 2025_contract_template_nda.txt
- 員工通訊錄（最新版）.txt → 2025_employee_directory_latest.txt
執行前先列出新舊檔名的對照表讓我確認，
我同意後再實際執行重新命名」
⚠️ 注意最後那句「執行前先列出對照表」！ 批次改檔名是有風險的操作——萬一改錯了，要一個一個改回來很麻煩。養成習慣：讓 Claude 先「預覽」它要做什麼，你確認後再執行。這就是模組4學到的「Plan Mode 思維」。
Step 3（加碼）：生成改名對照記錄
「把剛才的新舊檔名對照表，輸出成 rename_log.csv，
欄位：原始檔名、新檔名、改名日期」
模組 6：工作流程自動化 — 從手動到全自動
你可能會卡在哪裡
- 「我不知道我的哪些工作可以自動化，好像什麼都可以又什麼都不確定」
- 「自動化流程跑到一半中斷了，我不知道從哪裡繼續、出了什麼問題」
- 「我聽說可以做定時自動執行，但完全不知道怎麼設定」
這個模組會幫你建立「自動化思維」，並且帶你從零到一建立你的第一個自動化工作流。
6.1 自動化思維：哪些工作適合交給 AI？
不是所有工作都適合自動化。用這個檢核清單，快速判斷一項工作是否值得自動化：
✅ 適合自動化的工作特徵
| 特徵 | 說明 | 舉例 |
|---|---|---|
| 重複性高 | 每天、每週、每月都要做同樣的事 | 每週一匯出上週的銷售報表 |
| 規則明確 | 有固定的步驟和格式，不需要主觀判斷 | 把A格式的資料轉成B格式 |
| 資料來源固定 | 每次都從同一個地方取資料 | 永遠從同一個 ERP 匯出的 CSV |
| 輸出格式固定 | 每次產出的報告格式都一樣 | 固定格式的週報、月報 |
❌ 不適合（或需要謹慎）的工作特徵
| 特徵 | 說明 |
|---|---|
| 需要深度主觀判斷 | 例如：評估一個提案的策略價值、決定是否投資某個市場 |
| 需要敏感資訊保護 | 含有個人隱私、商業機密的資料（確認你的資料安全政策） |
| 結果差錯代價很高 | 財務申報、法律合約的最終版本（AI 可以幫忙準備，但最終需要人工確認） |
| 需要即時人際互動 | 談判、說服、建立關係的工作 |
不同職位的自動化機會
專案經理（PM）：
- 每週五下午自動整理這週的 Sprint 進度報告
- 每個 Sprint 結束後自動生成回顧報告模板
- 每天早上自動匯整各個 Jira 看板的狀態更新
行銷人員：
- 每天早上蒐集競品的社群媒體發文，整理成摘要
- 每週一整理上週的廣告數據，計算各渠道 ROI
- 每月初自動生成月度行銷報告初稿
業務人員：
- 每月初從 CRM 匯出數據，生成個人業績報告
- 每週為所有待跟進的客戶生成個人化的跟進郵件草稿
- 每季統計客戶拜訪次數、成交率等 KPI
人資（HR）：
- 每週整理招募漏斗數據（收到多少履歷、面試幾位、錄取幾位）
- 定期更新員工培訓記錄摘要
- 新員工入職時自動生成第一週的 onboarding 清單
財務：
- 每月底自動整理費用申請單，生成分類統計表
- 每週匯整各部門的預算使用率
- 每季生成標準格式的財務摘要報告
6.2 Custom Slash Commands（自訂快捷指令）
什麼是 Custom Slash Commands？
你可以建立屬於自己的「快捷指令」，把一個常用的複雜任務壓縮成一個簡短的指令。
舉例：
- 以前你要打一大段描述才能讓 Claude 生成週報
- 有了自訂指令，你只需要輸入
/weekly-report或/週報 - Claude 就知道你要做什麼，直接執行
快捷指令的存放位置
你的自訂指令存放在這個路徑（如果資料夾不存在，要先建立它）：
你的工作資料夾/
└── .claude/
└── commands/
├── weekly-report.md ← 每個指令是一個 .md 文字檔
├── email-draft.md
└── meeting-summary.md
注意：
.claude是一個隱藏資料夾（名稱以點號開頭）。在 Mac 上，按 Command + Shift + . 可以顯示隱藏資料夾。在 Windows 上，在 File Explorer 裡勾選「顯示隱藏的項目」。
如何建立你的第一個自訂指令（步驟教學）
Step 1：在你的工作資料夾建立 .claude/commands/ 目錄
在 Claude Code 裡輸入：
mkdir -p .claude/commandsStep 2：建立指令文件
請 Claude 幫你建立：
「在 .claude/commands/ 資料夾裡，
建立一個叫做 weekly-report.md 的檔案，
內容是讓我可以用 /weekly-report 指令，
自動整理本週的工作進度報告的指令模板」
Step 3：使用你的指令
建立好之後，在 Claude Code 裡輸入 /weekly-report，Claude 就會按照你設定的模板執行。
三個實用自訂指令範本
指令一：自動生成週報 /weekly-report
檔案路徑： .claude/commands/weekly-report.md
檔案內容：
# 週報生成指令
讀取以下來源，生成本週工作進度週報：
1. 讀取 daily_logs/ 資料夾中本週（週一到週五）的所有 .txt 工作日誌
2. 讀取 tasks.csv 中這週「已完成」的任務清單
3. 讀取 meetings/ 資料夾中本週的會議記錄
生成格式：
## 本週工作進度報告 [自動填入日期範圍]
**本週完成事項：**
[條列式，從各來源整理]
**進行中事項：**
[從tasks.csv中「進行中」的任務提取]
**下週計劃：**
[留空，等我手動填寫]
**需要注意的事項：**
[從會議記錄中提取需要追蹤的事項]
輸出為 reports/weekly_report_[本週日期].docx指令二：Email 草稿生成 /email-draft
檔案路徑： .claude/commands/email-draft.md
檔案內容：
# Email 草稿生成指令
用法：/email-draft [收件人名稱] [Email目的]
步驟：
1. 從 contacts.csv 查找 $ARGUMENTS 中提到的收件人資料
2. 根據他們的公司、職位、過去往來記錄（contacts_notes.txt）
3. 根據指定的 Email 目的（感謝/跟進/提案/邀請會議）
4. 生成一封個人化的 Email 草稿
格式要求：
- 繁體中文，語氣依職位調整（主管較正式，同級較輕鬆）
- 主旨行精簡有力（20字以內）
- 正文3段：開場、主題、收尾
- 結尾附上預設簽名檔（從 email_signature.txt 讀取）
輸出：在畫面上顯示草稿，詢問是否需要修改使用方式： 輸入 /email-draft 陳總監 邀請下週進行Q1業績檢討會議
指令三：會議記錄整理 /meeting-summary
檔案路徑： .claude/commands/meeting-summary.md
檔案內容：
# 會議記錄整理指令
用法：/meeting-summary $ARGUMENTS
（$ARGUMENTS = 會議記錄的檔案名稱，例如：/meeting-summary 20251215_q4_review.txt）
步驟：
1. 讀取指定的會議記錄檔案
2. 整理出以下結構：
---
會議摘要
日期：[從檔案提取]
與會人員：[從內文提取]
會議時長：[從內文提取，如果有的話]
**討論重點：**
[3-5個主要討論點，條列式]
**決議事項：**
[明確決定的事項，條列式]
**待辦事項：**
| 負責人 | 待辦事項 | 期限 |
|-------|---------|-----|
[從會議記錄中提取，如果有明確指派的話]
**下次會議：**
[如果有提到的話]
---
輸出：存成 meetings/summaries/[原檔名]_summary.docx，
並在畫面上顯示預覽使用方式： 輸入 /meeting-summary 20251215_q4_review.txt
關於 $ARGUMENTS
$ARGUMENTS 是一個特殊的佔位符，代表你在使用指令時輸入的「額外參數」。
例如：
- 你的指令是
/email-draft - 你輸入
/email-draft 陳總監 邀請開會 - 那麼
$ARGUMENTS的值就是「陳總監 邀請開會」 - Claude 會把這個資訊帶入指令模板中使用
這讓你的一個指令可以靈活應對不同情況，不需要為每個人、每種場景各建一個指令。
6.3 建立你的第一個自動化工作流（完整實戰）
我們要從零到一，建立一個真實的自動化工作流：每週五自動整理專案進度報告。
案例背景
你是一位專案經理，每週五下午都要做同一件事：
- 從 Jira 或 Google Sheets 的任務清單確認本週完成了什麼
- 查看本週的會議記錄，找出重要決議
- 查看有沒有未解決的問題或阻礙
- 整理成一份格式固定的週報，發給老闆和客戶
這個任務每週要花你 60–90 分鐘。讓我們把它壓縮到 5 分鐘。
Step 1：設計工作流程（用 Plan Mode）
先不要急著做，用 Plan Mode 設計整個流程：
在 Plan Mode 下輸入：
「我想建立一個每週五自動生成專案進度週報的工作流程。
資料來源：
- tasks.csv（每列是一個任務，欄位：任務名稱、負責人、狀態、週次）
- meetings/ 資料夾裡的週會記錄（.txt 格式）
- issues.txt（已知問題和阻礙的列表）
輸出：weekly_report_[日期].docx，格式固定如下：
- 本週完成事項
- 進行中事項
- 重要決議（從週會記錄提取）
- 目前風險與阻礙
- 下週計劃
請先幫我設計整個工作流程，列出步驟，不要直接執行」
Claude 會給你一份計劃，你可以在這個階段調整細節。
Step 2：建立 Custom Command
計劃確認後，請 Claude 把這個流程存成一個可重複使用的指令：
「根據剛才的計劃，在 .claude/commands/ 資料夾裡
建立一個叫做 weekly-report.md 的指令文件，
這樣我以後每週只需要輸入 /weekly-report 就可以執行這個流程」
Claude 會建立這個文件，並告訴你內容是什麼。
Step 3：測試執行
準備好一些測試資料（可以用真實本週的資料），然後：
/weekly-report
看看輸出結果是否符合你的期望。
第一次執行後，你可能需要微調：
- 「報告的摘要寫太長了，每個段落控制在100字以內」
- 「下週計劃這段，自動從 tasks.csv 裡過濾出下週的任務」
- 「輸出格式改成 .pdf 而不是 .docx」
把這些微調的要求告訴 Claude，請它更新 weekly-report.md 指令文件。
Step 4：調整優化
跑了幾週之後，你可能會發現：
- 某個欄位每次都需要手動修改 → 把這個修改邏輯寫進指令
- 某些任務的狀態判斷規則需要更清楚 → 在指令裡加上判斷規則說明
- 報告要寄給不同的人，格式略有不同 → 建立多個版本的指令（
/weekly-report-boss、/weekly-report-client）
優化的心態： 第一版不需要完美，能跑起來就是勝利。每用一次就改善一點，三個月後這個工作流就會變成你的超級助理。
讓整個流程更完整：加入版本控制
在你的工作資料夾初始化 Git 備份，這樣每週執行前都有備份點：
在 Claude Code 裡輸入：
「幫我建立一個簡單的備份流程：
每次執行 /weekly-report 之前，自動做一次 git commit，
commit 訊息是『週報生成前備份 [今天日期]』」
6.4 常見問題排除
🔧 問題：輸入 /weekly-report，Claude 說找不到這個指令
排查清單：
- 確認
.claude/commands/weekly-report.md這個檔案存在 - 確認你目前的工作目錄是包含
.claude資料夾的那個目錄（用pwd確認） - 指令名稱要和檔案名稱完全一致，大小寫也要一樣
- 在 Claude Code 裡重新啟動（關掉再開一次），有時候新建的指令需要重啟才能載入
🔧 問題：指令執行了，但輸出結果和我期望的完全不一樣
原因： 指令模板的描述不夠具體或有歧義。
解法：
- 直接查看
.claude/commands/裡的指令文件內容 - 找到可能有歧義的地方，用更明確的語言重寫
- 加入「範例輸出」在指令文件裡，讓 Claude 有參照範本：
# 預期輸出範例：
本週完成事項：
• 完成 A 客戶提案文件（負責人：王大明）
• 召開 Q4 預算審查會議（決議：預算維持不變）
...🔧 問題：流程跑到一半中斷了，不知道做到哪裡了
這是「長流程任務」最常碰到的問題。建立「斷點續做」的能力：
方法一：在指令裡加入狀態追蹤 在你的指令文件裡加上這段：
執行前：先檢查 output/ 資料夾，如果已經有部分輸出，
從最後一個成功處理的檔案繼續，不要重複處理已完成的項目。
執行後：輸出一份 process_log.txt，記錄每個步驟的完成時間和結果。方法二：分批執行 如果任務很大（例如處理100個檔案），請 Claude 分批做：
「先處理 invoices 資料夾裡的前20個檔案，完成後告訴我結果，
我確認沒問題後，再繼續處理接下來的20個」
方法三：讓 Claude 解讀錯誤訊息 把錯誤訊息直接貼給 Claude：
「執行 /weekly-report 時出現以下錯誤，請幫我分析原因和解決方法：
[貼上完整的錯誤訊息]」
🔧 問題：我想讓這個指令自動在每週五執行，不需要我手動輸入指令
這個叫做「排程執行（Scheduled Tasks）」，需要用到作業系統的工具。
Mac： 使用 cron 或 launchd
Windows： 使用「工作排程器（Task Scheduler）」
這些工具的設定相對複雜，建議的做法是：
「幫我設定一個排程任務，讓這個腳本每週五下午5點自動執行：
[描述你要執行的指令]
我用的是 Mac/Windows」
讓 Claude 幫你寫好設定腳本，它會用適合你作業系統的方式完成。
6.5 沙盒實戰練習 — 混合資料夾大掃除
📂 使用檔案：
05-混合資料夾整理練習/資料夾
這個練習模擬的是你的「真實桌面」——那個你一直想整理但永遠沒動手的地方。裡面有四個亂糟糟的子資料夾：
| 子資料夾 | 裡面有什麼 | 有多亂 |
|---|---|---|
桌面暫存/ | 截圖、未命名檔案、重複的報價單、亂打的檔名 | 有 未命名.txt、未命名(1).txt、asdfg.txt |
下載區/ | 重複下載的面試評分表、多版本報表範本、照片、影片 | 有 面試評分表.txt、面試評分表(1).txt、面試評分表(2).txt |
舊專案/ | 2024-2025年的舊專案資料（行銷活動、年會、裝修） | 每個專案有企劃書、預算表、成果報告、照片 |
未分類/ | 很重要！！！.txt、記得看.txt、先放這裡.txt、名片資料… | 一堆你忘記為什麼存的檔案 |
Step 1：讓 Claude 先幫你「健檢」
不要一上來就讓 Claude 亂搬東西。先讓它分析現況：
「掃描 05-混合資料夾整理練習/ 裡的所有檔案和子資料夾，
給我一份『資料夾健檢報告』：
1. 總共有多少個檔案和子資料夾
2. 列出每個子資料夾的檔案數量
3. 找出明顯的重複檔案（檔名類似的，例如 xxx.txt 和 xxx(1).txt）
4. 找出可能可以刪除的檔案（未命名、亂打名字、暫存檔）
5. 列出有意義的檔案清單（名片、專案資料等）
輸出成一份結構化的報告，讓我決定怎麼整理」
Step 2：制定整理計劃（用 Plan Mode 的思維）
看完健檢報告後，告訴 Claude 你的整理規則：
「根據剛才的健檢報告，請按照以下規則整理 05-混合資料夾整理練習/：
整理規則：
1. 重複檔案：保留最新版本（版本號最高或修改日期最近的），
刪除其他重複版本
2. 未命名/無意義檔案（未命名.txt、asdfg.txt、temp.txt 等）：
先讀取內容判斷是否有用，有用的依內容重新命名，沒用的移到 垃圾桶/
3. 舊專案資料：每個專案壓縮成一個 .zip 封存
4. 有意義的檔案：分類到合適的資料夾
5. 名片類檔案：彙整成一份 聯絡人清單.xlsx
目標資料夾結構：
05-混合資料夾整理練習/
├── 已整理/
│ ├── 報價單/
│ ├── 人事表單/
│ ├── 報表範本/
│ ├── 媒體檔案/
│ └── 其他文件/
├── 封存/（壓縮後的舊專案）
├── 垃圾桶/（確認後可安全刪除的檔案）
└── 聯絡人清單.xlsx
⚠️ 執行前先列出完整的『搬移計劃表』：
每個檔案會從哪裡搬到哪裡，讓我確認後再動手」
💡 為什麼要先出計劃表？ 跟批次改檔名一樣的原則——任何批次修改檔案的操作，一定要讓 Claude 先說明它打算做什麼。等你確認OK了，再回覆「好，請執行」。
Step 3：確認並執行
Claude 給你搬移計劃表之後，仔細看一遍（特別注意「垃圾桶」裡的檔案，確認真的可以刪掉），然後：
「計劃看起來OK，請執行整理。
完成後輸出一份 整理報告.txt，記錄：
- 搬移了多少個檔案
- 刪除了多少個重複檔案
- 封存了多少個舊專案
- 還有哪些檔案需要我手動判斷」
Step 4（加碼挑戰）：建立維護指令
整理完之後，把這個整理流程存成一個可以重複使用的指令：
「把剛才的整理流程做成一個 Custom Slash Command，
存成 .claude/commands/cleanup.md，
這樣以後我每個月可以用 /cleanup 自動整理一次桌面和下載區」
💡 這就是模組5和模組6的完美結合： 模組5教你如何處理文件，模組6教你如何把處理流程自動化。先把一個流程手動跑通，確認結果滿意了，再做成自動化指令。
模組 4-6 總複習
你學到了什麼
| 模組 | 核心概念 | 最重要的一件事 |
|---|---|---|
| 模組4 | Plan Mode 與安全操作 | 重要工作先用 Plan Mode 看計劃，動工前先 git commit 備份 |
| 模組5 | 文件自動化 | 了解「工作目錄」的限制，用清楚的提示語指定檔案位置和輸出格式；用沙盒資料實際練習 Excel、Word、PDF、改檔名 |
| 模組6 | 工作流程自動化 | 用 Custom Slash Commands 把重複任務存成快捷指令；用沙盒資料練習「混亂資料夾大掃除」 |
你的第一個實踐任務
不要只看不做！如果你還沒跑過沙盒練習，先回去做 5.5 節的練習 A-G 和 6.5 節的混合資料夾大掃除。做完沙盒練習後，選一個你現在最常重複做的工作（每週或每月），按照模組6的步驟，今天就建立你的第一個自動化工作流。
推薦的入門選擇（按難度）：
- 最簡單： 建立一個
/meeting-summary指令，下次開完會就試著用它整理記錄 - 中等難度： 建立一個
/weekly-report指令，下週五試著用它生成週報 - 進階挑戰： 把模組5的某個文件處理任務（例如批次處理發票）做成 Custom Command
快速參考卡
常用快捷鍵：
Shift + Tab ：切換操作模式（Normal → Auto-accept → Plan → Normal）
Ctrl + C ：立即中斷 Claude 的執行
/ ：開始輸入自訂指令（輸入 / 後接指令名稱）
常用指令：
pwd ：顯示目前所在的資料夾位置（Mac）
cd [路徑] ：切換到指定資料夾
git init ：初始化版本控制（第一次使用時）
git add . ：把所有檔案加入備份範圍
git commit -m "說明" ：建立備份（拍快照）
git checkout . ：恢復到最後一次備份的狀態
Custom Commands 位置：
.claude/commands/[指令名稱].md
每次新任務的安全流程：
1. 確認工作目錄正確（pwd）
2. 做備份（git add . && git commit -m "備份說明"）
3. 切換到 Plan Mode（Shift + Tab 按兩次）
4. 描述任務，審查計畫
5. 確認後切換到 Auto-accept 執行
6. 確認輸出結果正確
模組 4-6 完。下一部分：模組 7-9（進階工作流與企業應用）
Claude Code 實戰教學（下冊）
模組 7–8 + 附錄完整指南
適合對象：完全不懂程式的白領上班族 語氣：就像朋友坐在你旁邊，一步一步帶你做 前置條件：已完成模組 1–6 的基礎設定
MODULE 7：Skills 與 Subagents — 打造你的 AI 團隊
你可能會卡在哪裡
在進入這個模組之前，先來看看大家最常遇到的困惑：
「Skills 和 Custom Commands 有什麼不同？我之前不是已經學過 /command 了嗎？」 確實，這兩個東西長得很像，但用途完全不一樣。我們在 7.1 節會用一張清楚的比較表幫你搞懂。
「Subagents 聽起來很像科幻電影裡的東西，我真的用得到嗎？」 用得到！它的概念比你想像的簡單很多。想像一下：你是老闆，你可以同時派三個員工去做三件不同的事，而不是一件一件等。這就是 Subagents。
「自訂 Subagent 的設定看起來很技術，我怕設定錯了會出問題。」 放心，我們會一行一行解釋每個設定的意思，而且就算設定不完美，頂多就是 Claude 問你要怎麼做，不會爆炸的。
7.1 Skills 系統：讓 Claude 自動學會新能力
什麼是 Skills？
你有沒有遇過這種情況：每次叫 Claude 幫你寫行銷文案，你都要重新說一遍「我們公司的語氣是這樣、格式是這樣、要同時產出 IG 版和 Email 版……」？說了一遍又一遍，超累的。
Skills 就解決了這個問題。
用最簡單的話說：Skills 就像你幫新員工寫的 SOP 手冊。 你寫好一次，Claude 就永遠記得這個工作該怎麼做，下次遇到類似的任務，它會參考這份 SOP 來執行，你完全不需要再解釋一遍。
Claude Code 會自動發現並載入你的 Skills，當任務內容與某個 Skill 的描述相關時，Claude 會參考該 Skill 的指引來完成工作。不過要注意，這不是像 Custom Commands 那樣的「一鍵觸發」，而是 Claude 在工作時「作為參考依據」。
Skills 存放在你的專案資料夾裡的 .claude/skills/ 資料夾。每個 Skill 是一個資料夾，裡面包含一個 SKILL.md 主要指示檔，以及可選的輔助檔案（如腳本、範例、模板等）。
你的專案資料夾/
├── .claude/
│ ├── skills/ ← Skill 資料夾放這裡
│ │ ├── brand-content/ ← 每個 Skill 一個資料夾
│ │ │ ├── SKILL.md ← 主要指示檔（必要）
│ │ │ └── templates/ ← 可選的輔助資源
│ │ ├── meeting-notes/
│ │ │ └── SKILL.md
│ │ └── contract-review/
│ │ └── SKILL.md
│ └── CLAUDE.md
└── （你的其他檔案）
💡 提示： Skills 也可以放在全域位置 ~/.claude/skills/，讓所有專案都能使用。
Skill 檔案的結構
每個 Skill 的核心是 SKILL.md 檔案，它長這樣：
---
name: 這個Skill的名稱（英文，不要有空格）
description: 說明這個Skill是做什麼的、什麼時候該用（這個很重要！）
---
## （Skill 的正文內容）
這裡寫你的SOP、格式要求、注意事項、範例……最上面那一塊（被 --- 包起來的部分）叫做「frontmatter」，是讓 Claude 識別這個 Skill 的「身份證」。description 特別重要，因為 Claude 就是靠這段描述來判斷什麼時候該參考這個 Skill。
💡 進階用法： 如果你的 Skill 不需要額外的腳本或模板，也可以直接在 .claude/skills/ 下放一個 .md 檔案（不建立子資料夾），Claude 同樣能讀取。一般建議初學者先使用資料夾結構。
Skills vs. Custom Commands：傻傻分不清楚？
| Skills | Custom Commands | |
|---|---|---|
| 觸發方式 | Claude 自動發現，任務相關時參考 | 你手動打 /command |
| 檔案位置 | .claude/skills/ | .claude/commands/ |
| 適合場景 | 經常重複的複雜工作流程 | 需要時才觸發的快捷動作 |
| 攜帶內容 | 可以包含詳細SOP、模板、腳本 | 主要是指令文字 |
| 你的介入 | 不需要明確呼叫 | 每次都要你手動叫出 |
| 適合例子 | 品牌文案產出、會議記錄整理 | 快速重置設定、一次性動作 |
何時用 Skills： 當你有一套固定的工作流程，而且這個流程會被重複用到，就把它寫成 Skill。
何時用 Commands： 當你有一個快捷動作，但不想讓它自動觸發（你想掌控什麼時候執行），就用 Command。
7.2 建立你的第一個 Skill
我們用一個真實的辦公室場景來示範：行銷部門的品牌內容產出器。
想像你是行銷專員，每週都要為同一個品牌產出各種平台的內容。你已經厭倦每次都要重複說明品牌語氣和格式要求了。
步驟一：建立 Skills 資料夾
先在終端機輸入：
mkdir -p .claude/skills
💡 提示：如果你不確定自己在哪個資料夾，先輸入
pwd確認，再用cd移動到你的專案資料夾。
步驟二：建立 Skill 檔案
輸入：
touch .claude/skills/brand-content.md
步驟三：寫入 Skill 內容
用你熟悉的文字編輯器（記事本、VS Code 都行）打開這個檔案，貼入以下內容：
---
name: brand-content
description: 當使用者要求產出行銷內容、社群貼文、Email 行銷文案、廣告文案、品牌推廣文字時使用
---
## 品牌聲音指南
**語氣與風格**
- 語氣：專業但親切，像一個懂你的朋友在說話
- 避免太多艱深術語（jargon），若必須用，請附上說明
- 不用「您」，用「你」——更有溫度
- 句子不要太長，每句話最多 30 個字
**目標受眾**
- 主要：25–40 歲的台灣上班族
- 次要：對工作效率有需求的自由工作者
**品牌關鍵詞**（每篇至少自然帶入 1–2 個）
- 效率、簡單、可靠、直覺、貼心
## 輸出格式
每次產出內容時，**同時生成以下四個版本**：
**1. Instagram 版**
- 字數：150 字以內
- 結尾加 5 個相關 hashtag
- 可以用 emoji，但不要超過 3 個
**2. Facebook 版**
- 字數：300 字以內
- 語氣可以稍微長一點、完整一點
- 可以包含呼籲行動（CTA）
**3. LINE 推播版**
- 字數：100 字以內，精簡有力
- 第一句話要抓住注意力
- 包含一個行動連結提示（例如：「點此了解更多 👉」）
**4. Email 版**
- 包含：主旨行（25 字以內）+ 正文（300 字以內）
- 主旨行要讓人想打開
- 正文結尾要有明確的 CTA
## 品質檢查清單
產出前，自動檢查以下項目：
- ✅ 全部使用繁體中文，不使用簡體
- ✅ 金額標示使用新台幣（NT$ 或「元」）
- ✅ 日期格式統一（西元 YYYY 年 MM 月 DD 日）
- ✅ 每個版本字數符合限制
- ✅ 語氣一致，聽起來像同一個品牌說話步驟四：測試你的 Skill
存檔後，啟動 Claude Code（在這個專案資料夾裡）。然後直接說：
「幫我寫一篇介紹我們新推出的電子報訂閱服務的行銷內容，重點是免費訂閱、每週三早上發送、內容是職場效率技巧。」
你應該會看到 Claude 自動產出四個版本，而且完全符合你在 Skill 裡設定的規格。你完全不需要提到「品牌Skill」——Claude 自己就知道要用了！
更多 Skill 範例（直接可以用）
以下是幾個辦公室常見場景的 Skill 範本，你可以直接複製使用，再根據自己公司的狀況修改：
會議記錄摘要器（meeting-notes.md）
---
name: meeting-notes
description: 當使用者貼上會議記錄、訪談逐字稿、或要求整理會議內容時使用
---
## 摘要格式
請依照以下結構整理：
### 📋 會議基本資訊
- 日期：
- 參與者：
- 會議主題：
### ✅ 決議事項
（條列最重要的決定，每條前面標 ✅）
### 🔧 待辦事項
（條列要做的事，附上負責人和 deadline）
| 待辦事項 | 負責人 | 截止日期 |
|---------|--------|---------|
### 💡 重要討論點
（摘要討論過的重要內容，不需要逐字記錄）
### ❓ 待確認事項
（還沒有答案、需要後續跟進的問題）
## 注意事項
- 條列式，不要長段落
- 待辦事項一定要有負責人和 deadline，如果原文沒提到，標注「待確認」
- 語氣中立，不帶個人評論合約審查助手（contract-review.md）
---
name: contract-review
description: 當使用者上傳或貼上合約文字、要求檢查合約重點或風險時使用
---
## 審查重點
請依序檢查以下項目：
### 🔴 高風險條款（一定要特別注意）
- 違約金條款：金額是否合理？觸發條件是否清楚？
- 不可抗力條款：是否有保護自己的空間？
- 排他性條款：是否限制你與其他廠商合作？
- 自動續約條款：有沒有自動續約、通知期多長？
### 🟡 需要確認的條款
- 付款條件：時間、幣別、匯率風險
- 智慧財產權歸屬
- 保密義務的範圍和期限
- 爭議解決方式（是否有仲裁或訴訟地點限制）
### 🟢 基本條款確認
- 雙方資訊是否正確
- 合約期限是否清楚
- 服務/產品範圍是否明確
## 輸出格式
1. 先給整體風險評估（低/中/高）
2. 逐點列出發現的問題
3. 針對高風險條款，建議修改方向
4. 最後列出「建議在簽約前確認的問題清單」月報自動生成器（monthly-report.md）
---
name: monthly-report
description: 當使用者要產出月報、週報、進度報告，或整理一段時間的工作成果時使用
---
## 月報結構
### 一、本月摘要
（2–3 句話，說明這個月最重要的成就和狀況）
### 二、目標達成情況
| 目標 | 目標值 | 實際值 | 達成率 | 備註 |
|------|--------|--------|--------|------|
### 三、本月亮點工作
（條列 3–5 項最重要的工作成果）
### 四、遇到的挑戰與解決方法
（誠實列出困難點，重要的是說明如何處理）
### 五、下月計劃
（條列下個月的優先工作）
## 語氣要求
- 正面積極，即使在說明困難時也要帶出解決方向
- 數字要具體（不要說「有所提升」，要說「提升了 23%」）
- 給主管看的版本要簡潔，給團隊看的可以更詳細🛠️ 排除問題：Skill 沒有自動觸發？
最常見的原因是
description寫得不夠具體。Claude 是靠 description 判斷要不要啟動 Skill 的。差的 description（太模糊）：
description: 行銷相關內容好的 description（具體說明觸發條件）：
description: 當使用者要求產出行銷內容、社群貼文、Email 行銷文案、廣告文案、品牌推廣文字時使用原則是：越具體越好，多寫幾個同義詞和使用場景。
7.3 Subagents：讓多個 AI 同時幫你工作
用比喻理解 Subagents
想像你是一個部門主管。你手上有一個大型專案要完成：整理上季度的市場分析報告。
以前（沒有 Subagents）： 你一個人，先去找資料（花1小時），找完資料再開始寫（花2小時），寫完再做圖表（花1小時）。總共 4 小時，全部是你一個人串行完成。
現在（有了 Subagents）： 你派出三個部屬同時工作——A 去蒐集競品資料、B 去整理上季業績數字、C 去準備圖表模板。三件事同時進行，可能 1.5 小時就搞定了。
這就是 Subagents 的概念：Claude 可以同時派出多個「分身」去做不同的任務，然後把結果合併回來給你。
內建的 Subagent 類型
Claude Code 有幾種內建的 Subagent：
- Explore（探索型）：讀取和分析你的檔案、搜尋資料，只看不動
- Plan（規劃型）：制定計劃、列出步驟，不實際執行
- General-purpose（通用型）：什麼都做，完整能力
💡 注意： 以上分類為功能性描述，實際 Subagent 的行為取決於其分配的工具和指令。
怎麼讓 Claude 用 Subagent？
大部分時候，你不需要特別指示——Claude 遇到複雜任務時會自己判斷要不要用 Subagent，以及用幾個。
但如果你想明確要求，可以這樣說：
「同時幫我做兩件事：一、整理這份會議記錄；二、根據會議內容草擬給客戶的 follow-up email。」
或者：
「用 subagent 去分別分析這三個競品的官網，然後整合成一份比較表。」
背景執行：讓任務在後台跑
如果你有一個耗時比較長的任務（例如分析一個很大的資料夾），可以讓它在「背景」執行，你繼續做其他事：
- 快捷鍵：
Ctrl + B - 或說： 「在背景執行這個分析，完成後通知我。」
這樣你就可以在等待的時候繼續對話或做其他工作。
7.4 自訂 Subagent：打造你的專屬 AI 助理
Subagent 檔案存放位置
自訂 Subagent 的設定檔放在：
你的專案資料夾/
└── .claude/
└── agents/ ← 自訂 Agent 放這裡
├── research-agent.md
└── data-agent.md
💡 提示： 自訂 Agent 設定檔也可以放在 .agents/、_agents/ 等替代路徑，但建議初學者統一使用 .claude/agents/。
Subagent 設定檔的結構
和 Skill 類似，Subagent 也有 frontmatter：
---
name: research-agent
description: 專門負責蒐集和整理資訊的助手，適合用在需要大量資料蒐集的任務
tools: Read, Grep, Glob, Bash # 工具名稱的大小寫須符合官方規範
---
（這裡寫這個 Agent 的行為指示）
你是一個資料蒐集專家。你的任務是...Frontmatter 說明：
| 欄位 | 說明 | 例子 |
|---|---|---|
name | Agent 的識別名稱 | research-agent |
description | 說明用途，Claude 靠這個判斷要不要叫它 | 負責蒐集競品資訊 |
tools | 這個 Agent 可以用哪些工具 | Read, Grep, Glob |
為什麼要限制工具？
你可能會問：「限制工具不是讓它變笨了嗎？」
其實恰恰相反。限制工具是為了安全和專注。
例如，如果你建立一個「資料蒐集 Agent」，只讓它有「讀取」的能力，它就不可能不小心刪除你的檔案或送出什麼奇怪的訊息。這叫做「最小權限原則」——給它剛好夠用的工具就好。
常用工具列表：
Read：讀取檔案Write：寫入檔案Bash：執行指令Grep：搜尋文字Glob：找檔案
自訂 Subagent 範例
範例 1：只讀取資料的研究助手
---
name: research-agent
description: 專門負責蒐集和整理資訊，只有讀取權限，不會修改任何檔案
tools: Read, Grep, Glob # 建議僅授予必要的讀取權限
---
你是一個資料蒐集和整理專家。
**你的工作原則：**
1. 你只負責讀取和整理資訊，不修改任何檔案
2. 找到的資訊要條列清楚，標明來源（哪個檔案的第幾行）
3. 如果找不到資訊，明確說「未找到相關資訊」，不要猜測
4. 整理完後，給主要 Agent 一份結構化的摘要
**輸出格式：**
- 先給 3 句話的執行摘要
- 再條列詳細發現
- 最後標注「資訊來源」7.5 實戰案例：PM 的 AI 團隊
讓我們看看一個產品經理（PM）小玉，如何用 Skills 和 Subagents 打造她的 AI 工作團隊。
小玉的工作痛點
小玉每兩週要交一份 Sprint 報告給主管，格式固定但每次都要花她兩小時整理。她還要定期做競品研究，每次翻來翻去找資料很累。
她的 AI 團隊設定
Skill 1：Sprint 報告自動生成器
（sprint-report.md）
---
name: sprint-report
description: 當使用者要產出Sprint報告、迭代報告、衝刺進度報告時使用
---
[格式要求：完成的任務、未完成的任務、阻礙因素、下期計畫…]Skill 2：用戶訪談整理器
（user-research.md）
---
name: user-research
description: 當使用者上傳用戶訪談錄音逐字稿、用戶回饋、NPS調查結果時使用
---
[整理重點：用戶痛點、需求、滿意點、建議改善項目…]自訂 Subagent：競品監控助手
（.claude/agents/competitor-watcher.md）
---
name: competitor-watcher
description: 負責分析競品資訊，整理競品動態
tools: Read, Grep, Glob, Bash
---
你是一個競品分析專家。
當主要 Agent 提供競品相關資料時，你負責：
1. 整理競品的功能特點
2. 與我們的產品做差異比較
3. 標出值得關注的競品動向它們如何一起工作
場景： 今天是 Sprint 結束日，小玉需要在下班前交出報告。
她在 Claude Code 輸入：
「@sprint_tasks.txt 這是這次 Sprint 的任務清單，@meeting_notes.txt 這是今天 Sprint Review 的會議記錄。幫我產出這次的 Sprint 報告，同時用競品監控助手分析 @competitor_updates.txt 裡面的競品資訊，整合成一份給主管的完整週報。」
Claude 會：
- 自動啟動
sprint-reportSkill 來產出 Sprint 報告 - 同時派出
competitor-watcherSubagent 去分析競品資訊 - 最後把兩份內容整合成一份完整週報
小玉的兩小時工作，縮短到 15 分鐘。
7.6 常見問題排除
🛠️ 問題 1：Skill 沒有自動觸發
原因： Description 不夠明確，Claude 沒辦法判斷要用這個 Skill。
解決方法：
- 打開 Skill 的
.md檔案- 把
description寫得更具體，多列幾個觸發條件和同義詞- 重新啟動 Claude Code 讓它重新載入 Skills
範例修改： 改前：
description: 用於行銷內容改後：description: 當使用者要求產出行銷內容、社群媒體貼文、IG文案、Facebook貼文、Email行銷文案、廣告文案時使用
🛠️ 問題 2：Subagent 回報的結果太長，難以閱讀
原因： Subagent 沒有長度限制，會盡可能詳細。
解決方法： 在你的 Agent 設定裡加入長度限制，或者在對話中直接說： 「請控制在 500 字以內，重點條列就好。」
如果你常常需要這個限制，可以在 Subagent 的 description 裡加一行：
注意：每次回報控制在 500 字以內，用條列式格式。
🛠️ 問題 3：自訂 Agent 設定無效，行為跟普通 Claude 一樣
原因： YAML Frontmatter 格式錯誤。YAML 對格式非常嚴格，一個空格、一個符號差錯都會讓整個設定失效。
解決方法：
- 確認 frontmatter 用
---開頭和結尾（三個橫線）name不能有空格或特殊符號（用-代替空格）tools的工具名稱要正確（R 大寫：Read,Write,Bash）- 不要在 frontmatter 裡用中文（name 和 tools 用英文）
正確格式：
--- name: my-agent description: 這裡可以用中文 tools: Read, Grep ---錯誤格式：
-- （少了一個橫線） name: my agent （有空格） tools: read, grep （小寫） --
MODULE 8：MCP 整合 — 連接你的工作工具
你可能會卡在哪裡
「MCP 是什麼？聽起來超技術的，我大概用不到吧？」 MCP 是這門課裡對非技術人員最有實際用途的功能之一。它能讓你的 Claude 直接「接上」你每天用的工作工具。看完 8.1 節的比喻，你馬上就會明白它為什麼這麼有用。
「我試著加 MCP 但 OAuth 認證一直失敗，不知道哪裡出問題。」 OAuth 認證失敗有幾個固定的原因，8.4 節有完整的排除步驟。
「我想連接的服務好像沒有 MCP Server。」 大部分主流工具都有，我們在 8.2 節整理了一覽表。如果真的沒有，我們也說明進階選項。
「公司的安全政策很嚴，我不確定可不可以用這個。」 這個問題很重要，8.1 節末尾有說明如何和 IT 部門溝通。
8.1 什麼是 MCP（用白話說）
USB 比喻
讓我們用一個所有人都懂的比喻。
你的電腦有 USB 接口。沒有接任何東西的時候，電腦只能做自己的事。但當你插上隨身碟，電腦就能讀你的檔案；插上印表機，電腦就能列印；插上讀卡機，電腦就能讀你的信用卡。
MCP 就是 Claude Code 的 USB 接口。
以前，Claude 只能看到你直接貼給它的文字。你要讓它看你的 Notion 頁面？你得自己複製貼上。你要讓它查你的行事曆？你得先截圖或手打。每次都要「搬資料」給它，很麻煩。
有了 MCP，Claude Code 可以直接「插上」你的各種工具：
- 直接讀取你的 Notion 頁面（不需要複製貼上）
- 直接查看你的 Google Calendar（不需要截圖）
- 直接搜尋你的 Gmail（不需要你去找）
- 直接把資料寫回你的資料庫
這不只是方便，而是整個工作方式的升級。
MCP 的完整名稱
MCP = Model Context Protocol（模型情境協議）。這是 Anthropic（Claude 的開發公司）制定的一個標準，讓不同的工具都可以用同樣的方式跟 AI 「對話」。
你不需要理解它的技術細節，你只需要知道：有了 MCP Server，Claude 就能直接操作那個工具。
關於公司安全政策
如果你在使用公司電腦，在連接任何 MCP Server 之前，有幾件事要確認：
- 確認你要連接的服務是公司允許的（例如公司已在使用的 Notion、Slack）
- 不要連接含有公司機密資料的系統（例如 ERP、人事系統）到個人設定
- 有疑問時，先問 IT 部門
通常，連接你個人已在使用的生產力工具（Notion、Google Drive、Slack）是沒問題的，但連接公司核心系統需要 IT 審核。
8.2 常用的 MCP Server 一覽
以下是白領上班族最常用的 MCP Server：
| 工具 | MCP Server 類型 | 可以做什麼 |
|---|---|---|
| Notion | HTTP 遠端服務 | 讀寫 Notion 頁面、資料庫、建立新頁面 |
| GitHub | HTTP 遠端服務 | 管理 Issues、Pull Request（技術或PM用） |
| Slack | 可用 | 讀取頻道訊息、發送訊息（注意公司政策） |
| Google Drive | 可用 | 存取和搜尋雲端檔案 |
| Google Calendar | 可用 | 讀取行事曆、查詢空檔 |
| Sentry | HTTP 遠端服務 | 監控和查詢錯誤（技術團隊用） |
| Jira | 可用 | 管理專案任務（PM 常用） |
| Confluence | 可用 | 讀寫公司知識庫文件 |
📝 如何找到更多 MCP Server？ 可以查詢 MCP Server 的社群目錄：
https://github.com/modelcontextprotocol/servers大部分主流工具都有對應的 MCP Server。
8.3 如何添加 MCP Server（步驟教學）
添加 MCP Server 有三種方法，由簡單到複雜。我們從最簡單的開始。
方法一：HTTP 遠端服務（最簡單，推薦新手）
適合：Notion、GitHub、Sentry 等有提供官方 MCP 網址的服務。
格式：
claude mcp add --transport http [名稱] [MCP網址]
以 Notion 為例：
claude mcp add --transport http notion https://mcp.notion.com/mcp
打完 Enter 之後，在 Claude Code 裡輸入 /mcp，你會看到 Notion 出現在清單裡。點擊它旁邊的「認證」按鈕（或連結），會跳出瀏覽器讓你登入 Notion，授權之後就完成了。
方法二：本地 stdio 服務（稍微進階）
適合：需要在你電腦本地執行的 MCP Server。
格式：
claude mcp add --transport stdio [名稱] -- npx [server套件名稱]
例子：
claude mcp add --transport stdio filesystem -- npx @modelcontextprotocol/server-filesystem /Users/你的名字/Documents
這個例子是讓 Claude 可以存取你的 Documents 資料夾。/Users/你的名字/Documents 要換成你實際的資料夾路徑。
方法三：從 JSON 配置添加
適合：有現成配置設定要套用，或者批次添加多個服務。
格式：
claude mcp add-json [名稱] '{"type":"http","url":"https://..."}'
例子：
claude mcp add-json my-notion '{"type":"http","url":"https://mcp.notion.com/mcp"}'
添加後如何確認？
添加完成後，在 Claude Code 裡輸入：
/mcp
你會看到已安裝的 MCP Server 清單，以及它們的連線狀態（已連線/未認證/錯誤）。
8.4 MCP 認證流程
大部分 MCP Server 需要你登入授權——這樣它才知道要存取的是你的帳號，而不是別人的。這個過程叫做「OAuth 認證」。
OAuth 認證流程（用白話說）
- 你添加 MCP Server（上面學的三種方法之一）
- 在 Claude Code 輸入
/mcp查看狀態 - 點擊「認證」或「連結帳號」，會跳出瀏覽器視窗
- 在瀏覽器裡登入對應的服務（例如你的 Notion 帳號）
- 點擊「授權」或「Allow Access」
- 瀏覽器會告訴你「認證完成」，可以關閉視窗
- 回到 Claude Code，再輸入一次
/mcp確認狀態變成「已連線」
遇到「Incompatible auth server」錯誤
這個錯誤意思是：這個 MCP Server 需要你自己去那個平台「申請一個應用程式授權」，而不是直接用你的個人帳號。這在某些進階場景（例如連接公司自架的系統）才會遇到。
解決方法：
- 去那個平台的「開發者設定」申請一個 OAuth 應用
- 取得
client-id和client-secret - 重新添加時帶上這些資訊：
claude mcp add --transport http myserver https://... --client-id 你的ID --client-secret 你的密鑰
💡 對大部分人來說，直接用官方 MCP Server（像 Notion、GitHub 的官方服務）不會遇到這個問題。 這個錯誤主要出現在連接非標準服務時。
8.5 管理 MCP Servers
常用管理指令
查看已安裝的所有 MCP Server：
claude mcp list
會顯示名稱、類型、狀態。
移除一個 MCP Server：
claude mcp remove notion
（把「notion」換成你要移除的名稱）
在 Claude Code 內管理（最直覺）：
/mcp
輸入這個指令，會顯示互動式的管理介面，可以查看狀態、重新認證、開關服務。
Scope（範圍）設定
添加 MCP Server 時，你可以選擇它的「範圍」：
| Scope | 說明 | 使用時機 |
|---|---|---|
local（預設） | 只在你目前這個專案有效 | 這個服務只跟這個專案有關 |
project | 整個專案資料夾（包含子資料夾）有效 | 整個專案都會用到 |
user | 你的所有專案都有效 | 你在每個專案都想用的服務 |
例子（設定為 user 範圍，所有專案都能用）：
claude mcp add --scope user --transport http notion https://mcp.notion.com/mcp
8.6 實戰案例：連接 Notion 建立自動化筆記系統
讓我們走過一個完整的使用場景。
情境： 業務主管阿明每天要把客戶訪談的重點記錄到 Notion。以前他要開著 Notion、邊訪談邊打字，很分心。
目標： 訪談結束後，只要把訪談錄音轉成逐字稿（可以用手機的語音轉文字，或直接把錄音給 Claude Code 處理），Claude 自動把整理好的重點存入 Notion 的指定頁面。
步驟 1：添加 Notion MCP
claude mcp add --scope user --transport http notion https://mcp.notion.com/mcp
步驟 2：完成 Notion 認證
/mcp
點擊 Notion 旁邊的認證連結，在瀏覽器登入 Notion，授權完成。
步驟 3：讓 CLAUDE.md 知道你的 Notion 設定
在 CLAUDE.md 裡加上：
## Notion 設定
- 客戶訪談記錄頁面：[你的Notion頁面名稱或ID]
- 訪談記錄格式：請使用「客戶訪談摘要器」Skill步驟 4：使用
訪談結束後，把逐字稿貼給 Claude Code，說：
「這是剛才跟張總的訪談記錄，幫我整理成標準格式並存入 Notion 的客戶訪談頁面。」
Claude 會自動：
- 整理訪談重點（使用你的 Skill，如果有設定的話）
- 透過 Notion MCP 建立新頁面
- 把整理好的內容存入 Notion
- 回報給你「已成功建立頁面：XXX」
阿明從此不需要再手動記錄，訪談結束後 5 分鐘內，客戶洞察就自動整理好在 Notion 裡了。
8.7 常見問題排除
🛠️ 問題 1：OAuth 認證失敗，一直跳回錯誤頁面
嘗試以下步驟（依序進行）：
- 清除瀏覽器的 cookie（清除所有與該服務相關的）
- 重新在 Claude Code 輸入
/mcp，選擇重新認證- 確認你登入的是正確帳號（有些人有多個帳號）
- 嘗試用無痕視窗完成認證
🛠️ 問題 2：「Incompatible auth server」錯誤
說明： 這個 MCP Server 要求你用「應用程式憑證」認證，而不是個人帳號。
解決：
- 如果是官方服務（Notion、GitHub），確認你用的是官方提供的 MCP 網址
- 如果是第三方或自架服務，需要向服務提供者申請 OAuth client credentials
🛠️ 問題 3：MCP Server 連得上但一直 timeout（逾時）
原因： 通常是網路問題或對方 Server 繁忙。
解決：
- 確認你的網路連線正常
- 確認 MCP Server 的網址是否正確（有沒有打錯？）
- 等幾分鐘後重試
- 查看對方服務的狀態頁（很多服務都有 status.xxx.com）
- 如果是公司內部服務，確認防火牆沒有擋住連線
🛠️ 問題 4：權限不足，Claude 說「無法存取這個頁面/資料」
原因： 你的授權 scope 不夠，或者那個資源本來就沒有對外開放。
解決：
- 重新做認證，確認在授權頁面時有勾選所有需要的權限
- 確認你在那個服務上本身有那個資源的存取權限
- 以 Notion 為例：確認那個頁面有分享給整合（在 Notion 頁面右上角 → 分享 → 找到你的整合並開啟）
🛠️ 問題 5：找不到想要的 MCP Server
首先搜尋：
https://github.com/modelcontextprotocol/servers（官方整理的 Server 清單）- 直接 Google 搜尋「[工具名稱] MCP server」
如果真的沒有：
- 看看有沒有其他替代方案（例如用 Zapier 或 Make 做中間橋接）
- 如果你的公司有技術團隊，可以請他們評估是否值得開發一個內部 MCP Server
附錄
附錄 A：常見錯誤排除手冊（完整版）
這是一份可以列印出來放在桌邊的速查手冊。遇到問題時，先找這裡。
安裝問題
| 錯誤訊息 | 原因 | 解決方法 |
|---|---|---|
command not found: claude | Claude Code 未安裝，或 PATH 環境變數未設定 | 重新執行 npm install -g @anthropic-ai/claude-code，若仍失敗，手動將 npm global 路徑加入 PATH |
Permission denied (EACCES) | npm 安裝時權限不足 | 依序執行：mkdir -p ~/.npm-global → npm config set prefix '~/.npm-global' → 把 ~/.npm-global/bin 加入你的 PATH |
Node.js version not supported | Node.js 版本太舊（需要 18 以上） | 升級 Node.js，推薦安裝 22 LTS 版。前往 https://nodejs.org 下載 |
Git Bash not found（Windows） | Windows 上未安裝 Git for Windows | 前往 https://git-scm.com 安裝 Git for Windows，或在設定裡指定 CLAUDE_CODE_GIT_BASH_PATH |
ENOMEM: not enough memory | 系統記憶體不足 | 關閉其他程式，或重新啟動電腦後再試 |
ENOTFOUND api.anthropic.com | 無法連接到 Anthropic 伺服器 | 檢查網路連線，確認沒有防火牆擋住 |
操作問題
| 問題描述 | 可能原因 | 解決方法 |
|---|---|---|
| Claude 說找不到我指定的檔案 | 工作目錄不正確 | 先用 pwd 確認目前位置，用 cd 移動到正確的資料夾，然後再啟動 claude |
| 中文檔名顯示亂碼 | 系統編碼問題 | 暫時改用英文檔名；或確認你的終端機使用 UTF-8 編碼 |
| Claude 操作卡住不動、對話越來越慢 | Context 長度過長，超過限制 | 輸入 /compact 壓縮對話歷史；如果需要全新開始，輸入 /clear |
| Claude 一直問「我可以做這個嗎？」 | Permission 設定過嚴 | 在對話中使用 /config 進入設定或手動編輯 settings.json（通常位於 ~/.claude/）並在 allowedTools 加入你允許的操作 |
| 指令明明輸入正確，但沒有反應 | 可能在錯誤的模式（Normal Mode） | 按 Shift + Tab 確認切換到正確模式，或直接說「請執行」 |
| Claude 做了我不想要的事 | 沒有使用 Plan Mode 確認計劃 | 養成習慣：複雜任務前先說「用 Plan Mode 幫我規劃，讓我確認後再執行」 |
| API 費用比預期高很多 | 使用了高能力模型處理簡單任務 | 用 /model 切換到較便宜的模型；或用 /cost 查看哪個部分最花錢 |
MCP 相關問題
| 問題描述 | 可能原因 | 解決方法 |
|---|---|---|
| OAuth 認證失敗 | 認證過期、帳號問題、瀏覽器 cookie 衝突 | 清除相關 cookie → 用無痕視窗重新認證 →/mcp 重新授權 |
| MCP Server timeout | 網路問題或 Server 端繁忙 | 等待後重試；確認網路；查看服務狀態頁 |
| MCP Server 已加入但 Claude 不知道有這個工具 | 需要重啟 Claude Code | 完全關閉 Claude Code 後重新啟動 |
| 「Incompatible auth server」 | 服務要求應用程式憑證而非個人帳號 | 參考 8.4 節的 OAuth 應用程式申請流程 |
| MCP 工具存取被拒 | 授權 scope 不完整，或資源本身無權限 | 重新認證並確認勾選所有需要的 scope |
Skills 與 Agents 問題
| 問題描述 | 可能原因 | 解決方法 |
|---|---|---|
| Skill 完全沒被使用 | description 太模糊；或檔案放錯位置 | 確認檔案在 .claude/skills/ 資料夾；加強 description 的具體性 |
| Skill 被用了，但格式不對 | 格式指示不夠明確 | 在 Skill 裡加入更明確的輸出格式範例 |
| 自訂 Agent 行為和設定不符 | YAML frontmatter 格式錯誤 | 確認三個橫線、name 無空格、tools 大寫開頭 |
| Claude 不知道有哪些 Skills | 首次使用需要說明 | 可以問 Claude：「你有哪些 Skills 可以用？」它會列出來 |
附錄 B：快捷鍵與指令速查表
把這個頁面加入書籤，或者列印出來貼在螢幕旁邊。
快捷鍵
| 快捷鍵 | 功能 | 最佳使用時機 |
|---|---|---|
Shift + Tab | 切換操作模式 | 在 Normal（一般）/ Auto-accept（自動）/ Plan（計畫）模式之間切換 |
Ctrl + C | 停止當前操作 | Claude 在做你不想讓它做的事時，立刻按這個！ |
Ctrl + L | 清除畫面顯示 | 畫面訊息太多，想清爽一下（不會刪除對話歷史） |
Ctrl + B | 背景執行 | 讓耗時的任務在背景跑，你繼續做其他事 |
↑ 方向鍵 | 調出上一條訊息 | 想重複上一個指令，或想微調上一句話 |
Tab | 自動完成 | 輸入指令或路徑時，Tab 會自動補全 |
Esc | 退出多行輸入模式 | 打完多行輸入後按 Esc 送出 |
斜線指令（輸入 / 開頭）
| 指令 | 功能 | 使用時機 |
|---|---|---|
/help | 查看所有可用指令的說明 | 不知道有哪些指令時 |
/init | 初始化 CLAUDE.md | 第一次在新專案設定時 |
/compact | 壓縮對話歷史 | 對話很長、回應變慢時（建議優先使用此指令） |
/clear | 清除整個對話，重新開始 | 想換話題、重新來過（注意：這會清空目前的對話上下文） |
/cost | 查看這次對話花了多少錢 | 控制 API 費用時 |
/config | 查看和修改設定 | 需要調整各種選項時 |
/model | 切換使用的 AI 模型 | 想換更快/更強/更省錢的模型 |
claude doctor | 診斷 Claude Code 的健康狀態 | 這不是斜線指令，請在終端機執行 claude doctor 找原因 |
/add-memory | 把某件事加入 Claude 的記憶 | 想讓 Claude 記住偏好或資訊時 |
/mcp | 管理 MCP Server 連線 | 查看狀態、認證、管理外部工具連線 |
/agents | 查看和管理 Subagents | 查看可用的 Agent、管理執行中的任務 |
/review | 讓 Claude 審查檔案變更 | 讓 Claude 確認它做的修改有沒有問題 |
特殊符號快捷
| 符號 | 功能 | 使用方法 |
|---|---|---|
@ | 引用檔案或資料夾 | 輸入 @ 後輸入檔名，讓 Claude 讀取特定檔案 |
# | 快速新增到記憶 | 輸入 # 後接內容，會快速加入最相關的記憶檔案中 |
! | 直接執行系統指令（Bash 模式） | 輸入 !ls 可以直接列出資料夾內容，不需要叫 Claude 做 |
附錄 C：安全檢查清單
每次開始 AI 工作階段前，花 30 秒做這個檢查。
養成習慣可以避免 90% 的「哎呀我不是要這樣」的情況。
開始前（每次都做）
- ☐ 備份重要檔案 — 如果你要讓 Claude 修改或整理現有檔案，先備份
- ☐ 確認工作目錄正確 — 輸入
pwd確認你在預期的資料夾 - ☐ 複雜任務使用 Plan Mode — 讓 Claude 先列出計劃，你確認後再執行
設定檢查（不定期做）
- ☐ CLAUDE.md 裡沒有機密資訊 — 帳號密碼、API 金鑰、機密客戶資料都不應該放在這裡
- ☐ 定期檢查 /cost — 確認費用在預期範圍內，發現異常早點處理
- ☐ MCP 連線範圍合理 — 只連接你真的需要的服務，不需要的移除
使用公司資料時的特別提醒
- ☐ 確認公司政策允許 — 特別是使用 AI 處理客戶資料、財務資料之前
- ☐ 機密等級確認 — 不要把「機密」等級的文件傳給 AI 服務（除非公司有批准的流程）
- ☐ 不要在 CLAUDE.md 放個人資料 — 姓名、電話、身分證號等個人識別資訊
- ☐ 輸出結果記得再確認 — AI 輸出的報告和文件在分享給他人前，人工審查一遍
緊急情況：Claude 在做不應該做的事
- 立刻按
Ctrl + C停止操作 - 檢查 Claude 做了什麼（如果有修改檔案，檢查還原）
- 使用
/clear清除對話，重新說明需求 - 下次使用 Plan Mode，在執行前先確認計劃
附錄 D：練習沙盒設定指南
在真實工作環境練習 Claude Code 之前，強烈建議先用「假資料」練習，培養手感和信心。
這個附錄告訴你怎麼建立一個安全的練習環境。
建立練習資料夾
在終端機依序輸入：
# 建立沙盒主資料夾
mkdir -p ~/ai-sandbox/practice
# 進入資料夾
cd ~/ai-sandbox/practice
# 建立子資料夾
mkdir input output temp完成後，你的練習環境長這樣：
ai-sandbox/
└── practice/
├── input/ ← 放練習用的原始資料
├── output/ ← Claude 處理後的結果放這裡
└── temp/ ← 暫時用的工作檔
建立假資料練習檔
以下是幾個可以直接複製使用的假資料範本。把它們存成對應的檔名，放入 input/ 資料夾。
假的銷售報表（input/sales_report_q3.csv）
月份,產品,銷售金額,件數,業務員
2025-07,筆電A,125000,5,王小明
2025-07,滑鼠B,18000,30,林美華
2025-07,鍵盤C,24000,20,王小明
2025-08,筆電A,98000,4,陳大偉
2025-08,滑鼠B,21000,35,林美華
2025-08,鍵盤C,30000,25,陳大偉
2025-09,筆電A,175000,7,王小明
2025-09,滑鼠B,15000,25,陳大偉
2025-09,鍵盤C,18000,15,林美華
2025-09,顯示器D,88000,4,王小明練習題目：叫 Claude 幫你：
- 計算每個業務員的業績總計
- 找出哪個月份銷售最好
- 製作一份季度銷售摘要
假的客戶名單（input/customer_list.csv）
客戶代號,公司名稱,聯絡人,職稱,最後聯絡日期,合約狀態,年費
C001,台灣科技股份有限公司,張經理,採購主任,2025-09-15,有效,120000
C002,大成食品工業,李副理,IT負責人,2025-08-20,即將到期,85000
C003,信義建設集團,陳總監,資訊長,2025-09-28,有效,250000
C004,旭日貿易有限公司,黃小姐,行政主管,2025-07-10,已到期,45000
C005,永康電機製造,林工程師,IT主管,2025-09-05,有效,65000練習題目：叫 Claude 幫你：
- 找出合約即將到期或已到期的客戶，產出跟進清單
- 依照年費大小排序，找出前三大客戶
- 針對已到期客戶，草擬一封續約提醒 Email
假的會議記錄（input/meeting_notes_1015.txt）
2025年10月15日 下午2:00
產品規劃會議
參與者：陳副總（主持）、產品部小玉、業務部阿明、行銷部小芬、技術部老李
陳副總：
這次會議主要討論Q4的產品推廣計劃。先請小玉說明一下目前產品的狀況。
小玉：
好的。目前A產品的月活躍用戶是3萬人，比上個月成長了8%。
主要問題是用戶留存率不夠高，30天留存率只有35%，行業平均是50%。
我們分析原因，主要是新用戶上手門檻太高，希望能改善引導流程。
阿明：
業務端的反饋是，客戶在demo時都很感興趣，但實際成交後前三個月的續約意願不高。
有幾個客戶說因為不會用所以放棄了。這跟小玉說的問題一致。
老李：
技術上來說，改善引導流程大約需要2個sprint，也就是4週的時間。
但我們Q4的排程已經滿了，要做的話需要砍掉其他功能。
小芬：
行銷這邊計劃在11月底做一波年終促銷。
如果產品體驗問題沒解決，促銷帶來的新用戶還是會流失，效果會打折扣。
陳副總：
聽起來改善引導流程的優先級應該提高。老李，能不能評估一下哪個功能可以延後？
老李：
可以把B功能推到Q1，這樣就能空出一個sprint來做引導流程優化。
陳副總：
好，那就這樣決定。小玉負責寫改善需求文件，下週三前交給老李。
小芬的促銷計劃繼續推進，但把時間從11月底調整到12月初，讓引導流程先上線。
阿明幫忙收集3~5個具體客戶反饋，給小玉作為需求參考。
其他事項：
阿明提到有個大客戶有客製化需求，陳副總說先請業務評估需求規模，下次會議再討論。
練習題目：叫 Claude 幫你：
- 整理成標準的會議記錄格式（決議事項、待辦事項、負責人）
- 用 Email 格式把決議事項發給所有與會者
- 根據討論內容，草擬一份給主管的執行摘要
如何用沙盒環境練習 Skill
建好沙盒之後，可以做以下練習：
- 練習建立你的第一個 Skill：用 7.2 節的步驟，在沙盒裡的
.claude/skills/資料夾建立一個 Skill - 測試 Skill 是否運作：用上面的假資料觸發你的 Skill，觀察 Claude 的反應
- 不怕搞壞：沙盒裡都是假資料，就算 Claude 做了你不預期的事，也不會有任何損失
附錄 E：推薦學習資源
你已經完成了整個 Claude Code 課程！以下是繼續進步的資源。
官方資源（最準確、最及時）
| 資源 | 網址 | 適合用途 |
|---|---|---|
| Claude Code 官方文件 | https://docs.anthropic.com/claude-code | 查詢功能細節、最新功能更新 |
| Anthropic 官方部落格 | https://www.anthropic.com/blog | 了解新功能公告、最佳實踐 |
| MCP Server 目錄 | https://github.com/modelcontextprotocol/servers | 尋找可用的 MCP Server |
社群資源（學習新技巧、解決問題）
| 資源 | 在哪裡找 | 適合用途 |
|---|---|---|
| Reddit r/ClaudeAI | https://reddit.com/r/ClaudeAI | 與其他用戶交流、看真實使用案例 |
| Reddit r/AIToolsInTheWorkplace | Reddit 搜尋 | 辦公室 AI 使用心得 |
X（Twitter）#ClaudeCode | Twitter/X 搜尋 | 看最新的使用技巧分享 |
繼續進步的建議
第一個月：穩固基礎
- 把課程裡的 Skills 範例全部實作一遍
- 試著把你最常重複的一項工作做成 Skill
- 每天用 Claude Code 做一件「以前用 AI 做不順的事」
第二個月：擴展應用
- 連接至少一個你常用的工具（從 Notion 或 Google Drive 開始）
- 嘗試設定一個 Subagent 來處理你的重複性分析工作
- 開始在 CLAUDE.md 累積你的工作偏好和規則
第三個月：分享和精進
- 把你的 Skills 分享給同事（直接複製
.claude/資料夾） - 觀察哪些 Skill 最常被自動觸發、哪些需要改進
- 嘗試你在工作中最想自動化的一件大事
給非技術人員的最後一點建議
你已經學完了這門課。但最重要的一件事不在任何一個模組裡：
不要完美主義。先動手試。
很多人學完工具之後，還是在等「對的時機」或「我再熟悉一點再開始用」。但使用 AI 工具的能力，只有在真實的工作場景中不斷嘗試，才會真正內化成你的能力。
就算你今天設定的 Skill 格式不完美，就算你的 CLAUDE.md 只有三行，也比什麼都不做強一百倍。
從明天開始，用 Claude Code 做一件你今天用手做的事。
本教學文件持續更新。如有任何問題或建議，歡迎回饋給課程作者。
最後更新：2026 年 2 月