0002-claude-agent-sdk.md 584 B

ADR-0002 Claude 通过 Agent SDK 接入

  • 状态:Accepted · 日期:2026-10-22

决策

使用 @anthropic-ai/claude-agent-sdk,不直接解析 claude -p --output-format stream-json。

理由

  • canUseTool 异步回调可以挂起等待人工审批和回答提问(硬需求)
  • 原生支持 resume、interrupt、流式输入(图片)、部分消息增量
  • 默认不加载本机 settings,行为可预测

代价

与 SDK 版本耦合;需要锁定版本,并通过回归用例验证升级。 详见 design/03-providers.md。