Claude Code SDK 每日技术拆解

공개

이 채널에는 아직 추가 소개가 없습니다.

Claude Code SDK 每日技术拆解2026. 06. 06. 09:12:52

Claude Code SDK #13：自动化脚本全解——`-p` 开关背后的完整标志体系，把 Claude Code 嵌进任意流水线

CLI 的 -p（--print）模式是把 Claude Code 从交互工具变成可编程组件的关键开关。本篇完整拆解三种输出格式（text/json/stream-json）的选型逻辑、--max-turns/--max-budget-usd 防止脚本失控、--bare 最小模式加速批量启动、--exclude-dynamic-system-prompt-sections 提升 CI 缓存命中率、系统 Prompt 追加 vs 替换策略、后台会话的脚本管理，以及一个把这些标志组合成完整 CI 审查脚本的实战示例，附五条可落地的实践建议。

Claude Code SDK 每日技术拆解2026. 06. 05. 09:12:20

Claude Code SDK #12：权限与安全全解——五步评估链 × 五种模式 × Allow/Deny 规则，精准控制 Agent 的工具访问边界

权限系统不是一个开关，而是一条五步单向评估链：Hooks → Deny 规则 → Permission Mode → Allow 规则 → canUseTool 回调，每步都可能终止请求。本篇完整拆解 allowed_tools 与 disallowed_tools 的行为差异（后者才是真正的全局拦截）、bypassPermissions 不受 allowed_tools 约束的关键陷阱、五种 mode 的选型逻辑、set_permission_mode 动态切换、canUseTool 回调的 Python 实现要点，以及 acceptEdits 模式的精确边界，附五条可落地的实践建议。

Claude Code SDK 每日技术拆解2026. 06. 04. 09:11:06

Claude 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:06

Claude 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:31

Claude 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 示例和五条实践建议。

Claude Code SDK 每日技术拆解2026. 06. 01. 09:03:39

Claude Code SDK #8：MCP 集成全解——三种接入方式 × 工具命名规范 × Tool Search 懒加载，把 Agent 能力边界推到任意外部服务

MCP 是 Claude Code SDK 把 Agent 能力边界从「内置 11 工具」扩展到任意外部服务的核心机制。本篇完整拆解三种传输方式的选型逻辑（stdio/HTTP-SSE/SDK内嵌）、工具命名规范 mcp__<server>__<tool>、allowedTools 与 permissionMode 的对比、三种认证方式、连接状态检测，以及大量工具时的 Tool Search 懒加载机制，附 Python/TypeScript 完整代码示例和五条实践建议。

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 的多轮有状态自动化工作流。