本文へスキップ
claudemods

agents-md:Claude Code の AGENTS.md をプロジェクト指示として読み込む

CLAUDE.md と同じ扱いで AGENTS.md をプロジェクト指示として読み込む Mod。/config で 4 つのモードを選べます。

権限

  • ツール呼び出しを傍受Claude が行うすべてのツール呼び出しを参照でき(tool.call / tool.check)、ブロックや変更も可能です。
  • UI を変更Claude Code の画面に描画します。バンド、ペイン、ステータス表示、トーストなど(ui.render / $.ui.*)。
検証バージョン
v2.1.310
最終検証日
必要バージョン
Claude Code ≥ 2.1.287
表示先
なし

Claude Code 内でインストール:

git clone https://github.com/anthropics/claude-code
claude --plugin-dir ./claude-code/mods/agents-md
すべてのインストール方法 ↓

このModでできること

agents-md は、Claude Code の AGENTS.md 対応を加える Anthropic の Mod です(anthropics/claude-code)。多くのリポジトリはエージェント向けの指示を AGENTS.md に書いていますが、Claude Code が読むのは CLAUDE.md です。この Mod は AGENTS.md をプロジェクト指示ファイルとして Claude Code に渡すので、モデルには CLAUDE.md と同じ位置、同じ枠付けで見えます。

読み込み対象は、オプション instructionFiles の 1 つで決まります。

  • claude-md:CLAUDE.md だけ。今の Claude Code と同じで、Mod は何も足しません。
  • claude-md-or-agents-md(既定):自前の CLAUDE.md がないプロジェクトは、代わりに AGENTS.md を読み込みます。
  • claude-md-and-agents-md:すべての AGENTS.md を CLAUDE.md と並べて読み込みます。
  • managed-only:プロジェクトと本人の指示ファイルを捨て、組織の管理下の CLAUDE.md とメモリだけを残します。

ファイルはファイルシステムのルートから作業ディレクトリまでたどって探し、AGENTS.md と .claude/AGENTS.md が対象です。Claude がサブディレクトリのファイルを読むと、そのディレクトリの AGENTS.md が読み取り結果に添えられます。入れ子の CLAUDE.md に Claude Code が行うのと同じ扱いです。Mod は画面に何も描かず、効果はモデルが知っていることに現れます。

デモ

録画では、小さなデモプロジェクトでこの Mod を読み込んだ Claude Code を起動します。録画の前に、非表示のセットアップ行がプロジェクトに短い AGENTS.md を書き込みます(コミットメッセージは DEMO-123 のようなチケット番号で始める、コミット前に npm test を実行する、の 2 つ)。プロジェクトに CLAUDE.md はありません。クリップでは「Without reading any file: what does my AGENTS.md say about commit messages? One sentence.」と尋ねます。Claude は 2 秒ほどで、コミットメッセージは DEMO-123 のようにチケット番号で始めると答えます。ツールは一度も呼ばれません。ファイルがすでにコンテキストに入っているからです。

インストール

インストール欄のいずれかの方法を使ってください。いずれも anthropics/claude-code リポジトリからインストールします。このリポジトリにはこのプラグインを載せた marketplace.json がないため、インストール欄はリポジトリそのものを取得元にしています。既定モードでは設定は不要で、AGENTS.md があり CLAUDE.md がないプロジェクトでセッションを始めるだけです。

$ install agents-md

Claude Code 2.1.287 以上が必要

作者のマーケットプレイスからインストール: anthropics/claude-code

  1. 1.インストールせずに試す

    git clone https://github.com/anthropics/claude-code
    claude --plugin-dir ./claude-code/mods/agents-md

    その1セッションだけ Mod を読み込みます。設定には何も追加されません。

仕組み

hooks/hooks.json に載っているモジュールは hooks/register.ts だけで、hooks/ 以下の他のファイルはそれがインポートする小さな補助モジュールです。読み込み系の 2 つのモードでは、prompt.context フックが Claude Code の読み込み済みの指示ファイルを受け取り、$.fs.ancestors で上方向に AGENTS.md を探し、新しいファイルを project ファイルとして足した一覧を返します。探索部分は hooks/register.ts の次のコードです。

const found = isClaudeProject
  ? NONE
  : await $.fs.ancestors({ names: Names.AGENTS_NAMES }).catch(() => {
      isWalkFailed = true

      return NONE
    })
const added = Files.unseenFiles(Files.filesOf(found), handed)

unseenFiles は、Claude Code がすでにパスを持っているファイルや、渡されたプロジェクトファイルと本文が同じファイル(たとえば AGENTS.md へのシンボリックリンクの CLAUDE.md)を除きます。Read に付いた tool.call フックは、まず読み取りを終わらせ、プロジェクトルート以下のファイルであれば、ルートとそのファイルの間にある各ディレクトリの AGENTS.md を Contents of <path>: の形で添えます。添えるのはエージェントループごとに 1 回です。fork 向けの agent.spawn フックは、親が送り済みの集合をコピーし、fork に同じファイルを二度渡さないようにします。

カスタマイズ

オプションは /config の「Project instructions」の行で、4 つの値から選ぶピッカーです。手で設定する場合は、ユーザー設定、--settings、管理設定のいずれかに書きます(プロジェクトの .claude/settings.json はプラグインのオプションとして読まれません)。

{
  "pluginConfigs": {
    "agents-md@builtin": {
      "options": { "instructionFiles": "claude-md-and-agents-md" }
    }
  }
}

claude --plugin-dir mods/agents-md で動かす場合、同じエントリのキーは "agents-md" です。古いキー projectInstructions は、instructionFiles が既定以外の値になるまで有効です。作者の README には、AGENTS.md が CLAUDE.md と今も異なる点が 8 つ挙がっています。たとえば --add-dir のディレクトリからは AGENTS.md が読まれず、/memory もこれらのファイルを認識しません。

権限と安全性

プラグインが実行できるファイルはすべて読みました。plugin.json、hooks/hooks.json、hooks/register.ts、そこからインポートされる hooks/ 以下のすべての補助モジュール、そしてテストです。package.json、インストールスクリプト、バイナリ、バンドルされたコードはなく、ソースに ASCII 以外の文字もありません。

  • ファイルを読みます。 $.fs.ancestors がディレクトリを上にたどって AGENTS.md と .claude/AGENTS.md を読みます(CLAUDE.md、.claude/CLAUDE.md、CLAUDE.local.md の有無も調べます)。その本文はプロジェクト指示としてモデルに渡るので、信頼できない AGENTS.md は CLAUDE.md と同じように Claude を誘導できます。
  • 環境変数を読みます。 HOME、USERPROFILE、CLAUDE_CODE_SIMPLE、CLAUDE_CODE_DISABLE_ATTACHMENTS で、~ のパス解決と、Claude Code が何も添付しない実行での添付の省略のためだけです。環境変数は書き込みません。
  • ツール呼び出しに割り込みます。 Read の tool.call フックと fork 向けの agent.spawn フックは、呼び出しの完了を待って結果を返し、読み取りが成功したときだけコンテキストを足します。呼び出しを拒否することはありません。claude plugin validate は、この 2 つのフックに .catch がないと示しています。
  • テレメトリー。 件数と固定の選択肢(モード、ファイル数とインポート数、合計の長さ、いくつかのフラグ)で $.telemetry.log と $.telemetry.mark を呼びます。README によると、パスも本文も含まず、Anthropic の telemetry プラグインがない環境では破棄されます。そのプラグインは確認していません。
  • ネットワーク、プロセス、書き込み、常駐プロセスはありません。 fetch、シェル、$.fs の書き込み、バックグラウンドのタイマーは使いません。書くのは $.ui.log 経由のデバッグログ 1 行 no CLAUDE.md found; AGENTS.md loaded: <paths> だけです。
  • ライセンス。 リポジトリの LICENSE.md は「© Anthropic PBC. All rights reserved」で、利用は Anthropic の商用利用規約に従うとあります。そのためこのページは redistributable: false で、コードへのリンクだけを載せ、ミラーはしません。

claude plugin validate はエラーを報告しませんでした。出たのは、プラグインディレクトリの「アイコンなし」というブロックしない警告、上記の .catch がない 2 件の注記、README にインストール行がないという助言だけです。作者の 5 件のテストは Claude Code 2.1.310 ですべて通りました。

ツール呼び出しを傍受
Claude が行うすべてのツール呼び出しを参照でき(tool.call / tool.check)、ブロックや変更も可能です。
UI を変更
Claude Code の画面に描画します。バンド、ペイン、ステータス表示、トーストなど(ui.render / $.ui.*)。

互換性とトラブルシューティング

macOS 上の Claude Code 2.1.310 で確認しました(validate、テスト、デモ録画)。README はこれを組み込みプラグイン(agents-md@builtin)と説明しているため、同梱している Claude Code ではすでに読み込まれている可能性があります。/plugin は組み込みを一覧表示し、そこでオフにできます。AGENTS.md が読まれないときは次を確認してください。

  • ルートから作業ディレクトリまでに CLAUDE.md、.claude/CLAUDE.md、CLAUDE.local.md がないか。既定モードでは、どれか 1 つでもあると Mod は身を引きます。
  • /config のオプションが claude-md や managed-only になっていないか。
  • --bare や --safe-mode の実行、または CLAUDE_CODE_DISABLE_CLAUDE_MDS が設定されている場合、Claude Code は指示ファイルを読み込みません。CLAUDE_CODE_DISABLE_ATTACHMENTS では入れ子の添付が省かれます。
  • シンクライアントでは何も見つかりません。ワークスペースのファイルがリモートにあるためです。
  • オプションを変えた後、新しいファイルは Claude Code が次に作るコンテキストで届きます。次のターン、/clear、またはコンパクトの後です。

よくある質問

この Mod なしでも Claude Code は AGENTS.md を読みますか?
Mod の README によると、エンジンが読み込むのは CLAUDE.md だけで、プラグインがその上に AGENTS.md を足します。オプションを claude-md にすると何も足さず、CLAUDE.md は従来どおり読み込まれます。
CLAUDE.md と AGENTS.md の両方があるとどうなりますか?
既定の claude-md-or-agents-md では、ルートから作業ディレクトリまでのどこかに CLAUDE.md、.claude/CLAUDE.md、CLAUDE.local.md があれば、Mod は何もしません。claude-md-and-agents-md では両方を読み込み、CLAUDE.md がすでにインポートまたはリンクしている AGENTS.md は読み飛ばします。
AGENTS.md の内容はどこかに送られますか?
コードはネットワーク通信もコマンド実行もしません。件数(ファイル数、インポート数、合計の長さ、モード)だけを telemetry に渡します。README によると、この記録は Anthropic の telemetry プラグインがある環境にしか存在せず、パスもファイルの中身も含みません。
モードはどう切り替えますか?
/config の「Project instructions」の行で値を選ぶか、ユーザー設定の pluginConfigs に instructionFiles を書きます。変更するとモジュールが再読み込みされ、エンジンが次に作るコンテキストから新しいモードが使われます。
このコードを自分のプラグインに流用できますか?
コピーはできません。リポジトリの LICENSE.md は all rights reserved で、Anthropic の商用利用規約に従うと書かれています。そのため、このページはコードへのリンクだけを載せ、ミラーはしません。
Claude Code で動作中の Context Inspectorおすすめ

Context Inspector

Claude Code のコンテキストを何が埋めているか、再読み込みや重複がどれだけあるか、コンパクトで何が残ったかを表示します。

  • ステータス
  • ペイン
  • トースト
  • ファイルを書き込む
  • ツール呼び出しを傍受
  • プロンプトを読み取る
  • UI を変更
  • コマンド・ツールを追加

v2.1.303 で検証済み

同じカテゴリの Mod: タイマー、ToDo、スタンドアップ。