---
title: "Dùng AGENTS.md trong Claude Code và Codex"
description: "Codex mặc định đọc AGENTS.md. Claude Code từ phiên bản 2.1.277 đọc file này khi dự án không có CLAUDE.md. Để giữ cả 2, hãy đặt @AGENTS.md vào CLAUDE.md."
canonical: "https://logbrew.co/vi/guides/agents-md"
last_updated: "2026-11-10"
---

# Dùng AGENTS.md trong Claude Code và Codex

Codex mặc định đọc `AGENTS.md`. Claude Code từ phiên bản 2.1.277 đọc file này khi dự án không có `CLAUDE.md`. Để giữ cả 2, hãy đặt `@AGENTS.md` vào `CLAUDE.md`.

Đã thử nghiệm ngày 10 tháng 11, 2026 với Claude Code 2.1.319 và Codex CLI 0.167.0

Tác giả [Furkan Erday](https://github.com/furkanerday). Furkan Erday là nhà sáng lập LogBrew. Anh xây dựng LogBrew bằng Claude Code và Codex mỗi ngày.

Canonical: https://logbrew.co/vi/guides/agents-md

## Khi nào mỗi agent nạp `AGENTS.md`

| Dự án của bạn có | Claude Code | Codex |
| --- | --- | --- |
| Chỉ có `AGENTS.md` | Đã nạp | Đã nạp |
| `AGENTS.md` và `CLAUDE.md` | Bỏ qua | Đã nạp |
| `CLAUDE.md` import `@AGENTS.md` | Đã nạp | Đã nạp |
| `CLAUDE.md` là symlink tới `AGENTS.md` | Đã nạp | Đã nạp |
| `AGENTS.md` và `CLAUDE.local.md` | Bỏ qua | Đã nạp |

Chúng tôi đọc các chỉ dẫn mà mỗi agent gửi kèm request đầu tiên.

## Thiết lập 1 file cho cả 2 agent

### Viết AGENTS.md ở thư mục gốc dự án

Đặt lệnh build, lệnh test và quy tắc code vào 1 file. Cả 2 agent đọc file từ thư mục gốc của repository Git xuống đến thư mục hiện tại.

### Cập nhật Claude Code

Claude Code tự đọc `AGENTS.md` từ phiên bản 2.1.277. Phiên bản cũ hơn cần dòng import ở bước tiếp theo.

```bash
claude update
```

### Import AGENTS.md từ CLAUDE.md

Nếu có `CLAUDE.md`, `.claude/CLAUDE.md` hoặc `CLAUDE.local.md` trong thư mục của bạn hoặc thư mục cha, Claude Code sẽ không đọc `AGENTS.md`. Thêm dòng này vào `CLAUDE.md` để nạp cả 2.

```bash
@AGENTS.md
```

### Hoặc tạo symlink CLAUDE.md tới AGENTS.md

Nếu `CLAUDE.md` chỉ chứa dòng import, hãy thay nó bằng một symlink.

```bash
ln -s AGENTS.md CLAUDE.md
```

### Hoặc nạp cả 2 bằng một cài đặt

Để giữ `CLAUDE.local.md` mà vẫn nạp `AGENTS.md`, thêm đoạn này vào `~/.claude/settings.json`. Trong một phiên, tùy chọn chỉ dẫn dự án trong `/config` đặt cùng giá trị đó.

```bash
{
  "pluginConfigs": {
    "cc-plugin-agents-md@builtin": {
      "options": { "instructionFiles": "claude-md-and-agents-md" }
    }
  }
}
```

### Kiểm tra Codex đã nạp gì

Chạy lệnh này từ thư mục bạn đang làm việc. Tài liệu Codex đưa ra lệnh này để Codex nhắc lại các chỉ dẫn mà nó đã nạp.

```bash
codex --ask-for-approval never "Summarize the current instructions."
```

## Kết quả khi chúng tôi thử nghiệm

Chúng tôi trỏ cả 2 agent tới một máy chủ thử nghiệm cục bộ và đọc các chỉ dẫn mà mỗi agent gửi kèm request đầu tiên. Cách này cho thấy chính xác mỗi agent nạp những file nào.

Claude Code nạp `AGENTS.md` khi dự án không có `CLAUDE.md`, và debug log ghi `no CLAUDE.md found; AGENTS.md loaded`. Khi có `CLAUDE.md` bên cạnh, Claude Code bỏ qua `AGENTS.md`. Với dòng import `@AGENTS.md` hoặc symlink, nội dung `AGENTS.md` xuất hiện đúng 1 lần.

Cài đặt `pluginConfigs` ở trên nạp cả 2 file, kể cả khi dự án có `CLAUDE.local.md`.

Codex nạp `~/.codex/AGENTS.md` trước, rồi `AGENTS.md` ở thư mục gốc, rồi file trong thư mục hiện tại. File `AGENTS.override.md` thay thế `AGENTS.md` trong cùng thư mục. Codex bỏ qua `CLAUDE.md` cho đến khi chúng tôi thêm nó vào `project_doc_fallback_filenames`. Khi có cả 2 file, Codex chỉ nạp `AGENTS.md`, kể cả khi đã đặt fallback.

## AGENTS.md và CLAUDE.md

Codex đọc `AGENTS.override.md` hoặc `AGENTS.md` trong mỗi thư mục, cùng với file chung `~/.codex/AGENTS.md`, mặc định tổng cộng tối đa 32 KiB. Codex chỉ đọc `CLAUDE.md` nếu bạn liệt kê nó trong `project_doc_fallback_filenames`.

Claude Code đọc `CLAUDE.md` trước. Nó chỉ đọc `AGENTS.md` và `.claude/AGENTS.md` khi dự án không có `CLAUDE.md` nào được áp dụng. File cá nhân `~/.claude/CLAUDE.md` không tính, nên nó vẫn được nạp cùng `AGENTS.md`.

## Các báo cáo trên GitHub nói gì

#6235, với 409 bình luận, đề nghị Claude Code hỗ trợ AGENTS.md. Ngày 17 tháng 8 năm 2026, một kỹ sư Anthropic đã đóng báo cáo này kèm cách import và symlink ở trên. Giờ Claude Code tự đọc file này. #31005 đề nghị hỗ trợ thêm `.agents/skills/` và vẫn đang mở.

## Câu hỏi thường gặp

### Claude Code có đọc AGENTS.md không?

Có, từ phiên bản 2.1.277, khi không có `CLAUDE.md`, `.claude/CLAUDE.md` hoặc `CLAUDE.local.md` trong thư mục của bạn hoặc thư mục cha. Chúng tôi đã xác nhận trên bản 2.1.319.

### Nên dùng AGENTS.md hay CLAUDE.md?

Dùng `AGENTS.md` nếu có ai trong nhóm dùng Codex hoặc agent khác. Chỉ giữ `CLAUDE.md` cho các quy tắc riêng của Claude Code, và import `@AGENTS.md` từ file đó.

### Có thể tạo symlink CLAUDE.md tới AGENTS.md không?

Có. Trong lần thử của chúng tôi, Claude Code nạp file được liên kết 1 lần, giống như khi import.

### Codex có đọc CLAUDE.md không?

Mặc định thì không. Thêm `project_doc_fallback_filenames = ["CLAUDE.md"]` vào `~/.codex/config.toml`.

## Đưa lỗi trên production cho agent của bạn

Kết nối máy chủ MCP của LogBrew, và Claude Code hoặc Codex sẽ đọc lỗi, log và trace của các dự án bạn phê duyệt. Bắt đầu với gói miễn phí rộng rãi, không cần thẻ.

[Kết nối agent](https://logbrew.co/vi/agents)

## Nguồn

- [Claude Code docs, How Claude remembers your project](https://code.claude.com/docs/en/memory#agents-md)
- [Codex docs, Custom instructions with AGENTS.md](https://learn.chatgpt.com/docs/agent-configuration/agents-md)
- [anthropics/claude-code#6235](https://github.com/anthropics/claude-code/issues/6235)
- [anthropics/claude-code#31005](https://github.com/anthropics/claude-code/issues/31005)

## Thêm hướng dẫn cho AI agent lập trình

- [Thêm máy chủ MCP vào Claude Code và Codex](https://logbrew.co/vi/guides/mcp-server-claude-code-codex)
- [Khắc phục lỗi Claude overloaded 529 và lỗi rate limit 429](https://logbrew.co/vi/guides/claude-overloaded-rate-limit-error)
- [Cách sửa lỗi trong Claude Code, Codex và JavaScript trên trình duyệt](https://logbrew.co/vi/guides)