Cung cấp bối cảnh cho Claude: CLAUDE.md và các lời nhắc tốt hơn (Give Claude context: CLAUDE.md and better prompts)

Claude Code hoạt động tốt ngay khi mới sử dụng, nhưng nó trở nên hiệu quả hơn rõ rệt khi nó hiểu các quy ước của dự án của bạn và khi bạn áp dụng một vài thói quen gợi ý. Hướng dẫn này đề cập đến cả hai điều đó.

CLAUDE.mdlà một tệp markdown đơn giản mà Claude tự động đọc khi bắt đầumọiphiên làm việc trong thư mục đó. Hãy coi nó như bản tóm tắt mà bạn sẽ đưa cho một thành viên mới có năng lực vào buổi sáng đầu tiên của họ: cách đội thực hiện công việc, những gì cần tránh, và nơi các phần quan trọng nằm.

Bạn không cần phải tham chiếu nó trong các lời nhắc hoặc đính kèm nó một cách thủ công. Nếu tệp tồn tại, Claude đã đọc nó rồi.

Claude nhìn vào một vài nơi và kết hợp những gì nó tìm thấy, từ chung đến cụ thể:

Hầu hết các nhóm chỉ cần tệp gốc dự án. Cam kết nó lên git để cả nhóm đều hưởng lợi.

Các tệp tại và trên thư mục làm việc của bạn được đọc khi bắt đầu phiên và được gửi đến Claude dưới dạng tin nhắn người dùng ngay sau lời nhắc hệ thống (không được nhúng bên trong lời nhắc hệ thống). Thư mục conCLAUDE.mdcác tệp được tải theo nhu cầu sau này, khi Claude đọc các tệp trong thư mục con đó. Không có tóm tắt hay cắt bớt, và nó không được đọc lại từ đĩa ở mỗi lượt. Nếu bạn chỉnh sửa tệp trong phiên làm việc, thay đổi sẽ được áp dụng lần tới khi bạn chạy/gọnhoặc mở nó qua/bộ nhớ; nếu không, nó sẽ có hiệu lực trong phiên làm việc tiếp theo của bạn.

Đối với khách hàng doanh nghiệp của Claude, bức tranh chi phí tốt hơn so với những gì ‘tải trên mọi yêu cầu’ có thể gợi ý. Claude Code áp dụng bộ nhớ đệm yêu cầu của Anthropic choCLAUDE.md. Yêu cầu đầu tiên trong một phiên sẽ trả toàn bộ giá token đầu vào cho tệp; các yêu cầu tiếp theo trong khoảng năm phút gần nhau sẽ truy cập bộ nhớ đệm và được tính phí theo mức đọc bộ nhớ đệm thấp hơn nhiều. Bộ nhớ đệm được địa chỉ theo nội dung, vì vậy bất kỳ thay đổi nào đối vớiCLAUDE.mdlàm mất hiệu lực của nó và yêu cầu tiếp theo phải trả giá đầy đủ một lần nữa.

Trong thực tế, điều này có nghĩa là một lượng đáng kểCLAUDE.mdchi phí toàn bộ token một lần mỗi phiên, cộng thêm một lần sau bất kỳ khoảng thời gian không hoạt động nào đủ lâu để bộ nhớ đệm hết hạn, thay vì một lần cho mỗi tin nhắn. Vẫn đáng để giữ cho tệp gọn gàng để tiết kiệm không gian cửa sổ ngữ cảnh và tỉ lệ tín hiệu-nhiễu, nhưng bạn không cần phải phân bổ dòng chỉ để kiểm soát chi tiêu theo tin nhắn. Trong bảng điều khiển sử dụng Enterprise, dấu chân của tệp sẽ hiển thị hầu như hoàn toàn dưới dạng token đọc từ bộ nhớ đệm thay vì token đầu vào tiêu chuẩn.

Trong bất kỳ dự án nào, kiểu/khởi tạo. Claude sẽ khám phá cơ sở mã và soạn thảo mộtCLAUDE.mdcho bạn, bao gồm các lệnh build, lệnh kiểm thử, tổng quan về cấu trúc, và bất kỳ quy ước nào mà nó phát hiện. Xem lại bản nháp, loại bỏ bất kỳ thông tin không chính xác nào, và cam kết nó. Việc này mất khoảng năm phút và mang lại lợi ích lâu dài.

Hãy nhắm đến một tệp ngắn và giàu thông tin — dưới khoảng 200 dòng. Mỗi dòng được nạp vào ngữ cảnh trong mỗi yêu cầu, vì vậy mỗi dòng đều nên đáng giá với chi phí của nó.

Đáng để bao gồm:

Không đáng để đưa vào:

Hãy coi nó như một tài liệu hướng dẫn nhập môn sống, chứ không phải một đặc tả.

Bạn cũng có thể thêm vào giữa phiên: mở/bộ nhớchỉnh sửa tệp trực tiếp, hoặc chỉ cần yêu cầu Claude ‘nhớ’ một quy tắc và nó sẽ thêm nó vào đúng chỗCLAUDE.mddành cho bạn.

Đây không phải là những mẹo chung về kỹ thuật tạo lệnh; chúng là những thói quen quan trọng nhất, đặc biệt khi Claude đang đọc và chỉnh sửa một cơ sở mã thực tế.

Claude có thể khám phá chính cơ sở mã. Nói với nógìbạn muốn vàtại sao, và để nó tự tìm hiểuở đâu.

❌ “Mở”userService.ts, tìmxác thựchàm, thêm kiểm tra null ở dòng 42.

✅ Người dùng không có email đang làm quá trình xác thực bị lỗi. Hãy xử lý tình huống đó một cách mượt mà và thêm một bài kiểm tra.

Dán toàn bộ ngăn xếp theo dõi thay vì tóm tắt nó. Tên tệp chính xác, số dòng và thông điệp là những gì cho phép Claude tìm đúng vị trí nhanh chóng.

Đối với bất cứ thứ gì liên quan đến hơn một vài tệp, nhấnShift+Tabnhấn hai lần để chuyển sang chế độ kế hoạch (lần nhấn đầu tiên vào chế độ chấp nhận chỉnh sửa) và hỏi:

Lên kế hoạch cách bạn sẽ thêm giới hạn tốc độ cho API công khai. Chưa thay đổi gì cả.

Xem lại kế hoạch, điều chỉnh nó trong cuộc trò chuyện, sau đó chuyển chế độ và nói ‘thực hiện bước 1.’ Điều này giúp phát hiện những hiểu lầm trước khi chúng biến thành một sự thay đổi 12 tệp.

Claude có thể tự tìm kiếm trong cơ sở mã, nhưng nếu bạn đã biết tệp liên quan, hãy nói – sẽ nhanh hơn và sử dụng ít token hơn. Sử dụng@để tham chiếu các đường dẫn, ví dụ@src/auth/login.ts.

Ví dụ bao gồm “bài kiểm tra vượt qua,” “phù hợp với phong cách của các trình xử lý khác,” hoặc “không có phụ thuộc mới.” Việc nêu rõ các tiêu chí chấp nhận ngay từ đầu hiệu quả hơn so với nhiều lần chỉnh sửa.

Các phiên làm việc dài tích tụ tiếng ồn. Khi bạn chuyển từ ‘sửa lỗi đăng nhập’ sang ‘tái cấu trúc mô-đun thanh toán,’ hãy chạy/xóavà bắt đầu lại từ đầu. Của bạnCLAUDE.mdmang theo bối cảnh bền vững, vì vậy lịch sử trò chuyện không cần phải làm vậy.

Nếu câu trả lời đầu tiên không đúng, bạn không cần phải viết lại toàn bộ yêu cầu. Chỉ cần nói điều gì sai — ví dụ,“Điều đó thay đổi API công khai; giữ nguyên chữ ký.”Claude sẽ giữ tất cả mọi thứ khác và chỉ điều chỉnh điểm đó.