Claude Code modsゼロから学ぶ教科書

Claude Code mods（モッド。この教科書では Claude Mods とも呼びます）は、Claude Codeの見た目や、仕事が進む途中の動作を、自分の用途に合わせて変えるための仕組みです。たとえば「校正の指摘を横のパネルにまとめる」「公開する直前に確認を挟む」といった機能を作れます。AIが考える力そのものを増やす機能ではありません。

「AI」「アプリ」「プログラム」という言葉に慣れていなくても、ここから読めます。TypeScriptというプログラミング言語は、本文を理解する前提にしません。先に仕事の流れを思い浮かべ、必要になってから専門用語を足していきます。

この教科書は、高度AIセミナーのために作った入門教材です。出版・編集・広報の例を使いますが、実際の社内運用や導入実績を示すものではありません。本文中の社名、人物、原稿、結果は、学習用の架空例です。

読み終えたときに目指すこと

• Claude、Claude Code、モデル、Modを、自分の言葉で区別できる。
• 「いつ」「何を」「どう変えるか」で、欲しい機能を説明できる。
• Skill・Hook・MCP・Pluginと比較し、Modが向く場面を選べる。
• 安全に試すための条件と、うまく動かなかったときの戻り方を説明できる。

一度で全部を覚える必要はありません。答えを見る前に少し考え、間違えた理由を確かめることで理解を積み上げます。読者全員の理解を保証する教材ではありませんが、戻る場所と確認する方法を用意しています。

この教材の操作

目次から章へ移動できます。「応用」や「答え」は見出しを押すと開きます。キーボードでもTabで移動し、EnterまたはSpaceで開閉できます。ページ内の語を探すときは、Macでは⌘F、ほかの環境ではブラウザーの検索機能を使ってください。

HTMLは1ファイルで、図・デザイン・教材内の動作を含みます。本文を読むための通信は不要です。公式資料へのリンクを自分で開くときはインターネット接続を使います。シミュレーションはこのページだけで動き、Claudeや実API、Macの端末を操作しません。入力や学習状況を送信・保存しません。

資料確認日：2026年10月8日。Modsの発表日：2026年10月1日。機能と画面は更新されるため、実際に利用する際は末尾の公式資料と手元のバージョンを確認してください。

まず、文章を考える担当と、Macの中で仕事を進める仕組みを分けます。この区別ができると、「Modで何が変わるのか」が見えやすくなります。

ClaudeはAIの名前でも、サービスの名前でもある

ClaudeはAnthropicが提供するAIの総称です。日常会話では、Webやアプリで会話するサービスを指して「Claude」と呼ぶこともあります。たとえば「イベントの案内文を考えて」と入力すると、文章を提案してくれます。

AIが文章を考える中心にはモデルがあります。モデルとは、入力された文章などをもとに、次の回答や行動案を作る仕組みです。人にたとえるなら、考える担当に近いものです。ただし、人のように意味を必ず理解し、正しい事実を保証する存在ではありません。

Claude Codeは仕事を進めるアプリの仕組み

Claude Codeは、モデルを使いながら、ファイルを読んだり、編集したり、コマンドを実行したりする道具です。「Code」はコードの意味ですが、ここではプログラムを書くだけの話に閉じず、AIの提案と実際の作業をつなぐ仕組みとして見てください。

たとえば「このフォルダーの文章を調べて、表記ゆれの候補を一覧にして」と頼んだ場合、モデルは調べ方を考え、Claude Codeが利用できる道具でファイルを読み、結果をモデルへ戻し、回答を組み立てます。ファイルや道具へのアクセスは、環境・権限・設定に左右されます。

道具とは、実際の作業をする手段

この教材のツールは「道具」です。たとえばReadならファイルを読む、Writeなら書く、Bashなら端末でコマンドを実行する、という仕事を担当します。モデルが「原稿を読もう」と考えることと、道具が実際に原稿を読むことは別の段階です。

画面が違っても名前だけで判断しない

Claude DesktopはMacなどで使うClaudeのアプリです。そのCodeタブでClaude Codeを使えます。一方、普段のチャット画面とCodeタブは別の作業場所です。「DesktopでModsが使える」と聞いて、すべてのチャット画面で同じ追加パネルが表示されるとは考えないでください。

CLIは、文字で命令を入力して使う画面のことです。Macの「ターミナル」は、その文字の画面を開くアプリです。Claude CodeにはCLIで使う形もあります。Modの考え方は共通でも、表示できるものは作業場所によって異なります。

根拠を確かめる：Claude Code Overview（公式）

1章では、モデルが考え、Claude Codeが道具を使って仕事を進めると整理しました。Modが手を加えるのは、その仕事が進む仕組みや、あなたが見る画面です。

Modが1つ、Modsが複数

Modは、ソフトウェアなどを自分の用途に合わせて改造する追加物を指す言葉です。ここではClaude Codeの拡張機能を指します。Modsはその複数形であり、機能全体の呼び名としても使われます。AIの別モデルや、「mode＝モード」の省略ではありません。

もともとのClaude Codeに「作業中の確認項目を表示する棚」を付け足す感覚です。棚の並べ方が変わっても、編集者の知識が増えるわけではありません。しかし、確認し忘れを見つけやすくなる、といった使い勝手の改善は期待できます。

見た目の変更と、動作の変更がある

• 見た目の例：校正結果を横のパネルに置く、道具の結果を読みやすくまとめる、作業状況を入力欄の上に表示する。
• 動作の例：特定の作業の前に確認を挟む、道具の呼び出しを止める、入力や道具の結果を変える。

これらはModで設計できる機能の方向です。「Modを入れれば全部が最初から備わる」という意味ではありません。何が実現するかは、そのModの実装に依存します。

Pluginは追加機能をまとめた包み

Plugin（プラグイン）は、拡張機能を導入・配布しやすくまとめたものです。Modはプラグインの中に入れて配布します。プラグインには、あとで学ぶSkillや設定Hook、MCPの設定などが含まれる場合もあります。

「箱がPlugin、その箱に入った、Claude Codeの内部で動作を変える部分がMod」という見方ができます。公式docsには「ModはClaude Codeの見た目と振る舞いを変えるプラグイン」とも説明されています。この教材では、配布のまとまりと、その動く部分を理解しやすいよう分けて呼びます。

作るときは日本語で目的を頼める

自分でJavaScriptやTypeScriptを書く方法に加え、Claude Codeに「こういうModを作って」と自然な言葉で頼む方法があります。ただし、コードを読めなくても依頼できることと、できたコードを無条件に信頼できることは別です。確認する範囲や失敗したときの戻し方も、依頼に含めます。

根拠を確かめる：2026年10月1日のMods発表記事（公式）

Modは、ただ何となくAIの仕事を監視して動くのではありません。Claude Codeの中で起きるイベントという合図に、決められた処理を結び付けます。

イベントは催し物ではなく、出来事の合図

ここでのイベントは「原稿を読む道具を使おうとしている」「質問が送られた」「画面を描こうとしている」といった、ソフトウェアの中の出来事を知らせる合図です。宅配便の「発送しました」「配達が完了しました」に似ています。合図を受けて何をするかを決めておけます。

ある出来事が起きたときに動く処理を、イベントハンドラーと呼びます。「合図を受け取る係」だと考えてください。Modはその係を登録し、Claude Codeが対応する合図のところで呼び出します。

合図の種類を、仕事の言葉に置き換える

「画面を描く」は、毎回画像を作るという意味ではありません。文字・ボタン・パネルを画面に配置して表示する処理です。人が画面を見ている時間と、ソフトウェアが表示を作るタイミングは区別します。

全部の合図に反応する必要はない

公開前の確認を作るなら、「道具を使う合図」のうち、公開を行う道具や操作だけを対象にします。原稿を読むたびに確認を出すと、必要な確認まで読み飛ばしやすくなるからです。

条件に合うものだけを選ぶ仕組みを、公式docsではmatcher（条件で選ぶフィルター）と呼びます。初心者が覚えるべき点は、Modの依頼を「すべてを確認して」から「この操作のときだけ確認して」へ具体化することです。

根拠を確かめる：Mods Reference（公式）

3章で、Claude Codeには仕事の途中の合図があると学びました。この章では、合図を受けたModが、いつ、どのように仕事に関わるかを見ます。英語は4語だけです。

beforeは前、afterは後、insteadは代わり、wrapは包む。これらは動作を説明する言葉です。この4つの名前のボタンを押して設定する機能や、そのままの名前のAPIがある、という意味ではありません。

before　処理の前に挟む

手紙を送る前に、封筒の宛先を確認する場面です。送り終わってから確認しても遅いため、送る前に確認します。Claude Codeでも、ある道具が仕事を始める前に、対象や条件を調べられます。

設計例：Webの公開ツールを呼ぼうとしたら、公開先と対象原稿を示し、「この内容で進めますか」と確認する。進める条件が満たされたときだけ、元の処理に渡す。確認が答えられなかった場合の扱いも決めます。

after　処理の後に挟む

コピー機が原稿を読み終えたあとに、結果の枚数を表示する場面です。処理を実行して、結果を受け取ってから動きます。

設計例：チェックを実行する道具が完了したら、「合格18件・失敗2件・未実施3件」と表示する。結果を見やすくする機能です。検査を実行していないなら、「全件合格」と表示してはいけません。

instead　元の処理の代わりをする

受付で「この窓口では発送できません」と答え、発送の担当には渡さない場面です。元の処理を走らせず、Modが自分で結果を返します。

設計例：学習用フォルダーでは外部公開を禁止し、公開ツールを呼ぼうとしたら「練習環境なので公開しません。プレビューを確認してください」と返す。元の公開処理へ進めません。

wrap　処理を前と後から包む

荷物を預かるときに受付番号を付け、実際に配達し、終了したら同じ番号に結果を記録する場面です。一つの処理の前後をまとめて扱います。

設計例：検査開始をパネルに表示し、検査を実行し、その結果を「完了」「失敗」「中断」に更新する。結果だけでなく、進行中の状態も伝えられます。

「後」は、どの処理の後かを確かめる

秘密を道具の出力から隠す場合、「道具が結果を返した後」であり、同時に「その結果をモデルが読む前」です。基準にする処理が違うため、同じ場所を「後」とも「前」とも説明できます。何の前後なのかを必ず言葉にしてください。

【説明用の擬似コード　実行できるAPIコードではありません】
before:  前の仕事 → 次へ渡す → その結果を返す
after:   次へ渡して結果を待つ → 後の仕事 → 結果を返す
instead: 次へ渡さない → 自分の結果を返す
wrap:    前の仕事 → 次へ渡して待つ → 後の仕事 → 結果を返す

根拠を確かめる：React to events with a mod（公式）

4章では介入する順番を学びました。次は、「介入して何を変えるか」です。見た目だけを変えるのか、実際の動作を変えるのか、モデルが読む内容を変えるのかで、効果も確認方法も変わります。

1　あなたが見る表示を変える

会話の横のパネル、入力欄の上の帯、道具の結果の行などを作り変えられます。「今回の校正候補は12件」「未確認が3件」という一覧が常に見えていれば、長い会話をさかのぼる手間を減らせます。

表示を変えただけでは、元の原稿は直りません。たとえばパネルに「ことばをやさしく」と表示しても、原稿ファイルにその修正が書き込まれるかは別です。表示・提案・ファイル編集を分けて考えます。

2　仕事の動作を変える

道具の呼び出しを止める、引数を変える、必要な確認を挟む、失敗した処理を再試行する、といった設計ができます。引数とは、道具に渡す「対象のファイル」「送る文章」などの情報です。

たとえば「Web公開の操作だけを、対象と公開先が確認されるまで待たせる」機能です。反対に、Modが権限判断を自動で許可する設計も技術的には可能な範囲があります。だからこそ、入れるModが何をするかが重要になります。

3　モデルに渡す内容を変える

質問がモデルに届く前に表記ルールを追加する、道具の出力に含まれる秘密をモデルが読む前にマスクする、といった設計もできます。画面で見えなくすることと、モデルに渡さないことは別です。

秘密とは、APIキー、パスワード、非公開の認証情報などです。APIキーは、サービスの利用権を示す鍵のような文字列です。この教材には本物のキーは含めません。マスクの確認には、必ず作り物の文字列を使います。

表示・内容・結果の境界を確かめる

Modは仕事に合わせる道具であり、正しさの証明ではない

Modに検査を付ければ、決まった形式のミスを見つける助けになります。しかし、難しい内容判断を任せるなら、検査方法を別に設計しなくてはいけません。児童向け文章の読みやすさ、表現の配慮、出典の正確さを、色の付いた表示だけで判断しないでください。

別のモデルへ依頼を送る設計もできますが、その場合は利用量や待ち時間が増えることがあります。Mod自体がモデルの基礎能力を変えるわけではありません。

根拠を確かめる：Draw in the interface（公式）

根拠を確かめる：Use the mods API（公式）

Modsは便利ですが、すべての仕事をModにする必要はありません。同じ困りごとでも、より単純な方法で解決できることがあります。ここでは、名前を覚えるより「どこに働くか」を見ます。

Skillは繰り返し使う仕事の手順書

Skill（スキル）は、Claudeが読む再利用可能な指示や資料などのまとまりです。たとえば「子ども向けの文章では、対象年齢を先に確認し、難しい語を候補として挙げ、勝手に固有名詞を変えない」という手順を毎回使いたいときに向きます。

料理ならレシピに近いものです。読むべき手順を渡すことで作業をそろえます。Skillの指示だけで、画面の横に新しいパネルが生えるわけではありません。指示を必ず守る安全装置として扱わないことも大切です。

設定Hookは合図に応じて動く既存の処理

Hook（フック）は、出来事に処理を引っかける仕組みです。この教材の比較表で「設定Hook」と書く場合は、設定ファイルに登録する従来のHookを指します。特定の合図で、外部のコマンド、HTTP要求、AI向けの処理などを呼び出せます。

たとえば、ファイル編集の後に、すでにある書式チェックを走らせたいときです。現行docsでは設定Hookも、道具の引数や結果、Claudeに追加する情報などを扱える範囲があります。「Hookは何も書き換えられない」と一律に理解するのは不正確です。

なお、Modのイベントハンドラーも公式docsではhookと呼ばれます。「Modの中のhook」と「設定ファイルのHook」が同じ単語なので、どちらの話かを確認しましょう。

MCPは外の道具やデータとつなぐ共通の仕組み

MCPはModel Context Protocolの略で、AIが外部の道具やデータにつながるための共通の仕組みです。社内データベースを調べる、別の業務システムから資料を取得する、といった場面で使います。

料理なら、材料を取りに行くための窓口に近いものです。MCPでつながっているから、データの正しさや操作権限が自動で保証されるわけではありません。接続するサービス、認証、渡す情報を確認します。

Pluginは配布のまとまり、Modは内部の動作と画面に働く

Pluginは、機能をまとめて入れる包みです。Skill、設定Hook、MCP、Modは、目的が異なる仕組みであり、同じプラグインに一緒に入ることもあります。箱と中身を、同列の選択肢として混同しないようにします。

同じ目的に、複数の方法があり得る

「毎回、表記ルールを守ってほしい」なら、最初は指示文やSkillで足りるかもしれません。「確認候補を一覧のパネルに残して、作業中に見返したい」ならModの画面拡張が合います。Modで何でも作る前に、欲しい変化を言葉にします。

「表記の判断」はSkill、「書誌の取得」はMCP、「結果のパネル」はMod、と組み合わせる設計も可能です。複数を使う場合は、どの役割が失敗したのかを分けて確認できるようにします。

根拠を確かめる：Extend Claude with skills（公式）

根拠を確かめる：Hooks Reference（公式）　／　設定ファイルの Hook を基礎から学ぶ：はじめてのHook教科書

根拠を確かめる：Connect Claude Code to tools via MCP（公式）

根拠を確かめる：Plugins Overview（公式）

考え方が分かったら、次は使うときの順番です。この章は、実際に取り組むときの案内です。この教材を開いただけでは、Modは導入されません。セミナー中は読むだけで構いません。

まず使う場所とバージョンを確かめる

2026年10月8日に確認した現行docsでは、Modsはデフォルトで有効です。CLIではClaude Code v2.1.287以上、Desktopでは内蔵Claude Code v2.1.286以上が目安です。Desktopアプリの番号と、内蔵Claude Codeの番号は区別してください。組織の設定によっては使えない場合もあります。

上のコマンドは、読者が環境を確認するための説明です。このページは実行しません。端末に不慣れなら、セミナーの担当者や社内の管理者に画面を一緒に確認してもらってください。古い記事にある環境変数 CLAUDE_CODE_ENABLE_FUNCTION_HOOKS を変更する案内は採用しません。現行v2.1.287以降では無視されるためです。

利用の順番を5つに分ける

1. 目的を一文にする。

   「今回使った道具の回数を見たい」「表記候補を見返したい」など、欲しい変化を一つ選びます。

2. どこから来たModか確認する。

   作者・配布元・説明・対応バージョン・利用する権限・外部通信の有無を確認します。会社では導入方針を先に確認します。

3. 架空の資料で試す。

   新しい練習用フォルダーに、短い架空原稿だけを置きます。未公開原稿、読者の情報、鍵は使いません。初回は表示だけの機能にすると、結果を理解しやすくなります。

4. 何が変わったか確かめる。

   目的の表示が出たか、元の作業が進むか、エラーや未実施が正しく示されるかを見ます。見た目が整ったことだけを合格条件にしません。

5. 停止と保存を確かめる。

   個別のプラグインを無効にして、元の動作に戻ることを確認します。自作の試作品を使い続けるなら、保存先と別セッションでの読込方法を確認します。

既存のModはプラグインとして導入する

CLIではClaude Codeの入力欄で /plugin を開き、プラグインを管理します。Mod入りのプラグインもその仕組みを使います。Desktopにもプラグインの管理画面があります。画面や組織の方針に従い、対応するCode用プラグインか確認します。

配布場所の一覧をmarketplace（マーケットプレイス）と呼びます。店に並んでいることだけで、すべての中身の安全が保証されるわけではありません。追加する配布元と作者を確認します。

/plugin install example-mod@your-marketplace

自分で頼んだModは、そのセッションだけの試作品から始まる

現行の制作手順では、Claude Codeに目的を伝えると、組み込みの plugin-authoring Skillを使ってModを作れます。ホットリロードとは、作り直した内容を同じセッションで読み直すことです。許可すると、作成や変更に応じてそのModのコードが読み込まれて動きます。

ホットリロードの承認は、単なる見た目の保存ではありません。コードの実行に関わる判断です。承認の範囲は、そのセッションの開発用Modsと、以後の変更にも及び、セッションを再開しても続きます。初めてのときは、8章のように先に仕様を確認してから進めます。

承認画面の「Not now（今はしない）」は、その場の読込を見送る回答です。永久に拒否する意味ではなく、次回そのセッションを開始するとModが読み込まれる、と現行docsは説明しています。使わないと決めた場合は、単に見送るだけでなく、開発用Modの保存場所と読み込みを止める方法を確認してください。

Claudeがその場で作る開発用Modは、そのセッションに結び付き、後で整理されるフォルダーに置かれます。次回も使うなら、保存先と読み込み方を確認します。「作ったら永遠に全セッションで使える」とは考えないでください。

やめるときは、まず対象のプラグインを無効にする

CLIでは /plugin のInstalled（導入済み）で対象を選び、無効化できます。必要に応じてアンインストールもできますが、まず無効化して動作を比べると原因を切り分けやすくなります。Desktopでは対応する管理画面を確認します。

無効化は今後の動作を止めるための方法です。すでに書き換えたファイル、送信した情報、使った利用量を自動で元に戻すものではありません。

根拠を確かめる：Mods Overviewの対応環境と無効化（公式）

根拠を確かめる：Create a modの制作・承認・保存（公式）

TypeScriptが書けなくても、「何を見たい」「何の前で止めたい」を日本語で頼めます。役立つのは、長い専門的な命令より、仕事の条件がはっきりした依頼です。

依頼は6つの問いで具体化する

1. 誰が何に使うか。編集者が、文章の表記候補を見返す。
2. いつ反応するか。校正の結果が更新されたとき。
3. 何を見せる・変えるか。原文、提案、場所、理由をパネルに示す。
4. どこまで動作させるか。原稿変更と外部通信は行わない。
5. 失敗をどう示すか。結果がなければ未検査、取得できなければ取得失敗。
6. 何をもって完成とするか。架空原稿の例で確認し、無効化して戻れる。

最初は「仕様だけ」を頼んで確認する

まだ使う場所や条件が決まらないなら、先に仕様案を頼みます。この段階ではコードを保存したり、Modを有効にしたりする必要はありません。何が実装可能か、どこから結果を受け取るかを確認してから制作へ進みます。

Claude Codeで使うModの仕様案を、日本語で作ってください。
目的は、文章校正の候補を横のパネルで見返すことです。
利用者は、プログラミングをしない編集者です。

まず、表示する情報、反応するタイミング、結果の受け取り方、
必要な権限、使えない画面での代替表示、停止方法を説明してください。
この段階ではファイルを作成せず、導入・実行・設定変更もしないでください。
実際に可能か、手元のClaude CodeのAPIと型定義に照らして確認してください。

表示だけの練習用Modを頼む例

この例は原稿の解析を行わず、架空の候補データを表示する試作品です。先に表示と操作を理解することで、校正判断まで一度に作る複雑さを減らします。

仕様を確認したうえで、練習用の校正パネルModを作ってください。
Claude CodeのCLIとDesktopのCodeタブで使う想定です。

まずは架空の候補データだけを表示してください。
候補は「3行目：子供 → 子ども」「6行目：出来る → できる」です。
原文、提案、理由、確認状態を日本語で示してください。
候補ゼロと未検査を別の状態で表示してください。

原稿ファイルを変更せず、外部通信、モデルの追加呼び出し、
秘密情報の読取、権限の自動承認を行わない仕様にしてください。
狭い画面では内容を読める形にし、表示できない環境では文字の代替を考えてください。
手元の型定義で確認し、可能な検証を行い、検証済みと未検証を説明してください。
読み込む前に、作るファイルと実行する内容と止め方を説明してください。

「ファイルを変更しない」と依頼したことだけで、コードの能力が制限されるわけではありません。できたコードがその仕様に沿っているか、検査やレビューで確かめます。必要なら社内の技術担当者と確認してください。

公開前確認を頼む例

確認したいのは「公開」そのものです。コマンドの名前にpublishという語が入っているだけで判定するような単純な方法は、別名の操作を見逃す可能性があります。実際の公開経路を先に洗い出します。

公開前の確認を行うModの設計案を作ってください。
まず、この環境で公開につながる道具と操作を洗い出し、対象を説明してください。
公開先、対象ファイル、変更の要点を見せ、人が確認するまで進めない設計にしてください。
取り消し、無回答、タイムアウト、Modのエラーは実行しない方向に扱いたいです。
ただしModだけで確実に止められるとは断定せず、既存の権限設定との関係を説明してください。

最初は外部へ接続しない架空の公開操作で試験します。
実際の公開、設定変更、権限の自動承認はしないでください。
許可・拒否・中断・失敗の例で確認する手順を示してください。

できたものの確認は、お願いした仕様と照らす

• 候補ゼロ、未検査、取得失敗が別に表示されるか。
• 一つの操作で、元の処理が何回実行されるか。意図しない二重実行がないか。
• 実行を止めたとき、「実行しなかった」と分かるか。
• 本来の処理を通すとき、結果を失わずに返すか。
• 無効化した後、画面や動作が戻るか。

根拠を確かめる：Create a mod（公式）

この章の5例は、出版・編集・広報の仕事を想定した設計例・未実装です。特定の会社に導入された実績や、Claude Codeの標準搭載機能を示すものではありません。実際に作るには、手元のAPI、使う道具、情報の受け取り方を確認します。

加工前の学習用データ：ACCESS_KEY = FAKE_SECRET_FOR_LEARNING_ONLY
加工後の表示例：      ACCESS_KEY = [マスク済み]

実際に公開されている公式サンプルもある

公式の初めてのModガイドには、次のサンプルが紹介されています。この教科書では、ソースを導入・実行していません。公開された説明をもとに役割を整理しています。

context windowは、一度の処理でモデルに渡せる情報量の範囲です。机に広げられる資料の量にたとえられます。「残りが少ない」と見えることと、机が大きくなることは違います。

根拠を確かめる：Getting started with Claude Code mods（公式）

ModはClaude Codeの中で動く追加のコードです。便利な表示を作ることも、Macの中のデータや外部通信に関わることもできます。ここでは、何を理解してから使えばよいかを整理します。

あなたのMacで動くコードとして信頼を判断する

公式は、ModsがClaude Code自体と同じようにMacへアクセスでき、OSの安全な隔離領域としてsandbox化されていないことを説明しています。あなたの利用者アカウントがアクセスできる範囲で、ファイルを読む・書く、プログラムを起動する、通信するなどの操作が可能です。

環境変数や設定ファイルの秘密を読むこと、依頼文や道具の呼び出しを見ること、入力や権限判断に関わること、モデルを追加で呼んで利用量を使うこともあり得ます。すべてのModがそれをするという意味ではありません。何をするコードかを知り、作者と配布元を選ぶ理由です。

Bashのsandboxを有効にしていても、Mod自身が起動したプロセスはその外で動く、と公式docsは説明しています。Claude Codeの道具に対する権限ルールと、Mod自身の操作を同じものとして扱わないでください。

初めて使うときに読む4点

• 目的と対象：どの合図に反応し、どの作業を変えるのか。
• 操作と通信：何を読み書きし、何を起動し、どこへ送るのか。
• 権限と利用量：自動許可や追加モデル呼び出しがあるか。
• 停止と更新：どう止めるか。更新した版でも同じ内容か。

知らない名前のModを、その場で大量に入れる必要はありません。最初は目的の明確な一つを、架空データで確認します。技術担当者には、説明文だけでなく、コードと登録するイベント・API呼び出しを確認してもらうと判断材料が増えます。

「公開を止めるMod」は、失敗するときも確かめる

止めるためのModでも、コードがエラーになった場合や制限時間を超えた場合に、その処理が飛ばされ、元の処理が進むことがあります。公式docsでは、通常の失敗時にハンドラーをスキップする動作が説明されています。

これを専門用語でfail openと呼びます。係が動けないときに、扉が開いたままになるような状態です。反対に、確認できないなら進めない設計をfail closedと呼びます。公開確認のような場面では、エラー・中断・無回答も「進めない」に扱う条件が必要です。

ただし、Modが元の処理を呼んだ後で失敗した場合、実際の操作はもう起きているかもしれません。失敗時に止める処理を付けたことだけで、すべての状況で安全になるわけではありません。実行前・実行中・実行後のどこで失敗するかも試します。

よくある失敗と、戻る場所

操作を増やす前に、対象のModを止めて比べる

不具合が出たら、実行中の作業を確認し、対象のプラグインを無効にして再確認します。何をしたかの記録と、変更されたファイルを見ます。「もう一度」を何度も押すと、送信・公開・課金などが重複する操作もあります。

共有するときは、再現できる架空の例と、使う版・画面・Modの版を伝えます。秘密や未公開資料をそのままエラーログに付けないでください。安全確認が済むまで実データや外部操作に広げません。

根拠を確かめる：Modsの権限と信頼（公式）

根拠を確かめる：イベントの失敗と.catchの扱い（公式）

根拠を確かめる：組織向けの制御条件（公式）

答えを開く前に、自分の言葉で一度答えてください。すらすら言えないところは、対応する章へ戻ります。用語を正確に暗唱するより、何が起きるかを説明できることが目標です。

まず一つの仕事を、最後まで設計してみる

あなたは架空の学習ページを制作しています。「検査を始めたことが分かり、終わったら結果を見られ、公開前に人が確認できるようにしたい」とします。次の4点を書き出してください。

1. 検査開始・検査結果・公開確認は、それぞれどこに介入するか。
2. 未検査・検査中・検査失敗・合格をどう区別するか。
3. 公開の確認が失敗したら、どうするか。
4. 最初の試験で、何を実行せずに確かめるか。

16問で理解を確認する

5分の復習に使う一枚

セミナーの対話に使う問い

自分の仕事で「毎回探し直すもの」「実行前に見比べるもの」「失敗が見えにくいもの」を一つ挙げてください。それを「いつ」「何を」「どう変える」の3つで説明します。Modが必要か、Skillなどで足りるかを隣の方と話してみてください。

例：「校正結果が更新されたときに、未確認の候補をパネルに表示したい。原稿は自動で変更しない」。ここまで言えれば、具体的な仕様相談を始められます。

用語集

分からない言葉を探し、説明の右のリンクから本文に戻れます。ここでの意味は、この教材の用途に合わせて簡潔に整理しています。

公式資料と、この教材で確かめた範囲

2026年10月8日に、下の公式記事・公式ガイド・docsを確認して制作しました。資料は更新されます。実装時は、実際に使うClaude Codeが出力する型定義と、その版の説明を優先してください。

1. Customize Claude Code with mods

   2026年10月1日の公式発表。Modsの目的、前後の介入、権限、プラグイン配布。

2. Getting started with Claude Code mods

   発表記事からリンクされた初めてのModガイド。Token Weatherなどの例。

3. Claude Code Overview

   Claude Codeの役割と、CLI・Desktopなどの入口。

4. Mods Overview

   現行の全体像、対応環境、バージョン、信頼、停止、比較。

5. Create a mod

   自然言語での制作、承認、ホットリロード、保存、検査。

6. React to events with a mod

   nextによる介入、条件の指定、複数Mod、失敗時の扱い。

7. Draw in the interface

   パネル、帯、表示変更、対応する画面、権限確認UIの境界。

8. Use the mods API

   Modが呼べる機能と、モデル呼び出しなど。

9. Mods Reference

   現行のイベント・API・表示要素の一覧。確認時点の説明はv2.1.290。

10. Manage mods for your organization

    組織の設定とsec-defaultの条件・権限制御。

11. Extend Claude with skills

    Skillによる手順と指示の再利用。

12. Hooks Reference

    設定ファイルに登録するHookの役割と、扱える情報。

13. Connect Claude Code to tools via MCP

    外部の道具・データへの接続。

14. Plugins Overview

    追加機能の配布と構成。

15. Plugin security and trust

    作者・配布元・コードを信頼する判断。

事実・たとえ・設計例の読み分け

公式資料に基づく事実：Modの役割、現行の対応環境、基本のイベント処理、導入・停止の方法、権限の注意など。各章の末尾に確認先があります。

教材独自のたとえ：編集室、受付、発送、机など。理解の助けに使うものであり、実際の画面や内部構造をそのまま写した図ではありません。

設計例・未実装：出版業務の5例、日本語の依頼文、公開確認の構想など。機能を実装・導入した結果ではありません。

教材内シミュレーション：4章のボタンで進む架空の流れ。ブラウザー内でだけ動き、実APIや端末、ファイル、公開操作に接続しません。

この教材を作る際は、Modやプラグインの導入・実行、Claude Codeの設定変更、秘密情報の取得は行っていません。紹介したModが現在の環境で実際に動くことを、教材のブラウザー検証が証明するものではありません。

次に一つだけ進めるなら

自分の仕事の「いつ」「何を」「どう変える」を一文にし、8章の仕様相談の形に整えてください。分からない点は、セミナーの担当者や社内の技術・運用担当者と、架空の例を使って確かめると進めやすくなります。