2026.11.22AI WEB構築

Claude Codeの止めた操作はOpenTelemetryで数える

AUTHORCreavePlus 編集部
Claude Codeの止めた操作はOpenTelemetryで数える
この記事の目次

Claude Codeに許可の規則やサンドボックスを足したあとで「本当に効いているのか分からない」と感じたら、OpenTelemetryで止めた操作を数えるのが確かめる近道です。社内の複数の人が使うClaude Codeに規則を入れたら claude_code.safety_event を記録し、止まった件数と規則の出どころを週に1回見て設定を直すのが弊社の結論です。反対に1人で使っていて許可の確認を毎回自分で見て答えているなら、記録の送信は入れなくて問題ありません。

この記録は新しいものです。Claude Code公式の変更履歴によると claude_code.safety_event は2026年10月21日の2.1.307で入り、許可の規則やauto mode・安全の確認・フック・サンドボックスが止めたり確認を求めたりした操作ごとに記録されます。

この記事では記録に何が入るのかと、止まった件数から設定の穴を見つける考え方を説明します。そのうえで2026年11月時点の公式の説明に沿って、記録を送って数える手順を書きます。

Claude Codeが止めた操作は1件ずつ記録できる

Claude Codeは止めた操作を1件ずつ claude_code.safety_event という名前のログとしてOpenTelemetryで送れます。Claude Code公式のMonitoringの説明では、ツールの呼び出しを確認が断ったときや許可の確認を求めたときに記録されると書かれています。サンドボックスのネットワークのプロキシが接続を断ったときと、フックが結果を止めたときも記録されます。

OpenTelemetry(ログや数値を決まった形で外に送るための共通の規格)なので、送り先は御社がすでに使っているログの置き場所で構いません。ほかのイベントと一緒に送られ、safety_eventだけを入れる設定はありません。

これまでも claude_code.tool_decision で許可したか断ったかは記録できました。safety_eventはそれに加えて、どの確認がなぜ止めたかを残します。

safety_eventを見れば、どの規則がどれだけ操作を止めたかを人に聞かずに数で確かめられます。

safety_eventに入ることと入らないこと

safety_eventには止めた理由が入りますが、コマンドの文字やファイルのパスは入りません。公式の説明に載っている主な項目は次のとおりです。

  • category:止めた確認の種類。許可の規則なら permission_rule が入り、管理の設定(managed settings)の規則なら managed_policy が入ります。サンドボックスのネットワークが断ったときは sandbox_network です
  • decision:accept・reject・sent_back のどれか
  • rule_source:規則が書いてあった設定の場所。policySettings・userSettings・projectSettings・localSettings などが入ります
  • reason_code:止めた理由の詳しい値。たとえば rule:policySettings や hook:PreToolUse です
  • tool_class と tool_use_id:Bashかファイルの操作かといった道具の種類と、呼び出しのID

safety_eventの項目にはコマンドの文字・ファイルのパス・接続先のホスト名・MCPのサーバーやツールの名前は入りません。どのコマンドが止まったかまで見るには、OTEL_LOG_TOOL_DETAILS=1 を入れて同じ tool_use_id の tool_decision の tool_parameters を読みます。

ただし OTEL_LOG_TOOL_DETAILS=1 を入れるとBashのコマンドやツールへの入力がそのまま記録されるので、コマンドの中に鍵を書く使い方があると鍵も記録に残ります。また公式の説明ではメールアドレスが分かる場合は user.email がどのイベントにも入るので、誰の操作かは記録から分かります。

まずは初期の設定のままsafety_eventを数え、コマンドの中身まで必要になったときだけ OTEL_LOG_TOOL_DETAILS=1 を入れてください。

止まった件数で設定の穴が分かる理由

止まった件数を category と rule_source で分けて数えると、規則が多すぎるのか足りないのかが分かります。前の節のとおり rule_source には規則の置き場所が入るので、同じ操作がどの設定ファイルの規則で止まったかまで分かります。

たとえば projectSettings の規則で同じ種類の操作が毎日何十回も止まっているなら、ふだんの作業に必要な操作まで止めている可能性があります。確認が多すぎると止められた人は手で許可を続けることになり、確認を読まずに許可する癖がつきやすくなります。

反対に規則を足したのに件数が0のままなら、規則の書き方が合っておらず何も止めていない可能性があります。sandbox_network が多いなら、サンドボックスに許可していない接続先へ何かが接続しようとしています。

記録に残らない断り方もあります。公式の説明では、-p で動かしたときに誰も確認に答えられずに断られた呼び出しにはsafety_eventが出ないとされています。そうした呼び出しは tool_decision が reject で source が config になり、同じ tool_use_id のsafety_eventが無いことで見分けます。

件数が多すぎる規則は直すか許可に移し、件数が0の規則は効いているかを確かめ直すのが設定の見直しの基本です。

記録を入れるチームと入れなくてよい使い方

記録を入れるかどうかは、使う人の数と規則を決める人と無人で動かすかで決まります。社内で説明するときは次の表をそのまま使えます。

確かめること

記録を入れる

入れなくてよい

使う人の数

2人以上で同じ規則を使う

1人だけで使う

規則を決める人

管理の設定やリポジトリの設定で規則を配っている

自分の設定に自分で規則を書いている

確認への答え方

auto modeや -p で動かし人が確認を見ない回がある

確認はすべて自分で見て答えている

ログの置き場所

社内にOpenTelemetryのログを受ける先がある

受ける先が無く用意する予定も無い

左の列が1つでもあるなら、safety_eventを記録して週に1回件数を見てください。規則を配る人と止められる人が別になるほど、止まった操作は配った人に見えなくなるからです。

4つとも右の列なら、記録の送信は入れなくて問題ありません。確認の画面を自分で毎回見ているので、止まった操作はその場で分かります。

safety_eventを送って数える手順

2026年11月時点・Claude Code 2.1.307以降・社内にOpenTelemetryのログを受ける先(OpenTelemetry Collectorなど)がある場合の手順です。設定の名前は公式のMonitoringの説明で確かめたものです。

  1. 今の設定ファイルを残します。管理の設定のファイルを書き換える前に、元のファイルをコピーしておきます。
    cp managed-settings.json managed-settings.json.bak
  2. まず1台で送られる内容を確かめます。ログを画面に出す設定でClaude Codeを起動し、指示を1つ送って safety_event や user_prompt が表示されるかを見ます。
    export CLAUDE_CODE_ENABLE_TELEMETRY=1
    export OTEL_LOGS_EXPORTER=console
    claude
  3. 管理の設定の env に送り先を書きます。リポジトリの .claude/settings.json に書いても送信は始まらないので、管理の設定か各自の環境変数に書きます。
    {
      "env": {
        "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
        "OTEL_LOGS_EXPORTER": "otlp",
        "OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",
        "OTEL_EXPORTER_OTLP_ENDPOINT": "http://collector.example.com:4317"
      }
    }
  4. 指示を1つ送り、ログの置き場所に claude_code.user_prompt が届くかで送信を確かめます。届かなければ claude --debug-file で記録を取り、[3P telemetry] で始まる行のエラーを見ます。
    claude --debug-file ./claude-debug.log
  5. ログの置き場所で event.name が safety_event の記録を1週間分集め、category と rule_source と decision の組み合わせごとに件数を数えます。
  6. 件数が多い組み合わせは、同じ tool_use_id の tool_decision とつないで止まった道具を確かめます。コマンドの中身まで必要なときだけ、一時的に OTEL_LOG_TOOL_DETAILS=1 を入れます。
  7. 規則を直したら次の1週間の件数を比べ、減っていることを確かめます。

うまくいったかは2つで判断します。4で claude_code.user_prompt が届き、5で category ごとの件数が出れば記録は動いています。

やりがちな失敗は、プロンプトの本文まで記録する OTEL_LOG_USER_PROMPTS=1 を一緒に入れてしまうことです。初期の設定ではプロンプトの本文は伏せて記録されるので、止まった操作を数えるだけなら入れる必要はありません。

弊社がAIで作るときに人が必ず見る所

弊社も制作にAIを使いますが、AIに任せた作業は次の2つを守ってから先へ進めています。

  • 秘密の鍵はサーバーの側だけで使う:公開の前に名前が NEXT_PUBLIC_ で始まる環境変数を一覧で見て、画面に出てはいけない鍵が入っていないかを確かめます
  • AIが作ったものは人が確認してから先へ進める:弊社の業務の自動化でも、AIが書いた記事は人が社内の確認用のボードで承認してから公開しています

許可の規則も同じで、AIに任せる範囲を広げるときは人があとから確かめられる記録を先に用意しておくと弊社は考えています。

弊社がやっていること

弊社はClaude CodeやChatGPTなどのAIで作ったサイトの点検と公開を引き受けています。点検ではコードを書き直さずにそのまま読み、直した方がよい所を報告に書きます。Claude Codeに鍵を読ませない規則の書き方は.envとサンドボックスの記事で説明しています。

上の表で4つとも右の列なら、記録の送信は入れずに今のまま使って問題ありません。safety_eventの設定は御社の中で進められるので、弊社に頼む必要もありません。

点検の中身はAIで作ったサイトの引き継ぎと点検のページに、料金は料金の一覧にあります。AIで作ったサイトを公開してよいか迷う場合は相談の窓口からご連絡ください。初回の30分は無料です。

よくある質問

safety_eventを送るとコマンドの中身も記録されますか

初期の設定では記録されません。safety_eventの項目にはコマンドの文字やファイルのパスは入らず、中身まで見るときだけOTEL_LOG_TOOL_DETAILS=1を入れてtool_decisionのtool_parametersを読みます。

リポジトリの設定ファイルで記録の送信を始められますか

始められません。公式の説明ではリポジトリの.claude/settings.jsonにあるOpenTelemetryの送信の設定は読まれないので、管理の設定か各自の環境変数に書きます。

1人で使っている場合も記録を入れた方がよいですか

確認の画面をすべて自分で見て答えているなら入れなくて問題ありません。止まった操作はその場で分かるので、件数を数える必要はありません。

件数が0なら規則は正しく効いていますか

0だけでは効いているとは言えません。規則の書き方が合っておらず何も止めていない場合も0になるので、止めたい操作を1回試してsafety_eventが出るかを確かめます。

RELATED