非対話型セッションにおいて、外部プロセスから渡されたW3C標準のトレースコンテキストを読み取り、スパンを関連付けます。
In Agent SDK and non-interactive sessions started with -p, Claude Code also reads TRACEPARENT and TRACESTATE from its own environment when starting each interaction span. This lets an embedding process pass its active W3C trace context into the subprocess so Claude Code's spans appear as children of the caller's distributed trace. Interactive sessions ignore inbound TRACEPARENT to avoid accidentally inheriting ambient values from CI or container environments.
trace_id/span_id when TRACEPARENT is set in SDK/headless mode変更前
分散トレース情報が不完全になり、トレースの追跡が困難でした。
変更後
ID が正しく記録されるようになり、分散トレースが正常に統合されます。
ユーザーへの恩恵
大規模なシステムでエージェントの挙動を追跡する際、ログ同士の関連付けが確実に行えます。
TRACEPARENT/TRACESTATEを読み取り、分散トレーシングのリンクに対応TRACEPARENT/TRACESTATE from the environment for distributed trace linking変更前
SDK経由や非対話モードで実行している際、外部のモニタリングツールなどでシステム全体のトレースを確認しても、Claude Code内部の挙動と紐付けることが困難でした。
変更後
W3C標準のトレースコンテキスト環境変数をサポートし、上位のプロセスから渡されたトレース情報をClaude Code内のスパンと統合して出力できるようになりました。
ユーザーへの恩恵
大規模な自動化パイプラインやマイクロサービスの中でClaude Codeを使用する際、全体の処理フローとAIの挙動を一貫して可視化・デバッグできるようになります。
TRACEPARENT 環境変数を伝播させるようにしました。これにより、子プロセスのスパンが Claude Code のトレースツリーに正しく紐付けられます。TRACEPARENT env var to Bash tool subprocesses when OTEL tracing is enabled, so child-process spans correctly parent to Claude Code's trace tree変更前
AIが実行したコマンドの詳細なログ(スパン)が、Claude Code 本体のトレースと分離されてしまい、全体の実行フローを追跡するのが困難でした。
変更後
本体とサブプロセスのトレーシング情報が連結され、分散トレーシングツール上で一連の動作として可視化されます。
ユーザーへの恩恵
複雑なタスクのデバッグやパフォーマンス分析において、どのツールがどのタイミングで時間を要したかを正確に診断できるようになります。
TRACEPARENT環境変数を継承するようになりました。TRACEPARENT env var when tracing is enabled変更前
Claudeが実行したシェルコマンドからさらに呼び出されるコマンド(ビルドツールなど)の動きが、分散トレーシング上で繋がらず、詳細な解析が難しい状態でした。
変更後
親プロセスから子プロセスへとトレースIDが伝播し、一連の動作を一つの流れとして監視できるようになりました。
ユーザーへの恩恵
大規模なシステム開発において、Claudeが行った変更がどのようにビルドやテストに影響したかを、組織全体の観測プラットフォームで正確に追跡・分析できます。