Claude API & Agent SDK 完全指南

從零開始使用 Claude API：API Key 申請、費用模型詳解（claude-opus-4-5、sonnet、haiku 定價比較）、Rate Limits，以及 curl、Python、TypeScript 三版本的第一個 API 呼叫。

深入理解 Claude Messages API 的核心設計：system/user/assistant roles、多輪對話管理、temperature 與 top_p 調校、stop_sequences，以及生產環境的 system prompt 最佳實踐。

深入理解 Claude API Streaming 的 SSE 事件類型、Python 與 TypeScript 實作、在 Next.js/Express 建立 streaming endpoint，以及 streaming 搭配 Tool Use 的特殊處理。

完整的 Claude Tool Use（Function Calling）指南：tool 定義格式、如何設計好的 tool description、parallel tool use、tool_choice 參數、structured output，以及完整的 Python 執行循環範例。

深入解析 Claude Extended Thinking：適用與不適用場景、budget_tokens 設定策略、thinking blocks 的回應格式、與 Streaming 結合、成本計算，以及 with/without thinking 的實際效果對比。

支援格式（JPEG/PNG/GIF/WebP/PDF）；base64 vs URL 兩種圖片輸入方式；PDF 文件上傳與分析；token 計算與成本；截圖分析、OCR、圖表解讀實戰範例；Python + TypeScript 完整代碼。

為什麼 prompt caching 是最重要的成本優化技術；cache_control 用法；快取有效期與定價；適合 vs 不適合快取的內容；Python + TypeScript 實作；快取命中率監控；RAG 系統省錢案例。

Message Batches API 完整指南；與普通 API 的差異；JSONL 輸入格式；輪詢狀態與結果處理；Python + TypeScript 完整範例；錯誤處理；50% 折扣的成本計算；最佳實踐。

為什麼有了 Messages API 還需要工具循環封裝；Tool Use 的 agentic loop 痛點；用 Claude 建 agent 的兩條真實路徑（官方 SDK 的 beta tool runner 與 Managed Agents）；Python + TypeScript 安裝與 Hello World；何時手寫 loop、何時用 tool runner；與 LangChain 的比較。

Agent 生命週期完整解析（真實 agentic loop）；用 @beta_tool 與手寫 JSON 定義工具；工具回傳值設計；用 messages 歷史傳遞記憶；max_iterations 與 stop_reason 停止條件；Python 完整 Research Agent（tool_runner 可跑版）；常見陷阱（無限循環、token 爆炸）；Debug 技巧；單元測試與 mock client 策略。

單一 agent 有 context 限制、無法平行化、難以專業分工。本章教你用真實的 Anthropic SDK 設計 Orchestrator-Worker 多 agent 系統：在程式碼裡當 orchestrator 做 routing、用 asyncio 平行跑 subagent、設計 agent 間的資料傳遞，以及防止 agent 失控的關鍵技術。

從使用者角度到開發者角度，掌握 MCP（Model Context Protocol）Server 開發。學會定義 Tools、Resources、Prompts，讓你的服務被 Claude Code、Claude.ai 以及任何 MCP 客戶端呼叫。

從 Token 成本全貌、模型選擇策略、Prompt Caching 到 Batch API，系統性地把 AI 應用的成本降下來。一個真實 RAG 系統從每月 $2000 降到 $300 的完整過程。

開發環境跑得好，不代表生產環境沒問題。本章全面解析 Rate Limits、指數退避、錯誤分類、API Key 安全管理、Logging 策略，以及 OpenTelemetry 整合——附 10 項生產環境部署 checklist。

本書的綜合實戰章——一個完整的 AI 客服系統，涵蓋 Messages API、Tool Use、Prompt Caching、Streaming、Multi-Agent、成本優化的所有核心概念整合。從架構設計到 Cloud Run 部署，用真實程式碼走完全程。