Hầu hết người dùng Claude Code đều biết
.thư mục/
của .claude/
tồn tại, nhưng chưa từng thực sự mở nó ra. Kỹ sư AI Akshay gần đây đã tổng hợp một hướng dẫn đầy đủ, phân tích chức năng của từng tệp trong thư mục này, cũng như cách thiết lập để Claude hoạt động hoàn toàn theo cách của bạn.
Hai thư mục, không phải là một
Trước tiên cần làm rõ một hiểu lầm phổ biến:
.thư mục/
của .claude/
có hai thư mục, không phải là một.
Cấp độ dự án (dự án của bạn/.claude/): chứa các thiết lập chia sẻ cho nhóm, được đẩy lên Git, để tất cả mọi người có thể có các quy tắc và lệnh nhất quán
Cấp độ toàn cục (~/.claude/): sở thích cá nhân và thiết lập giữa các dự án, chỉ ảnh hưởng đến máy của riêng bạn
CLAUDE.md: một tệp quan trọng nhất
Mỗi lần khởi động phiên làm việc Claude Code, Claude sẽ đọc
CLAUDE.md
và tải nội dung này vào hệ thống prompt (system prompt), duy trì tuân thủ các chỉ thị trong suốt cuộc hội thoại.
Nội dung cần ghi vào:
Lệnh build, test, lint (như npm run test)
Các quyết định kiến trúc quan trọng
Các chú ý không rõ ràng (ví dụ như “Chế độ strict của TypeScript bật, biến không sử dụng sẽ báo lỗi”)
Quy tắc đặt tên, phong cách xử lý lỗi
Những nội dung không nên ghi: quy tắc đặt trong cấu hình linter, tài liệu đầy đủ, giải thích lý thuyết dài dòng.
Akshay đề xuất giữ CLAUDE.md trong khoảng 200 dòng — vượt quá độ dài này, tỷ lệ tuân thủ lệnh của Claude thực tế sẽ giảm, vì tiêu hao quá nhiều ngữ cảnh.
Thư mục rules/：Lệnh module hóa, phù hợp mở rộng nhóm
Khi CLAUDE.md ngày càng trở nên cồng kềnh,
.thư mục/rules/
là giải pháp. Mỗi tệp Markdown đại diện cho một điểm chú ý, ví dụ như code-style.md, testing.md, api-conventions.md, Claude sẽ tự động đọc tất cả các tệp này.
Điều mạnh mẽ hơn là “quy tắc phạm vi đường dẫn”: thêm dữ liệu YAML tiền tố vào tệp quy tắc, giúp quy tắc chỉ được tải khi Claude xử lý các tệp trong đường dẫn cụ thể, tránh để các quy tắc không liên quan chiếm dụng ngữ cảnh.
Thư mục commands/：Lệnh chéo tùy chỉnh
Đặt trong
.thư mục/.claude/commands/
Mỗi tệp Markdown sẽ trở thành một lệnh chéo. review.md tương ứng với /project:review, fix-issue.md tương ứng với /project:fix-issue.
Chức năng hữu ích nhất là sử dụng cú pháp
!
trong tệp lệnh để thực thi lệnh shell và nhúng đầu ra — ví dụ như tự động lấy git diff để chèn vào prompt, giúp Claude “thấy” rõ các thay đổi mã của bạn. Các lệnh cá nhân đặt trong ~/.claude/commands/ có thể dùng chung cho tất cả các dự án.
skills/ và agents/：Kích hoạt chủ động vs. chỉ định phụ代理
Sự khác biệt cốt lõi giữa Skills và agents là cách kích hoạt:
Skills: Claude dựa vào nội dung hội thoại để tự động quyết định có gọi hay không, không cần nhập lệnh thủ công. Mỗi skill có thư mục riêng và tệp SKILL.md, có thể kèm theo các tệp hỗ trợ.
Agents: Định nghĩa nhân cách phụ代理 chuyên nghiệp, có prompt hệ thống riêng, quyền công cụ và thiết lập mô hình. Trong các nhiệm vụ phức tạp, Claude sẽ spawn một cửa sổ ngữ cảnh cách ly để代理 thực thi, tránh làm đầy ngữ cảnh chính bằng quá nhiều token.
Trong agents,
tools
của chúng có thể giới hạn phạm vi hành động của phụ代理 — chẳng hạn như agent kiểm tra an toàn chỉ cần quyền đọc, không có khả năng ghi. Trường model cho phép bạn chọn mô hình nhẹ hơn cho các nhiệm vụ tập trung, tiết kiệm chi phí.
settings.json: Danh sách trắng và danh sách đen quyền
.thư mục/.claude/settings.json
quản lý các thao tác được phép hoặc bị cấm của Claude:
allow (danh sách cho phép): thực thi trực tiếp, không cần xác nhận (ví dụ như npm run *, git *)
deny (danh sách cấm): hoàn toàn chặn (ví dụ như rm -rf *, đọc .env)
Các thao tác không nằm trong danh sách: Claude sẽ hỏi xác nhận tiếp tục
Cài đặt cá nhân có thể đặt trong
.thư mục/.claude/settings.local.json
, tự động được gitignore, không đẩy lên kho.
Bắt đầu từ đâu?
Theo đề xuất của Akshay, thứ tự khởi đầu thực dụng là: chạy
/init
để tạo ra CLAUDE.md ban đầu, thêm vào settings.json để thiết lập quyền cơ bản, rồi tạo một hoặc hai lệnh tùy chỉnh phổ biến nhất — các lệnh còn lại sẽ dần được thêm theo thói quen sử dụng.
Điểm cốt lõi là:
.thư mục/.claude/
là giao thức để bạn nói với Claude “Bạn là ai, dự án là gì, cần tuân thủ quy tắc nào”. Thiết lập rõ ràng càng nhiều, thời gian sửa lỗi Claude càng ít.
Bài viết này giúp bạn hiểu rõ hơn về thư mục .claude/: Trung tâm điều khiển của Claude Code, phân tích đầy đủ về CLAUDE.md, lệnh, skills và quyền hạn ban đầu xuất hiện trên ABMedia của Chain News.
