097、Claude API 加 Agent SDK 编程：用 API 构建自定义代码助手的架构设计

097、Claude API 加 Agent SDK 编程：用 API 构建自定义代码助手的架构设计

上周五凌晨两点，我在调试一个生产环境的微服务链路追踪问题。OpenTelemetry 的 span 数据死活不对，日志里全是context deadline exceeded。我习惯性地打开 Claude Code 准备让它帮我分析，结果发现——它只能处理我粘贴进去的代码片段，没法直接挂载到我的 Jaeger 实例上拉数据。

那一刻我意识到：Claude Code 再强，也是个通用工具。真正解决工程问题，得自己搭一个能理解你基础设施的代码助手。

于是有了这篇文章。不是教你调 API，是讲怎么用 Claude API + Agent SDK 搭一个能“长”在你项目里的自定义代码助手。我会把踩过的坑、改过的架构、以及那些“别这样写”的教训都摊开说。

为什么不用现成的 Claude Code 而要自己搭？

Claude Code 是个好产品，但它有几个硬伤：

• 上下文隔离：它不知道你的 CI/CD 流水线、监控系统、数据库 schema
• 工具链绑定：你没法给它注册自定义工具，比如“查一下这个服务的 QPS 趋势”
• 权限模型缺失：生产环境里，你不能让一个 AI 随便