Claude Code tự động đọc AGENTS.md khi dự án không có CLAUDE.md

Anthropic vừa phát hành bản cập nhật Claude Code 2.1.277, đánh dấu một thay đổi đáng chú ý về cách công cụ lập trình bằng AI này đọc hướng dẫn dự án. Theo đó, nếu một dự án không có tệp CLAUDE.md, Claude Code sẽ tự động đọc tệp AGENTS.md thay thế.

AGENTS.md — chuẩn chung đang dần được công nhận

Từ trước đến nay, Claude Code sử dụng CLAUDE.md làm nơi lưu trữ các chỉ dẫn dành riêng cho dự án: quy ước code, cách chạy kiểm thử, cấu trúc thư mục hay các lưu ý quan trọng mà lập trình viên muốn tác nhân AI tuân theo.

Trong khi đó, AGENTS.md là một định dạng mở, không gắn với riêng sản phẩm nào, được nhiều công cụ lập trình AI khác nhau sử dụng. Việc Claude Code chấp nhận đọc tệp này đồng nghĩa với việc người dùng không còn phải duy trì hai tệp hướng dẫn song song cho các công cụ khác nhau.

Người dùng có thể bật hoặc tắt hành vi này trong mục "Project instructions" thuộc lệnh /config. Tuy nhiên, tính năng này hiện chưa khả dụng trên các nền tảng Bedrock, Vertex và Foundry.

Đây là một bước đi hợp lý trong bối cảnh thị trường công cụ lập trình AI ngày càng phân mảnh, khi mỗi nhà cung cấp có tệp cấu hình riêng và lập trình viên phải "đối phó" với quá nhiều định dạng khác nhau.

Hàng loạt bản vá quan trọng khác

Bên cạnh thay đổi về AGENTS.md, bản cập nhật 2.1.277 còn mang đến nhiều cải tiến đáng chú ý:

• Bảo mật và quyền hạn: Bổ sung biến môi trường CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1 cho các cổng Claude app chỉ có một proxy chuyển tiếp làm điểm thoát duy nhất. Mọi yêu cầu gửi ra ngoài sẽ chuyển tên máy chủ cho proxy thay vì tự phân giải cục bộ.
• Sửa lỗi treo phiên: Các phiên claude -p và Agent SDK trước đây có thể bị treo không trả kết quả sau lỗi nội bộ; nay chúng báo lỗi rõ ràng và thoát với mã 1.
• Khắc phục lỗi đăng xuất bất ngờ: Tình trạng bị đăng xuất khi một bản Claude Code cũ hơn (ví dụ CLI đi kèm tiện ích IDE) chạy cùng máy đã được xử lý.
• Cải thiện hiệu năng khởi động: Với SDK và chế độ headless (-p), lượt đầu tiên không còn phải chờ tra cứu CLAUDE.md theo từng thư mục.
• Xử lý lỗi rõ ràng hơn: Các công cụ Grep và Glob nay báo lỗi cụ thể khi hệ thống hết tiến trình, bộ nhớ hoặc tệp tin, thay vì trả về "không tìm thấy kết quả" gây nhầm lẫn.

Cải tiến dành cho VS Code và môi trường đám mây

Phiên bản này cũng dành nhiều cập nhật cho tiện ích VS Code:

• Thêm dòng Sign out trong menu bảng điều khiển, cùng lệnh /logout.
• Bổ sung shell chạy nền và các tác vụ đang chạy vào bản đồ tác nhân, mỗi mục có nút Stop riêng.
• Thêm nút Copy response và lệnh /copy.
• Hiển thị chi phí và lượng token đã dùng trong hộp thoại Account & usage đối với các nền tảng không áp dụng giới hạn gói như Vertex, Bedrock, Foundry hay khi dùng API key.

Với Claude Code trên web, Anthropic bổ sung mục Personal và Organization trong bộ chọn môi trường dành cho gói Team và Enterprise, đồng thời cho phép quản trị viên chia sẻ môi trường cá nhân với tổ chức.

Ý nghĩa với lập trình viên Việt Nam

Với cộng đồng lập trình viên Việt Nam — những người thường xuyên làm việc với nhiều công cụ AI khác nhau như Claude Code, Cursor hay các tác nhân lập trình khác — việc hỗ trợ AGENTS.md giúp tiết kiệm đáng kể thời gian thiết lập. Thay vì sao chép cùng một bộ hướng dẫn sang nhiều tệp cấu hình, bạn chỉ cần duy trì một tệp duy nhất.

Bên cạnh đó, các bản vá liên quan đến sandbox và quyền hạn cũng đáng lưu tâm, đặc biệt với những nhóm đang chạy Claude Code trong môi trường CI/CD hoặc máy chủ dùng chung, nơi tính an toàn của việc thực thi lệnh là ưu tiên hàng đầu.