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.インストールせずに試す
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 の商用利用規約に従うと書かれています。そのため、このページはコードへのリンクだけを載せ、ミラーはしません。
# 関連する Mod
おすすめContext Inspector
Claude Code のコンテキストを何が埋めているか、再読み込みや重複がどれだけあるか、コンパクトで何が残ったかを表示します。
- ステータス
- ペイン
- トースト
- ファイルを書き込む
- ツール呼び出しを傍受
- プロンプトを読み取る
- UI を変更
- コマンド・ツールを追加
v2.1.303 で検証済み
同じカテゴリの Mod: タイマー、ToDo、スタンドアップ。