Claude Code 新增 AGENTS.md 作為專案指令的備援檔案

Claude Code 現在會在沒有 CLAUDE.md 時讀取 AGENTS.md —— 這是一項期待已久的標準化變更

Claude Code 2.1.277（於 2026 年 9 月 18 日發布）新增了一項單一但影響深遠的功能：當專案目錄中不存在 CLAUDE.md 檔案時，CLI 會自動改為讀取 AGENTS.md 作為其指令集。此變更可在 /config 中的 Project instructions 進行設定，目前尚未在 Bedrock、Vertex 或 Foundry 部署版本中提供。

為何這很重要

符合標準的設定 – AGENTS.md 是社群描述代理程式 (agents)、技能 (skills) 和專案層級提示詞 (prompts) 的事實標準。透過原生支援此檔案，Claude Code 消除了過去強迫使用者維護重複檔案或符號連結 (symlinks) 的專有怪癖。
減少摩擦 – 開發人員現在可以刪除為了向後相容而保留的 CLAUDE.md → AGENTS.md 符號連結。已經使用 AGENTS.md（或較新的 .agents/ 配置）的專案無需額外步驟即可運作。
回應社群的訊號 – 此更新回應了社群要求與更廣泛的 AI 工具標準保持一致的呼聲。這顯示 Anthropic 願意傾聽開發人員的意見，而非強加自己的檔案命名規範。

更新日誌內容

新增 AGENTS.md 支援：在沒有 CLAUDE.md 的專案中，Claude Code 會改為讀取 AGENTS.md；可在 /config 中的「Project instructions」進行變更（尚未在 Bedrock、Vertex 或 Foundry 上提供）

此功能僅為唯讀備援；它不會改變 Claude Code 探索 .agents/skills 或其他自訂目錄下技能的方式。它僅在 CLAUDE.md 缺失時，替換系統提示詞的來源。

Hacker News 上的社群反應

評論者	情緒	重點
@askonomm	正面	「終於做了符合標準的事，而不是強迫使用者採用專有工作流程。」
@neverrroot	正面	「謝謝你們，你們做了正確的事。」
@bcorigliano	正面	「終於！！我們需要全產業通用的標準。」
@stillpointlab	觀察	指出 Claude Fable 已經會建立 `AGENTS.md` 及其符號連結，暗示此變更可能是由自動專案架構所觸發。
@TomGarden	混合	讚賞此舉但稱其為「絕對的最低限度」，並移除了現有的符號連結。
@mococa	批評	認為此變更僅是對社群憤怒的反應，而非真正關心開發人員。
@mitchitized	批評	聲稱新的邏輯現在優先考慮 `settings.json` 而非 `CLAUDE.md`，可能會覆蓋使用者提供的指令。
@aroman	實用	「終於，我可以刪除 `sync-agent-docs.sh` 了，它之前遞迴地將 AGENTS.md 連結到 GEMINI.md 和 CLAUDE.md……」
@bluestein	幽默	「AGENTS.md 就是新的 autoexec.bat。」
@chr15m	正面	「這只是顯而易見、不愚蠢的做法，就像 Apple 改用 USB-C 一樣。」
@perganomoly	負面	「花這麼久才加入這種基本功能，簡直是恥辱。」

總體而言，社群將此變更視為一項必要的修正，而非開創性的創新。許多使用者對於不再需要符號連結感到鬆了一口氣，而少數人則對 Anthropic 的動機保持懷疑。

如何使用新的備援功能

確保 AGENTS.md 位於專案根目錄（或 Claude Code 掃描專案指令的子目錄中）。
移除任何您先前用來指向 AGENTS.md 的 CLAUDE.md 檔案或符號連結。
如果您需要自訂搜尋位置，請編輯 /config 檔案中的 Project instructions 區段：
```
{
  "projectInstructions": {
    "fallbackFile": "AGENTS.md"
  }
}
```
執行 claude --version 以確認您的版本為 2.1.277 或更高版本。

什麼沒有改變？

技能載入 – Claude Code 仍然不會自動從 .agents/skills 目錄載入技能。這仍然是一項獨立的功能需求。
Bedrock/Vertex/Foundry – 此備援功能目前在這些平台上無法使用；它們仍然需要 CLAUDE.md。
現有專案 – 已經同時包含這兩個檔案的專案，除非您刪除 CLAUDE.md，否則仍會優先使用它。

總結

Claude Code 新增 AGENTS.md 作為備援指令檔案，消除了長期存在的摩擦點，使該工具符合社群慣例，並展現了 Anthropic 根據開發人員回饋進行調整的意願。雖然這項變更規模不大，但對於可用性和標準合規性而言，這是一次明確的勝利。