14 · Agent SDK 开发实战

把 Claude Code 引擎装进你的产品

📚 《Claude Code 进阶玩法》第 14/20 篇 · 下一篇：15 · 自建 MCP Server

SDK 和 CLI 同引擎不同外壳——文件工具、权限、skills 生态都能带进你的应用。

01 最小应用

一个领域专用助手：自定义 system prompt + 裁剪工具面 + 指定可访问目录。几十行起步（示例文内附）。

02 工具裁剪

按用户角色裁剪工具面是产品化第一件事——把全部工具暴露给终端用户，一句注入就能让它读服务器敏感文件。

03 会话与多租户

会话持久化、用户间隔离、每用户预算——从"自己玩"到"给别人用"的三道坎。

04 何时用 SDK

需要文件/工具生态才用 SDK；纯对话场景直接调 API 更便宜——用 SDK 当普通 LLM API 是付了豪华套餐点白饭。

05 动手

用 SDK 做"团队文档问答机器人"雏形 → 验收：可对话、可读指定目录、权限受控。

06 小结

从工具用户到产品作者，隔着一个 SDK。下一篇反向接入：自建 MCP。

📎 实战案例

开发者用 Agent SDK 做团队文档机器人，第一版没裁工具面，测试同学一句话让它列了服务器目录。按用户角色裁剪工具面、加会话隔离后才敢上——SDK 应用第一件事是裁工具，不是加功能。

踩坑

• 我第一版机器人没裁工具面，测试同学一句话让它列了服务器目录——裁剪先于上线。
• 重造了 SDK 已有的会话管理——先读能力清单再动手。