Thư mục .claude

Claude Code lưu cấu hình và dữ liệu ở hai nơi: .claude/ trong từng dự án, và ~/.claude/ (thư mục home) cho cấu hình cá nhân áp dụng mọi dự án. Hiểu cấu trúc này giúp bạn biết chính xác nên đặt một tuỳ biến ở đâu.

Cấu trúc thư mục dự án

your-project/
├── CLAUDE.md                 # Chỉ dẫn dự án — nạp mỗi phiên (commit vào git)
├── CLAUDE.local.md           # Sở thích riêng của bạn cho dự án này (gitignore)
├── .mcp.json                 # MCP server dùng chung với cả team (commit vào git)
├── .worktreeinclude          # File gitignored cần copy khi tạo worktree mới
└── .claude/
    ├── settings.json         # Quyền hạn, hooks, biến môi trường (commit vào git)
    ├── settings.local.json   # Ghi đè cá nhân, chỉ máy này (gitignore)
    ├── rules/                # Chỉ dẫn theo chủ đề, có thể giới hạn theo đường dẫn file
    │   ├── testing.md
    │   └── api-conventions.md
    ├── skills/                # Prompt/quy trình tái sử dụng, gọi bằng /tên
    │   └── review-pr/
    │       └── SKILL.md
    ├── commands/              # Prompt một-file, cũng gọi bằng /tên
    ├── agents/                # Định nghĩa subagent — tool và system prompt riêng
    │   └── code-reviewer.md
    ├── output-styles/         # Tuỳ biến cách Claude định dạng câu trả lời
    └── agent-memory/          # Bộ nhớ riêng của từng subagent (nếu bật)

Cấu trúc thư mục cá nhân (`~/.claude/`)

~/.claude/
├── settings.json          # Cấu hình cá nhân, áp dụng mọi dự án
├── CLAUDE.md               # Chỉ dẫn cá nhân, áp dụng mọi dự án
├── rules/                  # Rule cá nhân, áp dụng mọi dự án
├── skills/                 # Skill cá nhân, dùng ở mọi dự án
├── agents/                 # Subagent cá nhân, dùng ở mọi dự án
├── keybindings.json        # Phím tắt tuỳ biến
├── themes/                 # Theme màu tuỳ biến
└── projects/
    └── <tên-dự-án>/
        ├── <session-id>.jsonl     # Transcript đầy đủ của từng phiên
        └── memory/
            ├── MEMORY.md          # Auto memory — mục lục, nạp mỗi phiên
            └── ...                # Các file chủ đề chi tiết hơn

File nào để làm gì

Bạn muốn…	Sửa file	Phạm vi	Xem thêm
Cho Claude biết ngữ cảnh và quy ước dự án	`CLAUDE.md`	dự án hoặc cá nhân	Bộ nhớ
Cho phép/chặn một tool hoặc lệnh cụ thể	`settings.json` → `permissions`	dự án hoặc cá nhân	Cấu hình
Chạy script trước/sau khi Claude dùng tool	`settings.json` → `hooks`	dự án hoặc cá nhân	Hooks
Đặt biến môi trường cho phiên	`settings.json` → `env`	dự án hoặc cá nhân	Cấu hình
Giữ tuỳ biến cá nhân ngoài git	`settings.local.json`	chỉ dự án này	Cấu hình
Thêm quy trình gọi được bằng `/tên`	`skills/<tên>/SKILL.md`	dự án hoặc cá nhân	Skills
Định nghĩa subagent chuyên biệt	`agents/*.md`	dự án hoặc cá nhân	Subagents
Kết nối công cụ ngoài qua MCP	`.mcp.json`	chỉ dự án	MCP

Vài lưu ý quan trọng

Có thứ tự ưu tiên: cấu hình cấp tổ chức (managed) do IT triển khai luôn thắng mọi cấu hình khác; cờ dòng lệnh (như --permission-mode) ghi đè settings.json cho phiên đó. Xem thứ tự đầy đủ tại Cấu hình.
.gitignore quan trọng: settings.local.json và CLAUDE.local.md mặc định là riêng tư — luôn thêm vào .gitignore nếu Claude Code chưa tự làm.
~/.claude/projects/ chứa dữ liệu Claude Code tự ghi ra khi làm việc: transcript hội thoại đầy đủ, auto memory, snapshot file trước khi sửa (phục vụ checkpoint/rewind), log debug… Đây đều là plaintext, không mã hoá — nếu một file .env hay một lệnh in ra thông tin nhạy cảm, giá trị đó sẽ nằm trong transcript. Cân nhắc dùng quy tắc permission để chặn đọc file credential, hoặc giảm cleanupPeriodDays trong settings để transcript tự xoá sớm hơn (mặc định 30 ngày).

Dọn dữ liệu cục bộ

Chạy lệnh sau để xoá toàn bộ trạng thái Claude Code lưu cho một dự án (transcript, auto memory, lịch sử prompt liên quan…):

claude project purge ~/duong-dan/du-an --dry-run   # xem trước sẽ xoá gì, không xoá thật
claude project purge ~/duong-dan/du-an              # xoá, có hỏi xác nhận

Lệnh này chỉ xoá dữ liệu cục bộ trên máy bạn (transcript, cache, cấu hình lưu về dự án đó) — không đụng đến CLAUDE.md, settings.json hay bất kỳ file nào bạn đã commit vào git.