Quản lý ngữ cảnh trong Claude Code

Ngữ cảnh là tất cả

Trong bài học trước, chúng ta đã tìm hiểu các lệnh cốt lõi. Bây giờ, hãy xây dựng trên nền tảng đó. Phản hồi của Claude Code chỉ tốt khi bạn cung cấp ngữ cảnh phù hợp. Cung cấp cho nó các file phù hợp, nó sẽ đưa ra những câu trả lời tuyệt vời. Cung cấp cho nó những thứ lộn xộn không liên quan, nó sẽ đưa ra những phản hồi khó hiểu.

Quản lý ngữ cảnh không chỉ đơn thuần là thêm file. Đó là việc lựa chọn một cách chiến lược những gì Claude nhìn thấy để có được kết quả bạn cần.

Cách thức hoạt động của ngữ cảnh

Hãy tưởng tượng ngữ cảnh của Claude giống như một cái bàn làm việc. Diện tích bề mặt hạn chế. Mọi thứ trên bàn đều cạnh tranh sự chú ý.

• Bàn làm việc nhỏ, ngăn nắp: Bạn có thể tìm thấy mọi thứ và làm việc hiệu quả.

• Bàn làm việc lớn, lộn xộn: Mọi thứ bị chôn vùi. Bạn mất tập trung.

Tương tự với Claude. Một vài file liên quan sẽ tốt hơn hàng tá file có liên quan gián tiếp.

Nguyên tắc ngữ cảnh tối thiểu khả thi

Trước khi thêm bất cứ thứ gì, hãy tự hỏi: "Claude có cần điều này cho nhiệm vụ hiện tại không?"

Có, hãy thêm vào:

• Các file bạn đang hỏi hoặc chỉnh sửa

• Các file định nghĩa giao diện đang được sử dụng

• Các file có mẫu bạn muốn tuân theo

• Các file test thể hiện hành vi dự kiến

Không, hãy bỏ qua:

• Toàn bộ thư mục "phòng trường hợp"

• Các file liên quan gián tiếp đến chủ đề

• Các file cấu hình lớn mà Claude sẽ không cần thay đổi

• Tài liệu mà Claude không cần tham chiếu

Khi không chắc chắn: Hãy bắt đầu mà không cần ngữ cảnh, sau đó thêm vào nếu Claude dường như thiếu thông tin.

Chiến lược phân lớp ngữ cảnh

Xây dựng ngữ cảnh theo từng lớp, từ tổng quát đến cụ thể.

Lớp 1: Hiểu biết về dự án

/add README.md package.json

Thông tin dự án cấp cao. Đây là gì? Ngăn xếp nào?

Lớp 2: Ngữ cảnh kiến ​​trúc

/add src/index.js src/routes.js

Các điểm truy cập và cấu trúc. Điều này được tổ chức như thế nào?

Lớp 3: Ngữ cảnh tính năng

/add src/auth/*.js

Khu vực cụ thể bạn đang làm việc.

Lớp 4: Ngữ cảnh tác vụ

/add src/auth/login.js src/auth/types.ts

Các file chính xác cho tác vụ hiện tại của bạn.

Bạn không phải lúc nào cũng cần tất cả các lớp. Đối với một lỗi đơn giản, hãy bỏ qua thẳng đến lớp 4.

Đọc tín hiệu ngữ cảnh

Claude cho bạn biết khi ngữ cảnh bị lỗi:

"Tôi không thấy..." Claude đang thiếu một file. Hãy thêm nó vào.

Tham chiếu code ảo Claude đang đoán vì nó không có code thực. Hãy thêm các file nguồn.

Phong cách hoặc mẫu không nhất quán Claude chưa thấy code hiện có của bạn. Hãy thêm các ví dụ về các mẫu bạn muốn.

Phản hồi rất chậm Ngữ cảnh có thể quá lớn. Hãy thử /compact.

Phản hồi tham chiếu đến công việc cũ, không liên quan Ngữ cảnh bị lộn xộn với thông tin lỗi thời. Hãy xem xét /clear và xây dựng lại.

Chiến lược ngữ cảnh theo nhiệm vụ

Sửa lỗi

/clear
/add [file có lỗi]
/add [các file liên quan có thể liên quan]
> Đây là lỗi: [thông báo lỗi]
> Tìm và sửa lỗi.

Ngữ cảnh tối thiểu, tập trung. Chỉ những gì cần thiết để hiểu và khắc phục sự cố.

Phát triển tính năng

/clear
/add src/similar-feature/*        # Mẫu cần tuân theo
/add src/types/*.ts               # Định nghĩa kiểu
/add tests/similar-feature.test.js # Các mẫu test
> Tạo một tính năng mới thực hiện X. Tuân theo các mẫu hiện có.

Ngữ cảnh cho Claude biết những mẫu nào cần tuân theo.

Kiểm tra code

/add $(git diff --name-only HEAD~1)  # Chỉ các file đã thay đổi
> Xem lại các thay đổi này để tìm lỗi, vấn đề về kiểu và những vấn đề tiềm ẩn.

Tập trung vào những gì thực sự đã thay đổi.

Tái cấu trúc

/add [tất cả các file liên quan đến việc tái cấu trúc]
> Tái cấu trúc [thành phần] để sử dụng [mẫu mới].
> Cập nhật tất cả các cách sử dụng trên những file này.

Tất cả các file bị ảnh hưởng trước để phối hợp các thay đổi.

Hiểu code không quen thuộc

/add src/mystery-module/*
> Giải thích cách mô-đun này hoạt động. Điểm vào chính là gì? Các phần kết nối với nhau như thế nào?

Hãy để Claude khám phá và giải thích trước khi bạn bắt tay vào.

Chia nhỏ ngữ cảnh cho các tác vụ lớn

Một số tác vụ cần nhiều ngữ cảnh hơn mức phù hợp. Giải pháp: Chia nhỏ công việc.

Thay vì:

/add src/**/*                    # Tất cả mọi thứ - quá nhiều
> Tái cấu trúc toàn bộ mã nguồn để sử dụng TypeScript

Hãy thực hiện như sau:

# Phiên 1
/add src/utils/*
> Chuyển đổi utils sang TypeScript. Đây là tsconfig của chúng ta.

# Phiên 2
/clear
/add src/models/*
> Chuyển đổi models sang TypeScript. Đối chiếu các mẫu từ utils.

# Phiên 3
/clear
/add src/services/*
> Chuyển đổi services sang TypeScript.

Mỗi phiên có ngữ cảnh cụ thể. Công việc được thực hiện từng bước.

Bài tập thực hành

Hãy thử bài tập quản lý ngữ cảnh này:

1. Mở Claude Code trong một dự án

2. Thêm quá nhiều file: /add **/*.js

3. Đặt một câu hỏi cụ thể về một hàm

4. Lưu ý cách câu trả lời có thể tham chiếu đến code không liên quan

5. Bây giờ hãy sử dụng /clear và chỉ thêm file liên quan

6. Đặt cùng một câu hỏi

7. So sánh chất lượng câu trả lời

Ngữ cảnh cụ thể thường mang lại lợi thế lớn.

Danh sách kiểm tra việc quản lý ngữ cảnh

Trước khi bắt đầu một tác vụ:

• [ ] /clear hoặc /compact nếu ngữ cảnh trước đó không liên quan

• [ ] Xác định số lượng file tối thiểu cần thiết

• [ ] Thêm file theo thứ tự hợp lý (mẫu trước, sau đó là file mục tiêu)

• [ ] Xác minh bằng /ls xem ngữ cảnh có đúng không

Trong khi thực hiện tác vụ:

• [ ] Thêm file khi cần thiết nếu Claude dường như thiếu thông tin

• [ ] Sử dụng /compact nếu phản hồi chậm lại

• [ ] Không thêm file "phòng trường hợp"

Hoàn thành một tác vụ:

• [ ] Cân nhắc sử dụng /compact trước khi thực hiện tác vụ tiếp theo nếu ngữ cảnh sẽ chồng chéo

• [ ] /clear nếu chuyển sang công việc không liên quan

Những điểm chính cần ghi nhớ

• Chất lượng ngữ cảnh quan trọng hơn số lượng ngữ cảnh

• Ngữ cảnh tối thiểu khả thi: Chỉ những gì cần thiết cho tác vụ hiện tại

• Phân lớp ngữ cảnh từ tổng quát đến cụ thể dựa trên độ phức tạp của tác vụ

• Theo dõi các tín hiệu cho thấy ngữ cảnh cần điều chỉnh

• Chia nhỏ các tác vụ lớn thành những phiên tập trung