Bỏ qua đến nội dung chính

Adding context

📖 Nội dung bài học

Gia đình phông chữ

Tóm tắt

Khi làm việc với Claude trên các dự án viết code, việc quản lý ngữ cảnh rất quan trọng. Dự án của bạn có thể có hàng chục hoặc hàng trăm tệp, nhưng Claude chỉ cần thông tin phù hợp để giúp bạn làm việc hiệu quả. Quá nhiều ngữ cảnh không liên quan thực sự làm giảm hiệu suất của Claude, vì vậy việc học cách hướng dẫn nó đến các tệp và tài liệu liên quan là điều cần thiết.

Lệnh /init

Khi bạn bắt đầu dùng Claude trong một dự án mới, hãy chạy lệnh /init. Lệnh này yêu cầu Claude phân tích toàn bộ codebase của bạn và hiểu:

  • Mục đích và kiến trúc của dự án
  • Các lệnh quan trọng và các tệp quan trọng
  • Các mẫu và cấu trúc viết code

Sau khi phân tích code của bạn, Claude tạo một bản tóm tắt và ghi nó vào tệp CLAUDE.md. Khi Claude yêu cầu quyền tạo tệp này, bạn có thể nhấn Enter để chấp nhận từng thao tác ghi, hoặc nhấn Shift+Tab để cho phép Claude tự do ghi tệp trong suốt phiên làm việc của bạn.

Tệp CLAUDE.md

Tệp CLAUDE.md có hai mục đích chính:

  • Hướng dẫn Claude thông qua codebase của bạn, chỉ ra các lệnh, kiến trúc và phong cách viết code quan trọng
  • Cho phép bạn đưa ra các hướng dẫn cụ thể hoặc tùy chỉnh cho Claude

Tệp này được bao gồm trong mọi yêu cầu bạn gửi đến Claude, vì vậy nó giống như có một system prompt liên tục cho dự án của bạn.

Vị trí tệp CLAUDE.md

Claude nhận ra ba tệp CLAUDE.md khác nhau ở ba vị trí phổ biến:

  • CLAUDE.md - Được tạo bằng /init, được commit vào source control, chia sẻ với các kỹ sư khác
  • CLAUDE.local.md - Không chia sẻ với các kỹ sư khác, chứa các hướng dẫn và tùy chỉnh cá nhân cho Claude
  • ~/.claude/CLAUDE.md - Được dùng với tất cả các dự án trên máy của bạn, chứa các hướng dẫn mà bạn muốn Claude tuân theo trên tất cả các dự án

Thêm hướng dẫn tùy chỉnh

Bạn có thể tùy chỉnh cách Claude hoạt động bằng cách thêm hướng dẫn vào tệp CLAUDE.md của bạn. Ví dụ, nếu Claude đang thêm quá nhiều comment vào code, bạn có thể giải quyết việc này bằng cách cập nhật tệp.

Dùng lệnh # để vào "chế độ bộ nhớ" - điều này cho phép bạn chỉnh sửa các tệp CLAUDE.md của mình một cách thông minh. Chỉ cần gõ một cái gì đó như:

Claude sẽ tự động hợp nhất hướng dẫn này vào tệp CLAUDE.md của bạn.

Đề cập đến tệp bằng '@'

Khi bạn cần Claude xem xét các tệp cụ thể, hãy dùng ký hiệu @ theo sau là đường dẫn tệp. Thao tác này sẽ tự động bao gồm nội dung của tệp đó trong yêu cầu của bạn đến Claude.

Ví dụ, nếu bạn muốn hỏi về hệ thống xác thực của mình và bạn biết các tệp liên quan, bạn có thể gõ:

How does the auth system work? @auth

Claude sẽ hiển thị cho bạn danh sách các tệp liên quan đến xác thực để bạn chọn, sau đó bao gồm tệp đã chọn trong cuộc trò chuyện của bạn.

Tham chiếu tệp trong CLAUDE.md

Bạn cũng có thể đề cập trực tiếp các tệp trong tệp CLAUDE.md của mình bằng cú pháp @ tương tự. Điều này đặc biệt hữu ích cho các tệp có liên quan đến nhiều khía cạnh của dự án của bạn.

Ví dụ, nếu bạn có một tệp lược đồ cơ sở dữ liệu xác định cấu trúc dữ liệu của bạn, bạn có thể thêm điều này vào CLAUDE.md của mình:

The database schema is defined in the @prisma/schema.prisma file. Reference it anytime you need to understand the structure of data stored in the database.

Khi bạn đề cập đến một tệp theo cách này, nội dung của nó sẽ tự động được bao gồm trong mọi yêu cầu, vì vậy Claude có thể trả lời các câu hỏi về cấu trúc dữ liệu của bạn ngay lập tức mà không cần phải tìm kiếm và đọc tệp lược đồ mỗi lần.

🔁 Bài học liên quan

📚 Nguồn & ghi nhận

Bài học có hữu ích không?

Góp ý / Báo lỗiPhát hiện sai sót hoặc có ý tưởng cải thiện?