Claude Code 2.1.277（2026-09-18）的更新紀錄寫著：
Added AGENTS.md support: in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead;
change it under "Project instructions" in/config(not yet on Bedrock, Vertex or Foundry)
Hacker News 上有 501pt（截至 2026-09-19）。搜尋出來的日文解說寫著「不會讀」。
在 2.1.277 之前，這樣的說法是正確的。
我放入關鍵字，重新測了 6 種組合與剛建立設定後的狀況。
只放 AGENTS.md 有讀
也放 CLAUDE.md AGENTS.md 不讀
放 1 個 CLAUDE.local.md AGENTS.md 不再讀
有 ~/.claude/CLAUDE.md AGENTS.md 仍會讀（不算在內）
而且，第一次 session 不會讀驗證環境：Windows 10 / 隔離安裝 Claude Code 2.1.277 /
claude -p/ 測試時間：2026-09-19
測法：在檔案中放關鍵字
在各檔案中放入各自獨一無二的字串，然後請它「列出指示中所有的關鍵字」。
AGENTS.md The AGENTS passphrase is AGENTS-ORANGE-7731.
CLAUDE.md The CLAUDE passphrase is CLAUDE-VIOLET-4420.我把所有會讀檔的工具都禁止了。 不然即使指示裡沒寫，它也能自己把檔案打開。
--disallowedTools "Read,Write,Edit,NotebookEdit,Bash,PowerShell,Glob,Grep,Task,WebFetch,WebSearch,Skill,ToolSearch"
--strict-mcp-config --mcp-config <空的MCP設定>我也在 ~/.claude/CLAUDE.md 放了關鍵字，並在空白設定目錄中反覆測試。
結果：6 種組合都符合官方表格
各測了 2～3 次。回傳的關鍵字如下。
| 放置的檔案 | 讀到的內容 |
|---|---|
只有 AGENTS.md |
AGENTS + 使用者層級 |
AGENTS.md + CLAUDE.md |
CLAUDE + 使用者層級（AGENTS 沒有） |
AGENTS.md + CLAUDE.local.md |
CLAUDE.local + 使用者層級（AGENTS 沒有） |
AGENTS.md + .claude/rules/ |
AGENTS + rules + 使用者層級 |
AGENTS.md + AGENTS.local.md |
AGENTS + 使用者層級（AGENTS.local 沒有） |
上方設定 claude-md-and-agents-md |
AGENTS + CLAUDE + 使用者層級 |
~/.claude/CLAUDE.md 不論任何組合都會一起讀到，而且即使有它，AGENTS.md 仍然會被讀取。
第一次 session 不會讀到
這裡最容易踩坑。
在新的設定目錄只放 AGENTS.md，接著連續測 4 次。
Session 1 沒有讀到
Session 2 讀到 AGENTS
Session 3 讀到 AGENTS
Session 4 讀到 AGENTS官方也有明確寫出來。
It's your first session after you install or upgrade to a version with
AGENTS.mdsupport.
Claude readsAGENTS.mdfrom your next session on
剛升級完就先測一次、然後判斷「沒效」的話，會判錯。
CLAUDE.local.md 加一個，就會讓團隊的 AGENTS.md 消失
很多人會用 CLAUDE.local.md 放個人備忘。
一旦放了，AGENTS.md 就不會再被讀取。 官方也有提醒。
Because
CLAUDE.local.mdcounts, adding one to keep your own uncommitted instructions in a
project that relies onAGENTS.mdstops Claude from readingAGENTS.mdfor you.
claude -p 的紀錄裡沒有警告也沒有錯誤。 如果要讓兩者都被讀到，必須改設定。
{
"pluginConfigs": {
"agents-md@builtin": {
"options": { "instructionFiles": "claude-md-and-agents-md" }
}
}
}這段要寫在 ~/.claude/settings.json。 官方說明是，專案或本機設定都會被忽略。
沒能確認的事情
- 只測了 Claude Code 2.1.277。尚未與 2.1.276 以前版本比較
- 只做了
claude -p的一次往返。 尚未確認互動式 session 的顯示 - 尚未測 子目錄中的
AGENTS.md、@path匯入、傳播到子代理 - 「第一次不會讀」是在新的設定目錄中測得。是否與官方所說的「安裝後第一次」是同一機制，尚未確認
- 官方寫明 停用遙測、Bedrock / Vertex / Foundry 不可用。尚未驗證
- 官方也寫明
AGENTS.md不會出現在/memory或/context。確認只能靠關鍵字 - 每個條件只測了 2～3 次。次數不多
- 測試中曾因自己的腳本 bug 導致某個條件出現假結果，後來重做並重新測試
總結
- 從 Claude Code 2.1.277 開始，如果沒有
CLAUDE.md，就會讀AGENTS.md - 第一次 session 不會讀。 從第二次開始才會讀
~/.claude/CLAUDE.md和.claude/rules/不算在「有 CLAUDE.md」的判定內- 放一個
CLAUDE.local.md，AGENTS.md就會默默不被讀取 AGENTS.local.md不會被讀取- 如果要兩者都讀，使用
claude-md-and-agents-md。寫在~/.claude/settings.json
既有的日文文章不是寫錯，而是前提改變了。
自己的環境到底是哪一種，只要放一個關鍵字就能知道。
參考
- Claude Code changelog — 2.1.277 新增 AGENTS.md
- How Claude remembers your project — 判定表與例外條件
相關文章
- Claude Code 的子代理也會拿到全部 CLAUDE.md。現在可以設定排除 — 測試 CLAUDE.md 會傳到哪裡的一篇
- CLAUDE.md 是 21 個區段，還是 8 行 — 用官方文件做出結論的一篇 — 依官方文件決定 CLAUDE.md 的份量的一篇
JQIT 的工程師有 95% 以上都是從無經驗錄取。
如果有興趣，也歡迎到公司網站逛逛。
▶ 公司網站
我們也在招募工程師。有興趣的話，歡迎看看。
▶ 招募網站
1) --- 會變成分隔線（上一行必須是空白）
2) # 會變成一級標題
3) ## 會變成二級標題
4) ### 會變成三級標題
5) **粗體文字**會顯示粗體文字
6) ```當第一行與最後一行會顯示程式碼
7) 請搜尋 Markdown 語法，了解各種格式
