Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

OpenTelemetryの tool_result イベントにおける tool_parameters は、OTEL_LOG_TOOL_DETAILS=1 フラグの後ろにゲーティングされるようになりました。

原文（英語） ​

tool_parameters in OpenTelemetry tool_result events are now gated behind OTEL_LOG_TOOL_DETAILS=1

概要 ​

OpenTelemetryを使った観測では、tool_result イベントにツールのパラメータ情報（tool_parameters）が含まれていましたが、これにはファイルパスや実行コマンドなど機密性の高い情報が含まれる可能性があります。今回の変更で、tool_parameters のログ記録は OTEL_LOG_TOOL_DETAILS=1 環境変数を設定した場合のみ行われるようになり、デフォルトでは記録されません。

基本的な使い方 ​

デフォルト動作（tool_parameters は記録されない）：

bash
# 通常通り起動
claude

tool_parameters を含む詳細ログを有効化する：

bash
OTEL_LOG_TOOL_DETAILS=1 claude

実践例 ​

ユースケース: 開発環境でのデバッグ ​

開発時に詳細なツールパラメータをOTELに送信してデバッグする：

bash
# .envファイルや起動スクリプトに設定
export OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4317"
export OTEL_LOG_TOOL_DETAILS=1
claude

ユースケース: 本番環境でのプライバシー保護 ​

本番環境ではデフォルト（OTEL_LOG_TOOL_DETAILS 未設定）のまま使用することで、ファイルパスやコマンドライン引数などの機密情報をOTELバックエンドに送信しないようにします：

bash
# 本番環境: OTEL_LOG_TOOL_DETAILS は設定しない
export OTEL_EXPORTER_OTLP_ENDPOINT="https://otel.company.com:4317"
claude

ユースケース: コンプライアンス要件に対応する ​

GDPRやHIPAA等のコンプライアンス要件がある環境では、OTEL_LOG_TOOL_DETAILS=1 を設定せず、ツールパラメータのログ記録を無効化します。

注意点 ​

  • この変更はデフォルトの動作を変更します（以前はパラメータが常に記録されていました）
  • 既存のOTELダッシュボードで tool_parameters を参照している場合は、OTEL_LOG_TOOL_DETAILS=1 を追加する必要があります
  • tool_parameters には実行したコマンドやファイルパスなど機密情報が含まれる可能性があるため、本番環境ではデフォルトのまま使用することを推奨します

関連情報 ​