Ngày 25 tháng 8, CEO Shopify Tobi Lütke công khai cho biết ông đang cân nhắc cấm sử dụng Claude Code trong nội bộ công ty, trừ khi Anthropic đổi ý và để công cụ này đọc các tệp như AGENTS.md và .agents/skills. Lý do ông đưa ra là Claude Code khăng khăng chỉ đọc CLAUDE.md, khiến các thành viên trong nhóm dùng công cụ khác nhau rơi vào tình trạng "phân liệt", và ông gọi đây là một khoản thuế phức tạp lẽ ra không cần phải trả.
Tranh cãi xoay quanh một tệp Markdown
AGENTS.md là quy ước do OpenAI đưa ra vào tháng 8 năm 2025: ghi các lệnh build, cách chạy kiểm thử, quy tắc bảo mật ở cấp dự án vào một tệp Markdown đặt tại thư mục gốc của kho mã, để các agent lập trình đọc và hiểu codebase. Đến cuối năm 2025, dữ liệu công khai cho thấy đã có hơn sáu vạn dự án mã nguồn mở sử dụng tệp này, và bản thân chuẩn sau đó được chuyển giao cho Agentic AI Foundation trực thuộc Linux Foundation. Codex, Cursor, Gemini CLI, GitHub Copilot, Jules, VS Code đều công nhận nó.
Claude Code lại dùng tệp riêng của mình là CLAUDE.md. Với dự án cá nhân, đây chỉ là chuyện viết thêm một tệp; nhưng với tổ chức như Shopify, nơi hàng nghìn người dùng chung một kho mã lớn, vấn đề biến dạng hẳn: nếu trong cùng một thư mục chỉ có một trong hai tệp, đồng nghiệp dùng công cụ khác sẽ nhận được ngữ cảnh không đầy đủ.
Yêu cầu bị treo một năm
Issue trên GitHub yêu cầu Claude Code hỗ trợ AGENTS.md từ gốc đã tồn tại từ tháng 8 năm 2025, gom được gần 5.000 lượt ủng hộ, là một trong những đề xuất tương thích được hưởng ứng nhiều nhất trong kho mã này. Vài issue cùng chủ đề sau đó lần lượt bị đóng, một trong số đó có kết luận là "hiện chưa có kế hoạch". Các nhà phát triển để lại hàng trăm bình luận bên dưới, nhưng phía chính thức vẫn im lặng.
Cộng đồng đã tự tìm ra cách lách từ lâu: biến CLAUDE.md thành liên kết tượng trưng trỏ tới AGENTS.md, hoặc đơn giản là viết một dòng trong CLAUDE.md bảo "hãy đọc AGENTS.md". Cách này chạy được, nhưng phải làm lại cho từng kho mã.
Anthropic cuối cùng cũng đưa ra lý do
Đúng ngày Lütke lên tiếng, Thariq của Anthropic đã trả lời trên diễn đàn, cho biết đội ngũ đang làm cho Claude Code dễ tùy biến hơn, để sau này có thể dễ dàng dùng AGENTS.md hoặc chỉnh trực tiếp system prompt, và sẽ thông báo khi hoàn tất. Đây cũng là lần đầu tiên hãng đưa ra lý do cho việc từ chối trước đó: họ không cho rằng các họ mô hình khác nhau có thể hoán đổi cho nhau, vì system prompt ảnh hưởng rất lớn tới hiệu năng — nội bộ Claude Code duy trì system prompt riêng cho từng mô hình, và khối lượng bảo trì này không nhỏ.
Về mặt kỹ thuật, lý do này đứng vững. Cùng một đoạn chỉ dẫn đưa cho các mô hình của những hãng khác nhau, hiệu quả thực sự có thể chênh lệch rõ rệt, prompt được tinh chỉnh riêng có thể tạo ra khoảng cách hiệu năng đáng kể. Nhưng nó chỉ giải thích vì sao CLAUDE.md cần tồn tại riêng, chứ không giải thích vì sao không thể tiện thể đọc thêm AGENTS.md — hai việc này không hề mâu thuẫn nhau.
Tệp ngữ cảnh trở thành chiến địa mới
Một thống kê trên 2.926 kho mã GitHub cho thấy tệp ngữ cảnh đã là cách phổ biến nhất để nhà phát triển ra lệnh cho agent lập trình. Một khi vị trí này bị định dạng riêng của một hãng chiếm giữ, chi phí di chuyển sẽ đổ lên vai người dùng — hôm nay là phải bảo trì thêm một tệp, ngày mai có thể là toàn bộ kỹ năng, sub-agent, cấu hình quyền hạn bị khóa cứng vào cấu trúc thư mục của một hãng.
Xét về khối lượng công việc kỹ thuật, thế bế tắc này có phần không tương xứng. Để Claude Code quay sang đọc AGENTS.md khi không tìm thấy CLAUDE.md chỉ là vài chục dòng logic tìm tệp, hoàn toàn khác tầng với việc "bảo trì system prompt theo từng mô hình". Nếu thực sự lo chỉ dẫn dùng chung làm giảm hiệu quả, thêm một dòng ghi chú là đủ. Suốt một năm qua, phương án dung hòa mà cộng đồng liên tục đề xuất chính là: mặc định đọc CLAUDE.md, không thấy thì đọc AGENTS.md, nếu có cả hai thì ưu tiên tệp trước.
Sức ép công khai của Lütke phát huy tác dụng cũng vì lý do đơn giản. Shopify là khách hàng quy mô lớn của Claude Code, và lời một CEO công ty niêm yết công khai tuyên bố sẽ cấm dùng có sức nặng hơn hẳn 5.000 lượt ủng hộ ẩn danh. Với Anthropic, lợi thế hiện tại của Claude Code nằm ở trải nghiệm sản phẩm, không phải ở việc trói buộc định dạng; trong bối cảnh nhà phát triển đã quen dùng nhiều công cụ song song, biến khả năng tương thích thành một công tắc bật/tắt rõ ràng có lợi hơn là giữ khư khư một tên tệp.
Nguồn tham khảo: The New Stack, GitHub, CocoLoop, Hacker News; quy mô áp dụng AGENTS.md, số lượt ủng hộ issue và phát biểu từ phía Anthropic đều được kiểm chứng theo các trang công khai.