Thao tác file trong Claude Code

Claude có thể thay đổi file của bạn

Trong bài học trước, chúng ta đã tìm hiểu về điều phối tác vụ. Bây giờ, hãy xây dựng trên nền tảng đó. Điều này rất mạnh mẽ. Nó cũng là một trách nhiệm.

Claude Code có thể tạo, chỉnh sửa và xóa file. Nếu làm tốt, điều này sẽ giúp tăng năng suất rất nhiều. Nếu làm bất cẩn, bạn có thể gây ra rắc rối.

Bài viết này sẽ dạy bạn cách làm việc với các file một cách an toàn và hiệu quả.

Lưới an toàn: Git

Trước khi thực hiện bất kỳ công việc quan trọng nào với Claude, hãy đảm bảo:

1. Làm sạch thư mục làm việc bash git status # Nên sạch hoặc đã được commit
2. Biết bạn đang ở nhánh nào bash git branch # Biết bạn đang ở đâu
3. Commit thường xuyên. Sau khi thực hiện các thay đổi tốt, hãy commit. Nếu có gì đó không ổn, bạn luôn có thể quay lại.

Git là lưới an toàn của bạn. Với nó, bất kỳ lỗi nào của Claude đều có thể khắc phục được.

Các mẫu thao tác file

Tạo file mới

> Tạo một file tiện ích mới tại src/utils/string-helpers.js
> Bao gồm các hàm cho: viết hoa, cắt ngắn, chuyển đổi slug

Claude tạo file với nội dung. Xem lại trước khi tiếp tục.

Đối với nhiều file liên quan:

> Tạo các file sau cho tính năng "bình luận" mới:
> - src/models/comment.js (mô hình dữ liệu)
> - src/services/comment-service.js (logic nghiệp vụ)
> - src/routes/comments.js (các tuyến API)
> - tests/comments.test.js (khung kiểm thử)

Các file liên quan được tạo cùng nhau thường nhất quán.

Chỉnh sửa các file hiện có

Luôn thêm file trước:

/add src/auth/login.js
> Thêm giới hạn tốc độ cho chức năng đăng nhập. Tối đa 5 lần thử mỗi phút.

Claude xem file, hiểu ngữ cảnh, thực hiện các thay đổi có mục tiêu.

Hãy cụ thể về những gì cần thay đổi:

> Trong hàm handleSubmit, thêm xác thực trước khi gọi API.
> Kiểm tra xem email có định dạng hợp lệ và mật khẩu có ít nhất 8 ký tự.

Hướng dẫn cụ thể → thay đổi chính xác.

Chỉnh sửa nhiều file

Để thực hiện các thay đổi phối hợp trên nhiều file:

/add src/types/user.ts src/services/user-service.ts src/routes/users.ts
> Thêm trường "phoneNumber" tùy chọn vào User type.
> Cập nhật dịch vụ và các tuyến đường để xử lý trường này.

Tất cả các file liên quan trong ngữ cảnh → Những thay đổi nhất quán trên tất cả các file.

Đổi tên và di chuyển

> Đổi tên src/utils/helpers.js thành src/utils/string-utils.js
> Cập nhật tất cả các câu lệnh import trong toàn bộ mã nguồn.

Claude xử lý cả việc đổi tên và cập nhật import.

Xóa file

> Thư mục src/old-auth/ không còn được sử dụng nữa.
> Xóa thư mục này và dọn dẹp mọi tham chiếu.

Hãy nêu rõ những gì cần xóa. Claude sẽ yêu cầu xác nhận đối với các thao tác gây ảnh hưởng đến dữ liệu.

Chiến lược xem xét

Xem xét trực tiếp

Sau mỗi thay đổi, hãy xem xét trước khi tiếp tục:

> Thêm kiểm tra hợp lệ đầu vào vào hàm createUser

# Claude thực hiện thay đổi

> Cho tôi xem sự khác biệt

# Xem lại các thay đổi

> Tốt. Bây giờ hãy thêm các bài kiểm tra cho việc kiểm tra hợp lệ.

Xem xét Git Diff

Sau khi Claude thực hiện thay đổi:

git diff src/auth/login.js    # Xem chính xác những gì đã thay đổi

Git diff thường rõ ràng hơn so với xem xét trực tiếp đối với các thay đổi phức tạp.

Xem xét theo giai đoạn

Đối với các thay đổi lớn:

> Thực hiện các thay đổi để triển khai tính năng X

# Claude thực hiện nhiều thay đổi

git add -p # Thêm các thay đổi vào giai đoạn một cách tương tác
git commit -m "Phần 1: thay đổi mô hình"

# Tiếp tục thêm vào giai đoạn
git add -p
git commit -m "Phần 2: lớp dịch vụ"

Xem xét và commit theo từng phần hợp lý.

Các thủ tục khôi phục

/undo

Hoàn tác ngay lập tức thay đổi cuối cùng của Claude:

/undo

Sử dụng lệnh này khi bạn thấy một thay đổi không mong muốn. Hiệu quả nhất khi thực hiện trước khi bạn tiếp tục.

Git Reset

Nếu bạn chưa commit:

git checkout -- src/file-that-got-messed-up.js

Khôi phục file về trạng thái đã commit lần cuối.

Lưu tạm và bắt đầu lại

Nếu mọi thứ lộn xộn:

git stash   # Lưu các thay đổi hiện tại
# Bắt đầu lại với Claude
git stash pop   # Khôi phục các thay đổi nếu cần

Khôi phục hoàn toàn

Phương án tối ưu (chỉ các thay đổi chưa được commit):

git reset --hard HEAD

Quay lại commit cuối cùng. Sử dụng hạn chế.

Kỹ thuật hiệu quả

Thay đổi liên quan hàng loạt

Chậm:

> Thêm trường "createdAt" vào mô hình User
> Thêm trường "updatedAt" vào mô hình User
> Thêm trường "lastLoginAt" vào mô hình User

Nhanh:

> Thêm các trường dấu thời gian vào mô hình User:
> - createdAt: thời điểm người dùng được tạo
> - updatedAt: thời điểm người dùng được sửa đổi lần cuối
> - lastLoginAt: thời điểm người dùng đăng nhập lần cuối

Một yêu cầu cho các thay đổi liên quan.

Tạo dựa trên template

> Tạo 5 file định tuyến API mới theo mẫu src/routes/users.js:
> - products.js
> - orders.js
> - inventory.js
> - categories.js
> - suppliers.js

Claude sao chép các mẫu một cách hiệu quả.

Thao tác hàng loạt

> Trong tất cả các file khớp với src/services/*.js:
> - Thêm ghi nhật ký lỗi vào các khối catch
> - Sử dụng trình ghi nhật ký từ src/utils/logger.js

Thay đổi hàng loạt dựa trên mẫu.

Danh sách kiểm tra thao tác file

Trước khi thực hiện thao tác file:

• [ ] Thư mục làm việc của Git sạch (hoặc các thay đổi đã được lưu trữ tạm thời)
• [ ] Các file liên quan đã được thêm vào ngữ cảnh
• [ ] Nhiệm vụ đủ cụ thể để nhận được các thay đổi chính xác

Trong khi thực hiện thao tác file:

• [ ] Xem lại các thay đổi trước khi tiếp tục
• [ ] Sử dụng /undo ngay lập tức nếu có gì đó sai
• [ ] Cam kết các nhóm thay đổi hợp lý

Sau khi thực hiện thao tác file:

• [ ] Xem lại toàn bộ diff bằng git diff
• [ ] Chạy thử nghiệm nếu có thể
• [ ] Cam kết với thông báo rõ ràng

Những điểm chính cần ghi nhớ

• Git là lưới an toàn của bạn - cam kết thường xuyên, hoàn tác dễ dàng
• Luôn thêm các file vào ngữ cảnh trước khi yêu cầu thay đổi
• Hãy cụ thể về những gì cần thay đổi và ở đâu
• Xem lại các thay đổi trước khi tiếp tục
• Sử dụng /undo và git để khôi phục
• Xử lý các thay đổi liên quan hàng loạt để tăng hiệu quả