hamzafer/claude-code-mods

解決する課題

Claude Code (Anthropic のターミナルコーディングエージェント) は、その内部動作がほとんど見えません。本プロジェクトは、Claude Code の動作を可視化する一連のオプションプラグインを提供します。プロンプト上のライブ行、エージェント活動を表示するパネル、破壊的コマンド前の警告、さらには待ち時間のためのゲームなどが含まれます。コンテキストの消費状況、サブエージェントの動作、レビューの完了タイミング、あるいはファイルを削除するような危険なコマンドが実行されようとしているかどうかが分からないという問題を解決します。

仕組み

これらのプラグインは Claude Code の関数フックに基づいて構築されています。これは、ツール呼び出し、プロンプト送信、セッションライフサイクルなどのイベントで発火するフックです。各「mod」は個別にインストール可能な小さなプラグインです。プロジェクトにはインストーラー (npx claude-code-mods@latest) が含まれており、利用可能な mod のチェックリストを表示し、有効にするものを選択して Claude Code 設定にインストールできます。「bands」（プロンプト上のライブ行）の順序もシンプルなインターフェースで調整可能です。Mod は Claude Code のマーケットプレイスシステムを通じてプラグインとしてインストールされ、一部の mod は追加ツール（画像レンダリング用の Chrome や GitHub 機能用の gh など）を必要とします。

対象ユーザー

ターミナルで Claude Code を使用し、セッションの透明性と制御性を高めたい開発者。コンテキスト使用量の確認、サブエージェントの監視、破壊的コマンドからの保護、あるいは待ち時間の娯楽を求める方に最適です。ターミナルと Claude Code に慣れたユーザーを対象としており、他の作者によって保守されているコミュニティ mod も含まれています。

ハイライト

• ライブステータス行 (例: context-bar, token-weather, cache-clock) が、プロンプト上にコンテキスト使用量、トークンキャッシュ、セッションコストを表示します。
• mission-control は、サブエージェント、ツール呼び出し、操作対象のファイルをマッピングするライブパネルを提供します。
• blast-radius は rm -r や強制プッシュなどの危険なコマンドを保留し、実行前に削除される内容を表示します。
• switchboard はサブエージェントをより安価なモデル (例: Claude Opus から Haiku へ) に自動的にルーティングします。
• reels (YouTube Shorts)、snake、now-playing (Spotify) などの楽しい mod が、Claude の作業中に娯楽を提供します。
• コミュニティ mod により、画像プレビュー、中国語ローカライズ、約 2,700 個の mod を備えた mod ストアなどの機能が追加されます。
• インストーラーにより、有効にする mod を正確に選択でき、自動化のための --dry-run や --pick オプションも用意されています。