Vì sao CEO Shopify dọa cấm Claude Code chỉ vì tệp AGENTS.md?

Shopify không dọa cấm Claude Code vì CLAUDE.md chắc chắn kém hơn AGENTS.md. Vấn đề nằm ở chỗ một định dạng riêng của nhà cung cấp có thể trở thành gánh nặng vận hành khi hàng nghìn kỹ sư cùng dùng nhiều tác nhân lập trình AI trên một kho mã.

CEO Shopify Tobi Lütke nói ngày 25/8/2026 rằng ông đang cân nhắc cấm Claude Code cho đến khi Anthropic thay đổi cách tiếp cận và cho công cụ đọc AGENTS.md, .agents/skills cùng các tệp liên quan. Ông cho rằng việc Claude Code chỉ ưu tiên CLAUDE.md đôi khi tạo ra tình trạng “não lệch” (split brain) khi các thành viên trong cùng một đội dùng những công cụ khác nhau. 415

AGENTS.md là gì?

AGENTS.md là một tệp Markdown đặt trong kho mã, thường ở thư mục gốc hoặc các thư mục con. Tệp này cung cấp bối cảnh mà tác nhân AI cần để làm việc an toàn và đúng quy ước, chẳng hạn:

• cách xây dựng và chạy thử phần mềm;
• quy ước viết mã;
• các thư mục không được chỉnh sửa;
• quy trình đóng góp, kiểm thử và tạo pull request.

Vì nằm cùng mã nguồn và được quản lý bằng hệ thống kiểm soát phiên bản, hướng dẫn trong AGENTS.md đi theo dự án thay vì gắn với một công cụ cụ thể. 2931

Định dạng này hình thành từ sự hợp tác trong ngành, với sự tham gia của các công ty như Google, OpenAI, Sourcegraph, Factory và Cursor. Ngày 9/12/2025, OpenAI và Anthropic đã đóng góp AGENTS.md cho Agentic AI Foundation (AAIF), một nền tảng do Linux Foundation bảo trợ nhằm thúc đẩy hạ tầng tác nhân AI mở và có khả năng tương tác. 192829

Theo Linux Foundation, AGENTS.md khi đó đã được hơn 60.000 dự án mã nguồn mở và framework tác nhân áp dụng, gồm Codex, Cursor, Devin, Factory, Gemini CLI, GitHub Copilot, Jules và VS Code. 31

Điều này không biến AGENTS.md thành một tiêu chuẩn kỹ thuật bắt buộc. Tuy nhiên, nó khiến tệp này trở thành một lớp tương thích thực tế: doanh nghiệp có thể lưu hướng dẫn bền vững của dự án ở một nơi và kỳ vọng nhiều công cụ cùng đọc được.

Vì sao Claude Code gây khó trong monorepo?

Tài liệu của Claude Code hiện tập trung vào CLAUDE.md, .claude/rules, skills, hooks và các thiết lập riêng. Công cụ có thể tìm những tệp này từ thư mục hiện tại và các thư mục cha, tạo thành một hệ thống hướng dẫn đệ quy của riêng mình. 2

Với một lập trình viên độc lập, khác biệt này có thể chỉ gây thêm một bước thiết lập. Nhưng trong một monorepo lớn, nơi các nhóm dùng Claude Code bên cạnh Codex, Cursor, Gemini CLI hoặc GitHub Copilot, hậu quả rõ ràng hơn.

Nếu một công cụ đọc AGENTS.md còn Claude Code chỉ đọc CLAUDE.md, cùng một thư mục có thể truyền cho các tác nhân những thông tin khác nhau về:

• lệnh kiểm thử cần chạy;
• tiêu chuẩn viết mã;
• quy trình xây dựng phần mềm;
• giới hạn đối với những khu vực “không được chạm vào”.

Doanh nghiệp khi đó phải lựa chọn giữa việc:

1. duy trì cả AGENTS.md và CLAUDE.md ở thư mục gốc;
2. lặp lại hai tệp ở các thư mục con liên quan;
3. liên tục đồng bộ chúng khi mã nguồn thay đổi; và
4. xây dựng công cụ kiểm tra để phát hiện hai bộ hướng dẫn bị lệch nhau.

Một lần quên cập nhật không chỉ là lỗi tài liệu. Codex hoặc Cursor có thể tuân theo lệnh kiểm thử mới, trong khi Claude Code dùng lệnh cũ; một tác nhân có thể biết rằng không được sửa một thư mục, còn tác nhân khác thì không. Kết quả là các lần chỉnh sửa, đánh giá mã và hành vi của AI trở nên thiếu nhất quán—đúng với vấn đề “não lệch” mà Lütke cảnh báo. 47

Một yêu cầu công khai trên GitHub cũng mô tả trực tiếp sự bất tiện này: khi người dùng tải về một kho mã có sẵn AGENTS.md, Claude Code có thể bỏ qua phần bối cảnh đó, buộc họ phải tự tạo CLAUDE.md rồi sao chép hướng dẫn. 12

Anthropic đưa ra cách xử lý nào?

Cách khắc phục được ghi nhận là đưa nội dung dùng chung vào hệ thống cấu hình riêng của Claude Code. Chẳng hạn, nhóm phát triển có thể tham chiếu AGENTS.md từ CLAUDE.md; một lựa chọn khác là dùng liên kết tượng trưng (symbolic link) hoặc một cầu nối cấu hình tương tự. 69

Các giải pháp này có thể giảm xung đột trước mắt, nhưng chưa giống việc hỗ trợ AGENTS.md nguyên bản. Chúng buộc từng tổ chức phải tự quyết định cách xử lý việc nhập tệp, thứ tự ưu tiên, phạm vi thư mục và đồng bộ nội dung.

Liên kết tượng trưng cũng có thể hoạt động khác nhau tùy hệ điều hành, thiết lập Git, IDE, container và chính sách bảo mật doanh nghiệp. Nói cách khác, phần việc tích hợp được chuyển từ nhà cung cấp sang đội ngũ kỹ thuật của khách hàng.

Trong cuộc trao đổi công khai, Thariq—một nhân sự của Anthropic—cho biết công ty đang làm Claude Code “dễ tùy biến” hơn, trong đó có việc giúp người dùng dễ sử dụng AGENTS.md hoặc thay đổi các thiết lập system prompt khác. 15 Các tài liệu hiện có chưa đưa ra lý do kỹ thuật hay thương mại dứt khoát giải thích vì sao Claude Code chưa hỗ trợ nhận diện nguyên bản định dạng này. Vì vậy, mọi kết luận về động cơ của Anthropic vẫn chỉ là suy đoán.

Nghịch lý về tiêu chuẩn mở

Tranh cãi càng đáng chú ý vì Anthropic có liên quan đến hệ sinh thái Agentic AI Foundation, nơi AGENTS.md được đặt dưới cơ chế quản trị trung lập của Linux Foundation. Trong khi đó, các quy ước dự án được Claude Code ghi nhận trong tài liệu vẫn chủ yếu là những tệp do Anthropic đặt tên và kiểm soát. 22829

Điều này không nhất thiết có nghĩa Anthropic phản đối tiêu chuẩn mở. Một nhà cung cấp vẫn có thể hỗ trợ nền tảng chung, đồng thời giữ lại các phần mở rộng riêng cho những tính năng đặc thù của sản phẩm hoặc mô hình.

Tuy nhiên, với khách hàng doanh nghiệp, khác biệt đó ít quan trọng nếu hướng dẫn cốt lõi của dự án vẫn phải viết lại hoặc bắc cầu trước khi công cụ khác sử dụng được.

Tranh chấp này có thể thay đổi thị trường thế nào?

“Thuế cấu hình” sẽ tăng theo số lượng công cụ

Mỗi cây hướng dẫn riêng của một nhà cung cấp đều tạo ra công việc bảo trì: sao chép tệp, kiểm tra đồng bộ, viết script di chuyển và xử lý lỗi phát sinh. Khi doanh nghiệp đưa thêm tác nhân AI vào quy trình, chi phí này tăng theo số công cụ và số phạm vi thư mục cần hỗ trợ.

Doanh nghiệp sẽ cảnh giác hơn với khóa nhà cung cấp

Các tệp hướng dẫn thường chứa quy trình nội bộ, ranh giới bảo mật, kiến thức vận hành và thói quen làm việc của đội ngũ. Nếu những thông tin đó hoạt động tốt nhất trong định dạng của một nhà cung cấp, việc đổi công cụ hoặc sử dụng nhiều công cụ song song sẽ trở nên đắt đỏ hơn.

Một định dạng chung giúp giảm chi phí chuyển đổi và tăng vị thế đàm phán của các lãnh đạo kỹ thuật khi lựa chọn sản phẩm.

Mô hình hai lớp có thể là lối đi thực tế

Kết quả khả dĩ không nhất thiết là một định dạng duy nhất thay thế mọi quy ước riêng. Mô hình hợp lý hơn có thể gồm:

• AGENTS.md làm lớp hướng dẫn nền tảng, có thể di chuyển giữa các công cụ;
• CLAUDE.md hoặc tệp riêng của từng nhà cung cấp làm lớp mở rộng tùy chọn.

Cách này vẫn cho phép sản phẩm tạo khác biệt, nhưng không biến những thông tin cơ bản của kho mã thành dữ liệu bị khóa trong một hệ sinh thái.

Khách hàng doanh nghiệp có thể trở thành người định hình tiêu chuẩn

Phản ứng của Lütke cho thấy một khách hàng lớn có thể biến yêu cầu tương thích nhỏ thành điều kiện triển khai. Nếu Shopify và các doanh nghiệp tương tự xem hỗ trợ đa công cụ là tiêu chí mua sắm, các nhà cung cấp sẽ phải coi khả năng tương tác là một phần của năng lực doanh nghiệp, thay vì một tính năng cộng đồng không bắt buộc.

Kết luận

Đây không thực sự là cuộc chiến giữa hai cái tên tệp Markdown. Shopify đang phản đối chi phí vận hành phát sinh khi mỗi công cụ lập trình AI áp đặt một “cây hướng dẫn” riêng lên cùng một kho mã.

Mức độ phổ biến của AGENTS.md, cơ chế quản trị thông qua Linux Foundation và sự hỗ trợ từ nhiều công cụ lớn khiến nó trở thành một lớp chia sẻ đáng tin cậy. 2931 Các cách nhập tệp hoặc dùng liên kết tượng trưng có thể giúp Claude Code hoạt động trước mắt, nhưng lại đẩy gánh nặng tích hợp về phía từng doanh nghiệp.

Câu hỏi lớn hơn là: các tác nhân lập trình AI sẽ trở thành hạ tầng có thể tương tác, hay vẫn là những nền tảng khép kín buộc kiến thức của dự án phải được điều chỉnh cho từng công cụ?