Bảng Tham Chiếu Claude Code

import { Aside, Card, CardGrid } from ‘@astrojs/starlight/components’;

Tham Chiếu Nhanh — Tất Cả Lệnh

Lệnh CLI (Terminal)

Lệnh	Mục đích	Ví dụ
claude	Bắt đầu phiên REPL tương tác	claude
claude -p "prompt"	Chế độ one-shot	claude -p "giải thích lỗi này"
claude --model sonnet	Chọn model cụ thể	claude --model opus
claude --version	Kiểm tra phiên bản	claude --version
cat file | claude -p "..."	Chế độ pipe — đưa nội dung file	cat log.txt | claude -p "tóm tắt"
claude config	Quản lý cấu hình	claude config

Dùng **one-shot mode** (`-p`) cho câu hỏi nhanh. Dùng **REPL mode** cho hội thoại nhiều lượt và task phức tạp.

Slash Commands (Trong REPL)

Lệnh	Chức năng	Khi nào dùng
/help	Liệt kê tất cả lệnh	Quên cú pháp? Bắt đầu từ đây
/init	Tạo CLAUDE.md cho project	Lần đầu vào project mới
/compact	Nén lịch sử hội thoại	Context ở 50-70% — giải phóng 30-70% token
/clear	Xóa TOÀN BỘ context	Chuyển sang project khác
/cost	Hiện token đã dùng và chi phí	Kiểm tra mỗi 20-30 phút
/exit hoặc Ctrl+C	Thoát phiên	Xong việc

`/compact` giữ lại context task đang làm. `/clear` xóa tất cả. Ưu tiên `/compact` khi đang làm việc.

Chọn Chế Độ Phù Hợp

Tình huống	Chế độ	Lệnh
Debug nhiều lượt	REPL	claude
Câu hỏi nhanh	One-shot	claude -p "..."
Review diff	Pipe	git diff | claude -p "review"
Phân tích log	Pipe	cat errors.log | claude -p "phân tích"
CI/CD	One-shot	Script dùng -p
Học / khám phá	REPL	claude

Chọn Model

Model	Chi phí	Dùng cho
Haiku	$	Format, sửa typo, edit đơn giản, trả lời nhanh
Sonnet	$$	Feature, debug, code review, documentation
Opus	$$$	Architecture, debug phức tạp, security, bài toán mới

Mặc định dùng **Sonnet** cho hầu hết task. Dùng **Haiku** cho edit đơn giản. Chỉ dùng **Opus** cho architecture và reasoning phức tạp.

---

Best Practice cho CLAUDE.md

6 Phần Thiết Yếu

Mỗi CLAUDE.md trong project nên có 6 phần sau:

# Project: [Tên]

## 1. Tổng Quan Project
Tech stack: Node.js 20, Express, PostgreSQL, Redis
Architecture: Monorepo với thư mục packages/

## 2. Quy Tắc Kiến Trúc
- Routes → Services → Repositories → Database
- Business logic chỉ ở services, không bao giờ ở routes
- Types dùng chung trong packages/shared/

## 3. Quy Ước Code
- Files: kebab-case (user-service.ts)
- Classes: PascalCase (UserService)
- Functions: camelCase (getUserById)
- Error handling: Promise<Result<T, AppError>>
- Imports: Tuyệt đối qua @/ prefix

## 4. Lệnh Thường Dùng
npm run dev          # Start dev server (port 3000)
npm test             # Chạy tất cả test
npm run lint         # ESLint + Prettier
npm run db:migrate   # Chạy database migration

## 5. Ràng Buộc (KHÔNG ĐƯỢC)
- KHÔNG dùng `any` type — luôn định nghĩa type cụ thể
- KHÔNG cài dependencies mà không hỏi trước
- KHÔNG đặt business logic trong route handler
- KHÔNG commit file .env
- KHÔNG sửa database schema mà không có migration

## 6. Context (Kiến Thức Ngầm)
- Redis key PHẢI có version prefix: v1:user:123
- JWT hết hạn sau 15 phút, refresh token sau 7 ngày
- Legacy /api/v1 routes giữ lại cho mobile app
- Payment gateway sandbox dùng key có prefix TEST_

Kích Thước CLAUDE.md

Kích thước	Token	Chất lượng
300-500 từ	~400-650	Tối thiểu — thiếu edge case
500-800 từ	~650-1000	Vừa đủ cho hầu hết project
800-1200 từ	~1000-1500	Toàn diện — project lớn
1200+ từ	1500+	Quá dài — giảm hiệu quả

Giữ CLAUDE.md dưới 1000 từ. Mỗi token dùng cho project memory là một token KHÔNG có sẵn cho công việc thực tế.

Thứ Tự Ưu Tiên File

Vị trí	Phạm vi	Ưu tiên
~/.claude/CLAUDE.md	Toàn cục (mọi project)	Thấp nhất
./CLAUDE.md	Gốc project	Chính — dùng cái này
./src/CLAUDE.md	Cấp thư mục	Cao nhất (ghi đè gốc)

---

Hướng Dẫn File Pattern

.gitignore — Bảo Vệ Secret

# Secret — KHÔNG BAO GIỜ commit
.env
.env.local
.env.*.local

# Dependencies
node_modules/
vendor/
.venv/

# Build output
dist/
build/
.next/

# File hệ điều hành
.DS_Store
Thumbs.db

Pattern .env.example — An Toàn Cho Claude

# .env.example — commit vào git, an toàn cho Claude đọc
DATABASE_URL=postgresql://user:password@localhost:5432/dbname
REDIS_URL=redis://:password@localhost:6379
API_KEY=your_api_key_here
STRIPE_KEY=sk_test_placeholder

# .env — secret thật, gitignored, KHÔNG BAO GIỜ cho Claude đọc
# DATABASE_URL=postgresql://realuser:s3cr3t@prod.db:5432/prod

**Không bao giờ** cho Claude đọc file `.env` trực tiếp. Luôn dùng `.env.example` với giá trị placeholder. Nếu secret bị lộ, rotate ngay lập tức.

Tham Chiếu Nhanh Quyền Hạn

Loại Lệnh	Hành động
ls, pwd, cat, head, tail	Cho phép — chỉ đọc
grep, find	Cho phép — chỉ tìm kiếm
git status, git log, git diff	Cho phép — git chỉ đọc
git commit -m "..."	Kiểm tra message trước
npm install <package>	Xác nhận tên package
Ghi file trong src/	Kiểm tra đường dẫn và nội dung
rm, git push --force	Luôn từ chối trừ khi cố ý
curl, wget	Luôn từ chối — rủi ro lộ dữ liệu
Thao tác trên ~/.ssh/, ~/.aws/	Luôn từ chối — thư mục nhạy cảm

Cài Đặt Secret Scanner (Gitleaks)

# Cài đặt
brew install gitleaks

# Thêm pre-commit hook
cat > .git/hooks/pre-commit << 'HOOK'
#!/bin/bash
gitleaks protect --staged --verbose
if [ $? -ne 0 ]; then
    echo "PHÁT HIỆN SECRET! Commit bị chặn."
    exit 1
fi
echo "Không phát hiện secret."
exit 0
HOOK
chmod +x .git/hooks/pre-commit

---

Quản Lý Context

Ước Tính Token

Loại nội dung	Token / 1000 ký tự
Văn bản tiếng Anh	~250
Source code	~400
JSON data	~400
File nhỏ (<5KB)	1,000-2,000 tổng
File vừa (5-20KB)	2,000-5,000 tổng
File lớn (>50KB)	10,000+ tổng

Theo Dõi Sức Khỏe Context

Mức	Chất lượng	Hành động
0-50%	Tuyệt vời	Tiếp tục làm việc
50-70%	Tốt	Chuẩn bị /compact
70-85%	Giảm sút	Chạy /compact ngay
85-95%	Kém	Phải compact hoặc clear
95%+	Không đáng tin	/clear và bắt đầu lại

Combo Hiệu Quả

Combo	Quy trình	Khi nào
/cost → /compact	Kiểm tra → nén	Bảo trì định kỳ (mỗi 30 phút)
/clear → /init	Reset → cấu hình	Bắt đầu project mới
/compact → làm việc → /cost	Nén → tiếp tục → kiểm tra	Phiên làm việc dài

---

Quy Trình Nhanh

Khởi Tạo Project Mới

cd my-project
claude               # Bắt đầu phiên
/init                # Tạo CLAUDE.md
# Sửa CLAUDE.md theo 6 phần ở trên
/cost                # Kiểm tra mức dùng cơ bản

Protocol Phiên Làm Việc Dài

# Mỗi 20-30 phút:
/cost                # Kiểm tra mức context

# Khi context ở 50-70%:
/compact             # Giải phóng, giữ context task

# Chuyển sang task không liên quan:
/clear               # Reset hoàn toàn

Review Code An Toàn

git diff main | claude -p "Review diff này về bugs, security, và style"

Khám Phá Codebase Tiết Kiệm Context

# Bước 1: Tổng quan trước
"Cho tôi xem cấu trúc thư mục của src/"

# Bước 2: Đọc có chọn lọc
"Cho tôi xem function signatures trong src/auth/"

# Bước 3: Đào sâu chỉ khi cần
"Đọc src/auth/login.ts — tôi cần hiểu luồng token"