settings.json

otelHeadersHelper

型string記述場所どの設定ファイルでも可

OpenTelemetry ヘッダーを JSON オブジェクトとして出力する実行可能ファイルのパス、または引数付きのシェルコマンドラインを指定する。起動時に実行され、CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS で設定された間隔で再実行される。CLAUDE_CODE_ENABLE_TELEMETRY=1 が必要。 See https://code.claude.com/docs/en/monitoring-usage#dynamic-headers

既定値: 未設定であり、Claude Code はヘルパーが生成したヘッダーを追加しない

記述例

{
  "otelHeadersHelper": "/bin/generate_otel_headers.sh"
}

使い方・用途

  • OpenTelemetry のエクスポート先バックエンドでトークンがローテーションする場合に、起動時と定期的にヘッダーを再生成して認証情報を最新のまま保つ
  • 組織の OpenTelemetry コレクターに送る認証ヘッダーを、設定ファイルにトークンを直接書かずに自前のスクリプトで動的に生成したい場合に使う
  • セッションのテレメトリーを中継ではなく自分の collector に直接送る運用で、ヘッダーの要件を満たす手段として用いる
英語原文(公式ドキュメントより)

Path to an executable, or a shell command line with arguments, that outputs OpenTelemetry headers as a JSON object. Runs at startup and re-runs on the interval set by CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS. Requires CLAUDE_CODE_ENABLE_TELEMETRY=1. See https://code.claude.com/docs/en/monitoring-usage#dynamic-headers

関連する変更履歴

v2.1.275(1件)

Added
設定された otelHeadersHelper の失敗時に起動時の警告を表示するようにした。テレメトリが何もエクスポートされていないセッションに気づけるようになる
英語原文を表示
Added a startup warning when a configured otelHeadersHelper fails, so sessions that silently export no telemetry are noticed

変更後

設定した otelHeadersHelper が失敗したときにセッション開始時に警告が表示されるようになり、テレメトリが通知されないまま静かに失われていることにすぐ気づける。

関連ドキュメント

v2.1.149(1件)

Fixed
otelHeadersHelperのスクリプトパスにスペースが含まれている場合に無言で失敗する問題を修正し、失敗を/doctorやログで報告するようにしました
英語原文を表示
Fixed otelHeadersHelper failing silently when the script path contains spaces; helper failures are now reported in /doctor and the debug log

変更後

監視設定のトラブルシューティングが容易になり、不具合に気づかないまま運用してしまうリスクを軽減できます。