Bỏ qua đến nội dung chính

Custom commands

📖 Nội dung bài học

Họ phông chữ Video này đang được xử lý. Vui lòng quay lại sau và tải lại trang.

Tóm tắt

Claude Code đi kèm với các lệnh tích hợp sẵn mà bạn có thể truy cập bằng cách gõ dấu gạch chéo (/), nhưng bạn cũng có thể tạo các lệnh tùy chỉnh (custom commands) của riêng mình để tự động hóa các tác vụ lặp đi lặp lại thường xuyên.

Tạo lệnh tùy chỉnh

Để tạo một lệnh tùy chỉnh, bạn cần thiết lập cấu trúc thư mục cụ thể trong dự án của mình:

  1. Tìm thư mục .claude trong thư mục gốc của dự án.
  2. Tạo một thư mục mới tên là commands bên trong đó.
  3. Tạo một tệp markdown mới với tên lệnh bạn muốn (ví dụ: audit.md).

Tên tệp sẽ trở thành tên lệnh của bạn - vì vậy audit.md sẽ tạo ra lệnh /audit.

Ví dụ: Lệnh Audit

Dưới đây là một ví dụ thực tế về lệnh tùy chỉnh dùng để kiểm tra (audit) các gói phụ thuộc (dependencies) của dự án nhằm tìm lỗ hổng bảo mật:

Lệnh audit này thực hiện ba việc:

  1. Chạy npm audit để tìm các gói đã cài đặt có lỗ hổng bảo mật.
  2. Chạy npm audit fix để áp dụng các bản cập nhật.
  3. Chạy các bài kiểm tra (tests) để xác minh rằng các bản cập nhật không làm hỏng ứng dụng.

Sau khi tạo tệp lệnh, bạn phải khởi động lại Claude Code để nó nhận diện lệnh mới.

Lệnh kèm tham số (Arguments)

Các lệnh tùy chỉnh có thể nhận tham số (arguments) bằng cách sử dụng trình giữ chỗ (placeholder) $ARGUMENTS. Điều này giúp chúng linh hoạt và có thể tái sử dụng tốt hơn nhiều.

Ví dụ, một lệnh write_tests.md có thể chứa nội dung sau:

Write comprehensive tests for: $ARGUMENTS

Testing conventions:
* Use Vitests with React Testing Library
* Place test files in a __tests__ directory in the same folder as the source file
* Name test files as [filename].test.ts(x)
* Use @/ prefix for imports

Coverage:
* Test happy paths
* Test edge cases
* Test error states

Sau đó, bạn có thể chạy lệnh này kèm theo đường dẫn tệp:

/write_tests tệp use-auth.ts trong thư mục hooks

Các tham số không nhất thiết phải là đường dẫn tệp - chúng có thể là bất kỳ chuỗi ký tự nào bạn muốn truyền vào để cung cấp ngữ cảnh (context) và hướng dẫn cho Claude thực hiện nhiệm vụ.

Lợi ích chính

  • Tự động hóa (Automation) - Biến các quy trình làm việc lặp đi lặp lại thành các lệnh đơn lẻ.
  • Sự nhất quán (Consistency) - Đảm bảo các bước giống nhau luôn được thực hiện mọi lúc.
  • Ngữ cảnh (Context) - Cung cấp cho Claude các hướng dẫn và quy ước cụ thể cho dự án của bạn.
  • Tính linh hoạt (Flexibility) - Sử dụng tham số để lệnh hoạt động với các đầu vào khác nhau.

Các lệnh tùy chỉnh đặc biệt hữu ích cho các quy trình làm việc đặc thù của dự án như chạy bộ kiểm thử (test suites), triển khai mã (deploy), hoặc tạo mã mẫu (boilerplate) theo quy ước của nhóm bạn.

🔁 Bài học liên quan

📚 Nguồn & ghi nhận

Bài học có hữu ích không?

Góp ý / Báo lỗiPhát hiện sai sót hoặc có ý tưởng cải thiện?