Tips & Tricks dùng Claude Code hiệu quả: viết prompt chuẩn và tiết kiệm token

Bạn đã bao giờ nhận được code từ Claude nhưng nó chạy sai hoặc không đúng ý? Vấn đề thường không nằm ở model, mà ở cách chúng ta yêu cầu. Việc đưa một prompt lớn và mong đợi kết quả hoàn hảo là không thực tế. Bài viết này tập trung vào một nguyên tắc cốt lõi để giải quyết vấn đề đó: tách biệt giai đoạn lập kế hoạch và thực thi. Mình sẽ chỉ cách áp dụng kỹ thuật này để Claude Code viết code chính xác hơn và giúp bạn tiết kiệm token.

Tại sao cần 'prompt chuẩn'? Claude Code không phải magic 🪄

Claude Code, đặc biệt là phiên bản Opus 4.5, là một công cụ mạnh mẽ. Nó có thể xử lý các tác vụ lập trình phức tạp, duy trì bộ nhớ lớn và thậm chí quản lý một nhóm các subagent AI [F1]. Phiên bản Opus 4.5 này đã đạt điểm cao hơn bất kỳ ứng viên kỹ thuật nào trong bài kiểm tra đầu vào của Anthropic [F1]. Điều này cho thấy tiềm năng to lớn của Claude Code trong việc hỗ trợ và tự động hóa công việc của lập trình viên.

Tuy nhiên, dù Claude Code có mạnh mẽ đến đâu, nguyên tắc "garbage in, garbage out" vẫn luôn đúng. Chất lượng output mà bạn nhận được từ Claude Code phụ thuộc trực tiếp vào chất lượng prompt (input) mà bạn cung cấp. Một prompt không rõ ràng sẽ dẫn đến kết quả không như mong đợi.

Hãy xem xét hai ví dụ sau để thấy sự khác biệt. Nếu bạn chỉ prompt "viết cho mình một cái button", Claude có thể trả về một đoạn mã HTML đơn giản. Ngược lại, một prompt chi tiết hơn như "viết một component Button bằng React và TypeScript, sử dụng Tailwind CSS, có các prop là variant, size, và onClick" sẽ mang lại một component hoàn chỉnh, đúng với stack công nghệ bạn đang dùng.

Để sử dụng Claude Code hiệu quả, mình nghĩ bạn nên xem nó như một lập trình viên junior cực kỳ nhanh. "Junior" ở đây có nghĩa là Claude cần được hướng dẫn rõ ràng, chi tiết, từng bước một [F5]. Nó không thể đọc được suy nghĩ của bạn, vì vậy hãy cung cấp mọi thông tin cần thiết để nó có thể hoàn thành công việc một cách chính xác nhất.

Nguyên tắc vàng: Tách biệt Lập kế hoạch và Thực thi 🗺️

Một trong những phương pháp hiệu quả nhất khi làm việc với Claude Code là tách biệt rõ ràng quá trình lập kế hoạch và thực thi [F2]. Điều này có nghĩa là bạn sẽ chia một yêu cầu lớn thành hai giai đoạn riêng biệt thay vì yêu cầu Claude viết code ngay lập tức.

Giai đoạn 1: Lập kế hoạch (Planning)

Ở giai đoạn này, mình và Claude sẽ cùng nhau phác thảo kiến trúc, định nghĩa yêu cầu, thiết kế cấu trúc dữ liệu và lập kế hoạch triển khai. Mục tiêu chính là để Claude đưa ra các văn bản mô tả, sơ đồ hoặc cấu trúc JSON, chứ không phải code. Ví dụ, bạn có thể yêu cầu Claude thiết kế API endpoint, định nghĩa các trường trong database, hoặc phác thảo luồng dữ liệu cho ứng dụng.

Giai đoạn 2: Thực thi (Execution)

Sau khi đã có một kế hoạch chi tiết và thống nhất, mình sẽ cung cấp kế hoạch đó làm ngữ cảnh và yêu cầu Claude viết code cho từng phần cụ thể. Việc này giúp Claude tập trung vào việc chuyển đổi kế hoạch thành code mà không cần phải tự suy nghĩ về kiến trúc tổng thể. Claude Code có khả năng xử lý các tác vụ lập trình phức tạp và duy trì bộ nhớ lớn, nên việc cung cấp ngữ cảnh rõ ràng sẽ phát huy tối đa sức mạnh của nó [F1].

Phương pháp này mang lại nhiều lợi ích. Nó giúp bạn suy nghĩ về bài toán một cách có hệ thống hơn, giảm thiểu việc Claude 'tự chế' logic không mong muốn, và tạo ra code dễ bảo trì hơn [F2]. Ngoài ra, việc có kế hoạch rõ ràng ngay từ đầu cũng giúp bạn dễ dàng điều chỉnh nếu có thay đổi yêu cầu.

Thay vì một prompt chung chung như 'Viết cho mình một API server cho app todo list', bạn nên chia nhỏ thành:

Cách triển khai trong dự án thực tế

Khi áp dụng Claude Code vào dự án thật, mình thấy hiệu quả nhất là tách giai đoạn lập kế hoạch khỏi giai đoạn viết code [F2]. Đẩy thẳng yêu cầu kiểu 'làm cho mình feature X' rồi để Claude vừa nghĩ vừa code thường ra output lan man. Bạn sẽ phải sửa nhiều vòng, và token bị đốt vô ích cho phần đã đi sai hướng từ đầu.

Workflow mình thường chia thành 4 bước rõ ràng, mỗi bước có output kiểm tra được trước khi qua bước tiếp theo [F2]:

1. Kiến trúc và yêu cầu — liệt kê constraint, input/output, edge case cần handle

2. Thiết kế — chọn module, định nghĩa interface giữa các phần

3. Kế hoạch triển khai — chia task thành bước nhỏ có thể verify từng phần

4. Viết mã — bám theo plan đã chốt, không nhảy cóc qua bước nào

Ở mỗi bước, prompt cần đủ chi tiết để Claude không lướt qua nội dung. Theo chia sẻ trong cộng đồng, dùng các từ như `deeply`, `in great details`, `intricacies`, hay `go through everything` giúp Claude đọc kỹ file thay vì skim [F5]. Mình hay thêm cụm `read the entire file before editing` khi yêu cầu sửa module dài. Cách này tránh được lỗi Claude tự đoán phần code ngoài cửa sổ context và viết đè lên logic đang có.

Với task chạy lâu hoặc đụng nhiều file cùng lúc, có thể tận dụng khả năng duy trì bộ nhớ lớn và quản lý nhóm subagent của Claude Code [F1]. Mình hay tách 1 subagent riêng cho việc viết test, để session chính tập trung vào logic core. Mỗi agent có role rõ ràng nên context ít bị nhiễu. Khi 1 nhánh xong, kết quả được merge lại session chính để review tổng thể trước khi commit.

Lưu ý và pitfalls thường gặp

Pitfall lớn nhất mình thấy là nhảy thẳng vào code mà bỏ qua bước plan. Một cách làm hiệu quả hơn là tách riêng quá trình lập kế hoạch và thực thi: kiến trúc, yêu cầu, thiết kế, kế hoạch triển khai rồi mới viết mã [F2]. Cách này giúp bạn xử lý vấn đề lớn trước, đồng thời hỗ trợ Claude bám sát context khi làm việc [F2].

Lỗi thứ hai là prompt mơ hồ. Claude Code cần prompt rõ ràng và chi tiết mới chạy đúng ý [F5]. Nếu bạn muốn nó đọc kỹ thay vì lướt qua, hãy dùng các từ như "deeply", "in great details", "intricacies", "go through everything" [F5]. Khác biệt giữa prompt vague và prompt rõ thường rất lớn về chất lượng output.

Một điểm dễ quên: Claude Code không chỉ dùng cho code. Nó có thể điều khiển máy tính để mở app, thực hiện phép tính và dán kết quả vào file văn bản [F3]. Nếu bạn chỉ coi nó là công cụ viết code, bạn đang bỏ phí nhiều use case automation đời thường.

Cuối cùng, đừng khoá mình vào một tool duy nhất. Nếu cần phương án thay thế, có OpenAI Codex với cấp miễn phí, hoặc OpenCode — một lựa chọn mã nguồn mở miễn phí cho phép bạn dùng LLM của riêng mình [F4]. Việc thử qua vài tool giúp bạn hiểu rõ điểm mạnh yếu của từng cái trước khi cam kết workflow.

So sánh với các giải pháp khác

Claude Code nổi bật với khả năng xử lý các tác vụ lập trình phức tạp, duy trì bộ nhớ lớn và chạy liên tục trong nhiều giờ [F1]. Phiên bản Opus 4.5 của Claude Code thậm chí đã đạt điểm cao hơn bất kỳ ứng viên kỹ thuật nào trong bài kiểm tra đầu vào của Anthropic [F1].

Tuy nhiên, Claude Code không phải là lựa chọn duy nhất. Trên thị trường có nhiều giải pháp thay thế. OpenAI Codex là một trong số đó, và nó có sẵn ở cấp miễn phí [F4]. Ngoài ra, OpenCode cung cấp một lựa chọn mã nguồn mở miễn phí, cho phép bạn sử dụng các LLM của riêng mình [F4].

Một điểm mạnh khác của Claude Code là khả năng được sử dụng cho các tác vụ không liên quan đến lập trình. Mình có thể dùng nó để điều khiển máy tính, mở ứng dụng, thực hiện phép tính và dán kết quả vào một tệp văn bản [F3]. Điều này mở ra nhiều khả năng tự động hóa công việc hàng ngày.

Dù vậy, để Claude Code hoạt động hiệu quả, bạn cần cung cấp prompt rõ ràng và chi tiết [F5]. Việc tách biệt quá trình lập kế hoạch và thực thi cũng là một phương pháp hiệu quả. Điều này bao gồm các bước như kiến trúc, yêu cầu, thiết kế, kế hoạch triển khai và viết mã, giúp bạn giải quyết các vấn đề lớn hơn trước khi đi vào chi tiết [F2].

Tóm lại, việc tách biệt hai giai đoạn 'lập kế hoạch' và 'thực thi' là thay đổi quan trọng nhất để bạn làm việc hiệu quả với Claude Code. Áp dụng nguyên tắc này sẽ giúp bạn nhận được output chất lượng hơn. Để xem cách các kỹ sư Anthropic áp dụng nó, bạn có thể tham khảo các video demo gốc của họ.