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 示例和五条实践建议。
Claude Code SDK 每日技术拆解2026. 06. 01. 09:03:39Claude 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:41Claude Code SDK #7:子 Agent 编排全解——上下文隔离 × 工具沙盒 × 并行加速,让主 Agent 不再被子任务撑爆SDK 的 AgentDefinition 把多 Agent 系统从抽象架构变成 5 行代码。本篇完整拆解子 Agent 的三种创建方式、AgentDefinition 10 个字段的作用、父子上下文继承机制(子 Agent 有什么、没有什么)、三个典型场景的完整代码示例(并行代码审查、动态 Agent 工厂、调用追踪),以及工具权限最小化原则、子 Agent 恢复机制和两个最容易踩的坑。