Một tệp văn bản thuần túy vừa thay đổi mãi mãi cách các nhà phát triển sử dụng AI để viết code.
Không phải một mô hình mới.
Không phải một IDE đắt tiền.
Không phải một startup "AI agent" nào khác.
Chỉ một tệp duy nhất:
CLAUDE.md
Và nó lặng lẽ trở thành một trong những thiết lập dành cho nhà phát triển phát triển nhanh nhất trên GitHub.
Hơn 82.000 sao.
Hàng nghìn bản fork.
Các kỹ sư từ startup đến đội ngũ doanh nghiệp copy nó vào dự án của họ chỉ sau một đêm.
Bởi vì các nhà phát triển cuối cùng cũng nhận ra một điều:
Claude Code không thất bại vì mô hình yếu.
Nó thất bại vì mỗi phiên làm việc đều bắt đầu với chứng hay quên.
Mỗi lần bạn mở Claude Code, nó quên:
• stack của bạn
• các quyết định kiến trúc của bạn
• quy ước đặt tên của bạn
• tiêu chuẩn code của bạn
• những gì đã thất bại vào tuần trước
• những gì KHÔNG BAO GIỜ được thay đổi
• tại sao bạn chọn framework này thay vì framework kia
• những tệp nào quá rủi ro để động vào
Vì vậy, mô hình làm những gì mọi AI làm khi không có ngữ cảnh:
Nó phỏng đoán.
Và những phỏng đoán đó trở nên cực kỳ đắt đỏ.
Bạn yêu cầu nó sửa một hàm.
Nó viết lại ba tệp.
Đổi tên các biến mà bạn cố tình chọn.
Tái cấu trúc code đang hoạt động.
Đề xuất các công cụ không tương thích với kiến trúc của bạn.
Xóa những thứ "để dọn dẹp."
Thay đổi định dạng mà không ai yêu cầu nó động vào.
Sau đó, bạn dành hàng giờ tiếp theo để hoàn tác những "sự giúp đỡ" đó.
Đó là khoản thuế ngầm của việc viết code bằng AI mà không ai nói đến.
Một quản lý kỹ thuật ước tính nhóm của họ đã mất gần 8 giờ mỗi tuần chỉ vì:
→ giải thích lại ngữ cảnh dự án
→ hoàn tác các thay đổi trái phép
→ sửa các giả định sai
→ dạy lại các quyết định kiến trúc
→ ngăn chặn sự leo thang phạm vi
Đó không phải là vấn đề của AI.
Đó là vấn đề về trí nhớ.
Và CLAUDE.md khắc phục nó theo cách đơn giản nhất có thể.
Nó chỉ là một tệp văn bản thuần túy được đặt trong thư mục gốc của dự án bạn.
Nhưng Claude tự động đọc nó khi bắt đầu mỗi phiên làm việc.
Có nghĩa là AI của bạn cuối cùng cũng bắt đầu với ngữ cảnh thay vì hỗn loạn.
Sự khác biệt là rất lớn.
Không có CLAUDE.md:
"Trợ lý AI"
Với CLAUDE.md:
"Kỹ sư đã biết dự án của bạn."
Tệp này thường chứa 3 lớp.
━━━━━━━━━━━━━━━
- QUY TẮC MẶC ĐỊNH ━━━━━━━━━━━━━━━
Phần này dạy Claude cách bạn làm việc.
Phản hồi nên chi tiết đến mức nào.
Stack của bạn trông như thế nào.
Cách bạn giao tiếp.
Bạn đã biết bao nhiêu ngữ cảnh.
Nên sử dụng phong cách viết nào.
Những điều KHÔNG NÊN làm.
Những thứ như:
→ không sử dụng cụm từ đệm
→ giữ câu trả lời tương xứng với độ phức tạp của nhiệm vụ
→ hỏi trước khi đưa ra giả định
→ không bao giờ giải thích quá kỹ các khái niệm cơ bản
→ khớp chính xác phong cách code của tôi
→ tự động tuân theo các ràng buộc của dự án
Nghe có vẻ nhỏ nhặt.
Nhưng qua hàng trăm prompt?
Điều này loại bỏ sự lặp lại rất lớn.
Hầu hết các nhà phát triển vô tình dành 20–40 phút mỗi ngày để dạy lại ngữ cảnh cho AI.
Mỗi. Một. Phiên. Làm. Việc.
Bây giờ hãy nhân điều đó lên trong một đội ngũ kỹ thuật.
Đó là hàng nghìn đô la mỗi tháng bị lãng phí chỉ vì lặp lại chính mình.
━━━━━━━━━━━━━━━
- KIỂM SOÁT HÀNH VI
━━━━━━━━━━━━━━━
Đây là phần mà các nhà phát triển ước gì họ có từ nhiều tháng trước.
Bởi vì đây là nơi bạn ngăn Claude trở nên "phá hoại một cách sáng tạo."
Bạn xác định các ranh giới cứng như:
→ chỉ chạm vào các tệp liên quan trực tiếp đến nhiệm vụ
→ không bao giờ tái cấu trúc code không liên quan
→ hỏi trước khi xóa bất cứ thứ gì
→ xác nhận trước các hành động phá hoại
→ không viết lại cấu trúc hiện có nếu không có sự chấp thuận
→ luôn hiển thị chính xác những gì đã thay đổi
→ không bao giờ triển khai hoặc chạy migration tự động
Chỉ riêng phần này đã ngăn chặn hầu hết các câu chuyện kinh dị về việc viết code bằng AI.
Không còn viết lại bất ngờ.
Không còn sai lệch kiến trúc.
Không còn thảm họa "Tôi đã dọn dẹp cái này cho bạn."
AI trở nên có thể dự đoán được.
Đó chính xác là những gì các kỹ sư thực sự muốn.
━━━━━━━━━━━━━━━
- BỘ NHỚ + BỘ NÃO DỰ ÁN
━━━━━━━━━━━━━━━
Đây là nơi mọi thứ thực sự trở nên mạnh mẽ.
Các nhà phát triển bắt đầu kết hợp CLAUDE.md với các tệp như:
MEMORY.md
ERRORS.md
Giờ đây Claude có thể nhớ:
• các quyết định mà nhóm bạn đã đưa ra
• các cách tiếp cận đã thất bại
• các công cụ đã bị loại bỏ
• các sự cố sản xuất
• các ràng buộc kỹ thuật
• sự đánh đổi kiến trúc
• các quy tắc dành riêng cho khách hàng
Có nghĩa là AI ngừng đề xuất những thứ bạn đã loại trừ từ nhiều tháng trước.
Nó ngừng quên.
Điều đó thay đổi mọi thứ.
Bởi vì nút thắt cổ chai thực sự trong việc viết code bằng AI không còn là tạo code nữa.
Đó là ngữ cảnh bền vững.
Và hầu hết mọi người vẫn chưa nhận ra điều này.
━━━━━━━━━━━━━━━
4 QUY TẮC KHIẾN NÓ TRỞ NÊN VIRAL
━━━━━━━━━━━━━━━
Thiết lập này bùng nổ sau khi các nhà phát triển bắt đầu chia sẻ 4 quy tắc đơn giản lấy cảm hứng từ cách tiếp cận của Andrej Karpathy khi làm việc với các hệ thống AI.
Chúng trông có vẻ cơ bản một cách đánh lừa:
- Hỏi trước khi giả định.
- Sử dụng giải pháp đơn giản nhất trước.
- Đừng chạm vào code không liên quan.
- Báo hiệu sự không chắc chắn ngay lập tức.
Chỉ có vậy thôi.
Nhưng 4 quy tắc đó giải quyết hầu hết các thất bại khi viết code bằng AI.
Bởi vì thiệt hại lớn nhất thường đến từ việc AI hành động một cách tự tin mà không có đủ ngữ cảnh.
Các nhà phát triển đạt được kết quả tốt nhất không phải là sử dụng "nhiều AI hơn."
Họ đang giảm sự mơ hồ.
Và một khi bạn thấy điều này, bạn không thể không thấy nó.
━━━━━━━━━━━━━━━
SỰ PHÂN CHIA THỰC SỰ TRONG VIỆC VIẾT CODE BẰNG AI
━━━━━━━━━━━━━━━
Ngay bây giờ, về cơ bản có hai loại nhà phát triển sử dụng Claude Code.
Nhóm 1:
Bắt đầu mỗi phiên từ đầu.
Lặp lại ngữ cảnh hàng ngày.
Dọn dẹp các thay đổi không mong muốn.
Liên tục chống lại sự leo thang phạm vi.
Đối xử với AI như tính năng tự động hoàn thành tạm thời.
Nhóm 2:
Sử dụng các hướng dẫn bền vững.
Khóa các quy tắc hành vi.
Duy trì bộ nhớ dự án.
Kiểm soát phạm vi chặt chẽ.
Đối xử với AI như một cộng tác viên kỹ thuật lâu dài.
Cùng một mô hình.
Kết quả hoàn toàn khác nhau.
Đó là lý do tại sao tệp này lan truyền nhanh như vậy.
Bởi vì một khi Claude có:
• các quy tắc
• bộ nhớ
• nhận thức về stack
• các ràng buộc hành vi
• ngữ cảnh dự án
…nó không còn giống như một chatbot nữa.
Và bắt đầu giống như cơ sở hạ tầng.
━━━━━━━━━━━━━━━
BẮT ĐẦU TỪ ĐÂY
━━━━━━━━━━━━━━━
Mở dự án của bạn.
Tạo một tệp có tên:
CLAUDE.md
Sau đó, dán 4 quy tắc này trước:
• Hỏi trước khi giả định
• Giải pháp đơn giản nhất trước
• Đừng chạm vào code không liên quan
• Báo hiệu sự không chắc chắn một cách rõ ràng
Chỉ riêng điều đó sẽ cải thiện ngay lập tức cách Claude hoạt động.
Sau đó, từ từ mở rộng nó theo thời gian:
→ stack của bạn
→ tiêu chuẩn code
→ quy tắc kiến trúc
→ các hành động bị cấm
→ nhật ký quyết định
→ bộ nhớ dự án
Hầu hết các nhà phát triển vẫn chưa làm điều này.
Điều đó có nghĩa là khoảng cách giữa việc viết code hỗ trợ AI trung bình và viết code hỗ trợ AI đẳng cấp đang trở nên ít liên quan đến các mô hình hơn…
…và liên quan nhiều hơn đến việc ai biết cách cấu trúc ngữ cảnh một cách phù hợp.
Đánh dấu trang này.
Bởi vì sáu tháng nữa, bộ nhớ dự án AI bền vững có thể sẽ trở nên bình thường như các kho lưu trữ GitHub ngày nay.
