Claude Code hiện cũng hỗ trợ instructions theo format Agents.md của OpenAI
Động thái của Anthropic có thể giảm công sức duy trì khi sử dụng nhiều AI coding agent trong cùng một project — dù vẫn có một số vấn đề cần lưu ý.
Một yếu tố khiến developer khó chuyển đổi giữa các AI coding tool trong cùng một project là Claude Code của Anthropic không tìm instructions ở cùng vị trí với các agent khác như OpenAI Codex — nhưng điều này hiện đang thay đổi.
Claude và Codex đều hỗ trợ instructions ở Markdown format, một cách đơn giản để cung cấp cho AI coding agent các hướng dẫn hành vi dành riêng cho project.
Trước đây, Claude Code mặc định tìm instructions dành cho project trong file CLAUDE.md, trong khi Codex và các agent khác sử dụng AGENTS.md. Format AGENTS.md là một sáng kiến open source được quản lý bởi Agentic AI Foundation, thuộc Linux Foundation.
Tuy nhiên hiện tại, như Thariq Shihipar, một thành viên trong technical staff của Anthropic, đã viết trong một bài đăng trên X vào thứ Sáu, “Chúng tôi đang bổ sung hỗ trợ cho AGENTS.md vào Claude Code. Bắt đầu từ hôm nay, trong phiên bản 2.1.277, nếu trong một folder không có CLAUDE.md, Claude sẽ kiểm tra và sử dụng AGENTS.md.”
Điều này có nghĩa là các developer sử dụng nhiều công cụ lập trình song song với Claude Code giờ đây có thể áp dụng cùng một project instruction cho các agent này, thay vì phải duy trì các instruction file riêng biệt cho Claude và cho các công cụ khác.
Các developer sẽ không còn phải duy trì các instruction giống hoặc tương tự nhau cùng lúc trên 2 file, cũng như không cần đảm bảo cập nhật đồng bộ tại 2 nơi mỗi khi có thay đổi về quy tắc coding, lệnh build hay các instruction khác dành cho agent - một quy trình vốn gây thêm gánh nặng bảo trì và dễ dẫn đến tình trạng dữ liệu không đồng nhất. Thay vào đó, họ có thể sử dụng `AGENTS.md` làm instruction file chung cho các coding tool của mình, miễn là project không chứa file `CLAUDE.md`.
Hỗ trợ AGENTS.md có thể giúp giảm bớt gánh nặng vận hành
Đối với Amit Kumar Jena, Trưởng bộ phận phát triển AI tại công ty tư vấn IT Kanerika, việc có thể sử dụng AGENTS.md cùng với Claude Code có thể giúp "loại bỏ những công việc lặt vặt tốn thời gian" cho các team đang sử dụng nhiều công cụ lập trình khác nhau.
"Trước kia, khi Claude chỉ đọc CLAUDE.md, bất kỳ team nào vận hành nhiều coding agent trên cùng một repository đều phải đồng bộ AGENTS.md bằng tay, hoặc dùng các giải pháp thay thế như tạo symlink hay lệnh import one-line để trỏ Claude sang file khác. Tuy nhiên, những cách làm tạm thời đó chỉ thực sự hiệu quả với các dự án quy mô nhỏ," Jena chia sẻ.
Jena nói thêm: “Trong monorepo (thường gặp ở các codebase lớn), khi instructions được đặt ở nhiều cấp thư mục, việc này trở thành một maintenance debt thực sự. Đặc biệt, dưới áp lực deadline, việc đồng bộ có thể bị bỏ sót và khiến các tool dần sử dụng instructions khác nhau mà không được phát hiện.”
Việc giảm maintenance và operational work nhờ thay đổi này cũng có thể giúp các doanh nghiệp dễ dàng hơn trong việc governance cách AI coding agent được sử dụng giữa các development team.
“Đối với các doanh nghiệp, một format chung cho instruction có thể trở thành đầu mối kiểm soát thiết thực để quản lý các quy tắc coding, yêu cầu bảo mật, các nguyên tắc định hướng kiến trúc và chính sách tuân thủ,” Charlie Dai, chuyên gia phân tích chính tại Forrester, cho biết.
Nhưng không phải mọi Claude Code deployment đều hỗ trợ
Tuy nhiên, format instructions thống nhất không nhất thiết khiến các AI coding agent có thể thay thế hoàn toàn cho nhau, Jena lưu ý: “CLAUDE.md có các tính năng dành riêng cho Claude mà trong thiết kế của AGENTS.md không hỗ trợ. Vì vậy, instructions được viết cho một agent, như Codex, có thể không hoạt động hoàn toàn giống như khi được Claude Code đọc.”
Jena cũng chỉ ra một hạn chế liên quan đến deployment khi Claude Code hỗ trợ AGENTS.md, đồng thời dẫn lại tài liệu của Claude Code:
“Session của bạn không lấy feature flags từ Anthropic, chẳng hạn khi bạn sử dụng Amazon Bedrock hoặc một nhà cung cấp bên thứ ba khác, hoặc khi bạn đã tắt telemetry.”
Theo Shihipar – người đã chia sẻ trên X rằng "người dùng có thể thay đổi cách thức hoạt động thông qua lệnh /config" – Claude Code cho phép người dùng tùy chỉnh các file mà tool sẽ đọc, bao gồm AGENTS.md, CLAUDE.md hoặc cả hai.
Như vậy các team vẫn sẽ sử dụng file AGENTS.md cho các instruction chung áp dụng trên nhiều công cụ lập trình, đồng thời vẫn duy trì file CLAUDE.md cho các instruction dành riêng cho Claude Code.
