Claude Code スラッシュコマンド Mod

Claude Code スラッシュコマンド Mod は、/tally や /diff のようにプロンプトに入力するコマンドを追加し、それにコードで応答します。ハンドラーは Claude Code の内部で動くため、Mod が集めたデータから即座に返答したり、ペインを開いたり、設定を切り替えたりでき、モデルへのリクエストもトークンの消費も発生しません。

Claude Code スラッシュコマンド Mod はどうやってコマンドを登録するのですか？#

Mod は通常 session.start フックの中で $.command.register({ name, description }) を呼び出し、その名前に一致するマッチャー付きで command.run を処理します（on('command.run', { command: 'tally' }, ...)）。ハンドラーが { text } を返すと返答が表示され、トランスクリプト上で Markdown としてレンダリングされます。{} を返せば何も表示せずに終了します。コマンド名に使えるのは英字、数字、_、- で、最大 64 文字です。

同じ command.run イベントは他のすべてのコマンドでも発火するため、Mod は組み込みコマンドをラップすることもできます。command.describe を使えばコマンド一覧での表示方法を変えられ、$.command.run を使えばある Mod から別のコマンドを呼び出せます。/tally を例にした手順は作成ガイドで解説されています。

インストール前に何を確認すべきですか？#

コマンド系の Mod には コマンド・ツールを追加のバッジが付きます。このバッジ単体ならリスクは低く、コマンドはあなたが入力したときにしか実行されません。重要なのはコマンドが実行時に何をするかなので、ほかのバッジも確認してください。Mod の状態を読んで表を表示するだけのコマンドなら、それ以上の権限は不要です。ペインを開くコマンドなら UI を変更が加わります。git を実行したり、ファイルを読んだり、サーバーを呼び出したりするものには、コマンドを実行、ファイルを読み取る、ネットワークが表示されます。

コマンド名の衝突も確認しましょう。2 つの Mod が同じコマンド名を登録しようとすることがあります。具体的で衝突しにくい名前を使い、その名前をページに明記している Mod を選ぶのがおすすめです。

プロンプトではなく Mod のコマンドを使うべきときは？#

答えが機械的に決まる場合、つまり数える、一覧にする、設定を切り替える、ビューを開くといった用途には Mod のコマンドを使いましょう。Claude に答えを考えてほしい場合は、通常のコマンドファイルやスキルを使います。便利な Mod の多くは両方を組み合わせており、フックでデータを集め、それを 1 つのコマンドで報告します。