Repolode
karanb192

karanb192/claude-code-hooks

Claude Codeのツール呼び出しに安全対策、各種自動化、コスト追跡、通知を適用する、インストール可能なフック集。

スター
576
フォーク
49
未解決の Issue
6
最終コミット
5 日前

これは何?

claude-code-hooksは、Claude Code向けのすぐに使えるフック集です。22個のインストール可能なプラグインを、プラグインマーケットプレイスとして提供しています。フックはPreToolUseやPostToolUseなどのタイミングで実行され、ツール呼び出しを許可、拒否、変更できます。その理由はエージェントに返されます。モデルの外部で独立したプロセスとして実行されるため、プロンプトの内容にかかわらず適用されます。

安全対策プラグインは、.envなどの秘密情報を含むファイルの読み取りや外部への持ち出し、パイプ経由でシェルに渡すインストール、ホームディレクトリへのrm -rf、mainへの強制push、フックや設定ファイル自体の編集をブロックします。そのほか、Markdown形式でのセッション記録、デイリースタンドアップの生成、テストの改ざん防止、gitへの自動ステージング、ruffやprettierによるコード整形、コンテキストコストの追跡、Claudeが入力を求めているときのSlack通知などに対応するプラグインもあります。多くのガードでは安全レベルを設定でき、ブロックする代わりに確認を促すaskモードも利用できます。

各プラグインはスラッシュコマンド1つでインストールでき、各スクリプトはsettings.jsonに登録すれば単独でも実行できます。プロジェクトにはNode 18、20、22で実行するテストスイートと、OWASP LLM Top 10 2026との対応表が含まれています。

主な機能

  • 01ホームディレクトリへのrm -rf、フォークボム、curl | shなどの危険なシェルコマンドをブロックします。
  • 02.envファイル、SSHキー、クラウド認証情報の読み取りや外部への持ち出しを防ぎます。
  • 03セッション中にエージェント自身の安全対策設定が変更されないよう保護します。
  • 04Claude Codeがユーザーの入力を必要とするときにSlackで通知します。
  • 05各セッションをMarkdown形式で記録し、エージェントの活動からデイリースタンドアップを生成します。
  • 06Claude Codeマーケットプレイスから個別のプラグインとして、または単独のスクリプトとしてインストールできます。

ユースケース

  • 自律型コーディングエージェントによるファイル削除やmainへの強制pushを防ぐための安全対策を追加する。
  • .envファイルを含むリポジトリで、エージェントが秘密情報にアクセスできないようにする。
  • Claude Codeを毎日使うチームで、セッションの活動状況とトークンコストを追跡する。
  • 長時間実行中のエージェントセッションが承認待ちになったとき、Slackで通知を受け取る。

クイックスタート

  1. 1

    Claude Code にマーケットプレイスを追加します(初回のみ)

    /plugin marketplace add karanb192/claude-code-hooks
  2. 2

    使いたいフックをインストールします(例: context-hogs。名前は任意のものに置き換えてください)

    /plugin install context-hogs@claude-code-hooks
  3. 3

    Claude Code を再起動してフックを有効にします

使う前に知っておきたいこと

  • Config-guard はデフォルトの高レベル設定では claude plugin install、uninstall、disable もブロックします。そのため、先に他のプラグインをインストールするか、そのコマンドの実行時に CONFIG_GUARD_ALLOW=true を設定してください。
  • Config-Change のペイロードスキーマは公開されていないため、config-watch は慎重に解析します。

収録されている特集

トピック

よくある質問

claude-code-hooks とは?
Claude Codeのツール呼び出しに安全対策、各種自動化、コスト追跡、通知を適用する、インストール可能なフック集。 claude-code-hooksは、Claude Code向けのすぐに使えるフック集です。22個のインストール可能なプラグインを、プラグインマーケットプレイスとして提供しています。フックはPreToolUseやPostToolUseなどのタイミングで実行され、ツール呼び出しを許可、拒否、変更できます。その理由はエージェントに返されます。モデルの外部で独立したプロセスとして実行されるため、プロンプトの内容にかかわらず適用されます。
claude-code-hooks は無料で使えますか?ライセンスは?
claude-code-hooks は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
claude-code-hooks は今もメンテナンスされていますか?
活発にメンテナンス中。claude-code-hooks の最終コミットは 2026年11月2日 です。
claude-code-hooks は何に使えますか?
自律型コーディングエージェントによるファイル削除やmainへの強制pushを防ぐための安全対策を追加する。 .envファイルを含むリポジトリで、エージェントが秘密情報にアクセスできないようにする。 Claude Codeを毎日使うチームで、セッションの活動状況とトークンコストを追跡する。 長時間実行中のエージェントセッションが承認待ちになったとき、Slackで通知を受け取る。
claude-code-hooks のインストール方法は?
Claude Code にマーケットプレイスを追加します(初回のみ): /plugin marketplace add karanb192/claude-code-hooks 使いたいフックをインストールします(例: context-hogs。名前は任意のものに置き換えてください): /plugin install context-hogs@claude-code-hooks Claude Code を再起動してフックを有効にします
claude-code-hooks はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/karanb192/claude-code-hooks

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト