Cách tắt bộ nhớ tự động của Claude Code trong một dự án

Để tắt bộ nhớ tự động của Claude Code chỉ cho một dự án, hãy thêm "autoMemoryEnabled": false vào tệp .claude/settings.json của dự án đó. Công tắc trong lệnh /memory không phù hợp với việc này: nó ghi cài đặt vào tệp dùng chung toàn cục và tắt bộ nhớ cho mọi dự án trên máy tính của bạn.

Một tác nhân có thể nhanh chóng trở nên lộn xộn vì những thứ nó không cần. Trong trường hợp được mô tả ở đây, Hermes đã dành 2 giờ suy nghĩ về một nhiệm vụ. Khi được hỏi, “Bạn đã dùng bao nhiêu token?”, nó trả lời, “Ước tính sơ bộ của tôi là 100 triệu.” Bạn đã giải quyết được nhiệm vụ chưa? “Chưa, tôi đang nghiên cứu.” Nó tiếp tục lần lượt xem qua tất cả các tệp và trở nên rối trí.

Đó là lý do bạn chỉ nên đưa những thông tin có giá trị nhất vào bộ nhớ của tác nhân. Và theo đánh giá được nêu ở đây, bộ nhớ tự động của Claude Code khá yếu: rất nhỏ và bị nén mạnh. Nếu muốn Claude chỉ làm việc theo quy tắc của bạn, 1 dòng trong cài đặt dự án là đủ.

Hãy cùng xem bộ nhớ tự động khác CLAUDE.md như thế nào, cách tắt nó và nên làm gì với các ghi chú cũ. Bắt đầu nhé.

Tài liệu tham khảo của Ailoot: ailoot.ai/docs/.

Bộ nhớ tự động khác CLAUDE.md như thế nào?#

CLAUDE.md là tệp hướng dẫn chính do bạn tự viết. Trong mỗi cuộc trò chuyện mới, về cơ bản Claude sẽ hỏi: “Ở đây có gì? Tôi là ai? Tôi nên làm gì?” Khi mọi thứ đã được ghi rõ trong CLAUDE.md, nó sẽ nói: “Được rồi, tôi là chuyên gia. Đã hiểu.”

Claude tự viết bộ nhớ tự động. Bạn nói với nó: “Hãy nhớ luôn trả lời bằng ngôn ngữ tôi muốn,” hoặc “Đừng mã hóa cứng các giá trị; luôn lấy chúng từ cơ sở dữ liệu,” rồi nó tạo một tệp trong thư mục bộ nhớ, kiểu như “đừng làm thế nữa.” Trong các phiên sau, nó sẽ nhớ lại điều đó.

Tất nhiên, không phải lúc nào cũng vậy. Tác nhân vẫn quên, và bạn phải để mắt đến chúng: “Này bạn, lại quên nữa rồi. Chúng ta đã nói chuyện này rồi.” Nó đáp: “Ồ, đúng rồi, tôi nhớ; tôi tìm thấy trong tệp ở đây.” Đó là lý do chúng ta thường đưa mọi thứ quan trọng vào CLAUDE.md thay vì dựa vào bộ nhớ.

Có giải thích chi tiết về những quy tắc nên đưa vào CLAUDE.md trong một bài viết riêng, và về sự khác biệt giữa Memory trong cuộc trò chuyện Claude với CLAUDE.md trong một bài khác.

Nếu bạn xây dựng dự án bằng các tác nhân AI, hãy để tài liệu về những công cụ bạn dùng ở gần trong tầm tay.

Claude tự viết những gì#

Claude Code lưu 4 loại ghi chú:

• user — vai trò, kinh nghiệm và cách làm việc bạn muốn;
• feedback — những điều chỉnh của bạn và các phương pháp bạn đã xác nhận;
• project — công việc hiện tại, thời hạn và các quyết định không thể thấy trong mã;
• reference — nơi tìm thông tin bên ngoài dự án, chẳng hạn như trình theo dõi nhiệm vụ.

Tất cả nằm trong ~/.claude/projects/<project>/memory/. Tệp chính ở đó là MEMORY.md, một mục lục có 1 dòng cho mỗi ghi chú. Khi bắt đầu mỗi phiên, Claude đọc 200 dòng đầu hoặc 25 KB từ tệp này, rồi mở các tệp khác khi cần. Bộ nhớ chỉ nằm trên máy tính của bạn: nó không chuyển sang máy khác hay lên đám mây.

Trong ví dụ được mô tả ở đây, tệp chứa tên và vai trò của người dùng, cùng một quy tắc không mã hóa cứng các giá trị động, tổng cộng chỉ 5–7 dòng. Đây là những quy tắc dành cho chính tác nhân: cách nó nên làm việc.

Bạn có thể lưu kiến thức dự án trong một bộ não thứ hai: các thư mục chứa tệp mà tác nhân đọc thông qua liên kết. Với cách này, bạn nên tạo một kỹ năng “bộ não thứ hai” và để một tệp PDF chứa lệnh cài đặt Hermes cùng bảng “dùng mô hình nào cho nhiệm vụ nào” bên cạnh các tệp dự án.

Cách tắt bộ nhớ tự động cho một dự án#

1. Thêm dòng vào cài đặt dự án

   Thư mục chính của dự án có một thư mục .claude ẩn, bên trong chứa tệp settings.json. Cách dễ nhất là yêu cầu chính Claude Code: “Thêm "autoMemoryEnabled": false vào tệp .claude/settings.json của dự án này và giữ nguyên các cài đặt khác.” Nếu bạn mở thủ công mà tệp chưa tồn tại, hãy tạo tệp với nội dung sau:

   {
     "autoMemoryEnabled": false
   }
   

   Nếu tệp đã có cài đặt, hãy thêm khóa bên cạnh chúng và giữ nguyên phần còn lại. Khi autoMemoryEnabled là false, Claude sẽ không đọc thư mục bộ nhớ cũng như không ghi gì vào đó.

2. Chọn đối tượng áp dụng cài đặt

   .claude/settings.json là tệp dự án dùng chung và áp dụng cho tất cả những người làm việc trong dự án. Nếu chỉ muốn tắt bộ nhớ cho riêng mình, hãy đặt cùng khóa đó trong .claude/settings.local.json: đây là tệp cài đặt cá nhân của bạn cho dự án này.

   Cài đặt dự án được ưu tiên hơn cài đặt toàn cục của bạn. Ngay cả khi bộ nhớ được bật trong ~/.claude/settings.json, giá trị false vẫn có hiệu lực cho dự án này.

3. Khởi động lại Claude Code

   Đóng phiên rồi chạy lại claude trong thư mục dự án. Nhập /status: tệp dự án của bạn sẽ xuất hiện trên dòng Setting sources. Nếu thấy tệp ở đó, Claude đã đọc nó. Bộ nhớ vẫn được bật trong dự án bên cạnh.

Có 2 phương pháp khác, nhưng chúng phục vụ những mục đích khác nhau:

• Biến môi trường CLAUDE_CODE_DISABLE_AUTO_MEMORY=1. Chạy CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 claude sẽ chỉ tắt bộ nhớ cho lần chạy đó và ghi đè khóa trong các tệp cài đặt. Nhưng bạn phải nhập lệnh này mỗi lần.
• Công tắc trong /memory. Công tắc này ghi autoMemoryEnabled vào ~/.claude/settings.json, tệp toàn cục của bạn cho mọi dự án trên máy tính. Dùng nó trong một dự án sẽ khiến bộ nhớ bị tắt ở mọi nơi.

Còn một điều nữa: trong phiên chạy nền, công tắc chỉ có thể tắt bộ nhớ chứ không thể bật lại. Để bật bộ nhớ, hãy dùng phiên bình thường do bạn tự khởi chạy bằng cách chạy claude trong terminal.

Nên làm gì với các ghi chú cũ#

Lệnh /memory liệt kê các tệp bộ nhớ và cho phép bạn mở bất kỳ tệp nào. Chúng là các tệp văn bản thông thường: bạn có thể chỉnh sửa hoặc xóa chúng.

Đừng xóa chúng một cách mù quáng; trước tiên hãy xem bên trong có gì. Trong trường hợp dọn dẹp thư mục quy tắc được mô tả ở đây, tác nhân đã ghi lại thông tin không cần thiết về người dùng trong quá trình tự suy ngẫm. Các quy tắc lộn xộn cũng gây hại như một tệp CLAUDE.md gốc lộn xộn, đầy quy tắc lỗi thời: tác nhân vẫn dùng chúng, ảo giác và đưa ra ngữ cảnh kém hơn cho bạn.

Bạn có thể yêu cầu tác nhân dọn dẹp. Mỗi tuần một lần, bạn có thể giao cho nó một nhiệm vụ như thế này đối với thư mục công việc; cách này cũng áp dụng cho thư mục bộ nhớ:

Nhiệm vụ của bạn là tìm mọi thứ không còn liên quan hoặc đã lỗi thời, đồng thời chứng minh rằng chúng thực sự đã lỗi thời. Bạn chưa được xóa chúng; chỉ tìm và trình bày cho tôi.

Tác nhân sẽ đưa ra danh sách kèm bằng chứng, rồi bạn quyết định xóa gì. Chỉ chuyển những thông tin có giá trị nhất từ ghi chú vào CLAUDE.md. Có giải thích về cách giữ cho hướng dẫn ngắn gọn để Claude làm theo trong một bài viết riêng. Còn cách tổ chức toàn bộ bộ nhớ dự án bằng thư mục và quy tắc được trình bày trong bài viết về bộ não thứ hai.

Bạn đang bật hay đã tắt bộ nhớ tự động? Hãy kiểm tra xem Claude đã ghi nhớ được gì về bạn. Bạn có thể tiếp tục khám phá Ailoot tại ailoot.ai.