Bỏ qua tới nội dung

Công cụ

CLAUDE.md là gì? Bộ luật giúp AI làm việc đúng ý mình

Nguyễn Xuân Hợp · Cập nhật · 7 phút đọc

Tóm nhanh

CLAUDE.md là file luật nằm ở gốc bộ não thứ 2, trợ lý AI đọc nó trước mọi việc. Trong đó ghi mình là ai, bộ não để làm gì, cấu trúc thư mục, giọng văn, luật chống bịa và những việc cấm. Luật phải mọc ra từ cách mình làm việc, giữ gọn, sửa dần, và vì là file của mình nên đổi AI nào cũng mang theo được.

Học viên mới vào lớp tôi, mở thư mục bộ não ra, thấy một file tên lạ hoắc. Câu hỏi đầu tiên luôn là: CLAUDE.md là gì? Có xóa được không?

Không xóa. Đó là file quan trọng nhất trong bộ não thứ 2 của các bạn. Nó là bộ luật. Trợ lý AI đọc nó đầu tiên, mỗi lần làm việc, trước khi đụng vào bất cứ thứ gì.

Tôi giải thích từ đầu, bằng lời người không biết công nghệ cũng hiểu.

CLAUDE.md là gì?

Đơn giản thôi. CLAUDE.md là một file chữ thường, đặt ở gốc thư mục bộ não. Đuôi .md là markdown, kiểu chữ thường có vài ký hiệu như dấu thăng để làm tiêu đề, dấu gạch để liệt kê. Mở bằng Notepad cũng đọc được.

Cái đặc biệt nằm ở tên file. Claude Code, trợ lý AI lớp tôi đang dùng, được làm sẵn để mỗi lần mở một thư mục, nó tìm file tên CLAUDE.md và đọc trước. Đọc xong nó mới biết mình đang ở nhà ai, làm việc cho ai, theo luật gì.

Các trợ lý của hãng khác cũng có file tương tự, chỉ khác tên. Bản chất giống nhau: một tờ giấy dặn việc đặt sẵn trên bàn.

Thử hình dung thế này. Các bạn thuê một trợ lý rất giỏi. Nhưng sáng nào anh ta cũng tỉnh dậy quên sạch hôm qua. Các bạn làm gì? Viết một tờ giấy dán ở cửa: tôi là ai, nhà này làm nghề gì, đồ để đâu, nói năng thế nào, cái gì tuyệt đối không được làm. Sáng nào anh ta cũng đọc tờ giấy đó trước.

CLAUDE.md chính là tờ giấy đó.

Vì sao trợ lý AI cần một bộ luật?

Sơ đồ trợ lý đọc CLAUDE.md trước khi làm việc
Có luật thì không phải dặn lại từ đầu mỗi lần.

Vì mỗi lần mở ra, trợ lý AI gần như bắt đầu lại từ đầu. Nó không tự nhớ các bạn là ai. Cái nó nhớ được là cái nằm trong file.

Không có luật thì sao? Nó vẫn làm, và làm khá giỏi. Nhưng làm theo kiểu số đông. Giọng văn chung chung. Đặt tên file lung tung. Gặp chỗ thiếu thông tin thì tự điền cho tròn. Mỗi lần các bạn lại phải dặn lại từ đầu.

Tôi gọi file này là schema, tức luật làm việc giữa người và máy. Có một điều tôi muốn các bạn hiểu thật kỹ: mình không thiết kế hệ thống AI. Mình thiết kế hệ thống bộ não của chính mình. AI là người đến làm việc trong hệ thống đó, và phải theo luật nhà mình.

Nên ghi gì vào CLAUDE.md?

Tôi bảo học viên ghi bảy thứ. Mỗi thứ vài dòng là đủ.

1. Mình là ai. Tên, nghề, đã làm bao lâu, khách hàng là ai. Không cần dài, phần kể chi tiết đã nằm trong bộ não rồi.

2. Bộ não này để làm gì. Để viết bài bán hàng? Để chăm khách? Để soạn giáo án? Trợ lý biết mục đích thì biết cái gì quan trọng, cái gì bỏ qua được.

3. Cấu trúc thư mục. raw/ là tài liệu thô, chỉ đọc, không sửa. wiki/ là nơi trợ lý viết tri thức. index.md là mục lục. log.md là nhật ký. Ghi rõ để nó không bỏ đồ lung tung.

4. Quy ước đặt tên. Tên file viết thế nào, có dấu hay không dấu, ngày tháng ghi kiểu gì. Nghe vặt vãnh. Nhưng sáu tháng sau có vài trăm file, các bạn sẽ cảm ơn mình.

5. Giọng văn. Mình xưng gì, gọi khách là gì. Câu ngắn hay dài. Những từ mình hay dùng, những từ mình ghét. Đây là chỗ biến bài AI viết thành bài của các bạn.

6. Luật chống bịa. Cái này bắt buộc. Mọi thông tin phải truy được nguồn. Chỗ suy đoán phải ghi rõ "suy đoán". Hai tài liệu nói khác nhau thì ghi cả hai, không tự chọn một.

7. Những việc cấm. Không xóa file khi chưa hỏi. Không gửi gì ra ngoài khi chưa duyệt. Không bịa số liệu, không bịa lời khách khen. Mỗi nghề có những điều cấm riêng, các bạn tự biết nghề mình hơn ai hết.

Một file CLAUDE.md mẫu trông như thế nào?

Đây là một bản mẫu ngắn để các bạn hình dung. Chỗ trong ngoặc vuông là chỗ các bạn tự điền.

# Luật bộ não của [tên các bạn]

## Tôi là ai
Tôi là [tên], [tuổi] tuổi, làm [nghề] được [số] năm.
Khách của tôi chủ yếu là [mô tả khách].

## Bộ não này để làm gì
Lưu tri thức nghề của tôi và giúp tôi viết bài, trả lời khách
đúng cách tôi vẫn làm.

## Thư mục
- raw/: tài liệu thô. Chỉ đọc, không sửa, không xóa.
- wiki/: trang tri thức. Mỗi trang một ý, có liên kết.
- index.md: mục lục. Thêm trang mới thì cập nhật.
- log.md: nhật ký. Mỗi lần nạp, ghi ngày và đã làm gì.

## Đặt tên
Tên file có dấu, đọc là hiểu. Ngày ghi kiểu 2026-11-21.

## Giọng văn
Tôi xưng "tôi", gọi khách là "anh chị".
Câu ngắn, dễ hiểu. Không dùng từ hoa mỹ.

## Chống bịa
- Mọi thông tin phải ghi nguồn lấy từ file nào.
- Chỗ suy đoán ghi rõ: (suy đoán).
- Hai nguồn nói khác nhau thì ghi cả hai.

## Cấm
- Không xóa file khi chưa hỏi tôi.
- Không bịa số liệu, không bịa lời khách.
- Không gửi gì ra ngoài khi tôi chưa duyệt.

Chưa tới ba mươi dòng. Thế là đủ chạy rồi.

Các bạn cũng không cần tự gõ. Mở trợ lý trong thư mục bộ não, gõ: "Hỏi tôi từng câu một để viết file CLAUDE.md cho bộ não này." Nó hỏi, các bạn đáp. Xong đọc lại, chỗ nào không giống mình thì bảo nó sửa.

Vì sao copy CLAUDE.md của người khác về lại không chạy?

Đây là câu tôi phải nói đi nói lại nhiều nhất.

Trên mạng có rất nhiều file CLAUDE.md mẫu, có cái dài cả chục trang. Nhiều bạn tải về, dán vào thư mục, nghĩ thế là xong. Rồi thấy trợ lý làm cứ sai sai, giọng cứ lạ lạ.

Vì sao? Vì đời tôi khác đời bạn.

File CLAUDE.md của tôi có những luật mà người ngoài đọc chẳng hiểu để làm gì. Có cả luật cấm một loại dấu câu tôi không ưa. Mỗi dòng đều mọc ra từ một lần trợ lý làm sai, tôi sửa, rồi ghi lại để lần sau khỏi sửa nữa. Các bạn bê về thì được cái vỏ, không được cái lý do. Mà luật không có lý do của mình thì chỉ là chữ.

Đọc luật của người khác để học cách nghĩ thì được. Bê nguyên về dùng thì không. Nhớ nhá.

Giữ luật gọn và sửa dần như thế nào?

Vòng làm việc: làm, ghi nhật ký, rút thành luật, đóng gói thành kỹ năng
Làm, ghi nhật ký, rút thành luật. Việc lặp lại thì đóng gói thành kỹ năng.

Ngày đầu, CLAUDE.md chỉ cần vài chục dòng như bản mẫu trên. Rồi để nó lớn dần theo cách các bạn làm việc.

Tôi đi theo một vòng thế này: làm một việc, ghi nhật ký, rút thành luật. Việc nào lặp lại nhiều lần thì đóng gói thành một kỹ năng riêng. Việc làm một lần thì không cần luật, không cần kỹ năng.

Cụ thể khi dùng hằng ngày:

  • Trợ lý làm sai một chỗ, các bạn sửa, rồi gõ thêm một câu: "Ghi luật này vào CLAUDE.md để lần sau không lặp lại."
  • Thấy mình dặn đi dặn lại một điều, đó là lúc nên thành luật.
  • Luật nào lâu không dùng tới, hoặc đã thành kỹ năng riêng, thì bỏ khỏi file chính.

Có một cái bẫy: luật cứ dồn mãi, file phình ra mấy chục trang. Trợ lý đọc cái gì dài quá cũng dễ sót. File chính chỉ giữ luật lõi. Chi tiết dài thì đẩy sang file khác trong bộ não, CLAUDE.md chỉ ghi một dòng chỉ đường tới đó. Bộ não muốn khỏi thành bãi rác thì cũng phải sắp xếp, các bạn xem thêm bài phương pháp PARA và CODE.

Giữ file của mình thì đổi AI nào cũng được

Nhiều người hỏi tôi: lỡ mai Claude đắt lên, hay có công cụ khác giỏi hơn thì sao? Học xong có phí không?

Không phí. Vì cái quý không nằm ở công cụ.

CLAUDE.md, raw/, wiki/, index.md, log.md, tất cả đều là file chữ thường nằm trên máy các bạn. Không khóa trong máy chủ của hãng nào. Mai đổi sang trợ lý khác, các bạn chỉ cần bảo nó: "Đọc file CLAUDE.md trong thư mục này trước, đó là luật của tôi." Hoặc đổi tên file cho hợp công cụ mới. Bộ não vẫn nguyên. Luật vẫn nguyên.

Chỉ cần giữ ngữ cảnh và trí nhớ, tức là các file của mình, thì AI nào cũng thay được. Không lệ thuộc một hãng nào cả.

Ai cầm bộ não người đó là chủ. Trao đổi với AI ở đâu cũng được, nhưng nạp thì phải nạp vào bộ não của mình, luật thì phải ghi vào file của mình.

Các bạn chưa có thư mục bộ não thì làm trước theo bài cách xây dựng bộ não thứ 2, rồi quay lại viết CLAUDE.md. Muốn hiểu vì sao phải có bộ não thứ 2 rồi mới giao việc cho Agent, đọc bài bộ não thứ 2 và AI Agent. Bức tranh tổng thì nằm ở trang bộ não thứ 2.

Còn ai muốn có người ngồi soát luật cùng, sửa từng dòng theo đúng nghề mình, thì lớp Ây Zần cho đội zà làm đúng việc đó.

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

CLAUDE.md có bắt buộc phải tên đúng như vậy không?

Với Claude Code thì nên giữ đúng tên CLAUDE.md, viết hoa như thế, đặt ở gốc thư mục, để nó tự tìm và đọc mỗi lần mở. Trợ lý khác có thể dùng tên khác. Nội dung bên trong mới là cái quý, tên file chỉ là cửa vào.

Không biết markdown có viết CLAUDE.md được không?

Được. Markdown chỉ là chữ thường, thêm dấu thăng cho tiêu đề và dấu gạch cho từng ý. Các bạn còn có thể bảo trợ lý phỏng vấn mình rồi tự viết file, mình chỉ đọc lại và sửa chỗ không đúng.

CLAUDE.md nên dài bao nhiêu?

Lúc đầu vài chục dòng là đủ. Về sau thêm dần, nhưng file chính chỉ giữ luật lõi. Phần chi tiết dài thì để ở file khác trong bộ não, CLAUDE.md ghi một dòng chỉ tới đó.

Đổi sang AI khác thì CLAUDE.md còn dùng được không?

Còn. Nó là file chữ thường trên máy các bạn. Sang công cụ mới, các bạn bảo trợ lý đọc file đó trước, hoặc đổi tên cho hợp công cụ. Luật và bộ não vẫn là của các bạn.

Quà tặng

Nhận mẫu bộ não thứ 2 của tôi

Thư mục bộ não thứ 2 dựng sẵn, kèm hướng dẫn từng bước: tải về, mở bằng trợ lý AI, gõ "Xin chào" là bộ não bắt đầu hỏi chuyện để hiểu bạn. Để lại tên, số điện thoại và email, tôi gửi qua email cho bạn, kèm link nhóm Zalo Ây Zần để hỏi khi vướng.

Thông tin của bạn chỉ dùng để gửi tài liệu và hỗ trợ bạn, không chia sẻ cho ai.

Nguyễn Xuân Hợp

Người viết

Nguyễn Xuân Hợp

Nhà đào tạo, Chủ tịch Hội đồng quản lý Viện Phát triển Thể chất và Trí tuệ

Tác giả sách Bán hàng Chuyên gia, Chủ tịch Midu Group. Hơn 20.000 người bán hàng đã học cùng tôi cách sống tốt bằng chuyên môn. Từ giữa năm 2026, tôi dạy những người nhiều trải nghiệm xây bộ não thứ 2 và làm chủ AI Agent, chính tôi cũng đang vận hành công việc hằng ngày bằng bộ não thứ 2 và đội trợ lý AI của mình.

Đọc tiếp

Học xây bộ não thứ 2 cùng Nguyễn Xuân Hợp