中文導讀
Claude API 開發〔文件版本 2026-08-18〕
從模型三檔位到多代理架構，為你逐章導覽 Anthropic 官方文件。
13支影片 4 小時 43 分總長度 191章節索引 15參考資料
課程地圖7 個主題
這門課在講的東西彼此怎麼關聯——不是單元的排列順序。點任何一個節點，直接跳到講它的那一支影片。
Claude API 開發：從一次請求，到一整個會自己動的系統
- 一次請求裡有什麼
- 把輸出釘住：叮嚀、分數、約束
- 讓它有手可以動
- 脈絡窗永遠不夠用
- 多步驟怎麼編排
- 在你自己的機器上跑
- 交出去之前要想的事
主線8 支
- 01 Claude API 介紹 聊天網頁版的「記憶」與「人格」，其實全是 API 之上的程式碼裝出來的。本集拆解 Claude API 的地基：模型三檔位（Haiku 4.5／Sonnet 5／Opus 5、Fable 5）、官方為什麼建議「先從 Opus 5 起手」、不換模型也能調深淺的 effort 五級、文字生成四階段、舊教材的取樣參數為什麼現在會直接回 400、API 金鑰的資安紅線與 App Attest、max_tokens、無狀態與 messages 陣列、System Prompt，以及串流與 Structured Outputs 結構化輸出。 三檔位與 effort、文字生成四階段、無狀態與串流、Structured Outputs 21:14 23 節
- 02 科學評估提示詞 花三小時雕出來的提示詞，換一個輸入就崩潰——沒有評估機制的提示詞工程只是在瞎忙。本集建立科學的評估管線：用 AI 出考卷做資料集、用 Structured Outputs 清掉開頭那堆對話廢話、出題就同時寫好評分標準、三種評分器與「懶惰的 6 分」、先推理再給分的 token 順序，再用一日餐飲計劃走完五步驟閉環（清楚直接、具體明確、XML 標籤、提供範例），最後補上兩個新陷阱：effort 管的是「想多少」，以及不要叫模型自己先篩題目。 評估資料集、三種評分器、懶惰的六分、effort 兩個陷阱 23:38 20 節
- 03 工具使用與代理迴圈 Claude 從不親自執行工具——揮錘子的永遠是你自己的伺服器，這是刻意的資安設計。本集拆解工具使用的完整迴圈：四步來回、兩條黃金守則（描述欄位怎麼寫、輸入驗證與 strict）、一次問三件事的多區塊與 tool_use ID 配對、由 stop_reason 驅動的代理迴圈，以及三件現成武器：文字編輯器、網頁搜尋（動態過濾、網域名單、引用機制），還有把模型本身當成工具的 Advisor 顧問工具。 tool_use、strict 嚴格模式、文字編輯器、網頁搜尋 19:33 12 節
- 04 800 頁報告的 RAG 檢索實戰 800 頁的年度報告直接塞進提示詞？撞上脈絡上限、燒錢，還會迷失在中間。本集蓋出完整的 RAG 檢索管線：三種切塊思路與重疊緩衝、text embeddings 與餘弦相似度、embedding 供應商要自己選的取捨、純語意搜尋對編號的盲點、BM25 關鍵字專家，用 RRF 倒數排名融合把兩份榜單合而為一，最後補上最容易被忽略的一哩路：搜尋結果要怎麼排版、怎麼讓模型附上引用。 切塊、embeddings、餘弦相似度、BM25、RRF 融合 29:25 13 節
- 05 自主思考與程式執行 投幣式販賣機掉不出一份完整的數據分析報告。本集把 Claude 從販賣機升級成自動化引擎：extended thinking 的草稿紙、舊教材的思考參數為什麼送出就回 400、用 effort 控制推理深度、思考簽章與摘要、思考一直在計費這件事，PDF 的圖文一起看與頁數上限，prompt caching 的壽命、計時起點與兩個實戰地雷，以及 Files API 與無網路容器裡的 code execution。 adaptive thinking、effort、快取續命、code execution 18:42 15 節
- 06 MCP 模型脈絡協定 為了幫模型裝上手腳，親自手刻冗長的 JSON Schema——MCP 把這整包苦差事剝離出去。本集拆解 MCP 的黃金三角：Tools（模型決定）、Resources（應用決定）、Prompts（使用者決定），加上本地 stdio 與遠端 Streamable HTTP 的傳輸無關性、官方 SDK 的裝飾器寫法、Inspector 除錯的新指令與控制權總盤點，最後收在「軟體世界的 USB 介面」這個願景。 黃金三角 Tools／Resources／Prompts、FastMCP、Inspector 16:04 12 節
- 07 Claude Code 終端機實戰 端著咖啡打開終端機，昨晚交辦的重構已經完成——Claude Code 是住在命令列裡的虛擬工程師。本集透視它的三項關鍵能力（檔案操作／終端機／網頁存取）、Windows 已有原生安裝程式不必再繞 WSL、/init 生成的 CLAUDE.md 與記憶的四種作用範圍（井字號捷徑已移除，改用 Auto Memory）、權限與審核怎麼設，先探查、再規劃、才實作的工作流，以及內建 MCP Client 如何突破本機的天花板。 原生安裝、CLAUDE.md 與四種作用域、權限審核、MCP 22:12 11 節
- 08 工作流與代理架構對決 workflow 與 agent 的核心差異只有一個：誰決定下一步。本集拆解五種 workflow 陣型（evaluator-optimizer／parallelization／routing／prompt chaining 與中央調度），說明超級提示詞為什麼會破功，再跨進 agent 領域：工具定義的份量、合理抽象與高度特化的取捨、盲目性與「你必須驗證」反模式、失控成本的兩種剎車，收在官方最高指導原則——能用 workflow，就優先用 workflow。 五種陣型、工具定義的份量、兩種成本剎車 27:27 15 節
特講5 支
- 09 特講 Claude Code in Action 把整包重構丟給 AI 然後去喝咖啡，幾小時後迎來災難現場——問題出在沒有先界定範圍。本特講拆解實戰策略：Plan Mode 先界定範圍、CLAUDE.md 為什麼不聽話、白板與 /compact 的方向盤、rewind 與兩下 Escape，hooks 怎麼把「期望」變成「強制」、驗證技能與 STOP 掛鉤、預設就開的 AUTO 模式與它的盲點、Routines 與 headless 的無人值守，最後是怎麼信任它的產出，以及 plugins 的隱患。 Plan Mode、hooks、AUTO 模式與 Routines 20:06 12 節
- 10 特講 Subagents 子代理隔離術 主脈絡視窗被塞爆之後，注意力就崩了——子代理的解法是物理隔離的小黑屋：中間過程留在裡面，只把精煉摘要送回主視窗。本特講拆解內建代理（Explore 與 Plan）、自訂子代理（互動精靈已移除，description 才是觸發器）、四大護法、三個系統限制數字、Fork 與 Subtask 這個唯一不是空白開場的例外、把四個層次一次講清楚，最後收在判斷該不該外包的黃金問題。 /agents、description 觸發器、四大護法、Fork 與層次 25:25 11 節
- 11 特講 MCP 進階架構 MCP Server 免費幫全世界的人跑 AI？不——sampling 把運算與帳單優雅地轉回 Client。本特講照著規格提案（SEP）逐條走：sampling 的錢與責任、Roots 是尋寶圖不是資安沙盒（路徑檢查得由 Server 端自己做）、Progress Token 活著而 Logging 被淘汰、Elicitation 的兩種模式、方向反轉的 MRTR 多回合請求，以及被清掉的兩個歷史包袱，最後收在落地的三句話。 Sampling 成本轉嫁、Roots 不是沙盒、Elicitation、MRTR 18:17 8 節
- 12 特講 Agent Skills 每天對 AI 講同一套台詞？Agent Skills 把教導寫下來一次，變成按需載入的技能包。本特講先比較兩種舊做法（CLAUDE.md 常駐、斜線指令），再拆解 SKILL.md 的結構：description 這張職位說明書、when_to_use 與 1536 字元、常被搞反的 allowed-tools 方向、漸進式揭露與 500 行、為什麼要它「Run 而不是 Read」、Context Fork、子代理不繼承技能的隔離陷阱、擴散途徑與同名衝突，收在機師級除錯快問快答。 SKILL.md、description 職位說明書、漸進式揭露、Context Fork 19:26 19 節
- 13 特講 它說做完了 AI 交回來測試全綠，打開一看它在程式裡加了一行 sys.exit(0)——在自己的考卷上蓋 A+。本特講從官方研究與 Claude Opus 5 系統卡講起（reward hacking：滿足字面、沒滿足精神），指出病灶是「你沒有給它可以自己跑的檢查」，再拆官方的四級階梯：同一則提示、/goal、Stop hook（連擋八次放行）、獨立第二意見；後半回答更難的一題——你給它的檢查怎麼讓它改不掉：三道寫給它看的叮嚀，與技術上做不到的約束（格式層 strict: true；環境層的權限規則、沙箱、工具呼叫攔截），收在「要證據不要宣稱；能寫成約束的就不要寫成叮嚀」。 reward hacking、四級階梯、/goal、Stop hook、叮嚀 vs 約束、strict: true 21:54 20 節
參考資料15 條
本系列是 Anthropic 官方課程與官方開發者文件的中文導讀，非 Anthropic 官方影片。技術主題的「一手」＝廠商自己的官方課程、開發者文件，以及 Anthropic 自家的工程與研究文章、模型系統卡；不採用第三方部落格、教學文與二手比較。廠商文件對自家產品是第一手，不能拿來當其他家模型的比較依據。
- API 參數、模型名稱與行為以錄製當時（2026 年 8 月）的官方文件為準。 官方文件改版很快，實作前請以 platform.claude.com 的現行版本為準。
- 已知的過期之處已在影片中就地處理：講錯且照做會出錯的段落直接剪掉，只錯一句細節或未涵蓋現行主線的疊上更正卡。旁白未重錄、未改寫——你看到的更正就是更正本身。
Anthropic 官方課程（特講四集）
4 條
第 9 至 12 集，各自對應一門官方課程或官方主題文件。
Anthropic 官方開發者文件
2 條
兩個用途：課程錄製後 API 改版之處逐項對照更新；官方課程未涵蓋的現行主線（Structured Outputs、adaptive thinking、automatic prompt caching 等）。
Anthropic 官方工程與研究文章、模型系統卡
6 條
特講「它說做完了」（wf1）的主要依據。廠商自家的工程與研究文章是對自家模型的第一手陳述，不是第三方部落格；但權威範圍只到自家產品，不能拿來當其他家模型的比較依據。