Claude Code SDK 每日技术拆解2026/06/04 09:11:06Claude Code SDK #11:流式输出全解——一个参数打开 Agent 运行时的实时可观测性默认模式下 Agent 运行像个黑盒,结果出来前什么都看不到。设置 include_partial_messages=True,SDK 开始向 async generator 插入 StreamEvent,文本逐字输出、工具调用实时显示状态。本篇完整拆解三层嵌套类型检查(StreamEvent→content_block_delta→text_delta)的设计逻辑、工具调用流的追踪方式、流式 UI 的构建模式,以及结构化输出在流式模式下的已知限制,附五条可落地的实践建议。
Claude Code SDK 每日技术拆解2026/06/03 09:13:06Claude Code SDK #10:结构化输出全解——JSON Schema × Zod/Pydantic,让 Agent 直接返回你要的数据结构Agent 默认返回自由文本,但应用需要的是可直接入库、渲染 UI 的结构化数据。本篇完整拆解 outputFormat 参数的接入方式、Zod/Pydantic 类型安全用法、多步工具调用下的结构化约束、error_max_structured_output_retries 错误处理,以及五条避免验证失败的实践建议。
Claude Code SDK 每日技术拆解2026/06/02 09:13:31Claude Code SDK #9:自定义工具全解——@tool 装饰器 × in-process MCP × 错误处理 × 非文本返回,把任意函数变成 Claude 的能力自定义工具是 Claude Code SDK 把 Agent 能力扩展到任意外部系统的核心机制。本篇完整拆解工具四要素(Name/Description/Input Schema/Handler)、Python @tool 装饰器与 create_sdk_mcp_server 注册流程、mcp__{server}__{tool} 命名规范与通配符放行、readOnlyHint 并行加速、throw 与 is_error 的错误处理差异、image/resource/structuredContent 非文本返回,以及 JSON Schema 枚举参数全写法,附完整可运行 Python 示例和五条实践建议。