Claude Code 許可ダイアログ リスク可視化ツール
概要
Claude Code の許可ダイアログは便利だが、表示だけでは「何が起こるか」が分かりにくいことがあります。本リポジトリはその問題を解決するためのツールで、許可を求めるコマンドに対してリスクレベル(低・中・高)を算出し、色分け・短い説明文でユーザーに提示します。日本語と英語の多言語対応を持ち、システム言語に自動適応。ウェブページ上のダイアログに情報を注入する形で動作し、ユーザーがより安全に操作を判断できるよう支援します。
リポジトリの統計情報
- スター数: 13
- フォーク数: 0
- ウォッチャー数: 13
- コミット数: 9
- ファイル数: 12
- メインの言語: JavaScript
主な特徴
- 許可ダイアログ内にリスクレベル(低・中・高)を色付きで表示
- 操作の目的や影響を簡潔に説明するテキストを併記(日本語・英語対応)
- システム言語設定に応じて表示言語を自動切替
- 最小限のUI変更でClaude Codeの既存フローに自然に統合
技術的なポイント
このツールは主にクライアントサイドのJavaScriptで実装され、Claude Code の許可ダイアログ要素を検出して情報を注入する仕組みになっています。実装上の中心は、DOMの監視(MutationObserverなど)でダイアログの出現を検知し、ダイアログ内に追加の説明ブロックを差し込むコンテンツスクリプトです。リスク判定は、要求されたコマンドや権限の種類に基づくルールベースの分類(例えばファイル操作、外部通信、システムコマンドの実行など)を行い、低・中・高のいずれかを割り当てます。表示は視認性を重視して色(緑・黄・赤)と短い説明文を組み合わせ、アクセシビリティを考慮してテキストでも意味が伝わる設計です。多言語対応はリソースファイル(ローカライズされた文言)で実現されており、ユーザーのブラウザ/OSのロケールに応じて文言を切り替えます。設定や拡張は軽量で、外部依存を抑えた単一のJS実装に集約されているため、ユーザースクリプト/ブラウザ拡張/開発者コンソールによる導入が比較的容易です。スクリーンショットやアセットが含まれており、デザインのサンプルや導入イメージも同梱されています。
プロジェクトの構成
主要なファイルとディレクトリ:
- .gitignore: file
- CLAUDE.md: file
- CONTRIBUTING.md: file
- LICENSE: file
- README.en.md: file
…他 7 ファイル
(assets フォルダにスクリーンショットやヘッダー画像が含まれること、ローカライズ文言やスクリプト本体がリポジトリ内に配置されていることが想定されます)
まとめ
Claude Code の許可判断を直感的に支援する実用的なツールです。
リポジトリ情報:
- 名前: claude-code-explain-risk
- 説明: Claude Code の許可ダイアログに、操作のリスクを分かりやすく表示するツール
- スター数: 13
- 言語: JavaScript
- URL: https://github.com/wataame/claude-code-explain-risk
- オーナー: wataame
- アバター: https://avatars.githubusercontent.com/u/4265467?v=4
READMEの抜粋:
Claude Code Explain Risk
Claude Code の許可ダイアログに、操作のリスクを分かりやすく表示するツール
Claude Code を使っていると「このコマンドを許可しますか?」というダイアログが表示されますが、何が起きるのか分かりにくいことがあります。
このツールを入れると、コマンドのリスクレベル(低・中・高)と、何をしようとしているかの説明が表示されるようになります。日本語・英語に対応しており、システムの言語設定に合わせて自動で切り替わります。
表示例