Claude Code đã đọc AGENTS.md: một file hướng dẫn cho mọi AI coding tool
Tóm tắt
Team dùng nhiều AI coding tool thường phải duy trì nhiều file cấu hình (CLAUDE.md, .cursor/rules, AGENTS.md…). Claude Code giờ đọc AGENTS.md khi thư mục không có CLAUDE.md, nên một file hướng dẫn có thể dùng chung cho nhiều tool.
Những gì thay đổi
| Điểm | Chi tiết |
|---|---|
| Phiên bản | Claude Code 2.1.277 |
| Thứ tự ưu tiên | CLAUDE.md được ưu tiên; AGENTS.md chỉ được dùng ở thư mục không có CLAUDE.md |
| Tuỳ chỉnh | Dùng /config để chọn đọc AGENTS.md, CLAUDE.md hoặc cả hai |
| Ngoại lệ | Cần phiên lấy được feature flag từ Anthropic; qua Bedrock/provider khác hoặc tắt telemetry sẽ quay về CLAUDE.md |
| AGENTS.md | Chuẩn mở, Markdown thuần, đặt ở root repo; do Agentic AI Foundation (thuộc Linux Foundation) quản lý |
Áp dụng thế nào?
- Repo dùng nhiều tool: đưa phần hướng dẫn chung (cách build, test, quy ước code) vào AGENTS.md.
- Giữ CLAUDE.md mỏng cho phần chỉ Claude dùng (hook, skill, subagent), và trỏ sang AGENTS.md cho phần chung.
- Kiểm tra lại trên từng tool: cùng một hướng dẫn có thể được hiểu khác nhau giữa các agent.
- Tech Lead: coi AGENTS.md như tài liệu onboarding — viết cho cả người lẫn máy đọc.
Tham khảo: InfoWorld