Bible Network Crypto DeFi Onchain RWA AI Agent Stablecoin Chain SAFU CryptoTax DeFAI AGI Claude Me Claude Skill Claude Design Claude Cowork
獨立知識媒體
與任何項目無關聯
學會用 Claude,每件事都做得更好
claudeskill-me.com
最新
用 OpenTelemetry 看 Claude Code 的壓縮與 hook:compaction、hook_execution_complete 與 precompute_reuse 欄位怎麼讀  ·  Bash 權限規則的盲區:deny 擋不住 /bin/rm、bash -c 與 git -C,devbox run * 還會放行內層任何命令  ·  CLAUDE.md 太長了怎麼辦:用 .claude/rules/ 與 paths 讓規則只在碰到特定檔案時才載入  ·  沙盒裡跑 Chromium 出現 No usable sandbox!:--no-sandbox、excludedCommands、allowNestedUserNamespaces 三種解法各放棄什麼  ·  Claude Code v2.1.309:沙盒啟動檔不再在沙盒外執行、denyWrite 經 symlink 失效等一批沙盒與權限缺口修正  ·  auto mode 的 $defaults 陷阱:autoMode.soft_deny 少放一個字串,內建的 force push 攔截規則就整批消失
名詞解析 · tools-integration

OpenTelemetry

OpenTelemetry(遙測事件)
tools-integration advanced

30 秒版 · 給沒耐心的人
業界標準的可觀測性框架;Claude Code 可以用它把用量指標與行為事件(壓縮、hook、工具決定等)輸出到你的收集器,需設 CLAUDE_CODE_ENABLE_TELEMETRY=1 才會啟用。
完整解說 +
01 · 這是什麼?

OpenTelemetry 是什麼,Claude Code 怎麼用它?

OpenTelemetry(OTel)是可觀測性的開放標準,定義了指標、事件(日誌)與追蹤怎麼輸出。官方監控文件說,Claude Code 在 CLAUDE_CODE_ENABLE_TELEMETRY=1 之後,可以輸出 claude_code.* 事件,例如 user_prompt、tool_decision、compaction、hook_registered、hook_execution_complete、at_mention、api_retries_exhausted。

02 · 為什麼存在?

為什麼存在?

個人用 Claude Code 看畫面就知道發生什麼,但團隊或 CI 要回答「誰載入了哪些 hook」「壓縮是不是失敗」「哪些工具被拒絕」就需要結構化紀錄。OTel 讓這些資料能進你已有的觀測平台,而不是各家自訂格式。

03 · 如何影響你的決策?

怎麼開啟?

文件的最小設定:CLAUDE_CODE_ENABLE_TELEMETRY=1(必要)、OTEL_LOGS_EXPORTER 選 otlp、console 或 none;送到收集器時再設 OTEL_EXPORTER_OTLP_PROTOCOL(無預設值,需自己設)與 OTEL_EXPORTER_OTLP_ENDPOINT,匯出間隔 OTEL_LOGS_EXPORT_INTERVAL 預設 5000 毫秒。送出一個 prompt 後看到 claude_code.user_prompt 就代表通了。工具參數等細節預設不記,要設 OTEL_LOG_TOOL_DETAILS=1。

04 · 你該怎麼辦?

對我有什麼影響?

如果你負責一個團隊的 Claude Code 使用,先開 console 輸出看一次事件長什麼樣,再決定接哪個後端。要注意事件不是完整稽核證據,部分欄位要額外開關才有;我沒有架過收集器實測。

資料來源:Monitoring - Claude Code Docs、Claude Code changelog - Claude Code Docs
實際例子 +

公開文件可查的例子:claude_code.compaction 事件有 trigger、pre_tokens、post_tokens 與 precompute_reuse(hit 或 miss_*),可以用來統計壓縮是否頻繁、有沒有重用背景預備的摘要。

常見誤解 +
✕ 誤解1
× 誤解:OpenTelemetry 只能看 token 與成本,實際是:官方文件還列了壓縮、hook、工具決定、@ 提及、API 重試用盡等事件
✕ 誤解2
× 誤解:設了 OTEL_LOGS_EXPORTER 就會有資料,實際是:還必須設 CLAUDE_CODE_ENABLE_TELEMETRY=1,用 otlp 時 OTEL_EXPORTER_OTLP_PROTOCOL 也沒有預設值
這件事跟你有什麼關係 +
直接影響

優點是標準格式、可進既有觀測平台、事件粒度細;缺點是要自己架收集器與儀表板,且事件是 session 層級紀錄,不等於完整稽核。

提問
請至少輸入 10 個字
更多相關主題