Claude Code 可观测性怎么做？|code|tool|沙箱|虚拟机|调用

昨天老冯发了条推特：“做了个 Claude Code Grafana Dashboard ，研究下它是怎么做决策，用工具，调 API 花钱的。”结果发现非常多的用户都对这个主题感兴趣。

这是我没想到的。所以今天来聊一聊那就是 Claude Code 的可观测性。

老冯的想法其实非常简单 —— 我也挺好奇这个 Claude Code 内部到底是怎么工作的。虽然 Claude Code 不开源（），但你其实可以通过它的监控指标和日志，分析出它的大概工作原理。

Claude Code 提供 OTEL 格式的指标和日志，而且配置起来其实挺简单的。你只要指定几个环境变量，就可以让它主动推送到支持 OTEL 的监控系统里面去，然后用 Grafana 进行可视化。

这里的难点其实在于：我去哪找这么一个监控系统和 Grafana 呢？后来我看见这么多人都有需求，就干脆做一个开箱即用的配置模板。你只要找一台 Linux 服务器，运行几行命令把这个东西拉起来，它就会自带一个 Claude Code 的环境，所有东西都帮你配好了（包括监控这些）。你也可以直接把自己的 Claude Code 监控给接进去。

实际上，如果你已经会用 Claude Code 的话，并不需要了解太多细节。你只要告诉它有这么个东西、能干这么个事，并给它准备一台虚拟机，剩下的事它都应该能帮你自动干好。我看有人评论留言就是这么说的。哈哈！

监控事件说明

这个监控面板其实很朴素：上方可以选择会话（Session ID），选择之后，下方会列出各种各样的事件。你可以通过拖动来查看在处理任务的过程中都产生了哪些事件。

目前最主要的事件分为以下四大类：

1.User Prompt：你对它说了什么，或者给了什么提示词2.API Request：调用 API 的请求3.Tool Decision：系统决定使用什么工具4.Tool Result：工具返回的具体结果

每个事件都有一些对应的字段。大体上，只要看一眼这个面板，就能明白整个任务的处理流程是怎么一回事了。

举个例子，最简单的事件就是 User Prompt，你给 CC 发一条信息，就会有一个这个事件：

User Prompt 事件之后，通常是 API Request，也就是调用 API 模型。这里会有一个 model 字段 —— Claude 是区分了快速模型和高质量模型的，这里我用的是 GLM 4.7 作为例子，有些简单快速的请求，是 4.5-air 来处理的。

然后 API Request 事件会有几个核心字段：Cost，就是开销，然后是四个 Token 指标。Token.In/Out 就是输入，输出的 Token，Token Cache Read 则是缓存命中的指标。

API Request 完成之后，通常会有一个 Tool Decision 事件，也就是模型进行了决策，用什么样的工具。这里比如说就有 Bash，Read，Write，Search 等各种各样的 Tool，然后会有一个 Decision Source / Result，也就是根据什么标准（配置文件/询问用户/……），选择 “批准” / “拒绝”。

Tool Decision 事件之后，就是 Tool Restult 事件了。这是调用工具的关键事件，关键字段包括 —— Tool 的命令，说明，错误，参数，UseID，成功与否等等……