Claude Code modsとは
Claude Code mod とは?
Claude Code mod(「Claude mod」とも呼ばれます)は、hooks module を持つプラグインです。セッションのイベントに処理を登録し、ライブパネルやステータスラインなどの画面を追加したり、ツール呼び出しの扱いを変えたりします。カウンター、費用の確認、作業手順を説明するコマンドが小さな実装例です。Mod という名称は、新しいモデル、契約の変更、品質の保証を意味しません。
セッション内の小さな道具と考えると分かりやすいでしょう。費用表示、完了通知、エージェントの状態確認、待ち時間のミニゲームなどに使えます。
公式ドキュメント
Claude Code の API はバージョンによって変わるため、お使いのバージョンの公式ページに従ってください:Mods の概要、Mod の作成、プラグインのインストールと管理、Claude Code ドキュメントのトップ。ClaudeMods はコミュニティ作品の独立したディレクトリであり、Anthropic の提供・推奨するものではありません。
/plugin で mod をインストールする
- 作品ページで元のソース、README、権限レベルを確認します。
- Claude Code 内で
/pluginを実行して marketplace とインストール済みプラグインを見るか、コマンドラインを使います。
claude plugin marketplace add owner/repo
claude plugin install plugin-name@marketplace-name
owner/repo、plugin-name、marketplace-nameは作者の説明にある値に置き換えます。すべてのリポジトリに marketplace があるわけではありません。ない場合は README に従うか、お使いの CLI が対応する--plugin-dirでローカルディレクトリを試します。- 作者の指示があれば再起動または再読み込みをし、動作を確認してから次の mod を追加します。削除方法は
claude plugin --helpと README を参照してください。
詳細はmod のインストール方法をご覧ください。
Mod・プラグイン・hook・skill の違い
| 用語 | 内容 | 主な用途 |
|---|---|---|
| プラグイン | インストールするパッケージ。skills、hooks、mods などをまとめられます。 | marketplace やリポジトリでツール一式を共有 |
| Mod | hooks module(function hooks)を持つプラグイン。セッションのイベントを処理し、画面も追加できます。 | ステータスライン、ダッシュボード、カウンター、通知、ミニゲーム |
| 従来の hook | イベント発生時に実行される設定済みの処理。多くは shell コマンドです。 | 変更の検証、フォーマット、通知 |
| Skill | Claude に繰り返し使える手順を教える説明とリソース。 | リリースレビュー、スタイル、チェックリスト |
詳しい比較はMod・hook・skill・MCP の違いをご覧ください。
権限レベル L0–L3
ClaudeMods は各作品にスキャンレベルを表示します。これは本ディレクトリ独自の分類であり、Anthropic の権限モード、サンドボックス、認証ではありません。
| レベル | 検出する能力 |
|---|---|
| L0 | 表示と純粋な処理 |
| L1 | ファイルや環境の読み取り |
| L2 | 書き込み、実行、ツールの変更 |
| L3 | 通信やモデルへのアクセス |
低いレベルでもコードが無害とは限らず、未スキャンの作品は追加の確認が必要です。Mod の安全性:L0–L3 の解説を読み、権限スキャナーもお試しください。
確認する3つのファイル
.claude-plugin/plugin.json:プラグイン名やバージョンなど。hooks/hooks.json:modules 配列で読み込む関数モジュールを宣言。register.tsx:イベントと UI を登録する実際のコード。
1つのリポジトリに複数のプラグインが含まれることがあります。ルートの内容すべてが mod だと決めつけず、目的のディレクトリを導入してください。エントリファイルだけでなく依存先も確認します。
小さな実験から始める
使い捨てのプロジェクトで、読み取り専用の表示から試しましょう。作業中に情報が必要ならダッシュボードが便利で、一度きりの自動化なら従来の hook のほうが簡単な場合があります。他のプラグインと干渉したらすぐ無効にでき、説明できない権限は与えないでください。
候補を探して評価する
カテゴリを見て、元のソースと最近のメンテナンス状況を確認します。スター数は関心の高さであり安全性ではありません。スキャン結果は見えるコードのパターンを示すだけで、動的に読み込まれるコードは見逃す場合があります。導入したバージョンと削除方法を記録しましょう。自作するならTypeScript で Claude Code mod を書くへ。
人気の Claude Code mods
公開済みの作品を、コミュニティの投票数、次に GitHub スター数の順に表示します。自動で更新されます。
- token-optimizer★ 2,981
- savvy-progress★ 380
- pixel-crew★ 4
- agent-flow★ 30
- 作業しながら Claude とチェス★ 33,441
- rainbow-week★ 2
- 「npx RuFlo」を新しい Claude Code Mod システムに移植した。これは次のレベルだ。I★ 81,451
- ruflo-music★ 81,451
- cache-warmer★ 100
- cache-warmer★ 24
FAQ
Claude Code mod とは何ですか?
Claude Code mod は hooks module を持つプラグインです。セッションのイベントに処理を登録し、ライブパネルやステータスラインなどの画面を追加したり、ツール呼び出しの扱いを変えたりします。新しいモデルや契約の変更ではありません。
Claude Code mod はどうやってインストールしますか?
まず作品のソースと権限レベルを確認します。そのうえで Claude Code 内で /plugin を実行するか、コマンドラインで claude plugin marketplace add owner/repo、続いて claude plugin install plugin-name@marketplace-name を実行します。marketplace がないリポジトリもあるため、作者が示す名前を使ってください。
Mod・hook・skill の違いは何ですか?
プラグインはインストールするパッケージです。Mod はセッションのイベントを処理し、画面も追加できる hooks module を持つプラグインです。従来の hook はイベント時に実行される設定済みの処理(多くは shell コマンド)、skill は Claude に繰り返し使える手順を教える説明です。
Claude Code mod は安全ですか?L0–L3 とは?
ClaudeMods は各作品をスキャンし、L0(表示や純粋な処理)、L1(ファイルや環境の読み取り)、L2(書き込み・実行・ツール動作の変更)、L3(通信やモデルへのアクセス)と表示します。これは本ディレクトリの分類であり認証ではありません。低いレベルでも無害とは限らないため、導入前にソースを確認してください。
ClaudeMods は Anthropic の公式サイトですか?
いいえ。ClaudeMods はコミュニティ作品の独立したディレクトリで、Anthropic の提供・推奨するものではありません。公式情報は code.claude.com/docs の Claude Code ドキュメントをご覧ください。
Claude Code の mod は TypeScript で作れますか?
はい。mod は .claude-plugin/plugin.json、hooks/hooks.json、hooks/register.tsx などのエントリという 3 つのファイルで構成されます。エントリで claude-code から Register 型をインポートし、session.start や command.run などのイベントのハンドラーを登録します。claude plugin validate で確認し、インストール済みの Claude Code が生成する型定義に従ってください。
mod ではなく MCP を使うのはどんなときですか?
MCP は Claude を別のツールやデータサービスに接続します。足りない機能が別サービス側にあるときに検討してください。mod は Claude Code 内のセッションイベントとインターフェースを扱い、skill は手順の指示、従来の hook は固定の動作に向きます。1 つのワークフローで組み合わせることもできます。
mod を安全に試すにはどうすればよいですか?
使い捨てのプロジェクトで、まず読み取り専用の表示系 mod から始めます。ソースと L0–L3 の等級を先に読み、すぐに無効化・削除できる状態にしてください。説明できない権限は与えず、インストールしたバージョンと削除方法を記録しておきます。