15 · SDK 嵌入

把 Codex 装进你自己的产品

📚 《Codex 进阶玩法》第 15/20 篇 · 下一篇：16 · 团队规范落地

从用户到作者：SDK 把 Codex 能力嵌进你的应用（与《Agent 开发进阶》衔接）。

01 何时用 SDK

需要它的工具生态与会话管理才用 SDK；纯对话场景直接调模型 API 更便宜。先读 SDK 能力清单——重造已有的会话管理是常见浪费。

02 最小产品

领域助手：自定义指令 + 裁剪工具面 + 限定目录。产品化第一件事是按用户角色裁剪工具面——全工具面暴露给终端用户，一句注入就能读宿主机文件。

03 多租户

用户隔离、每用户预算、审计日志——"给别人用"的三道坎，一个都省不得。

04 动手

做"运维手册问答+脚本代跑"内部助手雏形 → 验收：对话可用、工具受控、双用户隔离。

05 小结

自动化五连完结。下一段把个人打法变成团队制度。

📎 实战案例

开发者用 SDK 做内部助手，第一版暴露了全工具面，一句注入就让它读了宿主机文件。按角色裁剪工具面、加多租户隔离后才敢上——纯对话场景其实直接调 API 更便宜，别用 SDK 点白饭。

踩坑

• 我首版助手没裁工具面，测试同学一句话让它列了服务器目录——裁剪先于一切。
• 重造了 SDK 自带的会话管理，浪费一周——能力清单先读。