Claude Code SDK 每日技术拆解

公开

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

Claude Code SDK 每日技术拆解2026/06/10 09:11:48

Claude Code SDK #17：Memory 与 CLAUDE.md 全解——两套机制 × 四层作用域 × 路径级按需加载，让 Claude 跨 session 记住一切

每次新 session Claude 都从零记忆出发，CLAUDE.md 和 Auto Memory 是解决这个问题的两套互补机制。本篇完整拆解四层作用域（Managed/User/Project/Local）与加载顺序、`.claude/rules/` 的路径级按需加载如何省 token、Auto Memory 的存储结构与懒加载设计、企业 Managed 层部署与 claudeMdExcludes 策略，以及「/compact 后规则消失」等三个高频调试坑，附五条可落地的实践建议。

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

Claude Code SDK #16：Hooks 全解——30+ 生命周期事件 × 五种处理器 × 精准决策链，把 Agent 行为变成可编程的

大多数人知道 Claude Code 有权限系统，但背后还有一套更底层的可编程层：Hooks。本篇完整拆解 30+ 个生命周期事件（PreToolUse/PostToolUse/Stop/SessionStart 等三层结构）、五种处理器类型（Command/HTTP/MCP 工具/Prompt/Agent）、两条控制路径（exit code vs JSON output）、PreToolUse 四档决策（allow/deny/ask/defer）、Matcher 匹配规则与 `if` 过滤器，以及异步 Hook 和 Stop Hook 质量门禁的实战用法，附五条可落地的实践建议。

Claude Code SDK 每日技术拆解2026/06/08 09:13:18

Claude Code SDK #15：Settings 配置体系全解——四层作用域 × 优先级链 × 热重载，精确控制 Agent 行为

大多数人只知道 Claude Code 有个 settings.json，但背后是一套「配置层次体系」——四层作用域（Managed/User/Project/Local）决定「谁的配置」，优先级链决定「谁覆盖谁」，数组合并规则决定「权限规则如何叠加」，热重载边界决定「什么时候需要重启」。本篇完整拆解这套体系，覆盖 permissions/env/apiKeyHelper/sandbox 等核心字段、企业 MDM 受控部署、drop-in 目录管理，并附五条可落地的实践建议。

Claude Code SDK 每日技术拆解2026/06/07 09:11:25

Claude Code SDK #14：IDE 集成全解——`--ide` 标志、内置 MCP 服务器、诊断信息流与多目录权限

装上 VS Code 扩展或 JetBrains 插件只是开始。本篇完整拆解 `--ide` 标志的自动接线逻辑、内置 IDE MCP 服务器如何把 lint/编译报错实时流入 Claude 上下文（`mcp__ide__getDiagnostics`）、Jupyter 代码执行的安全确认机制、JetBrains WSL2 接线的两种方案，以及 `--add-dir` 多目录权限与「文件访问 ≠ 配置加载」的关键限制，附五条可落地的实践建议。

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 的关键差异。