Thư mục là một thư mục cấu hình kiểm soát cách Claude Code hoạt động trong một dự án; Nó nằm trong gốc dự án của bạn (và có một đối tác toàn cục phù hợp trong ) xác định các lệnh, lệnh, quyền và bộ nhớ cho trợ lý..claude/~/.claude/
Hai loại thư mục.claude
-
Project-level .claude/: Nằm bên trong repo của bạn và được chia sẻ với nhóm (cam kết với Git). Nó chứa các quy tắc, lệnh, kỹ năng, tác nhân và .settings.json -
Toàn cầu
~/.claude/: Nằm trong thư mục chính của bạn và lưu trữ các tùy chọn cá nhân, CLAUDE.md chung, cài đặt chung và bộ nhớ tự động cho mỗi dự án trên tất cả các kho lưu trữ.
Các tệp và thư mục cốt lõi
-
CLAUDE.md: Tệp hướng dẫn chính mô tả kiến trúc, quy ước mã hóa và phong cách của dự án của bạn; Nhiều tệp có thể xếp chồng lên nhau (root, subdirs, global).CLAUDE.md -
CLAUDE.local.md: Ghi đè chỉ dành cho cá nhân tùy chọn (thường không được cam kết), ví dụ: tùy chọn dành riêng cho biên tập viên hoặc phím tắt cục bộ. -
.claude/rules/: Chứa các tệp đánh dấu mô-đun mở rộng hoặc ghi đè, hữu ích khi các hướng dẫn phát triển vượt quá ~ 200 dòng hoặc khi các nhóm khác nhau sở hữu các phần khác nhau.CLAUDE.md -
.claude/commands/: Giữ các lệnh gạch chéo tùy chỉnh (ví dụ: , , ) có thể gọi các tập lệnh hoặc công cụ shell, được giới hạn theo dự án hoặc toàn cục./review/test/deploy -
.claude/skills/: Xác định quy trình làm việc có thể tái sử dụng hoặc “kỹ năng” mà Claude có thể tự động gọi để đáp ứng các mẫu nhất định (ví dụ: dependency-upgrade, API-client-gen). -
.claude/agents/: Lưu trữ các tác nhân phụ chuyên biệt (persona) với các hướng dẫn và ràng buộc công cụ riêng, được sử dụng cho các tác vụ như đánh giá mã hoặc kiểm tra bảo mật. -
settings.json+settings.local.json: Các tệp JSON xác định quyền (danh sách cho phép/danh sách từ chối cho các công cụ, quyền truy cập tệp, v.v.); Phiên bản ghi đè bằng các cài đặt dành riêng cho máy..local
Bộ nhớ và hệ thống phân cấp
-
Bộ nhớ tự động trong
~/.claude/projects/<project>/memory/: Claude lưu các ghi chú, mẫu và lệnh được phát hiện ở cấp phiên, tồn tại trong các phiên trong tương lai trong dự án đó. -
Hệ thống sử dụng hệ thống phân cấp: toàn cục → thư mục gốc dự án → thư mục cây con, với các tệp sau này hoặc cụ thể hơn ghi đè lên các tệp trước đó khi chúng xung đột.
~/.claude/.claude/.claude/
Việc xác định cấu trúc đúng của thư mục .claude/ đã tạo ra sự khác biệt rõ rệt về chất lượng các dự án cá nhân của bạn.
Hầu hết người dùng mới bỏ qua bước thiết lập. Họ mở Claude Code và bắt đầu lập trình một cách tùy tiện. Không cấu trúc. Không quy tắc. Không bộ nhớ.
Thư mục .claude là hệ điều hành của Claude cho dự án của bạn. Làm đúng và Claude sẽ ngừng đoán. Làm sai và bạn sẽ mất một nửa thời gian để sửa chữa.
Đây là cấu trúc thư mục hiệu quả:
👉 CLAUDE.md → Sổ tay hướng dẫn của Claude. Các lệnh xây dựng, quyết định kiến trúc, quy ước, những điểm cần lưu ý. Giữ độ dài dưới 200 dòng. Đây là tệp có tác động mạnh nhất.
👉 rules/ → Khi CLAUDE.md trở nên quá tải, hãy chia nhỏ theo từng vấn đề. code-style.md, testing.md, api-conventions.md. Giới hạn phạm vi các quy tắc cho các đường dẫn cụ thể bằng YAML frontmatter để chúng chỉ được tải khi có liên quan.
👉 commands/ → Các quy trình làm việc có thể lặp lại dưới dạng lệnh gạch chéo. Xem xét mã, sửa lỗi, kiểm tra triển khai. Chúng chạy các lệnh shell và chèn đầu ra thực vào dấu nhắc lệnh.
👉 skills/ → Giống như commands nhưng Claude tự động kích hoạt chúng khi tác vụ phù hợp. Chúng là các gói, không phải các tệp riêng lẻ.
👉 agents/ → Các nhân vật phụ độc lập với các công cụ và tùy chọn mô hình riêng. Một người xem xét mã chỉ đọc. Một chuyên gia kiểm toán bảo mật được giới hạn ở lệnh grep.
👉 settings.json → Kiểm soát quyền. Những gì Claude có thể chạy tự do, những gì nó phải hỏi, những gì bị chặn hoàn toàn.
Phần mà hầu hết mọi người bỏ qua: có hai thư mục .claude. Một trong dự án của bạn (đã được cam kết, chia sẻ với nhóm) và một tại ~/.claude/ (cá nhân, toàn cầu trên tất cả các kho lưu trữ).
Thư mục .claude là cơ sở hạ tầng. Hãy coi nó như vậy.
——
(St.)
Ý kiến bạn đọc (0)