必须在Claude Code运行时手动注入OpenTelemetry SDK并配置导出器,因其本身不内置OTel支持;需确认Python环境、安装SDK包、编写初始化脚本、修改启动入口加载instrument模块。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要让Claude Code的代码执行过程被OpenTelemetry追踪并上报使用指标,必须在运行时注入OTel SDK并配置好导出器,否则所有调用都会静默丢失。
确认Claude Code运行环境支持手动注入SDK
检查当前部署方式:若为Docker容器运行,需确保镜像基础层包含Python 3.9+且未冻结pip;若为本地VS Code插件调用的独立进程,则需定位到其实际执行的Python解释器路径。
这一步不可跳过——【Claude Code本身不内置OTel支持,所有追踪必须由宿主环境主动加载】。
执行 python -c "import sys; print(sys.executable)" 获取真实解释器路径。
安装OpenTelemetry相关包
方法一(推荐):在Claude Code所用Python环境中直接安装:
pip install opentelemetry-api opentelemetry-sdk opentelemetry-exporter-otlp-proto-http
方法二:若无法修改原环境,构建带OTel的wrapper脚本,用subprocess.Popen调用原命令前先注入sys.path和环境变量。
编写并注入OTel初始化代码
创建otel_instrument.py,内容如下:
记录结构化的Claude Code轨迹、影子git diff,并在代理行为需要法医级调试而非临时转录审查时回放分支。
from opentelemetry import trace
from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import BatchSpanProcessor
from opentelemetry.instrumentation.requests import RequestsInstrumentor
provider = TracerProvider()
processor = BatchSpanProcessor(OTLPSpanExporter(endpoint="http://localhost:4318/v1/traces"))
provider.add_span_processor(processor)
trace.set_tracer_provider(provider)
RequestsInstrumentor().instrument()
注意:endpoint地址必须与你部署的OTel Collector一致,【填错会导致所有span完全不上报,且无错误提示】。
启动Claude Code时加载OTel初始化模块
第一步:确认Claude Code启动入口——通常是某个.py文件或通过__main__.py触发。
第二步:在该入口文件最顶部插入:
import sys
sys.path.insert(0, "/path/to/your/otel_instrument.py目录")
import otel_instrument
第三步:保存后重启Claude Code进程。此时所有requests调用、函数执行将自动生成span并发送至Collector。










