Building Agents with the Claude Agent SDK

摘要

Anthropic 發布的 Claude Agent SDK 設計哲學文件，核心理念是「給 AI 一台電腦」——讓代理能使用檔案操作、終端指令、程式碼執行等程式設計師日常工具，將 Claude 轉變為通用型代理建構器。Agent Loop 採三步架構：蒐集上下文→執行動作→驗證結果。Model Context Protocol（MCP）標準化整合第三方工具，降低接入門檻。複雜任務可拆分給多個獨立子代理並行處理。LLM-as-Judge 驗證機制則用 LLM 本身評估產出品質，適用於難以規則衡量的場景。文件強調迭代改進最佳實踐：檢視代理失敗案例、審計工具適當性、精煉搜尋 API、加入正式驗證規則。這套框架使單人開發者能以 AI 增強的方式處理複雜工作流。

重點

• Agent Loop 三步架構：蒐集上下文、執行動作、驗證結果，是所有代理應用基礎骨架。
• MCP 標準化協議讓第三方工具用統一介面接入，降低整合複雜度與開發成本。
• 子代理平行化策略將複雜任務分散給多個獨立上下文代理，提升執行效率與可靠性。
• LLM-as-Judge 驗證用模型自身評估產出品質，適合難以制定明確規則的評估場景。
• 迭代改進強調審計失敗案例、檢驗工具選擇、優化搜尋 API 與加入正式驗證規則。

章節

1. Claude Agent SDK 設計哲學

   核心理念「給 AI 一台電腦」，讓代理使用檔案操作、終端指令、程式碼執行等工具。

2. Agent Loop 三步架構

   蒐集上下文、執行動作、驗證結果的迴圈設計，是代理應用的基礎骨架。

3. MCP 標準化整合

   Model Context Protocol 統一介面讓第三方工具接入，降低整合門檻與複雜度。

4. 子代理平行化與 LLM-as-Judge

   複雜任務拆分給多個獨立子代理並行處理，用 LLM 驗證難以規則衡量的品質評估。

5. 迭代改進最佳實踐

   審計代理失敗案例、檢驗工具適當性、優化搜尋 API、加入正式驗證規則的開發流程。

金句