Debug bug thực tế với Claude Code: demo sửa lỗi từ stack trace đến commit

Dán stack trace vào terminal và thấy bug được fix tự động không còn là chuyện xa vời. Với các AI agent mới như Claude Code, workflow này đang trở thành hiện thực cho lập trình viên. Thay vì phải tự mình `grep` code và lần theo từng dòng lỗi, bạn có thể để AI đọc toàn bộ codebase và đề xuất phương án sửa.

Bài viết này sẽ demo quy trình debug end-to-end, từ lúc nhận một lỗi Next.js thực tế đến khi có commit fix, tất cả diễn ra ngay trong terminal của bạn.

Claude Code là gì và tại sao nó thay đổi cuộc chơi debug?

Claude Code không đơn thuần là một chatbot AI thông thường. Nó là một AI agent hoạt động trực tiếp trong terminal của lập trình viên, nơi mình và bạn thực sự làm việc [F2]. Điều này giúp nó tích hợp sâu vào quy trình phát triển hàng ngày.

Khả năng cốt lõi của Claude Code là đọc và hiểu toàn bộ codebase, không bị giới hạn chỉ trong một file duy nhất. Nó có thể lên kế hoạch cho các thay đổi phức tạp, tự động viết code, debug, chạy lệnh và lặp lại quy trình này trong nhiều giờ để hoàn thành các tác vụ [F1].

So với quy trình debug truyền thống (dùng debugger hay `console.log`) hoặc các AI assistant trong IDE như Copilot Chat, Claude Code mang đến một workflow agentic hơn. Nó không chỉ gợi ý code mà còn chủ động thực hiện các bước để giải quyết vấn đề. Đây là công cụ phát triển nhanh nhất trong không gian startup và kỹ thuật cao cấp, với mức độ hài lòng của người dùng cao nhất so với các đối thủ cạnh tranh [F3].

Claude Code có thể tự động hóa các tác vụ phức tạp, từ việc phân tích lỗi đến việc đề xuất và thực thi các bản sửa lỗi. Nó lên kế hoạch, viết code, chạy lệnh và tự sửa lỗi trong một vòng lặp liên tục, tạo ra một quy trình debug cực kỳ hiệu quả.

🛠️ Chuẩn bị môi trường: Cài đặt và cấu hình Claude Code cho dự án đầu tiên

Để bắt đầu sử dụng Claude Code, bước đầu tiên là cài đặt CLI và cấu hình API key. Claude Code được thiết kế để chạy trực tiếp trong terminal của bạn [F2], giúp mình làm việc hiệu quả hơn.

Cài đặt Claude Code CLI

Bạn có thể cài đặt Claude Code CLI thông qua npm hoặc npx. Nếu muốn cài đặt toàn cục, dùng npm:

npm install -g @anthropic/claude-code-cli

Hoặc bạn có thể chạy trực tiếp bằng npx mà không cần cài đặt:

npx @anthropic/claude-code-cli

Cấu hình API Key an toàn

Việc cấu hình API key một cách an toàn là rất quan trọng. Thay vì hardcode key vào trong code, mình khuyến nghị sử dụng biến môi trường. Bạn có thể đặt biến môi trường tên là `CLAUDE_API_KEY` với giá trị là API key của mình.

export CLAUDE_API_KEY="sk-your-api-key-here"

Claude Code sẽ tự động nhận diện biến môi trường này khi bạn chạy lệnh.

Khởi tạo dự án và Index Codebase

Sau khi cài đặt và cấu hình API key, bạn cần khởi tạo Claude Code trong thư mục dự án của mình. Chạy lệnh sau trong thư mục gốc của dự án:

claude-code init

Lệnh này sẽ yêu cầu Claude Code bắt đầu index toàn bộ codebase của bạn. Việc index giúp Claude hiểu rõ cấu trúc dự án, các dependencies, và mối quan hệ giữa các file. Nhờ đó, Claude có thể đọc toàn bộ codebase, lên kế hoạch thay đổi phức tạp, tự động viết và debug code hiệu quả hơn [F1].

Lưu ý quan trọng về bảo mật

Claude Code là một công cụ mạnh mẽ, nhưng cũng cần chú ý đến bảo mật. Vào ngày 31 tháng 3 năm 2026, Anthropic đã vô tình rò rỉ mã nguồn của Claude Code v2.1.88 trên npm do một sourcemap JavaScript debug [F4]. Sự cố này đã dẫn đến việc phát hiện một lỗ hổng nghiêm trọng [F4]. Do đó, bạn nên luôn giữ phiên bản Claude Code của mình được cập nhật để đảm bảo an toàn.

🐞 Case Study: Từ stack trace đến fix bug Next.js trong 5 phút

Mình sẽ demo cách dùng Claude Code để sửa một lỗi Next.js thực tế. Claude Code có khả năng đọc toàn bộ codebase, lên kế hoạch thay đổi phức tạp, tự động viết và debug code [F1]. Nó cũng có thể chạy các lệnh và lặp lại trong nhiều giờ cho các tác vụ [F1].

Tình huống giả định: một dự án Next.js đang chạy gặp lỗi và hiển thị stack trace trong console. Thay vì tự mình phân tích từng dòng, mình sẽ đưa stack trace này cho Claude Code.

Claude Code hoạt động trong terminal, nơi các lập trình viên thường làm việc [F2]. Điều này giúp mình giữ workflow liền mạch mà không cần chuyển đổi ngữ cảnh.

Đầu tiên, mình paste stack trace vào Claude Code. Nó sẽ phân tích lỗi, xác định file và dòng code gây ra vấn đề. Sau đó, nó đề xuất một giải pháp, thường là một đoạn code đã được sửa.

Mình có thể yêu cầu Claude Code áp dụng bản sửa lỗi trực tiếp vào codebase. Nó sẽ tự động chỉnh sửa file, chạy lại các test (nếu có) để xác minh rằng lỗi đã được khắc phục. Toàn bộ quá trình này diễn ra rất nhanh, giúp tiết kiệm thời gian đáng kể so với việc debug thủ công.

Claude Code được đánh giá là công cụ phát triển nhanh nhất trong không gian startup và kỹ thuật cao cấp [F3]. Nó cũng có mức độ hài lòng của người dùng cao nhất so với các đối thủ cạnh tranh [F3].

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

Claude Code đang dần trở thành một công cụ không thể thiếu trong nhiều dự án phát triển phần mềm. Mình thấy đây là công cụ phát triển nhanh nhất trong không gian startup và kỹ thuật cao cấp, với mức độ hài lòng của người dùng cao nhất so với các đối thủ cạnh tranh [F3].

Khả năng của Claude Code rất rộng, nó có thể đọc toàn bộ codebase, lên kế hoạch thay đổi phức tạp, tự động viết và debug code. Thậm chí, nó còn có thể chạy các lệnh và lặp lại trong nhiều giờ cho các tác vụ cụ thể [F1]. Điều này giúp mình tiết kiệm đáng kể thời gian và công sức trong quá trình phát triển.

Một điểm mạnh khác là Claude Code chạy trực tiếp trong terminal, nơi các lập trình viên thường xuyên làm việc [F2]. Điều này tạo ra một quy trình làm việc liền mạch, không cần chuyển đổi ngữ cảnh quá nhiều.

Tuy nhiên, việc triển khai Claude Code cũng cần cân nhắc về chi phí. Ví dụ, Uber đã sử dụng hết toàn bộ ngân sách AI năm 2026 chỉ trong bốn tháng do sự lan rộng nhanh chóng của Claude Code trong khoảng 5.000 kỹ sư, vượt quá dự kiến của các mô hình tài chính công ty [F5]. Điều này cho thấy tiềm năng tiêu thụ tài nguyên đáng kể nếu không được quản lý tốt.

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

Claude Code là một công cụ mạnh mẽ, có khả năng đọc toàn bộ codebase và tự động debug code [F1]. Tuy nhiên, khi sử dụng, bạn cần lưu ý một số điểm để tối ưu hiệu quả và tránh các vấn đề không mong muốn.

Đầu tiên, chi phí sử dụng có thể là một yếu tố cần cân nhắc. Ví dụ, Uber đã dùng hết toàn bộ ngân sách AI năm 2026 chỉ trong bốn tháng do việc sử dụng Claude Code lan rộng nhanh chóng trong khoảng 5.000 kỹ sư của họ [F5]. Điều này cho thấy việc quản lý chi phí là rất quan trọng, đặc biệt với các tác vụ lặp lại hoặc các codebase lớn.

Thứ hai, dù Claude Code rất hiệu quả trong việc phát triển và debug [F3], nhưng cũng có những rủi ro về bảo mật. Vào ngày 31 tháng 3 năm 2026, Anthropic đã vô tình đưa một sourcemap JavaScript debug cho Claude Code v2.1.88 lên npm, dẫn đến việc rò rỉ mã nguồn và phát hiện lỗ hổng nghiêm trọng [F4]. Luôn cập nhật phiên bản mới nhất và kiểm tra các thông báo bảo mật từ Anthropic là cần thiết.

Cuối cùng, Claude Code hoạt động trong terminal, nơi các lập trình viên làm việc [F2]. Điều này mang lại sự tiện lợi nhưng cũng đòi hỏi bạn phải làm quen với việc tương tác qua giao diện dòng lệnh và kiểm soát các tác vụ mà Claude Code thực hiện.

Tóm lại, Claude Code cho thấy tiềm năng thay đổi cách chúng ta debug, chuyển từ việc mò mẫm thủ công sang hợp tác với AI agent. Workflow từ stack trace đến commit fix được rút ngắn đáng kể. Bạn có thể bắt đầu bằng cách cài đặt và áp dụng nó cho một bug nhỏ trong dự án của mình.