Cấu Trúc Thư Mục .claude/

Giới Thiệu

Nhiều nhóm đã áp dụng AI, nhưng khoảng cách giữa “sử dụng AI” và “đạt được ROI có thể đo lường từ AI” lớn hơn người ta tưởng. Postman đã công bố phân tích tiết kiệm chi phí, so sánh sự khác biệt về thời gian và chi phí thực tế khi AI được tích hợp sẵn trên nền tảng.

Thư Mục .claude/

Thư mục .claude/ là trung tâm kiểm soát cho cách Claude hoạt động trong dự án. Trong thư mục này, bạn có thể cấu hình Claude Code theo đúng nhu cầu của nhóm.

Thư Mục Dự Án và Toàn Cầu

Có hai thư mục .claude, một trong dự án và một tại thư mục gốc nhà của bạn.

• Thư mục dự án: Quản lý cấu hình nhóm.
• Thư mục toàn cầu: Giữ các tùy chọn cá nhân và trạng thái máy cục bộ.

Tập Tin Quan Trọng

CLAUDE.md

File này rất quan trọng. Claude sẽ đọc CLAUDE.md đầu tiên khi khởi chạy và theo dõi nó trong suốt phiên.

Hướng Dẫn:

• Nên Viết:

  • Lệnh build, test, lint
  • Quyết định kiến trúc chính
  • Các lưu ý quan trọng
  • Quy ước import, cách đặt tên

• Không Viết:

  • Cấu hình cho linter hay formatter
  • Tài liệu đầy đủ

Ví Dụ Tối Giản

Dưới 200 dòng là tốt nhất để tránh mất ngữ cảnh.

Tinh Chỉnh Cá Nhân

Tạo CLAUDE.local.md nếu có tùy chỉnh cá nhân, và nó sẽ không được tải lên repo.

Thư Mục Quy Tắc

Thư Mục rules/

Tách các hướng dẫn bằng cách tạo các file markdown nhỏ:

• Mỗi file tập trung vào một chủ đề, dễ duy trì và cập nhật.
• Kích hoạt định kỳ dựa trên đường dẫn cụ thể với frontmatter YAML.

Lệnh Tùy Chỉnh

Thư Mục commands/

Mỗi file markdown trong thư mục này tạo ra một lệnh slash mới.

/project:review

Kỹ Năng

Thư Mục skills/

• Kỹ năng có thể được Claude gọi tự động khi phù hợp.
• Bao gồm các tệp hỗ trợ.

Đặc Tính Kỹ Thuật

Thư Mục agents/

Khi có nhiệm vụ phức tạp, bạn có thể định nghĩa persona đại lý dưới dạng markdown.

Tùy Chọn Trong settings.json

• Allow list: Cho phép chạy mà không cần xin phép.
• Deny list: Cấm tuyệt đối.

Tạo settings.local.json cho những thay đổi cá nhân không muốn tải lên.

Các Thư Mục Liên Quan Khác

• ~/.claude/CLAUDE.md: Áp dụng cho mọi dự án.
• ~/.claude/projects/: Lưu trữ lịch sử phiên.
• ~/.claude/commands/, ~/.claude/skills/: Lệnh và kỹ năng cá nhân.

Tổng Kết

Bắt đầu từ những bước nhỏ và tinh chỉnh theo thời gian. Thư mục .claude là giao thức truyền tải cách Claude tương tác với dự án của bạn và đóng góp mạnh mẽ khi được cấu hình đúng cách.