Claude Memory: Memory, CLAUDE.md và Auto Memory
MarkdownBa hệ thống bộ nhớ của Claude: chúng hoạt động ở đâu, cách quản lý cài đặt, nên lưu gì và cách tránh năm lỗi thường gặp.
Đọc toàn bộ bài viết
Điểm chính
Claude có ba hệ thống bộ nhớ trong năm 2026: Memory trong Claude.ai — hoạt động trên đám mây và miễn phí từ tháng 3 năm 2026; CLAUDE.md trong Claude Code — tệp chứa các quy tắc của bạn; Auto Memory — ghi chú của tác nhân về dự án của bạn. Cả ba hoạt động khác nhau và thuộc các sản phẩm khác nhau: Memory không được chuyển sang Claude Code, còn CLAUDE.md không hoạt động trong claude.ai. Bài viết này có bảng so sánh, thời điểm nên bật từng hệ thống, nội dung nên lưu ở đâu và năm lỗi khiến thiết lập không hoạt động.
Hướng dẫn thực hành về cách làm việc với Ailoot có trong tài liệu.
Claude Memory là gì và tại sao có ba lớp?
Điểm chính
Claude có ba lớp bộ nhớ khác nhau trong năm 2026 và chúng nằm trong các sản phẩm khác nhau. Memory hoạt động trong Claude.ai — ứng dụng trò chuyện trên web và di động. CLAUDE.md và Auto Memory hoạt động trong Claude Code — trên máy tính xách tay của bạn thông qua terminal. Chúng không phải cùng một thứ. Memory không được chuyển sang Claude Code, còn CLAUDE.md không hoạt động trong Claude.ai. Khi mọi người nói “Claude quên dự án của tôi”, thường là họ nhầm lẫn nơi lưu từng loại bộ nhớ.
Thứ Ba, bạn mở Claude.ai và kể cho Claude về đối tượng, định dạng câu trả lời và phong cách viết của mình. Thứ Năm, bạn quay lại trong một cuộc trò chuyện mới — và Claude đã nhớ. Đó là Memory đang hoạt động.
Bạn mở Claude Code trong terminal, dành hai tuần tìm hiểu một dự án và giải thích cấu trúc thư mục, quy tắc triển khai cùng các thư viện yêu thích. Bạn đóng phiên làm việc, mở lại sau một giờ — và tác nhân lại bắt đầu từ đầu. Memory không hoạt động ở đây. Để thay đổi điều đó, bạn cần CLAUDE.md.
Một lớp thứ ba xuất hiện vào năm 2026. Auto Memory trong Claude Code nghĩa là tác nhân tự viết ghi chú về dự án của bạn: lệnh nào hoạt động, bài kiểm tra nào đạt, đường dẫn nào trong kho lưu trữ nhạy cảm. Những ghi chú này được lưu cục bộ trên đĩa và tự động tải trong phiên tiếp theo.
Điểm gây nhầm lẫn chính: mọi người nghe nói rằng “Claude giờ đã nhớ” và nghĩ tính năng này tự động hoạt động ở mọi nơi. Không phải vậy. Memory từ claude.ai không được chuyển sang Claude Code — tài liệu Claude Code chính thức mô tả hai cơ chế bộ nhớ, và Chat Memory không phải một trong số đó. CLAUDE.md và Auto Memory hoạt động trong Claude Code — đây là những hệ thống hoàn toàn khác. Anthropic API cũng tương tự: API có công cụ Memory riêng, không liên quan đến bộ nhớ trò chuyện.
Hướng dẫn này trình bày cả ba hệ thống để bạn biết nên lưu gì ở đâu và vì sao Claude đột nhiên “quên” một dự án dù bạn đã “thiết lập bộ nhớ”.
Memory trong Claude.ai là gì và ai được dùng miễn phí vào năm 2026?
Điểm chính
Memory trong Claude.ai là bộ nhớ trên đám mây gắn với tài khoản của bạn. Từ tháng 3 năm 2026, Anthropic cung cấp miễn phí tính năng này trên mọi gói, kể cả Free. Tính năng chỉ hoạt động trong claude.ai và ứng dụng di động. Claude tự động nhận diện thông tin dài hạn từ các cuộc trò chuyện (nghề nghiệp, phong cách trả lời, bối cảnh công việc) và lưu vào hồ sơ Memory của bạn. Quản lý tại Settings → Capabilities → Memory.
Memory thu thập thông tin như thế nào
Anthropic gọi đây là Memory Synthesis. Khoảng một lần mỗi ngày, Claude xử lý các cuộc trò chuyện gần đây của bạn, xác định thông tin nào sẽ hữu ích về lâu dài và ghi các đoạn tóm tắt ngắn vào hồ sơ Memory. Đây không phải những câu trích nguyên văn từ tin nhắn của bạn — mà là các câu cô đọng như “người dùng là nhà tiếp thị, điều hành một dự án trực tuyến và thích câu trả lời ngắn gọn, không lan man”.
Trong cuộc trò chuyện tiếp theo, các bản tóm tắt này được tự động thêm vào đầu ngữ cảnh. Claude biết bạn là ai, làm công việc gì và thích phong cách trả lời nào — mà bạn không cần nhắc lại trong mỗi cuộc trò chuyện.
Những gói nào hỗ trợ Memory
Anthropic triển khai Memory theo từng giai đoạn: ngày 11 tháng 9 năm 2025 — Team và Enterprise; ngày 23 tháng 10 năm 2025 — Pro và Max; ngày 2 tháng 3 năm 2026 — miễn phí trên mọi gói, đồng thời có công cụ nhập dữ liệu từ ChatGPT, Gemini và Grok.
| Gói | Memory hoạt động | Tính năng |
|---|---|---|
| Free | Có | Bản thân Memory đã hoạt động từ tháng 3 năm 2026, nhưng Chat Search (tìm kiếm lịch sử trò chuyện) vẫn chỉ dành cho các gói trả phí |
| Pro ($20/mo) | Có | Memory + Chat Search |
| Max | Có | Memory + Chat Search |
| Team / Enterprise | Có | Gắn với tài khoản nhóm |
| API | Không | Chat Memory không được chuyển tiếp. Có công cụ Memory riêng dành cho nhà phát triển tác nhân |
| Claude Code | Không | Với Claude Code, hãy dùng CLAUDE.md và Auto Memory |
Điều này quan trọng: Memory hoạt động ở nơi có giao diện web hoặc ứng dụng di động Claude.ai. Bất cứ nơi nào bạn dùng Claude thông qua mã của riêng mình hoặc CLI, Memory đều không có.
Xem và chỉnh sửa Memory ở đâu
Trong claude.ai: Settings → Capabilities → Memory. URL trực tiếp: claude.ai/settings/capabilities?modal=memory. Danh sách mọi thứ Claude đã lưu về bạn sẽ mở ra. Có ba nút:
- Pause — Claude giữ lại bộ nhớ đã tích lũy nhưng ngừng sử dụng và bổ sung vào đó.
- Reset memory — xóa mọi thứ.
Sau khi chọn tùy chọn này và nhấp vào 'Reset memory', bạn không thể hoàn tác.
— Anthropic, https://support.claude.com/en/articles/11817273 - Edit individual entries — bạn có thể xóa thủ công từng mục riêng lẻ.
Các thao tác trực tiếp trong cuộc trò chuyện cũng được hỗ trợ: nói với Claude “nhớ X” hoặc “quên Y” — Memory sẽ được cập nhật mà không cần mở Settings.
Một điều quan trọng nữa: các Project trong Claude.ai có bộ nhớ riêng.
Claude tạo bộ nhớ riêng cho từng dự án. Nhờ vậy, kế hoạch ra mắt sản phẩm của bạn vẫn tách biệt với công việc khách hàng, còn các cuộc thảo luận mật vẫn tách biệt với hoạt động thường ngày.
Điều đó có nghĩa là các cuộc trò chuyện bên trong Project không lọt vào Memory chung và ngược lại.
Bạn có thể hỏi trực tiếp Claude
Trong bất kỳ cuộc trò chuyện nào, hãy viết: “Bạn nhớ gì về tôi?” Claude sẽ liệt kê những gì nó nhớ cho cuộc trò chuyện này. Đây là cách nhanh nhất để kiểm tra thông tin nào đã được đưa vào hồ sơ Memory của bạn.
Quyền riêng tư
Anthropic tuyên bố rõ rằng bộ nhớ của bạn chỉ thuộc tài khoản của bạn và không được chia sẻ với người dùng khác. Theo mặc định, Anthropic có thể sử dụng các cuộc trò chuyện của bạn (bao gồm cả những cuộc trò chuyện được đưa vào Memory) để cải thiện mô hình. Bạn có thể tắt tính năng này trong cài đặt Privacy — tại Data Controls.
CLAUDE.md trong Claude Code là gì và khác Memory như thế nào?
Điểm chính
CLAUDE.md là tệp văn bản ở thư mục gốc của dự án mà Claude Code đọc khi bắt đầu mỗi phiên. Bạn viết các quy tắc: dùng công cụ nào, sắp xếp thư mục ra sao và không được làm gì. Khác với Memory, không có thông tin nào được tự động thu thập — bạn quyết định nội dung cần đưa vào. Mỗi dự án có một tệp riêng, không phải một tệp dùng cho toàn bộ tài khoản.
Memory thu thập thông tin về bạn với tư cách một con người — phong cách, sở thích và nghề nghiệp. CLAUDE.md dành cho một dự án cụ thể: kho lưu trữ này, những lệnh này và các quy tắc làm việc với mã. Khác biệt này mang tính căn bản: Memory tổng hợp “tôi là ai nói chung”, còn CLAUDE.md nêu “công việc này được tổ chức như thế nào”.
Claude Code tìm CLAUDE.md ở đâu
Cùng lúc tại bốn vị trí, theo thứ tự ưu tiên từ thấp đến cao:
| Cấp độ | Vị trí | Nội dung nên đặt ở đó |
|---|---|---|
| Toàn tổ chức | /Library/Application Support/ClaudeCode/CLAUDE.md trên Mac, /etc/claude-code/CLAUDE.md trên Linux | Quy tắc công ty áp dụng cho mọi dự án của nhóm |
| Người dùng | ~/.claude/CLAUDE.md | Quy tắc cá nhân áp dụng cho mọi dự án của bạn |
| Dự án | ./CLAUDE.md tại thư mục gốc dự án | Tệp chính — dành riêng cho dự án và được commit vào git |
| Cục bộ | ./CLAUDE.local.md | Ghi chú dự án riêng của bạn, không được commit vào git |
Cả bốn tệp đều được tải cùng lúc và nối lại với nhau; chúng không ghi đè lẫn nhau.
Tất cả các tệp được phát hiện đều được nối vào ngữ cảnh thay vì ghi đè lẫn nhau. Trong cây thư mục, nội dung được sắp xếp từ thư mục gốc của hệ thống tệp xuống thư mục làm việc của bạn.
Thứ tự đi từ phạm vi rộng đến phạm vi hẹp. Project và Local nằm cuối — vì vậy chúng xuất hiện ở cuối ngữ cảnh, gần yêu cầu hơn. Đó là lý do bạn nên đặt mọi thông tin quan trọng trong CLAUDE.md của dự án.
Những nội dung thường được đưa vào
- Công nghệ của dự án — Next.js / Prisma / PostgreSQL / Redis
- Lệnh — cách chạy kiểm thử, build và triển khai
- Đường dẫn nhạy cảm — thư mục nào không được đụng đến nếu không có yêu cầu rõ ràng
- Quy ước — phong cách commit, định dạng đặt tên tệp
- Quy tắc kinh doanh — những điều quan trọng với dự án (ví dụ: không bao giờ hardcode giá)
- Con trỏ ngữ cảnh — “xem
docs/business/để biết logic kinh doanh; xemdocs/design/để biết hệ thống thiết kế” (bạn tự chọn tên thư mục; điều quan trọng là không nhồi nhét mọi thứ vào một tệp)
Để xem hướng dẫn đầy đủ, hãy tham khảo hướng dẫn về CLAUDE.md có mẫu sẵn dùng.
CLAUDE.md KHÁC Memory như thế nào
| Tính năng | Memory (Claude.ai) | CLAUDE.md (Claude Code) |
|---|---|---|
| Nơi lưu trữ | Đám mây Anthropic | Tệp trong kho lưu trữ của bạn |
| Ai viết | Claude tự động | Bạn |
| Gắn với | Tài khoản của bạn | Một dự án cụ thể |
| Hoạt động ở đâu | claude.ai + ứng dụng di động | Claude Code trong terminal |
| Cách xem nội dung | Settings → Memory | Mở tệp bằng trình chỉnh sửa |
| Cách cập nhật | Memory Synthesis mỗi ngày một lần | Bạn chỉnh sửa thủ công |
| Lệnh cập nhật | Bảo Claude hoặc xóa qua Settings | /memory trong Claude Code |
Nói ngắn gọn: Memory là trí nhớ của bạn; CLAUDE.md là hướng dẫn dự án được dán trên tường văn phòng.
Auto Memory trong Claude Code là gì và được lưu ở đâu?
Điểm chính
Auto Memory là tính năng mới của Claude Code từ năm 2026. Tác nhân tự viết ghi chú về dự án vào thư mục cục bộ ~/.claude/projects/[project-name]/memory/ — chẳng hạn lệnh nào hoạt động, đường dẫn nào trong kho lưu trữ nhạy cảm và những vấn đề nào đã gặp phải. Khác với CLAUDE.md (nơi bạn viết quy tắc), Auto Memory được tự động điền. Tệp ghi chú lưu cục bộ; văn bản được chọn được nạp vào ngữ cảnh mô hình. Nó bổ sung CLAUDE.md, không thay thế.
Auto Memory khác CLAUDE.md như thế nào
CLAUDE.md chứa hướng dẫn của bạn. Auto Memory chứa ghi chú mà tác nhân viết cho chính nó. Đây là hai loại nội dung khác nhau.
Bạn tự viết CLAUDE.md: “luôn trả lời bằng ngôn ngữ người dùng ưa thích”, “triển khai bằng npm run deploy”, “không đụng đến thư mục legacy/”. Đây là những quy tắc bạn đặt ra từ trước.
Auto Memory là những gì Claude học được trong quá trình làm việc. Claude chạy một bài kiểm thử nhưng thất bại vì thiếu gói — Claude ghi lại: “trong dự án này, hãy chạy npm install trước khi kiểm thử”. Nó sẽ không lặp lại lỗi tương tự ở phiên tiếp theo.
Nơi lưu trữ
Trên đĩa cục bộ, trong một thư mục riêng cho từng dự án:
~/.claude/projects/[project-name]/memory/
Tệp chính bên trong là MEMORY.md. Một chi tiết quan trọng: Claude Code tải toàn bộ CLAUDE.md, nhưng MEMORY.md có giới hạn — chỉ tải 200 dòng đầu tiên hoặc 25KB, tùy điều kiện nào đến trước. Giới hạn này giúp Claude không bị ngập trong những ghi chú của chính nó tích lũy qua nhiều tháng làm việc. Ghi chú lưu bền ở thư mục cục bộ ngoài kho dự án. Văn bản được nạp trở thành ngữ cảnh hội thoại gửi dịch vụ mô hình đã cấu hình; lưu cục bộ không hứa xử lý ngoại tuyến. Không đặt bí mật ở các tệp này.
Khi nào tính năng hoạt động
Auto Memory hoạt động trong Claude Code từ phiên bản v2.1.59+ và được bật theo mặc định trong các bản cài mới. Để kiểm tra trạng thái và quản lý, hãy dùng lệnh:
/memory
Lệnh này mở trình chỉnh sửa cho mọi lớp bộ nhớ — cả CLAUDE.md và MEMORY.md. Bạn có thể xem Claude đã ghi lại gì về dự án, chỉnh sửa hoặc xóa nội dung. Để tắt hoàn toàn Auto Memory, đặt autoMemoryEnabled: false trong ~/.claude/settings.json hoặc dùng biến môi trường CLAUDE_CODE_DISABLE_AUTO_MEMORY=1.
Những nội dung thường được lưu
- Các lệnh đã chạy thành công hoặc thất bại
- Cấu trúc dự án mà tác nhân đã tìm hiểu
- Các kiểu thực hành không nên làm mà tác nhân gặp phải
- Tên các tệp và hàm quan trọng
Tài liệu Claude Code chính thức của Anthropic mô tả trực tiếp sự khác biệt này:
Tệp CLAUDE.md: hướng dẫn do bạn viết để cung cấp ngữ cảnh lâu dài cho Claude. Auto memory: ghi chú do Claude tự viết dựa trên các chỉnh sửa và sở thích của bạn.
Nói cách khác: CLAUDE.md = hướng dẫn do bạn viết. Auto Memory = ghi chú Claude tự viết cho mình dựa trên các chỉnh sửa và sở thích của bạn.
Memory hay CLAUDE.md: hệ thống nào phù hợp với từng việc?
Điểm chính
Nếu bạn làm việc trong trình duyệt trên claude.ai, bạn cần Memory để Claude nhớ bạn là ai với tư cách người dùng. Nếu bạn làm việc trên dự án bằng Claude Code, bạn cần CLAUDE.md để Claude nhớ các quy tắc dự án, cùng Auto Memory làm lớp nền. Các hệ thống này không cạnh tranh với nhau — chúng giải quyết các vấn đề khác nhau trong các sản phẩm khác nhau. Memory không được chuyển sang Claude Code và CLAUDE.md không hoạt động trong claude.ai.
Ma trận quyết định
| Tình huống | Nên bật gì |
|---|---|
| Tôi trò chuyện với Claude trong trình duyệt về nhiều chủ đề | Memory |
| Tôi làm việc trên một dự án bằng Claude Code trong terminal | CLAUDE.md (nền tảng) + Auto Memory (chạy nền) |
| Tôi có nhiều dự án trong Claude Code | CLAUDE.md trong từng dự án + Auto Memory |
| Tôi dùng Claude qua API trong mã của mình | Cả hai đều không hoạt động — thêm quy tắc thủ công vào system prompt |
| Tôi muốn Claude nhớ phong cách viết của mình | Memory trong Claude.ai |
| Tôi muốn Claude nhớ cấu trúc dự án | CLAUDE.md trong dự án |
Memory và CLAUDE.md không trùng lặp chức năng. Chúng hoạt động trong các sản phẩm khác nhau và lưu những nội dung khác nhau. Chúng giống như lịch cá nhân và chính sách công ty — cả hai đều hữu ích, nhưng không ai nhầm chúng với nhau.
Khi nào nên bật Memory: 3 tình huống thực sự hữu ích
Điểm chính
Memory trong claude.ai hữu ích trong ba tình huống làm việc: bạn thường xuyên trao đổi về nhiều chủ đề và không muốn giới thiệu bản thân mỗi lần; bạn viết nhiều nội dung ngắn theo cùng một phong cách; hoặc Claude cần nhớ bối cảnh vai trò của bạn. Nếu chủ yếu làm việc qua Claude Code, bạn không cần Memory vì tính năng này không hoạt động ở đó.
Tình huống 1. Bạn dùng claude.ai như trợ lý cá nhân
Bạn viết cho Claude mỗi ngày: viết lại email, phân tích bảng tính, nghĩ ý tưởng. Chủ đề thay đổi, nhưng bạn vẫn là cùng một người. Memory giúp bạn không phải nói: “Chào, tôi là nhà tiếp thị, tôi điều hành một dự án trực tuyến và tôi thích kiểu trả lời này”.
Sau một tuần sử dụng, Claude biết nghề nghiệp, định dạng trả lời, định dạng yêu thích, độ dài và giọng điệu của bạn. Mỗi cuộc trò chuyện mới đều bắt đầu với những thông tin đó. Bạn tiết kiệm 30–60 giây cho mỗi cuộc trò chuyện.
Tình huống 2. Bạn viết nhiều nội dung theo cùng một phong cách
Quảng cáo, bài đăng mạng xã hội, bản tin email — tất cả đều dùng cùng một giọng thương hiệu. Memory sẽ học phong cách của bạn: không nên dùng từ nào, nên dùng giọng điệu nào và các đoạn văn nên dài bao nhiêu.
Trong khoảng vài tuần, hãy nói với Claude một lần: “bài viết của chúng ta không dùng em dash, giọng thân thiện, không quá 3 đoạn”. Nội dung này sẽ được ghi lại. Sau đó, mỗi nội dung mới sẽ đúng phong cách của bạn mà không cần nhắc lại.
Tình huống 3. Bạn cần bối cảnh về vai trò
Bạn là nhà thiết kế dùng bộ công cụ cụ thể — Figma + Sketch chứ không phải Photoshop. Bạn là quản lý sản phẩm SaaS chứ không phải thương mại điện tử.
Memory sẽ ghi nhận bối cảnh vai trò này và tự động điều chỉnh câu trả lời cho phù hợp. Ít câu trả lời chung chung hơn, nhiều câu trả lời phù hợp với công việc cụ thể của bạn hơn.
Khi không cần Memory
Nếu chủ yếu làm việc với Claude Code trong terminal, Memory chẳng giúp ích gì. Tính năng này đơn giản là không hoạt động ở đó. Hãy dùng CLAUDE.md thay thế và đừng nhầm lẫn hai hệ thống.
Nếu bạn dùng Claude qua API trong mã của mình, tính năng cũng không hoạt động ở đó. Hãy thêm hướng dẫn thủ công vào system prompt.
Nếu bạn chỉ có một loại công việc và không ngại nhắc lại bối cảnh khi bắt đầu mỗi cuộc trò chuyện, Memory không phải thiết yếu. Đây là tiện ích, không phải yêu cầu bắt buộc.
Nên đưa gì vào CLAUDE.md và Auto Memory sẽ tự ghi nhận điều gì?
Điểm chính
Đưa các quy tắc ổn định vào CLAUDE.md — những điều không thay đổi giữa các phiên: bộ công nghệ, quy ước, đường dẫn nhạy cảm và logic kinh doanh. Auto Memory tự thu thập các chi tiết thay đổi — lệnh nào đã hoạt động, những điểm cần lưu ý ở đâu và cấu trúc dự án như thế nào. Quy tắc rất đơn giản: điều gì luôn phải hoạt động, không có ngoại lệ, thì đưa vào CLAUDE.md. Điều gì Claude có thể tự học trong quá trình làm việc thì để trong Auto Memory.
Những gì phải đưa vào CLAUDE.md
- Mô tả dự án trong một đoạn — dự án là gì, dành cho ai và vì sao.
- Công nghệ của dự án — dùng những framework, thư viện và cơ sở dữ liệu nào.
- Lệnh — kiểm thử, build, xuất bản. Ghi chính xác các lệnh.
- Thư mục nhạy cảm — những nơi không được đụng đến nếu không có yêu cầu rõ ràng.
- Quy ước — phong cách commit, định dạng đặt tên tệp, ngôn ngữ trả lời.
- Con trỏ ngữ cảnh — ví dụ: “logic kinh doanh nằm trong
docs/business/; thiết kế nằm trongdocs/design/”. Bạn tự chọn tên thư mục.
Những gì nên để Auto Memory ghi lại
- Chi tiết môi trường cục bộ — trên máy này, Python nằm tại
/usr/local/bin/python3.11. - Thay đổi của dự án — lệnh nào thất bại hôm qua và vì sao.
- Phát hiện trong quá trình làm việc — bài kiểm thử cho một mô-đun cụ thể nằm ở đâu.
- Mẹo quy trình làm việc — sau bước nào thì chạy tập lệnh nào.
Những gì không nên có trong cả hai
- API key, mật khẩu và token — chúng thuộc về
.env, không phải tệp bộ nhớ. - Dữ liệu cá nhân của khách hàng.
- Thông tin có thể sớm lỗi thời (giá cả, ngày của nhóm khách hàng, chiến dịch tạm thời).
- Prompt cho các việc chỉ làm một lần — chúng làm ngữ cảnh trở nên lộn xộn.
Quy tắc 200 dòng
Anthropic khuyến nghị trong tài liệu nên giữ CLAUDE.md ở khoảng 100–200 dòng. Sau 200 dòng, Claude bắt đầu đọc kém hiệu quả hơn — ngữ cảnh dài tiêu tốn tài nguyên và làm giảm độ chính xác. Khi tệp phát triển, hãy chuyển các phần sang những tệp .md riêng ở gần đó và để lại các con trỏ ngắn trong CLAUDE.md: “xem docs/code-style.md để biết phong cách mã”.
Để xem phân tích chi tiết về cấu trúc tệp, hãy đọc hướng dẫn Second Brain cho Claude Code, giải thích cách cấu trúc mở rộng từ CLAUDE.md thành năm thư mục ngữ cảnh.
5 lỗi nào làm hỏng bộ nhớ Claude và cách tránh chúng?
Điểm chính
Những lỗi chính khi sử dụng bộ nhớ Claude trong năm 2026: nhầm Memory với CLAUDE.md, quên rằng tên tệp phân biệt chữ hoa chữ thường, giữ CLAUDE.md quá lớn, đưa bí mật vào tệp và mong Auto Memory tự ghi lại những điều chỉ tồn tại trong đầu bạn. Mỗi lỗi làm hỏng thiết lập theo cách riêng — khiến Claude có vẻ “ngốc”, dù vấn đề nằm ở cấu hình.
Lỗi 1. Nhầm Memory với CLAUDE.md
Đây là lỗi phổ biến nhất. Ai đó nghe nói rằng “Claude giờ đã nhớ”, bật Memory trong claude.ai, rồi mở Claude Code trong terminal và thắc mắc vì sao tác nhân lại “quên”.
Memory trong claude.ai không được chuyển sang Claude Code. Đây là hai sản phẩm khác nhau với kiến trúc khác nhau. Nếu muốn Claude nhớ dự án trong terminal, hãy viết CLAUDE.md. Nếu muốn Claude nhớ bạn trong trình duyệt, hãy bật Memory.
Cách tránh. Trước khi thiết lập bộ nhớ, hãy quyết định nơi bạn làm việc chủ yếu. Nếu là claude.ai, hãy dùng Memory. Nếu là Claude Code, hãy dùng CLAUDE.md và Auto Memory. Nếu dùng cả hai, hãy cấu hình cả hai hệ thống thay vì tìm cách kết hợp chúng.
Lỗi 2. Quên rằng tên tệp phân biệt chữ hoa chữ thường
Tên tệp CLAUDE.md phân biệt chữ hoa chữ thường. Tác nhân sẽ đọc CLAUDE.md viết hoa. Nó sẽ không đọc claude.md hay Claude.md. Điều tương tự cũng áp dụng cho CLAUDE.local.md. Đây là lỗi thường gặp khi người dùng thiết lập Claude Code lần đầu: họ tạo tệp, viết hướng dẫn, rồi thắc mắc vì sao không hoạt động — nhưng tên tệp lại viết thường.
Cách tránh. Kiểm tra chữ hoa chữ thường trước khi lưu. Trên Mac, chọn tệp trong Finder rồi nhấn Enter — tên đầy đủ sẽ hiện ra. Trong terminal: ls -la CLAUDE*. Nếu thấy claude.md, hãy đổi tên: mv claude.md CLAUDE.md.
Lỗi 3. CLAUDE.md đã dài đến 800 dòng
Bạn nhận được một mẫu có sẵn, thêm mọi quy tắc có vẻ quan trọng và cuối cùng có một tệp 800 dòng. Giờ Claude mất nhiều thời gian hơn để đọc, nhưng chất lượng câu trả lời lại giảm. Ngữ cảnh dài chiếm dụng sự chú ý của mô hình.
Cách tránh. Giữ CLAUDE.md ở khoảng 100–200 dòng. Sau 200 dòng, chuyển các phần sang những tệp .md riêng và để lại con trỏ trong CLAUDE.md: “xem docs/code-style.md để biết phong cách mã”. Đây là nguyên tắc giống như mọi tài liệu dành cho con người — đừng nhồi nhét mọi thứ vào một tệp.
Lỗi 4. Giữ bí mật trong CLAUDE.md hoặc Auto Memory
Không được để API key, mật khẩu và token trong tệp bộ nhớ. CLAUDE.md thường được commit vào git nên bí mật sẽ rò rỉ vào kho lưu trữ. Auto Memory được lưu cục bộ, nhưng nội dung có thể xuất hiện trong ảnh chụp màn hình, cuộc trò chuyện được chia sẻ hoặc bị rò rỉ qua máy chủ MCP có quyền truy cập đĩa.
Cách tránh. Giữ bí mật trong .env (và thêm .env vào .gitignore). Trong CLAUDE.md, chỉ đề cập đến tên biến: “API key nằm trong STRIPE_KEY; lấy từ .env.”
Lỗi 5. Mong Auto Memory tự tìm hiểu logic kinh doanh của bạn
Auto Memory thu thập các quan sát kỹ thuật — lệnh, lỗi và cấu trúc. Nó sẽ không tự học các quy tắc kinh doanh (“đối với đại lý bất động sản, không nhận đơn hàng dưới một ngưỡng nhất định”, “không dùng một số từ nhất định trong bài viết”). Những nội dung đó thuộc về CLAUDE.md hoặc các tệp .md riêng được CLAUDE.md tham chiếu.
Cách tránh. Hãy tách chúng ra: chi tiết kỹ thuật tự động được đưa vào Auto Memory. Quy tắc kinh doanh, phong cách và quy ước được đưa thủ công vào CLAUDE.md. Đừng mong một hệ thống thay thế hệ thống kia.
Cách thiết lập Memory + CLAUDE.md trong một buổi tối (hướng dẫn từng bước)?
Điểm chính
Bạn có thể thiết lập toàn bộ trong 30–40 phút: bật Memory trong Claude.ai, tạo CLAUDE.md trong dự án và kiểm tra Auto Memory hoạt động. Sau đó, tiếp tục tinh chỉnh thủ công: mỗi khi tác nhân mắc lỗi, thêm một dòng vào CLAUDE.md ghi “đừng làm vậy”. Sau một tháng, bạn sẽ có một “hiến chương dự án” luôn được cập nhật.
Bật Memory trong Claude.ai. Mở Settings → Capabilities → Memory. Bật công tắc. Kiểm tra ngay phần cài đặt Privacy — quyết định có cho phép Anthropic dùng các cuộc trò chuyện của bạn để huấn luyện mô hình hay không. Quyết định là của bạn.
Trò chuyện với Claude về bản thân bạn. Trong 2–3 cuộc trò chuyện tiếp theo, hãy nói bạn là ai, làm gì và thích kiểu trả lời nào. Memory Synthesis sẽ ghi lại thông tin này trong vòng một ngày.
Kiểm tra thông tin đã ghi vào ngày hôm sau. Trong bất kỳ cuộc trò chuyện nào, hãy viết: “Bạn nhớ gì về tôi?” Claude sẽ liệt kê những gì nó nhớ. Nếu không thích điều gì, hãy xóa qua Settings → Memory hoặc yêu cầu Claude quên điều đó.
Tạo CLAUDE.md trong dự án. Tạo tệp có tên
CLAUDE.md(chữ in hoa) tại thư mục gốc của dự án chính. Lấy mẫu có sẵn trong hướng dẫn về CLAUDE.md — mẫu có 6 phần và độ dài khuyến nghị khoảng 200 dòng, theo Anthropic.Điền thông tin dự án vào các phần. Mô tả công nghệ, lệnh, đường dẫn nhạy cảm và quy ước. Không quá 200 dòng — sau đó Claude sẽ đọc kém hiệu quả hơn.
Kiểm tra Auto Memory. Trong Claude Code, nhập lệnh
/memory. Trình chỉnh sửa cho mọi lớp sẽ mở ra. Auto Memory là một trong số đó. Đọc những gì Claude đã biết về dự án của bạn.Commit CLAUDE.md vào git. Đây là một phần của dự án. Nếu làm việc theo nhóm, mọi người sẽ thấy các quy tắc.
Tiếp tục làm việc như bình thường. Sau mỗi lỗi của tác nhân, thêm một dòng vào CLAUDE.md ghi “đừng làm vậy”. Sau một tháng, bạn sẽ có một bộ quy tắc luôn được cập nhật và Claude sẽ không còn mắc lại những lỗi quen thuộc.
Điều gì không hoạt động: 3 kiểu thông tin mà bộ nhớ Claude không lưu giữ
Điểm chính
Bộ nhớ Claude trong cả ba hệ thống đều không lưu trạng thái phiên đang hoạt động khi đổi mô hình, ngữ cảnh của những tệp bạn chưa chủ động cho tác nhân xem, hoặc các lệnh riêng tư bạn đưa bằng giọng nói hay qua điện thoại. Đây là giới hạn kiến trúc, không phải lỗi. Biết trước những giới hạn này sẽ giúp bạn tránh thất vọng.
Trạng thái phiên không được giữ lại khi đổi mô hình
Bạn làm việc trong Claude Code với Opus 4.8 rồi chuyển sang Sonnet 4.6 — ngữ cảnh phiên có thể được đặt lại vì các mô hình có cửa sổ ngữ cảnh khác nhau. CLAUDE.md và Auto Memory sẽ tự động tải trong phiên mới, nhưng cuộc thảo luận đang diễn ra thì không.
Các tệp bạn chưa cho xem sẽ không được tải
Claude chỉ thấy nội dung trong CLAUDE.md, những gì nằm trong Auto Memory và những gì bạn chủ động mở trong phiên hiện tại. Nếu dự án có 500 tệp và bạn viết “xem cách tôi xử lý thanh toán”, tác nhân không biết cần kiểm tra tệp nào. Bạn phải cung cấp đường dẫn cụ thể hoặc thêm con trỏ vào CLAUDE.md.
Memory không hoạt động với các cuộc trò chuyện dùng API một lần
Mỗi yêu cầu đến Claude API là độc lập. Không có bộ nhớ nào được tải. Nếu xây chatbot qua API, bạn phải tự truyền system prompt và lịch sử tin nhắn. Memory, CLAUDE.md và Auto Memory không giúp được việc này.
Tiếp theo: bộ nhớ là điểm khởi đầu cho Second Brain
Điểm chính
Bộ nhớ Claude là bước đầu để xây dựng Second Brain xoay quanh một dự án. CLAUDE.md đặt ra quy tắc, Auto Memory thu thập các thay đổi kỹ thuật, nhưng giá trị thực sự xuất hiện khi bạn thêm các thư mục chứa bối cảnh kinh doanh bên cạnh chúng — đối tượng, kinh tế và sản phẩm. Khi đó, Claude bắt đầu viết “các giải pháp chất lượng nói chung” phù hợp với nhiệm vụ cụ thể của bạn.
CLAUDE.md và Auto Memory giúp Claude ghi nhớ cách tổ chức mã. Như vậy là đủ cho các việc kỹ thuật: tái cấu trúc, sửa lỗi, di chuyển và kiểm thử.
Nhưng ngay khi cần đưa ra quyết định kinh doanh — gửi email cho ai, diễn đạt đề nghị thế nào, đặt mức giá nào — bộ nhớ kỹ thuật là chưa đủ. Bạn cần ngữ cảnh: khách hàng của bạn là ai, họ đưa ra quyết định như thế nào và kinh tế doanh nghiệp hoạt động ra sao.
Đó là Second Brain — một thư mục kiến thức kinh doanh nằm cạnh dự án, để Claude truy cập thông qua các con trỏ trong CLAUDE.md. Có bộ nhớ về mã và bộ nhớ về doanh nghiệp — tác nhân sẽ thôi là “trợ lý thông minh hay bịa” và trở thành người đồng sáng tạo với bạn.
Nguồn
- Claude Code Docs - Memory - tài liệu chính thức về CLAUDE.md và Auto Memory
- Anthropic - Bringing memory to Claude - thông báo về tính năng Memory trong Claude.ai (tháng 9 năm 2025)
- Anthropic Support - Memory and Chat Search - cách sử dụng Memory trong Claude.ai
- Claude Code Docs - Settings - cài đặt Claude Code (autoMemoryEnabled và các tùy chọn khác)
- Claude Code on GitHub - mã nguồn và nhật ký thay đổi
Tiếp tục khám phá Ailoot tại ailoot.ai.
Xem thêm chi tiết
Câu hỏi thường gặp
Vì sao bật Memory trên Claude.ai không khôi phục ngữ cảnh dự án terminal?
Memory của Claude.ai và tệp dự án Claude Code là hai hệ thống riêng. Với Claude Code, cung cấp hướng dẫn qua CLAUDE.md và xem ghi chú Auto Memory riêng bằng /memory.
Auto Memory có an toàn để chứa khóa API vì tệp cục bộ không?
Không. Ghi chú nạp trở thành ngữ cảnh mô hình và công cụ có quyền đĩa cũng có thể đọc. Không để khóa hay mật khẩu trong Auto Memory hoặc CLAUDE.md; lưu bí mật riêng, chỉ ghi tên biến.