Công cụ lập trình Claude Code của Anthropic bắt đầu hỗ trợ AGENTS.md từ phiên bản 2.1.277. Quy tắc khá đơn giản: khi một thư mục không có CLAUDE.md, Claude Code sẽ tìm file AGENTS.md nằm cùng thư mục và đưa nội dung đó vào ngữ cảnh như chỉ dẫn dự án; còn ở những nơi đã có CLAUDE.md, công cụ vẫn chỉ đọc CLAUDE.md như trước.
Phiên bản này được phát hành trên GitHub ngày 18/9. Thariq, thành viên đội ngũ Claude Code, thông báo thay đổi này trên mạng xã hội:
"Starting today in version 2.1.277, if there is no CLAUDE.md in a folder, Claude will check for and use AGENTS.md."
(Kể từ hôm nay với phiên bản 2.1.277, nếu một thư mục không có CLAUDE.md, Claude sẽ tìm và dùng AGENTS.md.)
Bốn mức bật/tắt
Tính năng hỗ trợ AGENTS.md được làm dưới dạng plugin tích hợp sẵn, mã nguồn công khai trong kho GitHub của Claude Code. Người dùng chuyển đổi ở mục "Project instructions" trong /config, tổng cộng có bốn mức:
| Chế độ | Hành vi |
|---|---|
| claude-md | Chỉ đọc CLAUDE.md, coi như tắt tính năng này |
| claude-md-or-agents-md (mặc định) | Thư mục nào có CLAUDE.md thì bỏ qua AGENTS.md ở đó, không có mới đọc |
| claude-md-and-agents-md | Đọc cả hai loại file trên toàn bộ cây thư mục |
| managed-only | Bỏ qua mọi file chỉ dẫn commit trong kho và file cá nhân, chỉ giữ file và bộ nhớ do tổ chức phân phối thống nhất |
Chế độ mặc định là dự phòng, không gộp nội dung. Những kho đã có sẵn CLAUDE.md cho Claude Code sẽ không thay đổi hành vi sau khi nâng cấp; chỉ những kho chưa từng viết CLAUDE.md, trước đây chỉ chuẩn bị AGENTS.md cho công cụ khác, mới lần đầu được đọc file này vào. Cùng một file nếu bị xác định là trùng lặp theo đường dẫn hoặc nội dung sẽ không được nạp hai lần.
Vẫn còn vài điểm khác với CLAUDE.md
Tài liệu plugin liệt kê một số khác biệt so với CLAUDE.md. AGENTS.md trong thư mục con chỉ được đính kèm khi Agent dùng lệnh Read để đọc văn bản trong thư mục đó; lựa chọn vùng trong IDE, Notebook, hình ảnh và PDF đều không kích hoạt việc này. File được đính kèm theo cách đó không được ghi nhận là đã đọc, nên sau khi ngữ cảnh bị nén sẽ không tự động khôi phục lại. Lệnh /memory và phím tắt bộ nhớ # đều không chạm tới AGENTS.md, thư mục thêm bằng --add-dir cũng không đóng góp AGENTS.md, còn đường dẫn symlink được so khớp theo ký tự chứ không được phân giải.
Về kênh sử dụng, AWS Bedrock, Google Vertex và Microsoft Foundry hiện chưa hỗ trợ. Cùng phiên bản này còn có một thay đổi khác liên quan tới file chỉ dẫn: khi khởi động ở chế độ SDK và không giao diện, lượt hội thoại đầu tiên không còn phải chờ quá trình tìm CLAUDE.md hoàn tất.
Một kho mã, nhiều Agent
AGENTS.md tương đương một file README viết riêng cho các Agent lập trình đọc: build thế nào, chạy test ra sao, quy ước phong cách code là gì, thư mục nào không được đụng vào. Định dạng này ban đầu do OpenAI Codex và vài công cụ khác cùng thúc đẩy trong năm 2025, sau đó được chuyển giao cho Agentic AI Foundation trực thuộc Linux Foundation quản lý; Cursor, GitHub Copilot và nhiều công cụ khác đều nhận diện được. Claude Code trước nay chỉ đọc CLAUDE.md của riêng mình, khiến các đội dùng nhiều công cụ phải duy trì song song hai file có nội dung gần như giống hệt nhau; cách phổ biến trong cộng đồng là dùng symlink để cả hai cùng trỏ về một file.
Các đội ở Trung Quốc thường dùng tổ hợp công cụ đa dạng hơn: ngoài Claude Code, phổ biến còn có Kimi Code, Qwen Code, Cursor và Codex, trong đó không ít công cụ mặc định đọc AGENTS.md hoặc cho phép đổi tên file chỉ dẫn. Ở chế độ mặc định, các kho mã cũ không cần sửa gì; đội nào muốn chỉ duy trì một file AGENTS.md có thể xóa CLAUDE.md và gộp nội dung sang đó, nhưng cần rà lại những giới hạn nêu trên trước, nhất là việc chỉ dẫn thư mục con không tự quay lại sau khi phiên làm việc dài bị nén ngữ cảnh.
Mức managed-only hướng tới quản trị viên doanh nghiệp. File chỉ dẫn được commit vào kho sẽ bị Agent thực thi như một chỉ dẫn, bản thân đó là một cửa ngõ có thể bị đầu độc; quản trị viên có thể dùng mức này để chỉ cho phép các quy tắc do tổ chức phân phối thống nhất. Hiệu quả sử dụng mức này trong các đội lớn hiện chưa có dữ liệu công khai.
Nguồn tham khảo: Ghi chú phát hành GitHub của Claude Code, CocoLoop, bài đăng công khai của kỹ sư Anthropic Thariq; đối chiếu bốn chế độ, thứ tự nạp và các điều khoản giới hạn trong tài liệu plugin agents-md.