結論：設定値ではなく、出所・状態・変更の関係を残す
Claude Code 2.1.274では、OTEL_LOG_MANAGED_SETTINGS=1により、managed settingsのsourceとpolicy helper state、redacted settings、digestを含むclaude_code.managed_settings_resolved OTel eventが追加されました。何が適用されたかを追跡するのに役立ちますが、監査の完成はcollector、閲覧者、保持期限、削除、アラートまでを設計した時です。
読者の課題は、同じキーが組織設定、MDM、project、user、コマンドラインに存在した時に「なぜこの値になったか」を説明できないことです。設定本文をそのままログへ送ると秘密情報や内部構成を増やします。sourceとdigestを変更台帳へ結び付け、redactedな証跡で判断できる範囲を先に決めてください。
根拠はClaude Code v2.1.274公式リリースとClaude Code公式changelogです。OTelの有効化、metrics・logs・traces、managed settingsによるcollector固定はMonitoring公式文書、設定のscopeと優先順位はSettings公式文書を正本にします。既存のmanaged settings変更承認は承認判断、telemetryのuser属性は識別情報、監査ログは判断記録が中心で、本稿は解決結果の観測へ分けます。
解決結果と設定本文を比較する
| 記録 | 分かること | リスク |
|---|---|---|
| source | どの設定源が関与したか | 内部構成名の露出 |
| policy helper state | policy補助機能の状態 | 実装依存の誤読 |
| redacted settings | 適用された設定の安全な概略 | マスキング不足 |
| digest | 同一内容か変更されたか | 単独で意味を説明できない |
| 設定本文・prompt | 具体的な内容 | 秘密・個人情報・機密の保存 |
sourceとdigestは、誰がどの値を見たかではなく、適用結果がいつ変わったかを説明する材料です。digestが異なる時は、設定差分を別の承認済み保管場所で照合します。OTel eventに設定全文を詰め込んで差分解析を済ませようとすると、collectorの閲覧者が増え、削除対象も広がります。必要な監査証拠を最小限にしてください。
監査を始める8手順
- 監査目的を固定する。設定変更の検知、問い合わせ対応、policy適用確認のどれを先に行うか決めます。
- scopeを図にする。managed settings、MDM、claude.ai console、command line、project、userを環境別に並べます。
- 記録するeventを選ぶ。source、policy状態、redacted情報、digestを必要な監査要件へ対応付けます。
- 値の境界を確認する。secret、token、URL、部署名、repository名がredacted対象か、検証環境で実データを確認します。
- collectorを限定する。送信先、TLS、認証、network、rawログ閲覧者を台帳化します。
- 有効化を限定scopeで試す。
OTEL_LOG_MANAGED_SETTINGS=1を一つの検証環境へ入れ、event名・source・digestをreadbackします。 - 変更と結び付ける。承認番号、設定version、適用時刻、ownerを同じ監査IDへ関連付けます。
- 停止条件を試す。値の露出、event急増、collector障害、未知のsourceが出た時の無効化と通知を確認します。
OTel自体の設定でも、managed settingsにcollector endpointやcredentialを置いた時は、開発者側の競合する値が除去される場合があります。これは送信先を組織で固定するための挙動ですが、どのsourceが勝つかを理解しないまま配布すると、開発者の検証用collectorが突然使えなくなることがあります。変更前後のsourceと、実際の送信先を一緒に確認してください。
監査画面ではdigestの変化を即座に違反扱いにしないことも重要です。OS更新、managed policyの正規変更、端末移行でも変化します。重大度は「未承認変更」「承認済み変更」「source不明」「redaction不備」に分け、source不明だけを自動停止の候補にします。設定の意味と業務影響を確認する人を、collectorを管理する人とは分けると、自己承認を減らせます。
問い合わせ対応では、eventの時刻を端末のversion、設定配布のversion、承認記録と照合します。sourceが正しくても、古い端末が混在すれば期待したpolicyが全員へ届いたとは言えません。未着eventを「設定がない」と誤読しないよう、送信失敗、collector遅延、端末未接続を別の状態として扱います。監査のreadbackには、解決結果の有無だけでなく、確認できなかった理由も残してください。
企業向けチェックリスト
- Claude Codeのversionとmanaged settingsの配布元を記録した
- sourceの正式名称とscopeを定義した
- redacted情報に秘密値が含まれないことを確認した
- digestの照合元と変更承認を決めた
- OTel collectorへのTLSと認証を設定した
- raw eventと集計画面の閲覧権限を分けた
- 保持期限、削除証跡、バックアップの範囲を決めた
- event欠損・急増・未知sourceの対応を試した
監査の目的は、ログを増やすことではなく、判断を再現できることです。設定の変更を戻した時に、どのeventがどの承認に対応するか、問い合わせを受けた担当者が説明できる状態を合格とします。promptやtool結果を別のログへ出す設定とは混同せず、本文を保存しない方針を先に明文化してください。
よくある質問
redacted settingsだけで変更理由が分かりますか？
変更の存在や適用されたsourceを追跡する材料にはなりますが、承認理由は別の変更台帳が必要です。digestと承認番号を結び付けます。
OTel eventは設定の優先順位を自動で直しますか？
直しません。sourceとresolved stateを観測し、優先順位の期待値と違う時に設定を修正するための証跡です。
prompt内容も一緒に記録すべきですか？
原則として目的と必要性を先に審査します。managed settingsの解決監査には、prompt全文を追加しなくてもよい設計を優先してください。
公式情報
次の一歩
設定の正本、承認、ログ、削除責任が別々になっている場合は、eventを増やしても監査の説明がつながりません。Miraigentの無料診断で、Claude Codeの設定源と人間確認の境界を棚卸しできます。