Hôm nay source code Claude Code bị lộ. Hơn 500,000 dòng TypeScript, toàn bộ kiến trúc bên trong.
Mình đọc xong bản phân tích chi tiết và nhận ra: nhiều thứ mình dùng lâu nay chưa đúng cách. Chia sẻ lại cho anh em đang dùng hoặc đang học vibe coding.
Đây không phải tin tức. Đây là những tips thực tế, rút ra từ cách Claude Code thật sự vận hành bên trong.
1. Session dài – Claude quên
Claude Code có cơ chế tự nén conversation khi context window gần đầy. Nó tóm tắt đoạn chat cũ thành summary, chỉ giữ lại tối đa 5 files và một phần skills quan trọng nhất.
Nghe thì hợp lý, nhưng hệ quả là: session càng dài, nó càng mất chi tiết. Mình từng chạy session cả buổi sáng, đến chiều hỏi lại thì nó “lơ ngơ” như chưa từng nói chuyện.
Giờ hiểu rồi. Mỗi session nên tập trung 1 mục tiêu cụ thể. Xong thì mở session mới. Đừng tham gom hết vào một phiên.
2. Đọc thì nhanh, ghi thì chậm
Kiến trúc bên trong cho phép tối đa 10 tools đọc file chạy song song cùng lúc. Nhưng tools ghi file thì bắt buộc chạy tuần tự, từng cái một.
Đây là lý do khi Claude Code “đọc hiểu codebase” thì rất nhanh, nhưng khi sửa nhiều file thì chậm rõ rệt.
Tip: thay vì yêu cầu “sửa 10 file cùng lúc” rồi ngồi chờ, hãy yêu cầu nó plan trước, liệt kê cần sửa gì, rồi mới execute. Chia batch ra sẽ hiệu quả hơn dồn một đống.
3. CLAUDE.md quan trọng hơn bạn nghĩ
File CLAUDE.md được load vào mọi request. Mỗi lần bạn gửi tin nhắn, Claude Code đọc lại file này kèm git status và ngày hiện tại.
Nhưng nó được cache theo session. Nghĩa là nếu bạn sửa CLAUDE.md giữa chừng thì phải restart session mới nhận thay đổi.
Coi CLAUDE.md như “hiến pháp” của project. Viết kỹ từ đầu: project làm gì, tech stack gì, convention gì, điều gì không được làm. Viết càng rõ thì Claude Code càng ít đi lạc hướng.
4. 18 tools bị ẩn mặc định
Claude Code có hơn 60 tools. Nhưng nó không gửi hết cho model mỗi lượt. 18 tools bị ẩn (LSP, MCP, tạo task, skills…), chỉ xuất hiện khi model tự tìm thông qua một tool gọi là ToolSearch.
Lý do: giữ prompt gọn để model xử lý nhanh hơn và tiết kiệm token.
Tip: nếu muốn Claude Code dùng một tool cụ thể mà nó không tự dùng, nói rõ trong prompt. Ví dụ “dùng LSP để tìm definition của function này” thay vì hy vọng nó tự khám phá.
5. Output bị cắt? Nó tự retry 3 lần
Khi output dài quá token limit, Claude Code tự inject một message ẩn: “Resume directly, no apology, no recap.” Rồi tiếp tục.
Tối đa 3 lần. Sau 3 lần mà chưa xong thì dừng hẳn.
Nhiều anh em thấy nó dừng giữa chừng tưởng bug. Không phải. Đó là giới hạn thiết kế. Task quá lớn thì chia nhỏ ra, đừng ép nó nuốt hết một lượt.
6. Hệ thống memory file-based
Claude Code có hệ thống nhớ bằng file markdown, lưu tại ~/.claude/projects/. Chia làm 4 loại: user (bạn là ai, preferences), feedback (cách làm việc), project (mục tiêu, deadline), reference (link hệ thống ngoài).
Mỗi lượt chat, một model phụ chạy song song để chọn tối đa 5 file memory liên quan nhất rồi inject vào conversation.
Tip: vào máy kiểm tra thư mục ~/.claude/projects/ xem có gì chưa. Nếu có thì review. Nếu chưa thì bắt đầu tạo thủ công. Đây là cách giúp Claude Code “nhớ” bạn giữa các session.
7. Hook: automation mà ít ai dùng
Claude Code hỗ trợ hooks, tức là gắn hành động tự động vào trước/sau mỗi tool call. 4 loại: chạy shell command, chạy LLM prompt, gọi HTTP, hoặc chạy agent kiểm tra.
Ví dụ thực tế: gắn hook sau mỗi lần git commit để kiểm tra commit message có đúng convention không. Hoặc hook trước mỗi lần edit file để tự backup.
Cấu hình trong settings.json, pattern là Event → Matcher → Hook. Anh em nào dùng Claude Code hàng ngày nên setup vài hooks cơ bản, tiết kiệm rất nhiều thao tác lặp lại.
