Claude Code 乍看之下可能覺得很難。
終端機、MCP、掛鉤、技能、API 這些術語一次全出現，讓人在最初的一小時內很容易迷失方向。
在這篇文章中，我將把 Claude Code 整理成「一堂老師教兩個中學生的課程」。
讀完之後，你將了解學習基本操作、外部整合、技能、記憶、掛鉤、MCP 和 API 的順序。
標題圖片由 AI 生成。提示詞可在<a href="https://note.com/kawaidesign/n/n5cfbd87d1d4d">這篇文章</a>中找到。
Claude Code 是「行動型 AI」，而不只是「回答型 AI」
Claude Code 不只是回答問題，它是一個在你的電腦中執行任務的 AI。
在官方文件中，它被描述為一種代理型開發工具，可以編輯檔案、執行指令、進行 Git 操作，並整合 MCP。
一旦你掌握這一點，所有功能就會串聯起來。
老師在黑板上寫了這段話：
「聊天 AI 是給建議的老師。Claude Code 是和你一起在教室裡工作的班長。」
美奈問：
「那麼，Claude Code 只適合會寫程式的人嗎？」
老師搖了搖頭。
「它最初是以寫程式工具聞名的。但它的本質是一個能讀取資料夾、修正檔案、執行程序的 AI。它可以用於寫作、文件、網頁、研究筆記和製作教材。」
蓮說：
「所以與其告訴 ChatGPT『寫一篇作文』，我可以告訴 Claude Code『看看這個資料夾、修正它、檢查它』。」
完全正確。
在教 Claude Code 時，從這三個類別開始就夠了：
- 讀取
- 修正
- 檢查
例如，如果老師正在教如何為校慶建立網頁，他們會像這樣請 Claude Code 幫忙。
這裡的重點是，不要只向 AI 要求一個「答案」。你要給 Claude Code 一連串的任務。
目錄
- Claude Code 是「行動型 AI」，而不只是「回答型 AI」
- 基本操作：「請求、確認、修正」
- 記憶：老師的交接筆記
- 技能：必殺技卡片
- 掛鉤：上課鈴和巡邏員
- MCP：校外教學巴士
- API 和 SDK：將 Claude Code 當作零件使用
- 30 分鐘的入門練習菜單
基本操作：「請求、確認、修正」
Claude Code 的基礎涉及請求、確認和修正的流程。
與其背誦困難的指令，不如學習這種對話模式，進步會更快。
一開始，用「一起修正」的心態來使用，而不是「一次搞定」。
老師給了兩位學生第一個模式。
美奈鬆了一口氣說：
「我本來還擔心它會突然改動所有東西。只要讓它先提議就好。」
老師回答：
「是的。與其讓 Claude Code 自己亂動，不如建立確認點，這樣更安全。」
基本用法包含以下五種：
claude啟動對話claude "請求內容"傳遞初始請求claude -p "請求內容"一次性非互動執行/help查看可用指令/status查看狀態
不過，沒必要從頭開始教中學生所有東西。在第一堂課，只要打開 claude 並說一句話就夠了。
蓮說：
「如果第一個指令只需要這樣，那就不恐怖了。」
老師繼續說：
「沒錯。你可以一邊問 Claude Code 怎麼用，一邊使用它。如果不懂，就問它用法本身。」
基本操作的目標不是記指令。而是讓人類決定要交給 AI 處理的範圍。
記憶：老師的交接筆記
記憶是一個地方，用來寫下你希望 Claude Code 每次讀取的前提條件。
在官方文件中，它被解釋為一個系統，可以對不同使用者或專案使用不同的指令檔案。在教室情境中，它就像老師之間的交接筆記。
老師在黑板上寫了 CLAUDE.md。
美奈問：
「這是什麼？」
老師回答：
「這是 Claude Code 在開始工作前會讀取的教室規則手冊。」
對於校慶專案，你可以這樣寫。
蓮說：
「這樣我就不用每次都說這些了。」
老師點了點頭。
「沒錯。如果你每次都在解釋同樣的事情，就把它放進記憶。」
適合放進記憶的資訊包括：
- 專案目標
- 寫作風格或設計的規則
- 常用指令
- 不能碰觸的檔案
反之，有些資訊不適合放進記憶：
- 僅限今天的請求
- 未確認的想法
- 密碼或 API 金鑰
- 個人資訊
如果要教中學生，可以這樣傳達：
「記憶不是讓 AI 變聰明的魔法。它是一本筆記本，用來記錄你不想讓它每次都忘記的規則。」
這樣的解釋就夠了。
技能：必殺技卡片
技能是將常用的工作程序轉換成可呼叫的格式。
在官方文件中，它被解釋為一個以 SKILL.md 為核心的系統，用於組織範本、範例、腳本和參考資料。在教室中，這些就像只有在需要時才會拿出來的必殺技卡片。
老師畫了三張卡片：
- 讀書報告檢查
- 校慶頁面製作
- 英文單字測驗製作
美奈問：
「這跟提示詞集合有什麼不同？」
老師回答：
「提示詞集合是你每次都要貼上的紙片。技能是你放在 Claude Code 工具箱裡的卡片。」
技能的基本結構是這樣：
在 SKILL.md 中，你寫下何時使用、做什麼、讀取什麼。Claude Code 可以自動使用符合對話的技能，或者使用者可以用 /技能名稱 來呼叫。
蓮說：
「所以我可以把老師常用的訂正規則變成一個技能。」
完全正確。
對於讀書報告技能，你可以這樣設計。
這裡的重點是不要把所有東西都變成技能。對於一次性請求，直接當場問就夠了。
應該變成技能的任務符合這些條件：
- 重複很多次
- 有固定的程序
- 有判斷標準
- 有參考資料或範本
- 品質容易因人而異
老師最後說：
「技能不會為 AI 增加天賦。它們是把人類的程序變成可重複使用的格式。」
也歡迎使用 Claude Code 字典網站。
掛鉤：上課鈴和巡邏員
掛鉤是在 Claude Code 工作前後自動執行的機制。
在官方文件中，它們被解釋為根據特定事件（如 PreToolUse 或 PostToolUse）來執行指令或程序的設定。在教室中，它們就像上課鈴和巡邏員。
美奈問：
「上課鈴？」
老師回答：
「對。它在上課前響。它在提交前響。它會在你試圖去危險的地方時阻止你。這就是掛鉤的作用。」
例如，在 Claude Code 重寫檔案之前，它可以執行這樣的巡邏：
- 它是否在試圖碰觸
.env？ - 它是否在試圖破壞重要的設定檔？
- 重寫後是否應該執行測試？
- 是否應該格式化文字？
- 是否應該留下日誌？
蓮的眼睛發亮了：
「所以當 AI 快要犯錯時，你可以阻止它！」
老師語氣稍微嚴肅地說：
「不過，掛鉤是很強大的工具。由於它們可以自動執行 shell 指令，如果不了解就加入，會很危險。」
在向中學生解釋掛鉤時，一開始不需要讓他們寫設定。只要教他們角色就好：
工作前：阻止危險操作。工作後：執行測試或檢查。完成時：檢查是否有未完成的任務。
實務上，按這個順序介紹：
- 首先，手動檢查。
- 如果同一個檢查出現很多次，把它做成檢查清單。
- 一旦檢查清單穩定下來，再把它變成掛鉤。
不要突然自動化。如果你自動化了一個人類不懂的檢查，失敗也會被自動化。
老師在黑板上寫道：
「掛鉤不是方便的機器人，而是遵循你設定規則的巡邏員。」
MCP：校外教學巴士
MCP（模型上下文協定）是一種將 Claude Code 連接到外部服務和資料的機制。
在官方文件中，MCP 被解釋為一種開放標準，用於將 AI 工具與外部資料來源連接。在教室中，它就像前往教室外部的校外教學巴士。
老師畫了一間教室。在外面，他畫了圖書館、教職員室、市政廳和博物館。
蓮說：
「Claude Code 可以走出教室嗎？」
老師回答：
「就是那種感覺。當你連接 MCP 時，Claude Code 可以存取外部資訊，例如 GitHub、Sentry、PostgreSQL、Slack、Google Drive 和 Figma。」
當然，你不會讓它隨意看到所有東西。你要決定連接伺服器、認證和權限。
在 Claude Code 的 MCP 設定中，你可以新增 HTTP 伺服器或在本機執行的 stdio 伺服器。
美奈擔心地說：
「連到外面有點可怕。」
老師回答：
「這種感覺是對的。MCP 很方便，但你連接越多，它能觸及的資訊就越多。所以，先從唯讀開始。」
教授 MCP 的順序如下：
- 首先，只使用本機檔案。
- 接著，連接到安全的唯讀資料。
- 之後，連接到 GitHub 或票務管理。
- 最後，再考慮寫入或生產資料。
MCP 的價值不是讓 AI 變得更聰明。而是讓 AI 可以自己去找工作所需的材料。
老師總結：
「MCP 是帶 AI 去看外部世界的巴士。不過，老師決定它可以去哪裡。」
API 和 SDK：將 Claude Code 當作零件使用
API（應用程式介面）和 SDK（軟體開發套件）是將 Claude Code 整合到應用程式或自動化流程中的方法。
在官方文件中，Claude Code SDK 被解釋為一個可以從 CLI、TypeScript 和 Python 使用的系統。在教室中，這是一種讓班長在教室外參與工作的方式。
蓮問：
「API 到底是什麼？」
老師回答：
「與其說是人類在螢幕上對話，不如說是從程式向 Claude Code 請求工作的入口。」
例如，正常的使用方式像這樣。這是由人類從終端機一次性地提出請求。
使用 SDK，你可以在應用程式或批次處理中呼叫 Claude Code。Python SDK 以 claude-code-sdk 提供，也有 TypeScript SDK。
美奈問：
「這是初學者應該先做的事嗎？」
老師回答：
「不。這不是你應該先做的事。」
API 和 SDK 在以下階段使用：
- 當你想要每天自動執行相同的任務。
- 當你想要在 CI 中協助審查或測試。
- 當你想要從內部工具呼叫 Claude Code。
- 當你想要平行執行多個程序。
- 當你想要以 JSON 形式接收結果。
對於中學生來說，可以這樣比喻：
「手動請班長幫忙是 Claude Code 的基礎。從廣播室自動發送請求則是 API 和 SDK。」
它很方便，但從一開始就使用會造成混亂。順序是：基礎、記憶、技能、MCP、掛鉤，然後才是 API。
30 分鐘的入門練習菜單
你不需要一次學會 Claude Code 的所有東西。
如果你把前 30 分鐘要做的事縮小範圍，恐懼就會消失。在教中學生時，先創造小的成功經驗。
老師最後提出了 30 分鐘的課程菜單。
美奈說：
「我覺得我可以在課堂上做到！」
蓮說：
「所以 MCP 和掛鉤可以之後再學。」
老師回答：
「對。順序很重要。如果你直接跳到外部整合或自動執行，你會搞不清楚發生什麼事。」
前三個目標是：
- 讓 Claude Code 說明一個資料夾。
- 讓它修正一個小檔案。
- 讓它解釋修正的理由。
如果能夠做到這些，你已經掌握了 Claude Code 的本質。之後，根據你的需求來進行：
- 如果每次解釋同樣的事情很麻煩：使用記憶。
- 如果每次做同樣的任務：使用技能。
- 如果你想顯示外部材料：使用 MCP。
- 如果你想自動化檢查：使用掛鉤。
- 如果你想將它整合到系統中：使用 API 和 SDK。
Claude Code 不是用來記憶功能的工具。它是用來發展如何交付工作的工具。
老師最後說：
「擅長使用 AI 的人，不是那些對 AI 很了解的人。他們是能夠分配工作、交接規則、並執行檢查的人。」
這是在教中學生 Claude Code 時最重要的結論。
相關文章
[初學者 OK] Claude Code 個別支援
*前 10 位的早鳥名額已售罄。
Claude Code 設計模式
~資料夾結構、技能、資料庫與內容生成流程完全公開~
諮詢、個別輔導與企業培訓需求：
