Markdown版

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

# Claude Codeではテレメトリーを無効にするとAGENTS.mdが読み込まれない場合がある

> Claude CodeのAGENTS.mdネイティブ対応は、バージョン、機能フラグへのアクセス、プロバイダー、ファイルの優先順位によって異なる。公開済みのagents-mdプラグインでは、任意のテレメトリー記録にパスやファイル本文は含まれない。

By BIG CHANGE Editorial

Published: 2026-09-23T13:54:58.721Z
Updated: 2026-09-23T13:54:58.721Z
Canonical: https://bigchange.ai/blog/claude-code-agents-md-telemetry-feature-flags

![A desktop monitor shows a minimal project-instructions view with plain AGENTS.md and CLAUDE.md labels above a keyboard and mouse.](https://bigchange.ai/api/media/file/claude-code-project-instructions-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

Claude Code 2.1.277は、リポジトリ用指示ファイル`AGENTS.md`をネイティブに読み込む機能を追加した。重要な制限がある。Anthropicの現行ドキュメントによると、機能フラグを取得できないセッションでは、テレメトリーを無効にしたセッションや多くのサードパーティープロバイダー設定を含め、`CLAUDE.md`のみを読み込む。

公開版の`agents-md`プラグインはファイルの読み込みと、任意のテレメトリー記録を分けている。記録には件数と固定選択肢が含まれ、パスやファイル本文は含まれない。依存条件はその一つ前の層にある。リモートのフラグによって組み込みローダーが利用可能かどうかが決まる。

## 大きな変化

- **何が変わったか：**ローカルの指示ファイルがリモートの段階的展開の境界を越えるようになった。機能フラグにアクセスできるかどうかで、Claude Codeに組み込まれた`AGENTS.md`の読み込み機能が使えるかどうかが決まる。
- **なぜ重要か：**同じコミットを使う2人の開発者でも、バージョン、プロバイダー、プライバシー設定によって受け取るプロジェクト指示が異なる場合がある。チーム全体でエージェントの挙動を再現しにくくなる。
- **今後の注目点：**複数のプロバイダーを使うチームや制約の強い環境では、指示ファイルの読み込みを実行時の依存条件として扱える。各環境で動作を確認し、移植可能な方法として`CLAUDE.md`のインポートを維持するとよい。

## リリース記録と報告が示すこと

Anthropicの[2.1.277リリースノート](https://github.com/anthropics/claude-code/releases/tag/v2.1.277)は9月18日付で、プロジェクトに`AGENTS.md`がない場合、Claude Codeが`CLAUDE.md`を読み込むとしている。同リリースではBedrock、Vertex、Foundryを対象外としている。

現行の[プロジェクトメモリーのドキュメント](https://code.claude.com/docs/en/memory)では、対応バージョンをインストールまたは更新した直後の最初のセッションと、組み込みプラグインを無効にしたセッションも対象外としている。

Przemek Szypowskiによる[きっかけとなった報告](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on)は、2.1.280でのカナリアテストについて説明している。報告では、`DISABLE_TELEMETRY`と`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`によって`AGENTS.md`が読み込まれなくなった一方、隣に置いた`CLAUDE.md`のインポートは機能したという。BIG CHANGEは有料モデルでのそのテストを再現していない。Anthropicの文書が現在、同じ利用条件を独立に明記している。

## 機能の利用可否とテレメトリー記録は別のもの

Anthropicの[環境変数のドキュメント](https://code.claude.com/docs/en/env-vars)によると、空でない値を`DISABLE_TELEMETRY`に設定すると、`0`や`false`などの値でも、テレメトリーが無効になり、機能フラグも取得できなくなる。`DO_NOT_TRACK`、`DISABLE_GROWTHBOOK`、`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`もフラグ取得を止める場合がある。埋め込みホストが`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`を設定しない限り、サードパーティープロバイダーのセッションは対象外となる。Claudeアプリのゲートウェイセッションも対象外だ。

公開済みの[プラグインREADME](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md)によると、テレメトリー呼び出しに失敗しても、その記録は破棄され、プラグインの他の処理には影響しない。リポジトリの[modsの概要](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md)では、テレメトリーと`agents-md`が別々の組み込み機能として示されている。

ソースコードはローダーの動作を説明し、製品ドキュメントは各セッションでそのローダーが利用できるかを説明する。モジュール内の任意のログ記録によって、外側にある利用条件がなくなるわけではない。

9月23日、BIG CHANGEは`agents-md`のREADMEと[登録モジュール](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts)を`main`と9月22日公開の2.1.280タグの両方から取得し、それぞれの組がバイト単位で一致することを確認した。

## Claude Codeがファイルを読み込む条件

プラグインが利用可能かつ有効な場合、初期設定の優先順位は次のとおり。

| 指示ファイル | 初期設定での結果 |
| --- | --- |
| `AGENTS.md`、プロジェクト用Claude指示ファイルがない場合 | `AGENTS.md`が読み込まれる |
| プロジェクトの`CLAUDE.md`、`.claude/CLAUDE.md`、または`CLAUDE.local.md`が作業ディレクトリ内またはその上位にある場合 | 直接読み込まれる`AGENTS.md`は、これらのファイルがあれば優先されない |
| ユーザーまたは管理者の`CLAUDE.md`、または`.claude/rules/` | これらは`AGENTS.md` |

より優先されない`/config`両方の種類のファイルを読み込むには、`--settings`で「Project instructions」の設定を変更する。JSONオプションはユーザー設定、

## 、または管理者設定に置く必要がある。プロジェクト設定とローカル設定は無視される。

代替策は明示的なインポートを一つ置くこと`CLAUDE.md`直接対応していないセッションでは、Anthropicは共通の指示ファイルと同じ場所にある

`@AGENTS.md`

に次の内容を記すよう推奨している：

インポートはファイルをそのまま読み込む。「読んでください」という文章で頼むだけでは、判断をモデルに委ねることになる。`claude --version`を確認し、Project instructionsを`/config`で確認する。2.1.280では`/memory`または`/context`から、直接読み込まれた`AGENTS.md`を一覧できる。これより前の対応バージョンでは、そこに表示されなかった。

## Sources

- [Claude Codeはテレメトリーが有効な場合にのみAGENTS.mdを読む](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on) — Przemek Szypowskiによる2.1.280のカナリアテストと回避策の報告。BIG CHANGEは有料モデルでの実行を再現していない。記事では本人の観察と公式製品ドキュメント、ソースコードの解釈を区別している。
- [Claude Code v2.1.277リリース](https://github.com/anthropics/claude-code/releases/tag/v2.1.277) — AGENTS.md対応を導入し、公開時点ではBedrock、Vertex、Foundryを対象外としたことを示す公式リリース記録。
- [Claudeがプロジェクトを記憶する仕組み](https://code.claude.com/docs/en/memory) — 最低バージョン、ファイルの優先順位、Project instructionsの各モード、利用できないセッション条件、診断方法、CLAUDE.mdのインポートによる代替策を説明する現行の公式ドキュメント。
- [Claude Codeの環境変数](https://code.claude.com/docs/en/env-vars) — テレメトリーのオプトアウトによって機能フラグも取得できなくなり、AGENTS.mdの直接読み込みが利用できなくなること、および影響を受ける他のセッションを説明する現行の公式ドキュメント。
- [Claude Code v2.1.280：agents-md組み込み機能のソースと挙動](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md) — 指示ファイルのモード、優先順位、任意のテレメトリー記録についての公開ソース説明。記録には件数と固定選択肢が含まれ、パスやファイル本文は含まれないとしている。
- [Claude Code v2.1.280の組み込みmods](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md) — テレメトリーとagents-mdが別個の組み込みプラグインであり、タグ付けされたソースがClaude Codeに含まれることを示す公開概要。
- [Claude Code v2.1.280：agents-md登録モジュール](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts) — READMEと併せて確認した公開登録ソース。9月23日に確認した時点で、そのバイト列はmainブランチの対応ファイルと一致した。