換工具不必重教規矩，Claude Code 開始讀 AGENTS.md

9 月 19 日，Anthropic 旗下 Claude Code 團隊的工程師薩裏克．希希帕爾（Thariq Shihipar，網名 @trq212）在 X 平臺發了一則短短的推文：當天釋出的 2.1.277 版本，新增了對 AGENTS.md 的支援。消息經公開報導（IT之家，9 月 19 日）轉述，很快在開發者圈子裡傳開，不少人用「AI 通用說明書」來稱呼這個檔案。

一則版本更新說明，為什麼值得討論？因為它動到的東西比看起來多。AI 編程工具要讀哪一份說明書，原本是各家自訂的家務事，這一步之後，開始有了共用的答案。

推文內容經媒體中譯，大意如下：

兩份說明書，各管各的事

這次更新之後，Claude Code 的書架上放著兩種檔案，分工清楚。

CLAUDE.md 是 Claude Code 專屬的說明書，記的是工作流、MCP、Sub-agent、命令配置這類自家規矩，性質接近貼在工位上的私人便利貼，內容只給這一家的工具看。AGENTS.md 走的是另一條路：按工程師在推文裡的說法，它的目標是讓不同工具共用專案級的基礎規則，可以視為所有 AI 都應該遵守的通用規則，像釘在茶水間牆上的規章，誰來上班都得先看一眼。

讀取邏輯不複雜。先找 CLAUDE.md，找不到，就退一步去讀 AGENTS.md。不喜歡這個安排的使用者，可以在 /config 裡把這個行為切換掉，繼續維持原本的習慣。

一個小細節可以看出設計者的分寸：兩份檔案並存，專屬的優先，通用的墊底。已經寫好 CLAUDE.md 的專案完全不受影響，這次更新真正服務的，是那些希望一份說明書走天下的人。

給機器看的小紙條，其實有族譜

在軟體圈，專案根目錄裡本來就住著一批「給機器看的小紙條」，每一張都管過一段歷史。

README.md 是開源專案的門面，寫給第一次走進專案的人，從早期的開源光碟一路用到 GitHub 年代，幾乎是每個資料夾的標準配備。robots.txt 出現在 1994 年，由工程師 Martijn Koster 起草，網站把一份純文字檔放在根目錄，告訴搜尋引擎的爬蟲哪些路不要走；它沒有任何強制力，靠全行業自願遵守，運轉了三十年。.gitignore 交代版本控制系統哪些檔案不必追蹤。.editorconfig 則讓不同的編輯器，在同一個專案裡用同一套縮排和換行規則。

AGENTS.md 想坐的位置，正是這張桌子上 robots.txt 坐了三十年的那個位子：一份放在專案裡的通用說明，任何 AI 工具路過，先讀完再動手。

省下來的，是自我介紹的力氣

對開發者來說，這次更新省掉的是重複交代的成本。過去每換一個 AI 編程工具，專案的規矩就得重講一遍；今天用這家、明天換那家，或者中途接手別人的專案，都得先弄清楚對方讀哪一份說明書。AGENTS.md 有了 Claude Code 這個讀者之後，同一份「給 AI 看的使用說明」可以一路沿用，不必再從頭配置。

對開源專案的維護者，這套邏輯更實用。訪客用什麼工具上門，你管不著；一份通用說明，等於把門口的告示牌統一了，誰來都讀得到同一套規矩。

這兩年 AI 編程工具一個接一個上桌，模型的本事也一路被送進各種考場驗收，稍早GPT-6-Astra 在洛谷刷出整排 AC的討論就是一例。能力往前衝的同時，人與工具之間那層規矩介面也得跟著長，AGENTS.md 屬於後者的進度。

同一家公司的兩種姿態

時間點讓這件事多了些意味。同一個時期，Anthropic 執行長達裏奧才發表呼籲前沿 AI 放慢腳步的 3800 字長文，公司裡的工程團隊則忙著把說明書的門打開，讓 Claude 去讀一份別家工具也讀的檔案。一邊談加速的風險，一邊做互通的細節，兩件事排進同一份行事曆，剛好拼出這家公司的兩張臉。

Claude Code 這一年的更新節奏也不算慢。從桌面端與終端的打通，到跨會話的訊息傳遞，公開報導裡都有紀錄。AGENTS.md 的支援排在這串更新後面，像一次小步修改，方向卻是把門往外推：工具之間的牆，又矮了一截。

對使用者的意義倒是很樸素。將來再出現新的 AI 編程助手，只要它也認得 AGENTS.md，專案的規矩就不用重寫。

說明書的下一頁

通用說明書要真的通用，得看其他工具買不買帳。robots.txt 能運轉三十年，靠的是全行業心照不宣的配合。AGENTS.md 能不能從「Claude 也讀」長成「大家都寫、大家都讀」，版本號決定不了，往後幾年開發者的習慣才行。

十年後回頭看，這份檔案會像 robots.txt 一樣變成空氣般的存在，還是安靜躺在無數專案根目錄裡，偶爾被誰翻開？答案會由每一次「要不要多寫一份說明書」的小決定，慢慢累積出來。