Cách dùng Claude Code sửa code an toàn: quy trình 6 bước

Claude Code có thể đọc và chỉnh sửa nhiều tệp trong dự án, vì vậy yêu cầu “sửa giúp tôi” thường quá rộng. Một quy trình có điểm dừng giúp bạn hiểu phạm vi, xem thay đổi và phát hiện lỗi trước khi đưa code vào nhánh chính.

Bước 1: xác định kết quả và giới hạn

Mô tả lỗi bằng hành vi mong muốn, hành vi hiện tại và cách tái hiện. Nói rõ khu vực được phép sửa, các khu vực cần giữ nguyên và tiêu chí hoàn tất. Nếu chưa hiểu nguyên nhân, yêu cầu Claude Code khảo sát và trình bày kế hoạch trước.

Bước 2: đọc trạng thái repository

Trước khi sửa, kiểm tra branch, diff đang có và các tệp chưa commit. Điều này giúp phân biệt thay đổi của bạn với phần trợ lý sắp tạo. Không yêu cầu công cụ ghi đè những thay đổi bạn chưa lưu.

Bước 3: chia việc thành thay đổi nhỏ

Một yêu cầu nên tập trung vào một kết quả. Ví dụ, trước tiên sửa điều kiện gây lỗi; sau đó mới cân nhắc tái cấu trúc. Thay đổi nhỏ dễ review hơn và giúp bạn xác định nguyên nhân nếu kiểm tra thất bại.

Bước 4: yêu cầu kiểm chứng, không chỉ viết code

Nêu lệnh kiểm tra phù hợp với dự án hoặc yêu cầu một trường hợp tái hiện lỗi. Nếu không chạy được kiểm tra, cần biết lý do và điều gì chưa được xác nhận. Claude Code không thể chứng minh code đúng chỉ bằng cách nói rằng đã sửa xong.

Bước 5: đọc diff từng tệp

Kiểm tra thay đổi có đúng phạm vi không, có thêm dependency hoặc sửa cấu hình không cần thiết không, và có xử lý trường hợp lỗi không. Đặc biệt chú ý tới lệnh shell, thao tác xóa dữ liệu, thông tin xác thực và mã nguồn được sinh tự động.

Bước 6: tự quyết định trước khi tích hợp

Chỉ giữ lại thay đổi bạn hiểu và chấp nhận. Tài liệu Anthropic mô tả các chế độ quyền cho công cụ và lưu ý về việc bỏ qua lời nhắc cấp quyền; hãy xem tham chiếu CLI chính thức thay vì tắt kiểm tra quyền theo thói quen.

Prompt mẫu

Hãy khảo sát lỗi trước, chưa sửa file. Tóm tắt nguyên nhân có khả năng nhất, các file liên quan và cách tái hiện. Chờ tôi xác nhận kế hoạch. Sau khi được duyệt, chỉ sửa phần cần thiết, chạy kiểm tra phù hợp và tóm tắt từng thay đổi cùng kết quả.

Claude Code có thể tăng tốc công việc, nhưng trách nhiệm review vẫn thuộc về người đưa thay đổi vào dự án. Coi diff và kết quả kiểm tra là đầu ra cần xem xét, không phải thủ tục hình thức.