Claude Code 2.1.277 支援 AGENTS.md:跨工具代理指令標準不再各寫一套

Key takeaway

Anthropic 發布 Claude Code 2.1.277,在專案沒有 CLAUDE.md 時改讀開放格式 AGENTS.md,並可於設定切換;官方說明指 Amazon Bedrock、Google Vertex AI 與 Microsoft Foundry 首發尚未支援。本文核對 Claude Code 官方發佈說明、AGENTS.md 官網與 The Register 報道,說明跨工具代理指令標準化、技術含義與香港團隊私有部署選擇。

Claude Code 2.1.277 支援 AGENTS.md:跨工具代理指令標準不再各寫一套

重點摘要

Anthropic 發布 Claude Code 2.1.277,在專案沒有 CLAUDE.md 時改讀開放格式 AGENTS.md,並可於設定切換;官方說明指 Amazon Bedrock、Google Vertex AI 與 Microsoft Foundry 首發尚未支援。本文核對 Claude Code 官方發佈說明、AGENTS.md 官網與 The Register 報道,說明跨工具代理指令標準化、技術含義與香港團隊私有部署選擇。

Anthropic 在 Claude Code v2.1.277 正式加入對開放格式 AGENTS.md 的支援:若專案目錄沒有 CLAUDE.md,工具會改讀社群標準的 AGENTS.md。消息由 Claude Code 工程師 Thariq Shihipar 公布,並寫入官方 GitHub 發佈說明;《The Register》亦跟進報道。本文來源真實性已驗證:事實以 Anthropic 官方 release notes、AGENTS.md 官網說明,以及《The Register》技術報道為準。

一、核心事件:CLAUDE.md 優先,AGENTS.md 作後備

技術細節

據 Claude Code v2.1.277 官方發佈說明(2026-09-18,標籤時間約 UTC 18:06):

  • 行為:在沒有 CLAUDE.md 的專案中,Claude Code 會改讀 AGENTS.md;可在 /config 的「Project instructions」調整。
  • 雲端限制(首發):發佈說明明確寫出,此功能 尚未 在 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry 上線。
  • 工程師說明(Thariq Shihipar,經 Simon Willison 引述):支援建基於即將推出的 Claude Code mods(自訂 harness 的機制);AGENTS.md 為內建 mod,原始碼已公開,未來開發者亦可自建專案指令處理邏輯。
  • 業界解讀(《The Register》):過去同時使用 Claude Code 與 OpenAI Codex 等工具的團隊,往往要維護兩套 Markdown 指令(CLAUDE.mdAGENTS.md),或以符號連結同步;此次改動降低跨工具摩擦。OpenAI 頭產品負責人 Thibault Sottiaux 公開回應「Yay! This is the way」。
  • 標準背景:AGENTS.md 由 OpenAI 等生態在 2025 年倡議,後交由 Linux Foundation 旗下 Agentic AI Foundation 維護;官網稱逾 60,000 個開源專案採用,並列出 Cursor、Gemini CLI、Codex、Aider 等多款工具相容。

換言之:Anthropic 沒有 廢除 CLAUDE.md,而是在「沒有 Claude 專屬檔」時,願意讀取已成事實標準的跨工具檔——優先權仍屬 CLAUDE.md

二、技術原理深度解析:代理指令檔如何變成共用基礎設施

編碼代理每次請求都會把「站立指令」載入上下文:安裝/建置指令、測試門檻、程式風格、不可動的產生檔、安全紅線等。檔名分裂會造成三種失敗模式:

  1. 漂移CLAUDE.md 更新了測試指令,但 AGENTS.md 仍是舊版,Codex/Cursor 與 Claude 行為不一致。
  2. 維運稅:符號連結、匯入腳本、雙檔審核流程,在 monorepo 與多代理並行時成本倍增。
  3. 策略不可攜:新成員或第二供應商代理無法「開箱即讀」同一套規則。

AGENTS.md 的設計刻意保持 無強制 schema 的 Markdown,讓人類 README 繼續服務貢獻者,代理則有可預期入口。目錄樹可嵌套多份 AGENTS.md,較近路徑優先——與大型 monorepo 的套件邊界對齊。

Claude Code 以 mod 實作後備讀取,還預告更廣義的 harness 自訂:團隊可只讀 CLAUDE.md、後備 AGENTS.md、兩者並載,或限制為集中管理指令。Runtime Wire 等跟進指出,相關選項可由使用者設定、--settings 或託管設定施加,專案內 .claude/settings.json 不能擅自改寫個人/組織的指令載入政策——避免倉庫程式碼劫持本地政策。

對架構師而言,重點不是「檔名政治」,而是:把可審計、可版本控管的代理行為契約,從聊天視窗搬回 Git

四、日常應用場景

1. 開發者與技術團隊

若倉庫已標準化 AGENTS.md(建置、測試、lint、安全約束),升級至 Claude Code 2.1.277 後,通常無需再為 Anthropic 單獨複製一份檔。建議在 /config 確認「Project instructions」模式,並在 PR 模板要求:改動代理指令須同步說明影響哪些工具。Bedrock/Vertex/Foundry 用戶需留意首發缺口,勿假設雲端通道已具備相同後備行為。

2. 企業與隱私敏感行業

金融、法律、醫療團隊若採「多代理+私有模型」策略,應把 AGENTS.md/CLAUDE.md 納入變更管控與機密分級:指令檔可能含內部服務位址、測試帳號慣例或合規紅線。敏感知識庫與客戶資料仍宜留在可控環境(本地或香港託管私有 LLM),公有編碼代理只讀已淨化的站立指令。

3. 一般用戶

一般消費者未必直接接觸 AGENTS.md,但使用依賴編碼代理的產品(自動修 bug、產生 PR)時,供應商是否採統一指令檔,會影響輸出穩定度與「換工具是否行為大變」。

4. 香港與亞洲市場視角

香港外包與產品團隊常見「Claude Code+Cursor/Codex/Gemini CLI」混用。統一 AGENTS.md 可減少雙檔維護,並讓遠端協作時的代理行為可審查、可重現。對接銀行/保險 RFP 時,亦可展示:代理規則以 Git 為單一真相來源,而非散落在各人聊天記錄。

五、專業評價與潛在考量

優勢

  • 初級證據為 Anthropic 官方 GitHub release notes,版本號、行為與雲端排除項清楚可核對。
  • 對齊 Linux Foundation 旗下開放格式,降低跨供應商鎖定。
  • 預設保留 CLAUDE.md 優先,對既有 Anthropic 工作流破壞性低。

需要留意的地方

  • 預設是「無 CLAUDE.md 才讀 AGENTS.md」,不是自動合併兩檔;若需並載須改 /config
  • Bedrock/Vertex/Foundry 首發未支援,企業私有雲通道需另測。
  • 社群議題曾反映早期版本行為不一致;生產環境應以 2.1.277+ 實測後備載入,並用明確測試提示驗證上下文是否注入。

結語

Claude Code 2.1.277 把 AGENTS.md 從「社群最吵的功能請求」變成官方後備行為:跨工具代理指令終於可少寫一套檔。對香港工程與外包團隊,這是把代理治理收進 Git 的好時機——先統一站立指令,再決定哪些負載走公有 frontier、哪些必須私有部署。若貴司需要在香港部署企業私有 LLM 全託管(年費 HK$88,000 起,Dataset → QLoRA/LoRA → 私有 API,100% 數據不出境),可參考 YSK Limited 的企業私有 LLM 服務:https://ysk.hk/services/ai-automation


參考來源

  1. Claude Code 官方發佈說明 v2.1.277(2026-09-18):https://github.com/anthropics/claude-code/releases/tag/v2.1.277
  2. AGENTS.md 開放格式官網:https://agents.md/
  3. The Register(2026-09-18):https://www.theregister.com/ai-and-ml/2026/09/18/anthropic-decides-to-support-openais-markdown-instructions-spec/5297588
  4. Simon Willison 引述 Thariq Shihipar(2026-09-18):https://simonwillison.net/2026/Sep/18/thariq-shihipar/
  5. X 發現來源(TheRegister):https://x.com/TheRegister/status/2101062566349058304

Related services & products