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` 外掛將檔案載入與可選的遙測資料列分開。遙測資料列只包含計數與固定選項，不包含路徑或檔案文字。依賴發生在更前面一層：遠端旗標會決定內建載入器是否可用。

## 重大變化

- **有哪些改變：**本機指示檔現在受遠端推出機制影響：能否取得功能旗標，決定內建的`AGENTS.md`讀取器是否可用。
- **為何重要：**即使使用相同的程式碼提交版本，兩名開發者也可能收到不同的專案指示，因為版本、供應商或隱私設定各異，讓團隊更難重現代理程式的行為。
- **後續觀察重點：**使用多家供應商或受限制環境的團隊，可將指示檔載入視為執行階段相依條件，在每種環境中驗證，並保留一個`CLAUDE.md`匯入方式作為可攜替代方案。

## 版本發布說明與報導證實了什麼

Anthropic 的[2.1.277 版發布說明](https://github.com/anthropics/claude-code/releases/tag/v2.1.277)於 9 月 18 日發布，指出 Claude Code 會讀取`AGENTS.md`，前提是專案中沒有`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 Apps gateway 工作階段也同樣不支援。

已發布的[外掛 README](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md)指出，缺少遙測呼叫時會直接略過，不影響外掛的其他工作。儲存庫的[內建模組概覽](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`以及 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`變更 Project instructions 設定，即可同時載入兩種檔案類型。其 JSON 選項應放在使用者、`--settings`或受管理的設定中；專案與本機設定檔會遭忽略。

## 替代方案是明確加入一行匯入指示

對於不支援直接載入的工作階段，Anthropic 建議在共用指示檔旁邊加入一個`CLAUDE.md`，內容如下：

`@AGENTS.md`

這種匯入方式會直接納入該檔案；若只用文字要求 Claude 讀取，是否照做就由模型自行決定。

檢查`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 無法直接載入，並列出其他受影響的工作階段。
- [agents-md 內建外掛原始碼與行為（Claude Code v2.1.280）](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md) — 已發布的原始碼說明指示檔模式、優先順序及可選的遙測資料列；文件指出資料列只包含計數與固定選項，不含路徑或檔案文字。
- [Claude Code 內建模組（v2.1.280）](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md) — 已發布的概覽證實遙測與 agents-md 是不同的內建外掛，且該標籤版本的原始碼隨 Claude Code 一同發布。
- [agents-md 註冊模組（Claude Code v2.1.280）](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts) — 與 README 一併檢視的已發布註冊原始碼。2026 年 9 月 23 日查核時，其檔案內容與 main 分支對應檔案完全一致。