Anthropic từ chối hỗ trợ chuẩn AGENTS.md cho Claude Code
Yêu cầu tích hợp tệp AGENTS.md vào Claude Code đã bị đóng mà không được chấp nhận. Trong khi Codex, Amp, Cursor và nhiều công cụ khác đang hướng tới chuẩn chung này, việc Anthropic giữ riêng tệp CLAUDE.md khiến người dùng khó cộng tác với các nhóm dùng công cụ khác.

Anthropic vừa đóng yêu cầu bổ sung tính năng hỗ trợ tệp AGENTS.md cho Claude Code, công cụ lập trình bằng trí tuệ nhân tạo của hãng. Đề xuất này được mở từ ngày 21/8/2025 và không được chấp nhận.
Đây là điểm va chạm đầu tiên giữa một chuẩn mở đang hình thành và một sản phẩm đã có quy ước riêng. Người đề xuất cho rằng cách làm hiện tại của Anthropic gây bất tiện cho nhóm phát triển hỗn hợp.
Chuyện gì đã xảy ra?
Yêu cầu mang số hiệu #6235 trên kho mã nguồn mở của claude-code, gắn nhãn "core", "enhancement" và "memory". Nội dung đề nghị Claude Code đọc được tệp AGENTS.md, thay vì chỉ dựa vào tệp CLAUDE.md.
Người mở yêu cầu lập luận rằng Codex, Amp, Cursor và một số công cụ khác đang dần thống nhất quanh AGENTS.md. Đây là một tệp Markdown chung để các tác nhân lập trình (coding agent) hiểu cấu trúc và quy ước của một kho mã nguồn.
Theo mô tả trong yêu cầu, CLAUDE.md gắn quá chặt với Claude Code. Tệp này hoạt động kém khi lập trình viên cộng tác với đồng nghiệp không dùng Claude Code.
Vì sao chuẩn chung quan trọng?
Tệp hướng dẫn cho tác nhân AI đóng vai trò như bản mô tả dự án: cách chạy thử, quy ước đặt tên, thư mục nào cần tránh. Nếu mỗi công cụ đọc một tệp riêng, nhóm phát triển phải duy trì nhiều bản nội dung trùng lặp.
Một tệp chung giúp giảm việc sao chép và tránh lệch nhau khi dự án thay đổi. Nó cũng cho phép chuyển đổi công cụ mà không phải viết lại toàn bộ hướng dẫn.
Hệ quả với người dùng Claude Code
Quyết định đóng yêu cầu không có nghĩa Claude Code biến mất khỏi các dự án dùng chung. Người dùng vẫn có thể giữ tệp CLAUDE.md song song với AGENTS.md, nhưng phải tự đồng bộ hai bản.
Với các nhóm có thành viên dùng nhiều trợ lý lập trình khác nhau, việc này tạo thêm công việc bảo trì. Kho claude-code hiện có khoảng 142.000 sao và 22.800 bản rẽ nhánh (fork), nên quyết định này ảnh hưởng tới một cộng đồng lớn.
Góc nhìn
Với lập trình viên Việt Nam làm việc trong nhóm dùng cả Claude Code lẫn Cursor hay Codex, nên đặt AGENTS.md làm nguồn chính và để CLAUDE.md chỉ là tệp mỏng trỏ sang. Cách này giữ hướng dẫn dự án ở một chỗ, tránh sửa hai nơi rồi quên một nơi.
Về dài hạn, việc một hãng lớn từ chối chuẩn mở cho thấy các tệp hướng dẫn tác nhân AI vẫn chưa ổn định. Doanh nghiệp nên tách phần hướng dẫn chung khỏi phần đặc thù từng công cụ khi xây dựng quy trình nội bộ.
Nguồn: github.com · Quy trình biên tập


