Hướng dẫn Refactor Mã Nguồn Hiệu Quả với Claude Code

Hướng dẫn Refactor Mã Nguồn Hiệu Quả với Claude Code

Claude Code và các tác nhân lập trình (coding agents) khác có khả năng triển khai mã nguồn với tốc độ đáng kinh ngạc. Tuy nhiên, nếu bạn từng làm việc nhiều với các công cụ này, bạn sẽ nhận thấy chúng bắt đầu gặp khó khăn sau một thời gian. Có thể bạn đã dành vài ngày để viết code cùng AI, mọi thứ diễn ra suôn sẻ và nhanh chóng, nhưng sau đó các nhiệm vụ bắt đầu mất nhiều thời gian hơn và AI tạo ra ngày càng nhiều lỗi.

Đây là dấu hiệu rõ ràng cho thấy bạn cần bắt đầu refactor mã nguồn. Tôi tin rằng việc refactor codebase sẽ trở thành một tiêu chuẩn sau khi bạn đã triển khai một lượng lớn code với sự hỗ trợ của các tác nhân lập trình. Các tác nhân AI chắc chắn sẽ mắc sai sót và không viết ra mã hoàn hảo. Hơn nữa, nếu bạn không tuân thủ các phương pháp tốt nhất (best practices) trong code hiện có, AI sẽ tiếp tục lặp lại những sai lầm đó trong code mới mà nó tạo ra. Do đó, bạn cần liên tục refactor các kho lưu trữ (repository) của mình.

Trong bài viết này, tôi sẽ thảo luận về cách biết khi nào bạn cần refactor code, các dấu hiệu nhận biết, và cách thực hiện hiệu quả bằng Claude Code hoặc các tác nhân lập trình khác.

Infographic về cách refactor code với Claude Code

Tại sao cần Refactor mã nguồn?

Trước hết, tôi luôn muốn làm rõ lý do tại sao bạn nên quan tâm đến chủ đề này. Nghe có vẻ việc refactor code là một nhiệm vụ nhàm chán, và thực tế trước đây nó từng là công việc buồn tẻ mà bạn phải thỉnh thoảng thực hiện. Chỉ vài năm trước, con người phải tự thủ công vào kho lưu trữ mã nguồn để tìm kiếm những gì cần refactor và bắt đầu quá trình này.

Điều này thường xảy ra một lần, ngay sau khi triển khai nhiều code, bởi vì mã nguồn tự nhiên sẽ trôi dạt khỏi trạng thái hoàn hảo sang trạng thái lộn xộn đơn giản là do mọi người tương tác và làm việc trên nó. Hiện tượng này xảy ra dù con người hay tác nhân AI đang làm việc trên codebase đó.

Bạn cần refactor code của mình vì nếu mã nguồn lộn xộn, việc triển khai tính năng mới sẽ tốn nhiều thời gian hơn và bạn dễ mắc lỗi hơn.

Hãy lấy một ví dụ cụ thể. Giả sử chúng ta có một thiết kế chatbot trong ứng dụng của bạn, nơi người dùng có thể viết cho AI bot và nhận lại phản hồi. Về cơ bản, đây chỉ là một trường nhập liệu chat hiển thị phản hồi của AI và người dùng. Một codebase tốt sẽ đảm bảo bạn có một thành phần duy nhất được gọi là chat, và thành phần này được sử dụng ở tất cả các vị trí khác nhau trong ứng dụng nơi bạn hiển thị chat. Một codebase được thiết kế kém sẽ có một phiên bản chat cho từng vị trí khác nhau trong ứng dụng.

Vấn đề phát sinh khi bạn muốn thay đổi giao diện của chat. Ví dụ, bạn muốn cập nhật màu sắc của hộp chat hoặc biểu tượng của AI. Tất nhiên, bạn sẽ muốn cập nhật điều này ở tất cả các nơi trong ứng dụng nơi chat hiển thị, nhưng điều đó có nghĩa là con người hoặc AI đang chỉnh sửa code sẽ phải chỉnh sửa code ở nhiều vị trí khác nhau.

Tuy nhiên, nếu code được viết tốt, bạn chỉ cần cập nhật code tại một vị trí duy nhất vì đó là mã được tập trung hóa cho cách chat nên trông như thế nào. Đây chỉ là một ví dụ đơn giản về cách code được viết tốt có thể giúp việc triển khai dễ dàng hơn và ít gây lỗi hơn.

Khi nào nên Refactor codebase?

Đầu tiên, tôi sẽ đề cập đến khi nào bạn nên refactor codebase và những dấu hiệu bạn cần tìm kiếm.

Nói một cách đơn giản, bạn nên refactor code của mình khi các tác nhân lập trình trở nên chậm chạp hơn trong việc triển khai và khi bạn bắt đầu nhận thấy các tác nhân tạo ra nhiều lỗi hơn trong quá trình triển khai. Nếu bạn thấy các vấn đề xuất hiện ở những nơi không mong đợi, hoặc trong code mà bạn không chạm vào, đó là dấu hiệu rõ ràng bạn nên bắt đầu refactor.

Hơn nữa, tôi khuyên bạn nên bắt đầu refactor sớm hơn là muộn. Tất nhiên, làm việc với code cần refactor tốn nhiều thời gian hơn và dễ gây lỗi hơn, nhưng nó cũng rất gây bực bội vì bạn sẽ nhận thấy mình bắt đầu thực hiện các thay đổi, nhưng các tác nhân lập trình không thể làm chính xác những gì bạn yêu cầu.

Không bao giờ có một thời điểm cố định cho nhu cầu refactor này. Nó không nhất thiết xảy ra sau x số ngày hay x dòng code được viết. Nó giống như một thứ gì đó diễn ra theo thời gian. Nhu cầu refactor đơn giản xảy ra sau khi rất nhiều công việc đã được thực hiện trên một repository.

Lý thuyết của tôi là điều này xảy ra vì một mảnh code nhỏ bắt đầu trôi dạt khỏi trạng thái lý tưởng, điều này có thể xảy ra vì nhiều lý do khác nhau. Công việc tiếp theo trong cùng khu vực code này sẽ khuếch đại tác dụng của sự trôi dạt đó, và sau một thời gian, nó sẽ trở nên đáng chú ý khi các tác nhân lập trình hoặc con người ít có khả năng viết code ở đó hiệu quả hơn.

Tất nhiên, bạn nên cố gắng tránh điều này càng nhiều càng tốt; tuy nhiên, tôi tin rằng refactor không phải là thứ bạn nên cố gắng loại bỏ hoàn toàn. Tôi tin đó là một phần tự nhiên của sự tiến hóa của một codebase. Thay vào đó, bạn nên chấp nhận thực tế là bạn sẽ phải thực hiện refactor thỉnh thoảng, và bạn nên nhận biết các dấu hiệu cho khi nào bạn nên bắt đầu refactor code của mình.

Cách Refactor code với Claude Code

Bây giờ bạn đã biết khi nào nên refactor codebase, tôi sẽ bắt đầu thảo luận về cách refactor codebase với Claude Code hoặc bất kỳ tác nhân lập trình nào bạn thích.

Có một số quy tắc đơn giản mà tôi tuân theo bất cứ khi nào tôi bắt đầu refactor.

• Sử dụng khả năng suy luận cao nhất và tốn nhiều công sức nhất có thể. Refactor là một nhiệm vụ đòi hỏi nhiều trí thông minh, và bạn không muốn mắc sai lầm ở đây. Ví dụ: Sử dụng tính năng workflows từ Claude Code, hoặc suy nghĩ xhigh trên GPT-5.5.
• Chỉ thực hiện một refactor tại một thời điểm trong repository của bạn. Việc refactor trong khi thực hiện các triển khai khác cũng ổn, nhưng bạn không muốn có nhiều nhiệm vụ refactor chạy cùng một lúc.
• Nếu bạn không chắc chắn về cấu trúc thư mục tối ưu, hãy so sánh hoặc cung cấp cho tác nhân lập trình quyền truy cập vào một repository code khác có cấu trúc tốt mà bạn thích, và yêu cầu nó bắt chước cấu trúc đó.
• Refactor tốn thời gian. Hãy coi đó là một nhiệm vụ bạn chạy trong nền khi làm việc các việc khác.

Thông thường, khi tôi bắt đầu refactor code, tôi sử dụng thiết lập sau: Tôi mở Claude Code của mình trong một worktree mới trong repository, và khởi chạy nó với mức nỗ lực cao nhất có sẵn trong Claude Code, đó là Ultracode.

Nếu tôi biết những gì cần refactor, tôi sẽ cung cấp cho Ultracode và Claude càng nhiều thông tin càng tốt về những gì cần refactor và tại sao cần refactor nó. Bạn có thể nghĩ rằng việc đề cập đến lý do "tại sao" là không cần thiết, và trong một số trường hợp, đúng là như vậy, nhưng tôi thấy nó thực sự hữu ích vì khi đó AI sẽ hiểu lý do tại sao tôi đang làm những gì tôi đang làm, giúp nó phù hợp với những gì tôi muốn triển khai.

Sau đó, tôi để cho tác nhân có nhiều thời gian để đi qua toàn bộ repository, đặc biệt là phần tôi muốn refactor, và đưa ra một kế hoạch chi tiết về cách refactor. Tôi làm điều này trong chế độ kế hoạch (plan mode) trong Claude Code.

Sau đó, tôi đọc qua kế hoạch để đảm bảo nó như tôi mong đợi. Thông thường, các tác nhân giỏi refactor hơn tôi cá nhân, vì vậy tôi thấy rằng các kế hoạch thường ổn ngay từ lần thử đầu tiên.

Một phần quan trọng của câu lệnh (prompt) mà tôi sử dụng bất cứ khi nào thực hiện refactor là tôi yêu cầu mô hình triển khai các bài kiểm tra (tests) mà nó nên chạy trước và sau. Các bài kiểm tra này, tất nhiên, phải hoạt động trước đó, và tất nhiên, tất cả phải hoạt động trở lại khi hoàn tất. Điều này giúp mô hình xác minh công việc của mình và đảm bảo nó không giới thiệu bất kỳ lỗi mới nào khi thực hiện refactor.

Tôi đã thực hiện rất nhiều refactor bằng Claude Code, và tôi có thể nói rằng nó gần như hoàn hảo trong việc thực hiện công việc refactor. Khi tôi sử dụng thiết lập tôi mô tả ở trên, tôi rất hiếm khi gặp bất kỳ vấn đề nào, và nó hầu như luôn có sự gia tăng đáng kể về mức độ tốt mà các tác nhân lập trình có thể chạy trong repository của tôi.

Nói một cách đơn giản: Refactor code với Claude Code rất hiệu quả.

Kết luận

Trong bài viết này, tôi đã thảo luận về cách refactor code bằng Claude Code. Tôi đã thảo luận về lý do tại sao bạn nên quan tâm đến refactor, làm nổi bật cách nó có thể làm cho các tác nhân lập trình của bạn hiệu quả hơn nhiều trong việc triển khai trong repository code. Sau đó, tôi đề cập đến cách biết khi nào bạn cần refactor và cách refactor code, là hai điểm quan trọng nhất bạn nên biết khi nói đến refactor.

Với AI và các tác nhân lập trình, tôi tin rằng refactor code là thứ bạn nên đơn giản là thực hiện liên tục trong repository code của mình. Bạn thường xuyên nên để một tác nhân đi qua code của bạn, kiểm tra xem có gì cần refactor không, và bắt đầu refactor ngay lập tức. Thông thường, tác nhân sẽ có thể làm điều này hoàn toàn tự nó, và bạn sẽ không phải theo dõi nó nhiều, nhưng nó rất đơn giản để làm. Đó là điều bạn nên thực hiện liên tục để làm cho các tác nhân lập trình hiệu quả nhất có thể trong repository của bạn.