結論先說
- 個人自查用
/cost和/status,團隊彙總用官方內置的 OpenTelemetry(OTel)原生導出,不需要外掛抓包代理。 - 注意
/cost的適用範圍:按 API 計費(Console / 雲廠商網關)登入時,/cost會展示精確的本次會話折算花費、輸入輸出及緩存命中明細;使用 Pro 或 Max 訂閱登入時,配額按滾動窗口結算,應在/status或網頁端用量頁查看進度比例。 - 預設必須顯式打開
CLAUDE_CODE_ENABLE_TELEMETRY=1總開關才會外發監控數據,支持標準的otlp(gRPC 或 HTTP)協議直推內網 Collector。 - 私隱保護預設安全:即便開啟了日誌事件導出,官方預設也不記錄用戶的原始提示詞文本(只記字符長度等元數據),避免敏感需求描述意外落入運維日誌庫。

圖:本站根據 Claude Code 官方文檔 Monitoring usage 整理的示意圖
本文根據 Claude Code 官方文檔《Monitoring usage》《Manage costs effectively》整理,核對日期 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Anthropic 官方網站。
適用於誰
- 搜「claude code 監控用量」「claude code opentelemetry」「claude code /cost 怎麼看」的研發負責人與平台工程師;
- 給幾十名研發分配了 API 密鑰或團隊席位後,想在公司自建的 Prometheus、Grafana 或 Datadog 裏統計各模型消耗、代碼採納率與異常大額會話的管理員;
- 擔心開啟監控會把員工輸入的業務源碼和提示詞明文傳進日誌系統的安全負責人。
如果你只關心在自己終端底部常駐顯示當前上下文進度條,可以先看 /guides/claude-code-statusline-model-context-usage。
一、個人日常自查:看懂 /cost 裏的緩存讀寫比例
單兵開發排錯時,在交互會話裏敲 /cost,除了總消耗數字外,最值得盯緊的是緩存創建(Cache write)與緩存讀取(Cache read)的比例:
- 健康的同一模型長會話裏,絕大多數輸入 Token 應該落在折扣極高的「緩存讀取」一欄;
- 如果你發現每一輪都在大量觸發昂貴的「緩存寫入」,往往說明你中途頻繁切換模型,或者開了過多生命週期極短的獨立子代理(控費優化見 /guides/multi-agent-token-cost-why-high-how-to-control)。
二、團隊級監控:四步接入標準 OpenTelemetry 採集端
當團隊超過五個人時,官方推薦通過 settings.json(層級與託管下發機制見 /guides/claude-code-settings-json 與 /guides/claude-code-team-collaboration-shared-config)統一配置環境變量,把遙測信號推往你們內網自己的 OpenTelemetry Collector。

圖:本站根據 Claude Code 官方文檔 Monitoring usage 整理的示意圖
在用戶級或組織級託管 settings.json 的 env 塊中寫入:
json
{
"env": {
"CLAUDE_CODE_ENABLE_TELEMETRY": "1",
"OTEL_METRICS_EXPORTER": "otlp",
"OTEL_LOGS_EXPORTER": "otlp",
"OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",
"OTEL_EXPORTER_OTLP_ENDPOINT": "http://otel-collector.example.internal:4317",
"OTEL_RESOURCE_ATTRIBUTES": "department=backend,team=checkout"
}
}
如果只在本機終端驗證數據結構,不用搭後端服務,直接把 OTEL_METRICS_EXPORTER 臨時設成 "console",指標就會打印在終端標準輸出裏供你核對字段。
三、看板最該盯哪幾項核心官方指標
連接成功後,Claude Code 會定時上報兩類核心數據流——時序指標(Metrics)與結構化事件(Logs/Events):
- 成本與用量核心指標:
claude_code.token.usage:帶type(input、output、cacheRead、cacheCreation)和model標籤,一眼看出是不是全員連簡單搜尋都在燒頂級模型;claude_code.cost.usage:按模型統計預估 API 開銷趨勢;claude_code.session.count與活躍時長:評估團隊真實使用頻率,識別閒置帳號;
- 產出與採納指標:
claude_code.lines_of_code.count(區分新增與刪除行數)、創建的提交與 Pull Request 數量,以及工具權限彈窗的批准/拒絕統計,幫助工程效能團隊量化真實提效情況。
對於沒有自建運維監控基礎設施的小團隊或高頻獨立開發者,如果只是擔心 API 按量計費波動不可控,直接採用固定週期限額的個人訂閱(如 /chongzhi/claude-max 或 Pro 方案)在預算封頂上會更直觀省事。
常見問題
Q:開啟 OTEL_LOGS_EXPORTER=otlp 後,員工在對話框裏貼的代碼片段會被髮進日誌系統嗎?
按官方私隱說明,預設狀態下用戶輸入的提示詞正文(Prompt content)是脫敏屏蔽的,事件裏只保留提示詞長度等統計字段;只有當企業出於嚴格合規留痕需求,由管理員顯式額外設定 OTEL_LOG_USER_PROMPTS=1 時才會記錄原文。
Q:配好了環境變量,為什麼在 Grafana 裏要等一分多鐘才看到點?
OpenTelemetry SDK 預設的指標批量上報間隔較長(常見預設為 60 秒)以減少網絡請求開銷。在測試聯調階段想立刻看到數據,可以臨時加上 "OTEL_METRIC_EXPORT_INTERVAL": "10000"(10 秒導出一次),上線後再改回預設週期。
Q:怎麼防止員工在自己電腦上手動改設定把團隊遙測開關關掉?
企業管理員可將上述環境變量寫入系統級受控目錄的託管設定文件(Managed settings.json),託管層級的優先級高於個人用戶目錄與項目目錄配置,普通會話無法覆蓋關閉。
相關教學
- /guides/claude-code-settings-json:
settings.json各層級優先級與託管下發配置 - /guides/claude-code-team-collaboration-shared-config:Claude Code 團隊協作統一配置指南
- /guides/multi-agent-token-cost-why-high-how-to-control:多代理 Token 膨脹排查與緩存省錢技巧
- /guides/claude-code-statusline-model-context-usage:在狀態欄實時顯示模型與上下文佔用
參考資料
- Claude Code 官方文檔:Monitoring usage (OpenTelemetry) — https://code.claude.com/docs/en/monitoring-usage
- Claude Code 官方文檔:Manage costs effectively — https://code.claude.com/docs/en/costs
0 條評論
還沒有評論,來搶沙發~