karanb192/claude-code-hooks

🪝 Claude Code hooks + an installable plugin marketplace: safety, cost, observability, productivity.

概要

claude-code-hooks は、Claude Code（Anthropic製のAIアシスタントソフトウェアで、シェルコマンドの実行、ファイルの編集、パッケージのインストールなどを自律的に行うことができます）にプラグインできる、すぐに使えるフックのコレクションです。フックはエージェントのアクションを前後でインターセプトし、ブロック、変更、ログ記録を可能にするセーフティガードおよび自動化ヘルパーとして機能します。このプロジェクトは、単一のClaude Codeコマンドでインストールできる22個の個別プラグインを提供します。

プロジェクトが提供するもの

機能 説明 使用方法
セーフティガード 危険なコマンド（rm -rf ~、`curl sh`）をブロックし、シークレットファイルの読み取りを防止し、Gitブランチルールを適用し、テスト隠蔽トリックを停止し、エージェント自身の設定を保護し、サブエージェントの生成を制限します。
ログと監査 セッションレベルのMarkdownログ、スタンドアップの自動生成、障害の個人用フライトレコーダー、コンプライアンススコアカード、ファイルごとの「コンテキストコスト」リーダーボード。 session-loggerなどのロガープラグインをインストールし、生成されたMarkdownまたはコマンドラインカードを表示します。
自動化ヘルパー 編集したファイルを自動ステージング、編集後のコードを自動フォーマット、PR本文に由来情報をスタンプ、リポジトリのTODOをバウンティボードのクエストに変換。 ヘルパープラグインをインストールし、スラッシュコマンド（例：/auto-stage）を呼び出します。
通知 Claudeがユーザーの許可を必要とするときにSlackアラートを送信します。 notify-permissionをインストールし、Slackウェブフックを設定します。
開発者ユーティリティ event-logger.pyは、独自のフックを構築するときに任意のフックイベントのペイロードを検査するのに役立ちます。 Claudeセッションがアクティブな間にPythonスクリプトを実行します。

すべてのフックは通常のNode.jsスクリプト（*.js）であり、モデルプロセスの外部で実行されるため、プロンプトインジェクション攻撃がこれらをバイパスすることはできません。各フックは個別にインストールすることも、7つのコアガードについてはguard-packプラグインを介してバンドルし、単一プロセスで起動することもできます。

開始方法

  1. マーケットプレイスを追加（一度だけ）：
    /plugin marketplace add karanb192/claude-code-hooks
  2. 必要なフックをインストール（例）：
    /plugin install protect-secrets@claude-code-hooks
  3. Claude Codeを再起動してフックを有効にします。
  4. 提供されたスラッシュコマンド（例：/protect-secrets）を使用するか、生成されたログ/ボードを確認します。

設定は、HOOK_SAFETY_LEVEL=highやCONFIG_GUARD_ALLOW=trueなどの環境変数を使用して行われ、特定の呼び出しに対するガードを緩和できます。

これは誰に役立つか？

  • Claude Codeを使用する開発者：アシスタントがファイルを誤って削除したり、資格情報を漏洩したり、破壊的なgit操作を行ったりしないようにしたい場合。
  • コンプライアンス要件を持つチーム：AI駆動のコード変更の監査証跡が必要な場合。
  • 運用/セキュリティエンジニア：CI/CDパイプラインでAIエージェントをサンドボックス化したい場合。
  • カスタムClaude Code拡張を構築する人：提供されたevent-loggerとサンプルフックをテンプレートとして再利用できます。

制限事項/考慮事項

  • ガードは、文書化されたフックイベント（PreToolUse、PostToolUseなど）を発行するClaude Codeバージョンでのみ機能します。
  • config-guardを有効にすると、プラグインマネージャー自体もブロックされるため、他のすべてのプラグインをインストールしてからオンにするか、CONFIG_GUARD_ALLOW=trueを一時的に設定する必要があります。
  • フックは個別のプロセスとして実行され、バンドルされたguard-packでは呼び出しごとに約35msの小さなオーバーヘッドが追加されます。
  • セーフティレベル（critical、high、strict）によって、フックがサイレントに拒否するか、警告するか、続行する前にユーザーに確認するかが決まります。

要約： claude-code-hooksは、Claude Codeエージェントに最小特権、ロギング、自動化をもたらす実用的なツールボックスであり、モデルがマシン上で実際に実行できることを厳密に制御しながら、AI駆動のコーディングを安全に活用できます。

関連

  • プロジェクト
    sangrokjung/claude-forge

    Claude Forge は、基本的な Claude Code ターミナル型コーディングアシスタントをプロダクションレベルの開発環境に変えるプラグインパックです。16の専門AIエージェント、35のスラッシュコマンド、33の保存済み「スキル」、22のセーフティフック、14の行動ルール、4つの外部ツール接続を追加します。1行スクリプト（フルインストール）または Claude Code のプラグインマーケットプレイス（コマンドのみ）でインストール可能。このパックは計画、テスト最優先開発、セキュリティレビュー、ドキュメント同期、および独立したエージェントによる承認を要する敵対的検証ループを自動化します。MITライセンス、v4.3.0（2026年9月）で積極的にメンテナンス中。

  • プロジェクト
    Chachamaru127/claude-code-harness

    Claude Code Harness は、Claudeベース（または互換性のある）AIエージェントを、計画、作業、レビュー、同期、リリースという体系的なループで運用するGoネイティブプラグインです。各ステップで強力なガードレールと人間の承認を強制し、仕様の生成、AI駆動の実装、独立した変更レビュー、検証済みリリースのパッケージ化をサポートします。Claude Code、Codex CLI、Cursor、Grokを対応しています。

  • プロジェクト
    Lifecycle-Innovations-Limited/claude-ops

    Claude‑Ops は、Claude Code 環境をターミナルベースのビジネスオペレーティングシステムに変えるプラグイン兼インストーラーパッケージで、ダッシュボード、自動修正、安全フック、自律エージェント、GitHub、AWS、Stripe、マーケティングツール、音声通話などとの統合を提供します。

  • プロジェクト
    wesammustafa/Claude-Code-Everything-You-Need-to-Know

    AnthropicのClaude Code CLIに関する実践的かつ最新のガイド。インストール、プロンプトエンジニアリング、カスタムスラッシュコマンド（Skills）、自動化Hooks、サブエージェント、JavaScriptワークフロー、外部ツール統合のためのModel-Context-Protocolを網羅しています。AI拡張開発パイプラインを構築するチーム向けに、そのままコピー可能な.claude/の例を含みます。

  • プロジェクト
    Prorise-cool/Claude-Code-Multi-Agent

    Claude Code Multi‑Agent は、Anthropic の Claude Code プロジェクトに認識能力とエキスパートエージェント機能を追加するオープンソースフレームワークです。Python Hook システムとローカル実行の Ollama モデルを使用して、コードベースの種類を自動検出、ユーザーの意図を分析、300以上ものドメイン固有の「スキル」（バックエンド、フロントエンド、テスト、セキュリティなど）をロードし、自動ドキュメント（DEVELOPMENT.md、KNOWLEDGE.md、CHANGELOG.md）を強制します。リポジトリをクローンし、Ollama、モデル、uv をインストールした後、プロジェクトをリポジトリに配置するだけで、Claude Code は即座にコンテキストを把握し、適切なツールを提案し、`/backend‑specialist` や `/kiro/spec` のようなスラッシュコマンドで操作できます。 主な特徴： - ゼロ構成スタート；すべての設定は `.claude/settings.json` と `prompts.json` に保存。 - セッション開始、ユーザーのプロンプト、ツール使用などに応じて実行される Hooks で、プロジェクト検出、意図分析、ドキュメント更新を処理。 - Skills は `SKILL.md` ファイルで定義され、自動検出される。 - 外部 API を一切使わず、完全にローカルで動作。Git と統合可能。MIT ライセンス。 個人開発者や小さなチームが再現可能でオンプレミスの AI コーディングアシスタントを必要とする場合に最適です。