Claude Code: Ngừng "Đoán Mò", Bắt Đầu Lập Trình Với Sức Mạnh Của Ngữ Cảnh Chủ Động

1. Lời mở đầu

Trong kỷ nguyên của các công cụ lập trình AI, rào cản lớn nhất giữa một dòng code hoàn hảo và một lỗi sai ngớ ngẩn thường nằm ở hai chữ: "Đoán mò". Bạn đưa ra một yêu cầu, AI nỗ lực thực hiện, nhưng kết quả lại nằm sai file hoặc đi ngược lại logic hệ thống chỉ vì nó không hiểu hết ý định của bạn.

Vấn đề thường không nằm ở năng lực của AI, mà ở sự thiếu hụt thông tin đầu vào. Để Claude Code thực sự trở thành một cộng sự đắc lực (pair programmer), bạn cần học cách làm chủ Ngữ cảnh (Context). Việc cung cấp ngữ cảnh chủ động chính là chìa khóa để biến những dự đoán mơ hồ thành những hành động chính xác đến từng dòng lệnh.

2. Loại bỏ sự "Đoán mò": Tại sao hướng dẫn chung là chưa đủ?

Thông thường, chúng ta dựa vào file CLAUDE.md để cung cấp các quy chuẩn chung cho dự án (coding conventions, thư viện sử dụng). Tuy nhiên, với các dự án phức tạp, bấy nhiêu đó là chưa đủ để đảm bảo tính chính xác tuyệt đối.

Hãy lấy ví dụ về việc yêu cầu Claude thêm một component Footer vào "splash page" và "auth pages". Trong một cấu trúc thư mục lớn, Claude có thể gặp rắc rối vì không có file nào thực sự tên là "splash page" — đó thường chỉ là tên gọi logic của trang chủ (root homepage). Nếu không có chỉ dẫn rõ ràng, AI sẽ phải tự đoán xem file nào tương ứng với khái niệm đó giữa hàng trăm file route khác nhau.

Việc kiểm soát chính xác những gì AI được "nhìn thấy" không chỉ giúp loại bỏ sai sót mà còn tiết kiệm thời gian debugging quý giá, đặc biệt là trong các dự án có nhiều route group phức tạp.

3. Sức mạnh của @ và Explicit Context: Kiểm soát tuyệt đối

Để kiểm soát ngữ cảnh một cách thủ công và minh bạch (Explicit Context), Claude Code cung cấp một công cụ cực kỳ quyền năng: ký tự @.

Khi bạn gõ @ trong terminal (hoặc trong Claude Code chat), tính năng Tìm kiếm mờ (Fuzzy Search) sẽ được kích hoạt. Bạn chỉ cần gõ một vài ký tự trong tên file, Claude Code sẽ gợi ý đường dẫn chính xác. Đây không chỉ là một phím tắt; đó là cách bạn xác nhận 100% với AI về file mục tiêu.

Pro-tip: Bạn có thể thêm cả một Thư mục (Folder) làm ngữ cảnh. Khi thêm folder, hãy dùng cú pháp @folder/ (có dấu gạch chéo cuối) để Claude hiểu rõ đây là toàn bộ thư mục chứ không phải một file duy nhất. Bạn đang gửi đi một chỉ dẫn logic mạnh mẽ: "Tất cả những gì bạn cần để hoàn thành nhiệm vụ này đều nằm trong thư mục này".

"To eliminate that guesswork, we could add the pages that we want the footer adding to as context to the prompt. To do that, to add a file as context, we can type the at symbol."

4. Implicit Context: Khi Claude "nhìn" thấy những gì bạn thấy

Bên cạnh việc thêm thủ công, Claude Code còn sở hữu khả năng nhận diện ngữ cảnh "ngầm" (Implicit Context) dựa trên hành động của bạn trong trình soạn thảo. Đây là cách làm việc "không tốn sức" (zero-effort) nhưng mang lại hiệu quả cực cao.

• File đang hoạt động (Active File): Claude Code tự động nhận diện file bạn đang mở và đặt con trỏ chuột vào đó là ưu tiên hàng đầu.
• Vùng chọn (Selection/Highlighting): Đây là cấp độ chính xác cao nhất. Khi bạn bôi đen một đoạn code, Claude sẽ "pinpoint" (ghim) chính xác vị trí cần xử lý, loại bỏ mọi sự xao nhãng từ các phần khác của file.

Ví dụ thực tế: Giả sử bạn muốn tạo một class .btn đồng bộ với màu sắc hệ thống. Quy trình tối ưu sẽ là:

1. Sử dụng @app/globals.css (Explicit Context) để chỉ định nơi ghi code.
2. Mở file navbar và đặt con trỏ tại đó (Implicit Context) để Claude tham chiếu màu sắc theme đang dùng.
3. Highlight dòng chứa nút bấm trong navbar để Claude hiểu chính xác đối tượng cần áp dụng class mới.

Sự kết hợp giữa chỉ định thủ công và nhận diện tự động tạo nên một quy trình làm việc mượt mà và chuẩn xác.

5. "Context Architecture": Tối ưu hóa CLAUDE.md với Nested Context

Một kỹ thuật nâng cao dành cho các chuyên gia là sử dụng ký tự @ ngay bên trong file cấu hình CLAUDE.md. Đây gọi là mô hình Ngữ cảnh lồng nhau (Nested Context) hoặc cấu trúc cấu hình theo module.

Thay vì nhồi nhét mọi quy tắc vào một file duy nhất, bạn có thể biến CLAUDE.md thành một "Single Source of Truth" (Nguồn sự thật duy nhất) bằng cách tham chiếu đến các file hướng dẫn chuyên sâu khác:

• @docs/testing-standards.md: Để Claude tuân thủ quy chuẩn viết unit test của công ty.
• @docs/git-conventions.md: Để AI biết cách đặt tiêu đề commit đúng format.
• @docs/**/*.md (glob pattern): Để tự động include toàn bộ tài liệu trong thư mục docs.

Cách tiếp cận này giúp file cấu hình của bạn luôn gọn gàng nhưng vẫn đảm bảo Claude có thể truy cập vào toàn bộ "kho tàng tri thức" của dự án khi cần thiết.

6. Kết luận và Suy ngẫm

Quản lý ngữ cảnh không đơn thuần là một thao tác kỹ thuật; đó là nghệ thuật giao tiếp hiệu quả với AI. Khi bạn làm chủ được ký tự @, hiểu rõ sức mạnh của việc highlight code và biết cách tổ chức file CLAUDE.md một cách khoa học, bạn đang trực tiếp nâng cấp trí thông minh của Claude Code cho riêng dự án của mình.

Việc cung cấp ngữ cảnh tốt có lẽ chính là kỹ năng quan trọng nhất của lập trình viên trong kỷ nguyên AI. Nó biến chúng ta từ người gõ phím thành những "kiến trúc sư ngữ cảnh", dẫn dắt AI tạo ra những giải pháp tối ưu nhất.

Trong bài viết tới, chúng ta sẽ bước sang một ranh giới mới: Sử dụng hình ảnh làm ngữ cảnh để Claude Code có thể hiện thực hóa giao diện trực tiếp từ các bản thiết kế.