Claude Code SDK 每日技术拆解

公开

这个频道还没有补充简介。

Claude Code SDK 每日技术拆解2026/05/31 09:05:41

Claude Code SDK #7：子 Agent 编排全解——上下文隔离 × 工具沙盒 × 并行加速，让主 Agent 不再被子任务撑爆

SDK 的 AgentDefinition 把多 Agent 系统从抽象架构变成 5 行代码。本篇完整拆解子 Agent 的三种创建方式、AgentDefinition 10 个字段的作用、父子上下文继承机制（子 Agent 有什么、没有什么）、三个典型场景的完整代码示例（并行代码审查、动态 Agent 工厂、调用追踪），以及工具权限最小化原则、子 Agent 恢复机制和两个最容易踩的坑。

Claude Code SDK 每日技术拆解2026/05/30 09:04:15

Claude Code SDK #6：Hooks 系统全解——在 Agent 生命周期的每个节点插入你的代码

Hooks 是 Agent SDK 的「神经系统」——在工具调用前后、会话开始结束、用户提示提交等关键节点插入回调函数，不改动任何 SDK 内部代码，就能拦截危险操作、审计工具调用、动态注入上下文。本篇完整拆解生命周期三层结构（每会话/每轮/每工具）、HookMatcher 配置、五种决策输出、三个典型场景代码示例，以及 Python vs TypeScript 的关键差异。

Claude Code SDK 每日技术拆解2026/05/29 09:05:46

Claude Code SDK #5：消息流全解——6 种消息类型 × async for，把 Agent 执行过程变成可编程事件流

query() 返回的不是字符串，而是持续吐出消息对象的异步流。SDK 定义了 6 种消息类型：SystemMessage（会话初始化与事件）、AssistantMessage（每轮 Claude 回复，含工具调用决策）、UserMessage（用户输入与工具结果回传）、ResultMessage（任务终态 + 成本统计）、StreamEvent 和 RateLimitEvent。本篇完整拆解每种类型的数据结构、五种典型消费模式的代码写法、async for 的正确使用姿势（含「不要用 break 提前退出」的坑），以及 CLI 侧 stream-json 模式的对应关系。

Claude Code SDK 每日技术拆解2026/05/28 09:06:31

Claude Code SDK #4：内置工具全解——11 种工具 × 5 种权限模式，精准控制 Agent 能干什么

SDK 内置 11 种工具（Read/Write/Edit/Bash/Glob/Grep/WebSearch 等），搭配 allowed_tools、disallowed_tools 两个过滤器和 5 种 permission_mode，构成一套完整的工具权限体系。本篇完整拆解 11 种工具的能力范围、两个过滤器的本质区别、权限评估的 5 步顺序，附三种典型配置代码示例和选型建议。

Claude Code SDK 每日技术拆解2026/05/27 09:07:08

Claude Code SDK #3：Session 管理全解——continue / resume / fork 三把钥匙，让 Agent 真正拥有记忆

Session 是 Agent 的记忆，SDK 把每次对话存成本地 JSONL。本篇完整拆解三种 session 模式：continue（自动追踪最近会话）、resume（按 ID 精确恢复）、fork（分叉探索不同路径），附 Python/TypeScript 完整代码示例、CLI 对应命令，以及跨机器迁移的两种策略和四条实践建议。

Claude Code SDK 每日技术拆解2026/05/26 09:07:00

Claude Code SDK #2：--output-format 三种模式全解——把 Claude 嵌进任何脚本的正确姿势

Claude Code 命令行的 --output-format 有三种模式：text 适合管道和文件，json 适合提取元数据（token 用量、stop reason），stream-json 适合长任务实时处理。本篇完整拆解三种模式的输出结构、适用场景和实用脚本组合，包括 CI 审查机器人、批量文档生成和带 session-id 的多轮有状态自动化工作流。

Claude Code SDK 每日技术拆解2026/05/25 18:17:34

Claude Agent SDK #1：query() 函数全解——三行代码启动一个自主 Agent

整个 Claude Agent SDK 只有一个主入口：query()。本篇完整拆解它的三个核心参数（prompt / ClaudeAgentOptions / 消息流）、五种 permission_mode 的适用场景与安全边界、内置工具组合策略，以及 async for 消息流的正确消费方式——帮你从第一行代码就建立对 SDK 的完整心智模型。

Claude Code SDK 每日技术拆解2026/05/25 09:04:06

OpenAI Agents SDK #34：自定义 TracingProcessor——把 Agent 链路数据接进你自己的可观测性系统

默认 trace 只发 OpenAI 后台？这期完整拆解 SDK 的 Processor → Exporter 可插拔管道：TracingExporter 接口实现、BatchTraceProcessor 五参数调优（队列容量 / 批大小 / 触发比例）、add_trace_processor vs set_trace_processors 的关键区别、flush_traces() 在长驻进程里的必要性、custom_span 业务埋点，以及生产级接入五项清单。

Claude Code SDK 每日技术拆解2026/05/24 09:05:39

OpenAI Agents SDK #33：AgentHooks vs RunHooks——两层生命周期钩子，精准插入 Agent 执行的每个关键节点

SDK 的生命周期钩子系统分两层：RunHooks 全局监听整个运行，AgentHooks 精确绑定到某个 Agent 实例。七个异步钩子方法覆盖 LLM 调用、工具执行、handoff 等所有关键节点，配合 ToolContext 可拿到工具调用的完整元数据（call_id、参数、返回值），是做成本审计、链路日志和行为定制的核心抓手。

Claude Code SDK 每日技术拆解2026/05/23 09:04:53

OpenAI Agents SDK #32：RunConfig 完整拆解——20+ 字段五大功能域，一次性掌握全局运行配置

RunConfig 是 SDK 里最被低估的对象——20 多个字段涵盖五大功能域。本期完整拆解工具并发限流（ToolExecutionConfig.max_function_tool_concurrency）、模型调用前拦截（call_model_input_filter）、错误优雅降级（error_handlers）、reasoning item ID 策略（omit 防 400）和全局可观测性配置，附生产级配置模板与四条落地建议。

Claude Code SDK 每日技术拆解2026/05/22 09:07:16

OpenAI Agents SDK #31：MCPServerStreamableHttp——MCP 三传输方式的最后一块拼图，2025-03-26 新规范完全拆解

MCPServerStreamableHttp 是 OpenAI Agents SDK 对 MCP 2025-03-26 新传输规范的正式实现。本期完整拆解 MCPServerStreamableHttpParams 的 8 个字段，重点解析 terminate_on_close 会话生命周期控制、session_id 跨进程会话复用、ignore_initialized_notification_failure 兼容性开关，以及内置的共享会话→隔离会话自动降级重试机制。附三种 MCP 传输方式七维横向对比矩阵与三条生产建议。

Claude Code SDK 每日技术拆解2026/05/21 09:08:23

OpenAI Agents SDK #30：HostedTool 收官三件套——ComputerTool × CodeInterpreterTool × LocalShellTool 完整拆解

HostedTool 家族最后三个成员一次讲完：ComputerTool 操控真实桌面（ComputerProvider 生命周期钩子 + on_safety_check 安全回调）；CodeInterpreterTool 在 OpenAI 云端沙盒跑 Python（container 四维配置：file_ids / memory_limit / network_policy / 复用容器 ID）；LocalShellTool 在你本机执行 Shell（executor 自定义函数 + 强制 codex-mini-latest 模型）。附三工具 7 维横向对比矩阵与生产级安全实践建议。