Series này dành cho dev đã dùng Claude Code vài tháng, gõ claude ra một REPL, biết Tab để autocomplete, biết /init để khởi tạo CLAUDE.md. Nhưng vẫn cảm giác như đang dùng một cái hộp đen biết viết code. Không biết tại sao có bài chạy ngon còn bài khác lại bị compaction cắt giữa chừng. Không biết khi nào nên dựng skill, khi nào nên dựng subagent, khi nào chỉ cần thêm dòng vào CLAUDE.md. Không biết hooks thực sự chạy ở đâu, memory lưu ở đâu, và tại sao MCP lại liên quan đến chuyện đó.
Series này mở hộp đen đó ra. Không phải tutorial “cách cài Claude Code”. Đó là việc của doc chính thức. Đây là mental model: kiến trúc bên dưới, lý do thiết kế, và những pattern thực tế mà các skill và hook đang được dựng ra để giải quyết. Khi bạn hiểu các lớp bên dưới, việc customize sẽ tự đến.
Đối tượng
- Senior dev 3+ năm, đã dùng Claude Code hàng ngày ít nhất một tháng, đã thử
/init, đã thử viết một skill nhỏ và nó hoạt động (hoặc không hoạt động, cũng OK). - Người đã chuyển từ Cursor, Copilot, hoặc Windsurf sang Claude Code và muốn hiểu vì sao trải nghiệm lại khác.
- Tech lead hoặc platform engineer đang đánh giá CC cho team, muốn biết ranh giới giữa “demo đẹp” và “production-ready”.
- Không cần background về AI hay LLM. Cần biết shell, git, và một ngôn ngữ scripting bất kỳ.
Cách tiếp cận
Đây không phải course. Không có video, không có quiz. Đây là working notes của một dev đã dùng CC từ những phiên bản đầu, va vào đủ loại incident, và viết lại những gì học được kèm code ví dụ chạy được.
Mỗi bài sẽ có:
- Mental model giải thích khái niệm không dùng jargon thừa
- Ví dụ shell / markdown / JSON copy chạy được ngay
- So sánh với thứ quen thuộc. Nếu bạn biết git, biết shell, biết Makefile thì các pattern trong CC sẽ có analog
- “Tại sao thiết kế kiểu này”: phần thường thiếu trong doc chính thức, kèm incident thực tế đã định hình design
Phong cách viết: tối giản, không tô vẽ. Nếu bạn thấy một câu có thể bỏ mà không mất ý, tôi đã cố bỏ rồi.
Cấu trúc series
Part 1: Mental Model và Anatomy
Mục tiêu: hiểu một session CC được dựng từ những lớp nào, prompt được build ra sao, và tool loop hoạt động thế nào. Đây là nền tảng cho mọi customization sau này.
Part 2: Customization layer
Mục tiêu: hiểu 5 cơ chế customize chính (CLAUDE.md, rules, skills, agents, hooks) khác nhau ở đâu, khi nào dùng cái nào, và settings.json đóng vai trò gì. Đây là phần mọi dev sẽ va vào khi muốn “uốn” CC theo workflow của mình.
Part 3: Memory và Context
Mục tiêu: hiểu cách CC duy trì context xuyên session (auto-memory) và cách kéo context bên ngoài vào (MCP). Đây là phần khó debug nhất nếu không có mental model rõ.
| # | Title | Status |
|---|---|---|
| 12 | Auto-memory: file-based, MEMORY.md index, các loại memory | Đã xuất bản |
| 13 | Memory submodule pattern: share memory cross-machine an toàn | Đã xuất bản |
| 14 | autoMemoryDirectory: chia memory theo project hoặc client | Đã xuất bản |
| 15 | MCP servers: context bên ngoài, khi nào tự build, khi nào dùng có sẵn | Đã xuất bản |
Part 4: Agents và Parallelism
Mục tiêu: dùng được nhiều agent song song mà không tự bắn vào chân. Đây là phần tăng năng suất nhiều nhất nếu làm đúng, và phá hỏng working tree nhiều nhất nếu làm sai.
| # | Title | Status |
|---|---|---|
| 16 | Spawning patterns: foreground, background, sequential, teammate | Đã xuất bản |
| 17 | Worktree isolation: vì sao tách working tree, base branch hook | Đã xuất bản |
| 18 | TeamCreate và SendMessage: persistent addressable agents | Đã xuất bản |
| 19 | Cross-agent communication: tránh race, slice theo file scope | Đã xuất bản |
Part 5: Workflows nâng cao
Mục tiêu: các pattern dùng kết hợp nhiều thành phần ở trên. Mỗi bài là một workflow đã được kiểm chứng qua nhiều tháng dùng thực tế.
| # | Title | Status |
|---|---|---|
| 20 | Plan mode: state file, exit prompt, plan vs todo vs memory | Đã xuất bản |
| 21 | Worktree hotfix while main session debugs production | Đã xuất bản |
| 22 | Branch-per-machine: sync ~/.claude/ giữa các máy | Đã xuất bản |
| 23 | Mobile coding qua Telegram bridge | Đã xuất bản |
Part 6: Build for Claude Code
Mục tiêu: viết được skill và hook level production. Đây là phần kết, sau khi đã hiểu hết các lớp ở trên.
| # | Title | Status |
|---|---|---|
| 24 | Anatomy của 1 skill production-grade: từ ý tưởng đến SKILL.md | Đã xuất bản |
| 25 | Anatomy của 1 hook production-grade: shell script và exit codes | Đã xuất bản |
Bonus: Internals và edge cases
Bài nằm ngoài 6 phần chính, đi sâu vào kiến trúc nội bộ hoặc edge case ít người để ý nhưng đáng hiểu.
| # | Title | Status |
|---|---|---|
| 26 | Một vài session không phải là không xuất hiện, mà là xuất hiện trễ | Đã xuất bản |
| 27 | Background session và worktree: setting worktree.bgIsolation từ 2.1.143 | Đã xuất bản |
Timeline gợi ý
Series này không có deadline. Nhưng nếu cần khung tham chiếu:
Tuần 1-2. Foundation (Part 1) Đọc xong Part 1 là đủ để debug 80% các vấn đề “tại sao CC làm thế này”. Không cần thay đổi setup gì, chỉ cần đọc và đối chiếu với session thực tế.
Tuần 3-5. Customization (Part 2) Milestone đầu tiên: viết được 1 skill, 1 subagent, 1 hook đơn giản. Sau Part 2 bạn sẽ có một thói quen mới: thay vì lặp lại một workflow, bạn dựng skill cho nó.
Tuần 6-7. Memory (Part 3) Cấu hình memory cho 1-2 project bạn đang làm. Sau Part 3 bạn sẽ cảm thấy CC “nhớ” được những thứ quan trọng giữa các session, thay vì phải nhắc lại mỗi lần.
Tuần 8-10. Multi-agent (Part 4) Milestone thứ hai: chạy được team 2-3 agent song song trên một feature lớn mà không bị race. Đây là điểm bạn cảm thấy năng suất tăng đáng kể.
Tuần 11-12. Workflows (Part 5) Áp các pattern nâng cao vào setup riêng. Phần này nhiều bài có thể đọc độc lập, không cần đọc tuần tự.
Tuần 13+. Build (Part 6) Khi bạn đã có ý tưởng skill / hook riêng và muốn nâng chất lượng lên mức chia sẻ được.
Tổng: 3 tháng nếu dành 3-5 tiếng mỗi tuần. Nhanh hơn nếu bạn đã quen với pattern hooks và skills. Chậm hơn nếu cần thời gian để va vào incident thực tế giữa các bài.
Cách đọc series
Mỗi bài được viết để đứng được một mình. Bạn có thể link thẳng cho đồng nghiệp mà không cần họ đọc từ đầu. Nhưng đọc tuần tự sẽ tốt hơn vì mỗi bài assume bạn đã có mental model từ bài trước.
Nếu đã quen CC: nhảy vào Part 2 hoặc Part 4 tùy nhu cầu. Part 1 chủ yếu để align mental model trước khi đi sâu.
Nếu mới chuyển từ Cursor / Copilot sang: đọc tuần tự từ bài 1. Khác biệt lớn nhất giữa CC và các tool kia nằm ở 5 bài đầu.
Nếu đang đánh giá CC cho team: đọc Part 1 và Part 4 trước. Đó là hai phần quyết định CC có hợp với team workflow của bạn hay không.
Không có thứ tự sai. Chỉ có thứ tự hiệu quả hơn.
Quan hệ với các series khác trên blog
Blog này đã có một series về Claude Code: Claude Skills Toolkit. Hai series có góc nhìn khác nhau:
- Claude Skills Toolkit: chia sẻ từng skill cụ thể đã được white-label, kèm pattern bên trong. Phù hợp khi bạn muốn “copy và adapt” một workflow đã được kiểm chứng.
- Claude Code từ zero (series này): mental model và kiến trúc CC. Phù hợp khi bạn muốn hiểu bên dưới để tự thiết kế skill và hook riêng.
Hai series bổ sung cho nhau. Đọc series này sẽ giúp bạn hiểu các skill trong toolkit kia được thiết kế ra sao. Đọc toolkit sẽ cho bạn ví dụ cụ thể cho các pattern mô tả ở đây.
Bài 1. Claude Code là gì: CLI, IDE, Web, SDK và anatomy của 1 session. Đã lên sóng. Bắt đầu từ đó.
Cập nhật lần cuối: 2026-05-17 Trạng thái series: 27 đã xuất bản (25 chính + 2 bonus)