拆解 Claude Code 客户端工具调用流程

是什么

视频以“查看 Git 改动”为例，展示 Claude Code 与模型之间一次客户端工具调用：模型先返回含工具名和参数的结构化内容，客户端执行命令后，将输出作为结果回传，再由模型生成自然语言总结。

关键内容

演示重点是 tool_use、调用 ID、Bash 参数与 tool_result 的配对关系，以及 stop_reason 从工具调用状态变为结束状态的两轮交互。作者借助 claude-tap 观察请求、响应与 SSE 事件，并以 git status、git diff 作为执行样例。

可借鉴之处

排查 Agent 工具链时，可分别记录模型请求、实际命令、工具输出和关联 ID；这样能定位问题发生在模型决策、客户端执行还是结果回传环节，也能避免把“模型提出调用”误认为“模型直接执行”。

边界与风险

这是基于单次演示的协议讲解，术语、字段名和具体行为应以所用客户端及 API 文档为准。工具参数会触发本地命令执行，生产实现仍需权限控制、命令审计、输出脱敏和用户确认；视频中提到的服务端工具未作完整验证。