AI-translated from English; not yet reviewed by a fluent editor.

# Claude Codeのmodでコンテキスト表示を作り、アクセス権を確認する

> Claude Codeのmodはセッション内に表示を描画し、動作も変更できる。このガイドでは、文書に記載された方法でコンテキスト表示を依頼し、生成されたmodのアクセス範囲を確認する。

By BIG CHANGE Editorial

Published: 2026-10-02T04:59:25.238Z
Updated: 2026-10-02T04:59:25.238Z
Canonical: https://bigchange.ai/blog/claude-code-mods-context-display-guide

![Illustrated close-up of a computer display with three mod files, a session usage call, and an orange context strip.](https://bigchange.ai/api/media/file/claude-code-mods-context-hero-v2.png)
AI-generated by OpenAI; BIG CHANGE conceptual editorial illustration.

Claude Codeでは、JavaScriptまたはTypeScriptの関数をプラグインとしてまとめ、アシスタントの画面や動作を変更できるようになった。Anthropicは[10月1日にmodを公開](https://claude.com/blog/claude-code-mods)し、CLIとClaude DesktopのCodeタブに対応した。開発者は会話内にコンテキスト使用量を表示できる。

Anthropicによると、modはユーザーの端末の権限で動作し、サンドボックス化されていない。modはセッションデータを読み取ったり、モデルを呼び出したりもできる。インストール前にコードと公開元を確認する。

このガイドは、Claude Codeをすでに使っていて、小規模で画面上に表示されるカスタマイズを試したい開発者向けだ。ここではコンテキストウィンドウの使用量を表示し、生成されたプラグインを確認して、保存するかどうかを判断する。手順は2026年10月2日に確認したClaude Code v2.1.287以降の文書に基づく。BIG CHANGEはこの手順を実行しておらず、生成コードを独自に検証していない。

## 大きな変化

- 何が変わったか：Claude Codeのmodは、既存のプラグインシステムを使い、イベントを変更したり、アシスタントの画面内に表示を描画したりする関数を追加する。
- なぜ重要か：開発者はセッション内に表示やワークフロー制御を組み込める一方、そのコードに端末や会話へのアクセスも与えることになる。
- 今後の注目点：modの実際の呼び出しと動作が目的に合っているか、組織のどの制御が適用されるか、Claude Codeのバージョン間でAPIがどう変わるかを確認したい。

## バージョン、アカウント、ワークスペースを確認する

シェルで`claude --version`を実行する。現行の[modの公式ドキュメント](https://code.claude.com/docs/en/plugins/mods/overview)によると、v2.1.287以降が必要で、modは既定で有効になっている。早期アクセス時に使われた環境変数設定は、このリリースを制御しない。

Claude Codeを利用でき、信頼済みとして承認したワークスペースが必要だ。Anthropicの[セットアップガイド](https://code.claude.com/docs/en/setup)には、Pro、Max、Team、Enterprise、Consoleの各アカウントと、対応するサードパーティAPIプロバイダーが記載されている。無料のClaudeチャットプランにはClaude Codeは含まれない。組織の設定で、ユーザー作成のmodが読み込めない場合もある。

対話型のターミナルセッションを使う。CLIと対応するDesktopセッションでは、modの画面表示を確認できる。フックはVS Codeのチャットパネルとヘッドレスセッションでも実行されるが、そこでは描画が表示されない。DesktopのWSLセッションはプラグインに対応していない。

## 表示を作成し、内容を確認する

Anthropicの[10月1日のチュートリアル](https://claude.dev/blog/getting-started-with-claude-code-mods/)では、ターンの後にコンテキスト使用量を読み取る「Token Weather」を紹介している。割合は直近の応答で使われたコンテキストとモデルのコンテキストウィンドウに基づく。これは使用量の目安であり、回答品質を測る指標とは説明されていない。

1. 信頼済みのワークスペースで`claude`を開始する。プロンプトの上部にコンテキストの割合、使用トークン数、コンテキストウィンドウのサイズを表示し、メインエージェントの各ターンが終わるたびに更新するmodを作るよう依頼する。文書にあるセッション使用量APIを使い、ファイルアクセス、プロセス実行、ネットワークリクエスト、モデル呼び出しを行わない表示専用の実装を求める。これは文書に基づく作成手順をさらに限定した指定だが、依頼文そのものがこれらの動作を強制するわけではない。
2. Claudeが作成したファイルを確認する。[作成マニュアル](https://code.claude.com/docs/en/plugins/mods/create)によると、プラグインはセッション用ディレクトリ内の`~/.claude/dev-mods/`に配置される。マニフェスト、フック設定、コードを調べる。Claude Codeはホットリロードを有効にするか尋ねる。有効にすると、このセッションのmodと後からの変更が実行される。
3. 有効化する前に、シェルで`claude plugin validate`を実行し、続けて実際のプラグインのディレクトリを指定する。表示されたイベントフックとAPI呼び出しを読む。想定される動作には、使用量の取得、状態管理、描画が必要だ。ファイル、環境変数、プロセス、ネットワーク、モデルへのアクセスに加え、ソース内のイベント書き換えも調べる。検証が成功しても、ローダーとの互換性が確認されたにすぎず、安全が保証されるわけではない。
4. レビュー済みの実装を承認した後、`/plugin`を実行し、Installedタブにmodが表示されるか確認する。通常のリクエストを送り、ターン後に表示帯が更新されるか確かめる。読み込み済みのプラグインに使用量が表示され、更新されることが動作確認の目安だ。ファイルが生成されたことだけでは、動作の証明にならない。

この手順は、Claudeが最初の試みで意図どおりの実装を生成することを保証しない。完全な[Token Weatherの実装とテスト例](https://claude.dev/blog/getting-started-with-claude-code-mods/#build-your-first-mod-token-weather)は、生成コードを比較する参考になる。チュートリアルによると、通常のセッション使用量の読み取りは無料だが、内訳を依頼するとトークン数の取得リクエストが送信される場合がある。Claudeにmodの作成や修正を依頼する作業には、通常のClaude Code利用枠が使われる。

## コードと権限を把握しておく

セッション内で作成されたmodは一時的なものだ。作成マニュアルでは、modを残すにはそのディレクトリを自分の場所にコピーし、以降のセッションを`claude --plugin-dir`とその保存先を指定して開始するよう案内している。読み込みのたびにバージョン固有の宣言が`.claude-plugin/types/`に書き出される。APIが変わる可能性があるため、更新時に確認する。

Anthropicの[管理者向けマニュアル](https://code.claude.com/docs/en/plugins/mods/admin)には、ツール権限ルールだけでは分かりにくい制限が説明されている。組み込みのセキュリティガードは、TeamまたはEnterpriseのユーザー、あるいは管理対象の設定がある端末で読み込まれる。既定の構成では、拒否ルールがユーザーmodによるClaudeのツール呼び出し許可より優先される。ただし、そのルールはmod自身によるファイルシステムやプロセスAPIの呼び出しを制限しない。管理者はユーザーがインストールするmodを禁止したり、modの呼び出しにポリシーmodを適用したりできる。

Pluto Securityの[9月22日の調査](https://pluto.security/blog/claude-code-function-hooks-security/)は、一般提供前の実装を使ったテストで、認証情報へのアクセス、画面表示による欺き、リモートからのコード変更を報告した。Plutoはこれらの拡張機能向けセキュリティ製品を販売しており、報告が一般提供より前の調査であることも明記している。プラグインのソースやダウンロードされた依存関係を読む際の参考にはなるが、個別の指摘がv2.1.287の挙動を示すわけではない。現行の権限の詳細はAnthropicの文書で確認できる。

プラグインの操作画面からmodを無効にする。`--safe-mode`では、1回のセッションに限り、インストール済みmodなどのカスタマイズを読み込まない。

## 利用量と費用

Anthropicの公開発表とmodのマニュアルには、mod専用の追加料金は記載されていない。[Claude Codeの料金説明](https://code.claude.com/docs/en/costs)によると、サブスクリプション利用分はプランの利用枠から差し引かれ、Consoleやクラウドプロバイダー経由ではトークン単位で請求される。モデルを呼び出すmodは利用量を消費する場合がある。利用量の確認には`/usage`を使い、サインイン方法に応じた請求画面も確認する。コンテキストの割合は請求額でも支出上限でもない。

確認済みのプラグインとClaude Codeのバージョンを記録する。コマンドの承認やダウンロードした補助ツールを追加する場合は、コードで可能になる操作が変わるため、追加の確認が必要だ。

## 出典・参考資料

- [Anthropic「Claude Codeをmodでカスタマイズする」](https://claude.com/blog/claude-code-mods)、2026年10月1日。リリース発表、プラグインのパッケージ形式、端末権限に関する明示的な注意。AnthropicはClaude Codeの提供元。
- [modの概要](https://code.claude.com/docs/en/plugins/mods/overview)、2026年10月2日確認。バージョン、セッション上の表示場所、ホスト権限、検証、無効化の操作を説明する現行の公式文書。
- [modを作成する](https://code.claude.com/docs/en/plugins/mods/create)、2026年10月2日確認。作成、承認、ホットリロード、保持、バージョン固有の型宣言を説明する。期待される動作の案内であり、BIG CHANGEによるテストではない。
- [Claude Code modの始め方](https://claude.dev/blog/getting-started-with-claude-code-mods/)、Addy Osmani、10月1日。Token Weatherの指標、コード、テスト例を紹介する。デモはAnthropicによるもの。
- [組織のmodを管理する](https://code.claude.com/docs/en/plugins/mods/admin)、2026年10月2日確認。ガードが有効になる条件、拒否ルールの範囲、管理者の選択肢を説明する。ユーザーmodを端末から一般的に隔離する仕組みではない。
- [高度なセットアップ](https://code.claude.com/docs/en/setup)と[費用を効果的に管理する](https://code.claude.com/docs/en/costs)、2026年10月2日確認。アカウントの利用条件、認証方式に応じた請求、利用量の確認を説明する。確認した公開資料にはmod専用料金の記載がない。
- [Pluto Security「Claude CodeのFunction Hooks：Claude Modsに潜む信頼の問題」](https://pluto.security/blog/claude-code-function-hooks-security/)、9月22日。研究者による一般提供前のテストとその限界。Plutoは拡張機能向けセキュリティ製品を販売しており、BIG CHANGEはテストを再現していない。

## Sources

- [Claude Codeのmodをカスタマイズする](https://claude.com/blog/claude-code-mods) — Anthropicによるリリース発表。CLIとDesktopでのmod、プラグイン形式、端末権限を説明。Claude Codeの提供元による情報。
- [modの概要](https://code.claude.com/docs/en/plugins/mods/overview) — バージョンv2.1.287以降、表示場所、権限、検証、無効化を説明する更新型の公式文書。提供元による手順であり、BIG CHANGEのテストではない。
- [modを作成する](https://code.claude.com/docs/en/plugins/mods/create) — 公式の作成、承認、再読み込み、保持、バージョン固有の型宣言。依頼するコードの確認は別途必要。
- [Claude Code modの始め方](https://claude.dev/blog/getting-started-with-claude-code-mods/) — Addy OsmaniによるAnthropicのチュートリアル。Token Weatherの指標、完全な実装、テスト例を扱う。デモは提供元による。
- [組織のmodを管理する](https://code.claude.com/docs/en/plugins/mods/admin) — ガードの有効条件、拒否ルールの範囲、管理者向け制御を説明する公式資料。ツール拒否ルールはmod自身のファイルやプロセス呼び出しを制限しない。
- [高度なセットアップ](https://code.claude.com/docs/en/setup) — 有料プラン、Console、対応プロバイダーなどのアカウントと利用条件。無料のClaudeチャットはClaude Codeを含まない。
- [費用を効果的に管理する](https://code.claude.com/docs/en/costs) — プランの利用枠、API・プロバイダー経由のトークン課金、利用量の確認方法。確認した公開資料にmod専用料金はない。
- [Claude CodeのFunction Hooks：Claude Modsに潜む信頼の問題](https://pluto.security/blog/claude-code-function-hooks-security/) — Plutoの研究者による一般提供前のセキュリティテスト。v2.1.287の挙動を示すものではない。Plutoは拡張機能向けセキュリティ製品を販売しており、BIG CHANGEは再現検証していない。