MemoryLake
すべての記事に戻る
Tutorial2026年11月16日·11 分で読了

Claude Code Modで何ができるのか?フックやプラグインとの違い、セッション間の状態保持、/clearによるリセットの仕組み (2026年)

トランスクリプトの横にペインを追加する Claude Code Modをインストールしたとしましょう。そこには Claude が触れたファイルや、作業中に行った決定の実行集計が表示されます。午後ずっと便利に使っていましたが、心機一転するために /clear を実行したところ、ペインは空に戻ってしまいました。しかし翌朝、同じ Mod 内の別のカウンターには昨日の合計がまだ残っていました。

Anthropic のドキュメントによると、Mod の状態(state)はそのように動作します。Mod は異なる場所に値を保持でき、それぞれの場所で保持期間が異なります。ある場所は「ユーザーが /clear、/resume、または /branch を実行したとき」にリセットされます。別の場所は、マシン上のすべてのセッションで共有され、翌日以降も存続します。

Mod は Claude Code をカスタマイズする新しい方法の一つであり、他のオプションにはできないことが可能です。このガイドでは、Mod とは何で何ができるのか、設定フック、スキル、プラグイン、MCP サーバーとの違い、インストール方法と信頼性の判断基準、Mod の実行場所、セッション間で保持されるもの、Mod をオフにする方法、そしてプロジェクトのコンテキストを本来どこに置くべきかについて解説します。

Modとは何か

Anthropic のドキュメントは、次のような定義から始まっています。「Mod とは、Claude Code の見た目や挙動を変更するプラグインである」

Mod はコードです。「JavaScript または TypeScript のイベントハンドラーで構成されています。ツール呼び出し、プロンプトの送信、インターフェースの一部の描画などのイベントが発生すると、Claude Code がハンドラーを呼び出します。ハンドラーはそのイベントを監視、変更、または乗っ取ることができます」

ドキュメントではこれらのハンドラーを「フック」と呼んでいますが、Claude Code にはすでに設定ファイルで構成するフックが存在するため、混乱を招く可能性があります。Mod のページで Anthropic は、設定ファイルの方を「設定フック(settings hook)」と呼んでいます。違いは実行場所にあります。「Mod のハンドラーは、代わりに Claude Code の内部で実行される関数である」点です。

小さな Mod は、プラグインマニフェスト、コードを指し示す hooks.json、およびハンドラーを登録するコードファイルの3つのファイルで構成されます。

Modでできること

Mod は Claude Code 内部で実行されるため、Anthropic は設定フック、スキル、ステータスライン、MCP サーバーでは不可能な「Mod にできること」をリストアップしています。

  • 使用可能なインターフェースの描画: トランスクリプトの横のペインやプロンプトの上のバンドなど、タブ、ボタン、テキストフィールドを備えたものを描画できます。
  • Claude Code 自体のインターフェースの再描画: ツール呼び出しの行、スピナー、Claude が質問を表示するダイアログなどを変更できます。
  • ツール呼び出しやリクエストへの介入: 例えば、質問されている間ツール呼び出しを保留したり、リクエストを別のモデルに送信したりできます。
  • コマンドでの独自コードの実行: Claude のターンを介さず、Claude が作業中であっても即座に実行される /command を作成できます。
  • フック間でのデータ共有: あるフックで何かを記録し、別のフックでそれを表示させることができます。

Claude Code 自体の機能のいくつかも Mod として構築されています。組み込みリストには /diff や、「AGENTS.md をプロジェクトの指示として読み込む」組み込み Mod が含まれています。/plugin の Installed タブで組み込み Mod を確認できますが、「組み込み Mod を更新したりアンインストールしたりすることはできません」。

設定フック、スキル、プラグイン、MCPサーバーとの違い

プラグイン: Mod はプラグインと別物ではありません。マーケットプレイスからプラグインとしてインストールされ、1つのプラグインの中に Mod と共にスキル、コマンド、エージェント、MCP サーバーを含めることができます。

設定フック: 設定フックは、ライフサイクルイベント時に Claude Code が実行するシェルコマンド、HTTP リクエスト、またはプロンプトです。ツール呼び出しやプロンプトを許可、ブロック、変更したり、Claude にコンテキストを追加したりできますが、何も描画することはできません。設定フックの詳細と、どれがコンテキストを追加できるかについては、Claude Code フックとは何かのガイドで解説しています。

スキル: スキルは Claude が読み取る指示ファイル SKILL.md です。これは Claude が何を知り、何をするかを変えるものであり、Claude Code 自体の挙動を変えるものではありません。

MCP サーバー: MCP サーバーは、Claude が外部システムにアクセスするためのツールを提供します。

Anthropic の比較では、Mod を選ぶべき時を次のようにまとめています。ペインやプロンプト上のバンド、カスタムコマンドが必要な場合、またはイベントを書き換えたい場合です。設定フック、スキル、または MCP サーバーで必要なことがすでに実現できるなら、Mod を書く前にそれらを比較検討することをドキュメントは推奨しています。

Modのインストールと信頼性の判断

Mod のインストールは他のプラグインと同様です。セッション内で /plugin install に続けて「プラグイン名@マーケットプレイス名」を実行します。セッションが開いている間にシェルからインストールした場合は、/reload-plugins を実行して読み込みます。

Anthropic は公開リポジトリでサンプル Mod も共有しています。例えば、プロンプトの上にコンテキストウィンドウの予測を表示するものや、リスクのあるシェルコマンドを保留して変更内容を表示するものなどがあります。

インストールする前に、警告を真剣に受け止めてください。「Mod はあなたの権限で実行されるコードです」。ドキュメントには、Mod が読み込まれた後にアクセスできるものがリストされています。これには、ファイル、環境変数、設定ファイル、そしてセッション(「送信するすべてのプロンプトと Claude が行うすべてのツール呼び出し」)が含まれます。

さらに、「Mod はサンドボックス化されていません」。サンドボックスをオンにすると、Claude が実行する Bash コマンドは隔離されますが、Mod が開始したプロセスはその外側で実行されます。

制限もあります。「Mod は Claude Code のインターフェースの多くを再スタイルできますが、権限プロンプトは変更できません」。また、Anthropic は組み込みのガード機能について説明しており、ロード時にはデフォルトで、ユーザーの Mod がルールやフックで停止されるべきツール呼び出しを承認することを防ぎます。

インストール前に Mod が何をするかを確認するには、そのフォルダで claude plugin validate を実行してください。出力には、Mod が処理するイベントと、Claude Code に要求するアクションがリストされます。

Modが実行される場所

Mod は Claude Code CLI、Claude デスクトップアプリの Code タブ、および VS Code 拡張機能で動作します。Anthropic の表には例外的なケースも記載されています。

  • claude -p および Agent SDK: フックは実行されますが、何も描画されません。
  • リモートコントロール: フックはマシンのセッションで実行され、描画はそのターミナルに表示されます。
  • クラウドセッション: クラウドセッションに到達するプラグインのフックは実行されますが、何も描画されません。
  • デスクトップアプリの WSL セッション: プラグインが利用できないため、Mod は実行されません。

描画を行う Mod は、実行場所を確認し、トランスクリプト内の行やコマンドのテキスト返信にフォールバックするように設計できます。

セッション間で保持されるデータ

これは Mod を活用する前に理解しておくべき重要な部分です。Anthropic のドキュメントには次のように記されています。「Mod が値をどこに保持するかによって、その値がいつまで持続するかが決まる。モジュールがリロードされるまでか、セッションが終了するまでか、あるいは次のセッションまでかである」

保持場所は3つあります。

モジュールレベルの変数: モジュールがリロードされるまで持続します。開発中はファイルを保存するたびにリロードが発生します。Anthropic はこれらを「失われる可能性のある値」として説明しています。

$.state: 「セッションが終了するか、ユーザーが /clear、/resume、または /branch を実行するまで」持続します。これは、モジュールのリロードを越えて存続すべき、描画に依存する値のためのものです。冒頭の例で /clear 後にペインが空白になったのはこのためです。

$.store: Mod が値を削除するか、cleanupPeriodDays の期間中にどのセッションからも読み書きされなくなるまで持続します。Anthropic はこれを「マシン上のすべてのセッションが共有するキーバリューストア」と説明しています。これは ~/.claude/plugins/store/ 以下にプラグイン独自の JSON ファイルとして保存され、ドキュメントでは設定、履歴、「ユーザーが次回もそこにあると期待するもの」が用途として挙げられています。

つまり、昨日の合計を覚えていたカウンターは $.store にありました。リセットされたペインは $.state から描画されていました。

適切に構築された Mod は、この2つを橋渡しします。Anthropic は、セッション開始時に Mod が保存された値を $.store から $.state にコピーする場合、/clear、/resume、または /branch の後にも再度コピーする必要があると指摘しています。これらのコマンドは $.state をリセットしますが、セッション開始フックは再発火しないためです。データの永続性が期待されるのに Mod の表示がリセットされる場合、作者はその点を確認する必要があります。

実用的なポイントが2つあります。Mod のストアはあなたのマシン上にあり、そのマシンのセッション間で共有されるため、チームメイトや別のコンピュータから見えるものとは異なります。また、何もアクセスされない場合、Claude Code が他で使用しているのと同じ保持期間の対象となります。

Modをオフにする方法

「Mod はデフォルトでオンになっています」。これらを停止するために、Anthropic は3つのレベルを挙げています。

  • 特定の Mod 1つ: /plugin の Installed タブからそのプラグインを無効化またはアンインストールします。
  • 1つのセッションですべてのインストール済み Mod を無効化: Claude Code を --safe-mode で起動します。これにより他のカスタマイズも無効になります。
  • すべてのセッションですべてのインストール済み Mod を無効化: ~/.claude/settings.json で disableAllHooks を true に設定します。設定フックやカスタムステータスラインも停止します。

組み込み Mod は扱いが異なります。「disableAllHooks、--bare、--safe-mode などのインストール済み Mod を停止する設定やフラグは、組み込み Mod を停止しません」。組織は、管理設定を通じてどの Mod をロードするかを制限することもできます。

よくある間違い

Mod のペインが /clear を越えて存続すると期待すること: $.state は /clear、/resume、/branch でリセットされます。

Mod のデータが別のマシンでも利用できると期待すること: $.store は、それが保存されたマシン上のセッション間でのみ共有されます。

確認せずにインストールすること: claude plugin validate を実行して、Mod が何をするかを確認してください。

サンドボックスが Mod をカバーしていると思い込むこと: Mod はサンドボックス化されていません。

プロジェクトの知識に Mod を使用すること: Mod は Claude Code の挙動を変えるためのものです。プロジェクトの知識は指示ファイルに置くべきです。

解決策: Modは挙動のために使い、コンテキストは別の場所に保管する

ステップ 1: インストール前に Mod の動作を確認する

フォルダで claude plugin validate を実行し、リストされたイベントと呼び出しを確認します。

ステップ 2: 各値の所在を知る

Mod を書く場合は、/clear を越えて存続させる必要のある値を $.store に入れ、リセット後にそれらを $.state に再ロードするようにします。

ステップ 3: プロジェクトの知識を指示ファイルに保持する

規約や構造は CLAUDE.md や AGENTS.md に記述します。これらはプロジェクトの指示として読み込まれます。

ステップ 4: セッションで学んだことを書き留める

Mod のペインで進捗を追跡することはできますが、その背後にある決定事項は、セッションやマシンよりも長持ちする場所に記録されるべきです。

MemoryLake でのセットアップ

Mod はセッションで何が起きているかを確認するのに適した方法です。しかし、どのアプローチが有効だったか、なぜ特定のファイルが制限されているのかといったセッションからの決定事項や教訓には、/clear でリセットされず、特定のマシンに縛られない「家」が必要です。

MemoryLake は、決定事項、規約、学んだ教訓などのプロジェクトコンテキストのための記憶(memory)レイヤーです。これらを一箇所で管理し、ChatGPT、Claude Code、Codex など、接続したアシスタントから利用できるようにします。

エントリーはあなた自身の言葉で作成します。Mod、その $.state や $.store、プラグイン、設定ファイル、セッション、あるいはベンダーのストアから何かが読み取られたり、書き込まれたり、削除されたりすることはありません。Mod とその状態は、Anthropic が説明している通りに動作します。

ステップ 1: API キーを作成する

サインインしてダッシュボードからキーを生成します。他の資格情報と同様に、プラグインや Mod のコードには含めないようにしてください。

エージェントで使用するために新しいキーが作成されコピーされる、APIキー画面を表示した MemoryLake コンソール
エージェントで使用するために新しいキーが作成されコピーされる、APIキー画面を表示した MemoryLake コンソール

ステップ 2: 最初の記憶をアップロードする

解決策のステップ4で書いた内容から始めましょう。最近のセッションでの決定事項、信頼している規約、二度と繰り返したくない教訓などです。1つのエントリーにつき1つの決定事項を記述します。

最初のドキュメントがアップロードされ、各ファイルが検索可能な記憶としてリストされている MemoryLake ワークスペース
最初のドキュメントがアップロードされ、各ファイルが検索可能な記憶としてリストされている MemoryLake ワークスペース

ステップ 3: AI とエージェントを接続する

Claude Code や他の使用しているアシスタントを接続します。新しいセッションや別のマシンでも、同じエントリーを利用できます。

記憶レイヤーに接続可能な AI クライアントとエージェントフレームワークをリストした MemoryLake 統合画面
記憶レイヤーに接続可能な AI クライアントとエージェントフレームワークをリストした MemoryLake 統合画面

実践で何が変わるか

第一の違いは、/clear を実行してもコンテキストを失わなくなることです。Mod の表示はリセットされるかもしれませんが、決定事項は記録されたままです。

第二に、ポータビリティです。学んだことは1台のマシンのストアに縛られません。

第三に、役割分担が明確になります。Mod は Claude Code の挙動を処理し、プロジェクトのコンテキストは一箇所に集約されます。

Claude Code Mod のベストプラクティス

Mod をコードとして扱う: Mod はあなたの権限で実行され、サンドボックス化されていません。

インストール前に検証する: claude plugin validate で Mod が何をするかを確認できます。

シェルでのインストール後はリロードする: 開いているセッションで /reload-plugins を実行します。

3つの寿命を知る: 変数、$.state、$.store はそれぞれ保持期間が異なります。

/clear でのリセットを想定する: $.state はデフォルトに戻ります。

トラブルシューティングには --safe-mode を使う: 1つのセッションでインストール済み Mod を無効にします。

コンテキストを Mod に入れない: 指示ファイルと、自身で管理する記憶(memory)を使用してください。

結論

Claude Code Mod は、Claude Code 内部で実行される JavaScript または TypeScript のハンドラーで構成されたプラグインです。ペインやバンドの描画、インターフェースの再描画、ツール呼び出しやリクエストへの介入、コマンドの追加など、設定フック、スキル、MCP サーバーにはできないことが可能です。また、あなたの権限で実行され、サンドボックス化されていないため、インストール前に必ず検証してください。

Mod が保持するデータは、値をどこに保存するかに依存します。モジュール変数はリロードまで、$.state はセッション終了または /clear、/resume、/branch の実行まで、そして $.store は Mod が削除するか保持期間が過ぎるまで、マシン上のセッションを越えて持続します。これらすべてよりも長持ちさせる必要のあるコンテキストについては、自身で管理する場所に書き留めておきましょう。

よくある質問

Claude Code Modとは何ですか?

イベントが発生したときに Claude Code が呼び出す JavaScript または TypeScript のイベントハンドラーで構成されたプラグインです。Anthropic によれば、Mod は Claude Code の見た目や挙動を変更します。

Modは Claude Code フックとどう違うのですか?

設定フックは、設定ファイルからシェルコマンド、HTTP リクエスト、またはプロンプトを実行します。Mod のハンドラーは Claude Code 内部で実行される関数であり、インターフェースに描画することも可能です。

なぜ /clear の後に Mod がリセットされたのですか?

$.state は、セッションが終了するか、/clear、/resume、または /branch を実行するまでしか持続しないためです。

Modはセッション間で何かを記憶できますか?

はい、$.store を使用していれば可能です。これはマシン上のすべてのセッションで共有されるキーバリューストアで、~/.claude/plugins/store/ に保存されます。

Modは安全ですか?

Mod はあなたの権限で実行され、サンドボックス化されていません。信頼できる作者やマーケットプレイスからのみインストールし、claude plugin validate で内容を確認してください。

すべての Mod をオフにするにはどうすればよいですか?

1つのセッションなら --safe-mode で起動し、すべてのセッションなら ~/.claude/settings.json で disableAllHooks を true に設定します。組み込み Mod はこれらでは停止しません。

Modはどこで動作しますか?

Claude Code CLI、Claude デスクトップアプリの Code タブ、および VS Code 拡張機能で動作します。claude -p やクラウドセッションでは、フックは実行されますが描画は行われません。