Cài Node.js 18+
Tải bản LTS (≥18) từ nodejs.org. Kiểm tra bằng: node -v (cần ≥ 18.0.0).
GuideHướng dẫn chi tiết
Hướng dẫn sử dụng Claude Code hiệu quả
Claude Code là CLI chính thức của Anthropic — biến Claude AI thành lập trình viên AI chạy trên terminal. Bài này hướng dẫn cài đặt, workflow và 8 tính năng nổi bật.
🎯 Bạn sẽ học được gì sau bài này?
- Hiểu Claude Code khác gì Copilot, Cursor, ChatGPT.
- Cài đặt và đăng nhập Claude Code trong 10 phút.
- Nắm 8 tính năng cốt lõi và biết khi nào dùng tính năng nào.
- Áp dụng 6 workflow phổ biến: build feature, refactor, debug, viết test, code review, migration.
- Biết khi nào KHÔNG nên dùng Claude Code để tránh rủi ro.
MỤC LỤC
Bạn cần biết gì về Claude Code?
1. Claude Code là gì?
Định nghĩa, khác biệt với Copilot/Cursor.
2. Phù hợp cho ai?
6 nhóm người dùng và use case tiêu biểu.
3. Cài đặt 5 bước
Node.js, npm install, login, verify, CLAUDE.md.
4. Vòng lặp Agentic
Gather → Act → Verify, và 3 lầm tưởng phổ biến.
5. 3 chế độ phân quyền
Default, Auto Accept, Plan Mode — đổi bằng Shift+Tab.
6. Workflow cơ bản
Vòng lặp gõ yêu cầu → review → accept → kiểm chứng.
7. Quy trình EPCC
Explore-Plan-Code-Commit, hiệu chỉnh theo quy mô, /rewind.
8. Công thức prompt C-T-R
Context - Task - Rules: prompt là brief, không phải mệnh lệnh.
9. Quản lý context
/context, /compact, /clear và bẫy auto-compact.
10. CLAUDE.md 3 tầng
/init để khởi tạo, # để dạy rule, @ để tham chiếu.
11. 8 tính năng nổi bật
File ops, bash, web, subagent, skill, plan, hook, MCP.
12. Subagent đúng cách
Đôi mắt thứ hai, anti-pattern persona, least privilege.
13. Skill, Hook hay MCP?
Chọn đúng cơ chế mở rộng + kiểm soát chi phí MCP.
14. Làm việc async qua PR
Tạo PR bằng skill, --from-pr, GitHub Action.
15. 6 use case phổ biến
Build feature, refactor, debug, test, review, migration.
16. 5 mẹo nâng cao
CLAUDE.md, plan mode, hooks, allowlist, slash command.
17. 4 nguyên tắc vàng
Verify don't trust, prompt là code, giữ context, tự động hoá.
18. Khi nào KHÔNG nên dùng?
3 tình huống dễ gây rủi ro hoặc tốn tiền vô ích.
1. ĐỊNH NGHĨA
Claude Code là gì và khác gì các tool AI khác?
Claude Code là một agent chạy trong terminal — không phải plugin IDE. Nó là CLI (Command Line Interface) chạy độc lập, hiểu được nhiều file trong dự án, ra quyết định nhiều bước, gọi công cụ (đọc file, sửa file, chạy bash, gọi API, search web), và lặp cho đến khi hoàn thành yêu cầu của bạn. Đặc điểm agentic này khác biệt cốt lõi so với các tool AI khác.
| Tool | Bản chất | Phù hợp khi |
|---|---|---|
| GitHub Copilot | Autocomplete trong IDE | Gõ code từng dòng nhanh hơn |
| Cursor | IDE riêng có AI tích hợp | Đổi sang môi trường mới có AI sâu |
| ChatGPT / Claude chat | Chat web, copy-paste code | Hỏi đáp ngắn, học khái niệm |
| Claude Code | Agent CLI tự chạy đa bước | Refactor, migration, build feature từ A→Z, không rời terminal |
💡
Tóm tắt Copilot giúp bạn gõ; Claude Code thay bạn gõ. Hai tool bổ sung nhau — nhiều developer dùng cả hai.
2. ĐỐI TƯỢNG
Claude Code phù hợp cho ai?
💻
Developer full-stack
Build feature, refactor, debug đa file⚙️
DevOps / SRE
Viết script tự động hoá, sửa config, deploy🤖
ML / Data engineer
Xử lý data pipeline, viết notebook, debug📐
Tech lead / Architect
Code review hàng loạt, migration lớn📝
Technical writer
Generate docs từ code, đồng bộ docs hàng loạt🧪
QA engineer
Sinh test case, debug flaky test, viết E2EKhông bắt buộc phải là developer. Người làm ops, content, phân tích cũng dùng được — miễn quen terminal cơ bản (lệnh cd, ls). Nếu hoàn toàn mới với CLI, xem Bài 1 và làm quen Claude trên web trước.
3. CÀI ĐẶT
Cài đặt Claude Code trong 5 bước
Cài Claude Code qua npm
Mở terminal, chạy: npm install -g @anthropic-ai/claude-code. Lệnh này cài CLI ở chế độ global, dùng được mọi nơi.
Đăng nhập
Vào thư mục dự án (cd /path/to/project), chạy claude. Lần đầu sẽ yêu cầu đăng nhập — dùng tài khoản Claude Pro/Max/Team đã có, hoặc API key Anthropic.
Kiểm tra cài đặt
Chạy claude --version để xác nhận. Gõ /help trong session để xem mọi lệnh có sẵn.
Tạo file CLAUDE.md (tuỳ chọn nhưng nên có)
Tạo file CLAUDE.md ở root dự án, viết ngắn gọn: dự án dùng gì, convention, lệnh chạy/test/deploy. Claude sẽ tự đọc mỗi phiên — giảm rất nhiều câu hỏi qua lại.
Claude Code chạy được ở đâu?
Cùng một công cụ, bốn nơi làm việc. Bạn không phải chọn một và bỏ phần còn lại.
⌨️
Terminal
Mặc định. Giao diện chính bằng lệnh claude, cập nhật tính năng mới sớm nhất.
🧩
IDE
VS Code / JetBrains — chạy trong sidebar, xem inline diff, không phải rời editor.
🖥️
Claude Desktop
Trực quan, chọn thư mục bằng click. Hợp với người không sống trong terminal.
🌐
Trình duyệt
Chạy task trên cloud, làm việc từ xa, không phụ thuộc máy cá nhân.
⚠️
Sai lầm hay gặp nhất khi mới cài Luôn
cd vào thư mục dự án trước khi chạy claude. Đừng bao giờ chạy ở thư mục $HOME — Claude sẽ lấy cả ổ đĩa của bạn làm phạm vi làm việc.📋 Template CLAUDE.md tối giản
## Project: shop-frontend (Next.js 14 + TypeScript)## Run: pnpm dev — Test: pnpm test — Deploy: vercel## Convention: tabs 2 spaces, no default export, error boundary mọi page## Đừng sửa: /legacy, /vendor
4. MÔ HÌNH TƯ DUY
Claude Code hoạt động theo vòng lặp nào?
Hiểu vòng lặp này là hiểu vì sao Claude Code khác hẳn một ô chat. Claude Code không trả lời câu hỏi — nó tự chạy vòng lặp cho đến khi task xong hoặc gặp blocker thực sự.
Gather Context — Thu thập ngữ cảnh
Chủ động dùng tool (grep, find, đọc file) để tự tìm hiểu codebase. Không đoán mò convention của bạn.
Take Action — Hành động
Chạy lệnh bash, sửa file, tạo file mới. Đây là bước tạo ra thay đổi thật trên ổ cứng.
Verify — Kiểm chứng
Tự chạy test, đọc lỗi. Nếu fail thì quay lại bước 1 để thu thập thêm ngữ cảnh, rồi thử lại.
🔁
Vì sao điều này quan trọng Bạn không cần mô tả từng bước. Hãy mô tả kết quả cuối cùng và cách kiểm chứng — vòng lặp sẽ tự lo phần còn lại. Câu "chạy test đến khi pass" có sức mạnh hơn nhiều so với việc bạn ngồi sửa từng lỗi.
Ba lầm tưởng phổ biến khiến bạn dùng sai
| Lầm tưởng | Thực tế |
|---|---|
| LLM tự động đọc toàn bộ file của project lúc khởi động. | Không có phép thuật nào cả. Nó dùng Bash, Grep, Read y hệt như con người để tìm file — nên chỉ đúng đường dẫn cho nó là tiết kiệm rất nhiều. |
| Auto-compact là tính năng thông minh giúp bộ nhớ tốt hơn. | Auto-compact là sự thoả hiệp: nó xoá chi tiết cũ để lấy chỗ. Hãy chủ động /compact hoặc /clear đúng lúc thay vì phó mặc. |
| Nhồi 5 chuyên gia vào một prompt thì code sẽ giỏi hơn. | 5 persona nhồi một chỗ chỉ làm loãng ngữ cảnh. Muốn tách việc thì tách subagent, không phải tách vai diễn. |
5. PHÂN QUYỀN
3 chế độ kiểm soát và khi nào dùng chế độ nào?
Nhấn Shift+Tab để xoay vòng giữa ba chế độ. Chọn đúng chế độ là cách rẻ nhất để cân bằng giữa tốc độ và an toàn.
🔒
Default
Hỏi trước mỗi bước. Dùng cho task lạ, branch production — nơi cái giá của một sai lầm là cao.
⚙️
Auto Accept
Tự sửa file, không hỏi lại. Dùng trong sandbox hoặc dev branch. Ít gián đoạn, tốc độ cao nhất.
🗺️
Plan Mode
Read-only. Claude chỉ đọc và lập kế hoạch, không đụng file. Dùng trước mọi task trung bình đến lớn.
⚠️
Quy tắc thực dụng Auto Accept rất sướng, nhưng chỉ bật khi bạn đã có git commit sạch để quay về. Không có điểm khôi phục thì Auto Accept là canh bạc, không phải tăng tốc.
6. WORKFLOW
Vòng lặp dùng Claude Code mỗi ngày trông thế nào?
Mô tả việc cần làm
Gõ yêu cầu bằng tiếng Việt hoặc Anh, càng cụ thể càng tốt: "Refactor file auth.ts tách phần JWT ra module riêng, viết test unit cho từng hàm."
Review kế hoạch (nếu Claude đề xuất)
Với task lớn, bật Plan Mode (Shift+Tab hai lần) — Claude sẽ xuất kế hoạch trước khi sửa code. Bạn duyệt rồi mới cho phép thực thi.
Duyệt từng thao tác
Mỗi lần Claude muốn chỉnh file hay chạy lệnh, nó hỏi trước (trừ khi bạn cấu hình allowlist). Bạn bấm Y/N/E (Yes/No/Edit) để duyệt.
Kiểm chứng
Chạy test/lint/build để xác nhận Claude làm đúng. Có thể yêu cầu Claude chạy hộ: "Chạy test rồi sửa lỗi nếu fail."
Commit khi hài lòng
Yêu cầu: "Commit với message tuân theo convention dự án." — Claude sẽ stage và commit, hoặc gợi ý message cho bạn tự chạy.
7. QUY TRÌNH
EPCC — quy trình 4 pha cho task lớn
EPCC là viết tắt của Explore → Plan → Code → Commit. Điểm mấu chốt gây bất ngờ với hầu hết người mới: Explore + Plan nên chiếm khoảng 50% thời gian. Đó là đầu tư, không phải lãng phí.
Explore — Khám phá
Để Claude đọc codebase trước. Mục tiêu: tránh việc AI phải đoán mò convention của dự án. Đây là lúc dùng Plan Mode.
Plan — Lên kế hoạch
Điểm căn chỉnh giữa bạn và AI. Đây là nơi sửa sai rẻ nhất — sửa một dòng trong kế hoạch rẻ hơn sửa 15 file đã viết xong.
Code — Thực thi
Claude thực thi tự động theo kế hoạch đã duyệt. Có test suite thì hiệu quả nhân lên nhiều lần, vì Claude tự biết mình đúng hay sai.
Commit — Lưu trữ
Review kỹ diff rồi tạo commit có ngữ nghĩa. Không bao giờ commit thứ bạn chưa đọc.
Hiệu chỉnh EPCC theo quy mô task
Không phải task nào cũng cần đủ 4 pha. Áp nguyên xi EPCC cho việc sửa một typo là tự làm khổ mình.
| Quy mô task | Explore | Plan | Code | Commit |
|---|---|---|---|---|
| Tiny — sửa typo, đổi tên biến | Bỏ qua | Bỏ qua | Code thẳng | Nhanh |
| Medium — feature mới, refactor | Kiểm tra | Kiểm tra | Code + Test | Review kỹ |
| Hard — migration lớn | Nhiều vòng | Nhiều vòng | Chia pha | Chia nhỏ commit |
↩️
Khi Claude đi sai hướng:
/rewind Lệnh này (hoặc nhấn Esc hai lần) quay code và hội thoại về một checkpoint trước đó. Nó không chỉ hoàn tác code — nó còn loại bỏ phần ngữ cảnh đã bị ô nhiễm bởi hướng đi sai. Rewind sớm rẻ hơn nhiều so với cố sửa chữa một cuộc hội thoại đã lệch.8. PROMPT
Prompt không phải là ra lệnh — prompt là bản brief
Công thức C-T-R giúp một prompt đủ thông tin để Claude không phải đoán:
Context — Ngữ cảnh
Bối cảnh kỹ thuật hiện tại. "Trong project này, chúng ta đang dùng JWT."
Task — Nhiệm vụ
Việc cần làm, nêu theo kết quả. "Viết hàm login cho admin dashboard."
Rules — Ràng buộc
Thư viện bắt buộc, chuẩn code, thứ không được đụng vào. "Dùng thư viện argon2, đặt error_message rõ ràng."
📋 Prompt hoàn chỉnh theo C-T-R
Trong project này, chúng ta đang dùng JWT.Viết hàm login cho admin dashboard.Dùng thư viện argon2, đặt error_message rõ ràng.
💡
Mẹo đắt giá nhất trang này Đừng dùng Claude Code để viết code ngay. Hãy dùng nó để hỏi về codebase trước. Một prompt cụ thể 50 từ có thể tiết kiệm 20.000 token mà Claude phải tốn để mò mẫm quanh dự án.
9. CONTEXT
Quản lý context — kỹ năng phân biệt người mới và người thạo
Context window là bộ nhớ làm việc của một phiên. Với Sonnet 5, Opus 5 và Fable 5, cửa sổ này lên tới 1 triệu token (Haiku 4.5 là 200K) — rất rộng, nhưng vẫn hữu hạn. Và nó đầy nhanh hơn bạn tưởng, vì kết quả grep, nội dung file và log test đều nằm trong đó.
⚠️
Điều xảy ra khi context gần đầy Claude tự động nén (auto-compact). Hành động nén sẽ vứt bỏ chi tiết — kết quả tool cũ, ràng buộc bạn nêu từ đầu — và thay bằng bản tóm tắt. Hậu quả điển hình: AI bắt đầu quên yêu cầu ban đầu và code lệch spec. Đừng phó mặc cho hệ thống tự nén.
3 lệnh làm chủ context
📊
/context
Xem token đang bị chiếm dụng bởi nguồn nào, dưới dạng lưới trực quan. Gõ mỗi 30–45 phút để không bị bất ngờ.
🗜️
/compact
Giữ lại tóm tắt task hiện tại, dọn các log read/grep cũ. Dùng khi vẫn đang dở task.
🧹
/clear
Reset sạch, bắt đầu phiên mới không bị ám bởi ngữ cảnh cũ. Dùng khi chuyển sang task khác.
Bạn còn đang dở task hiện tại không?
✅ CÓ→
→ /compact
Giữ mạch việc, chỉ dọn rác
❌ KHÔNG→
→ /clear
Sang việc mới thì dọn sạch
10. BỘ NHỚ
CLAUDE.md — bộ nhớ dài hạn của dự án
CLAUDE.md là một file Markdown được tự động nhúng vào system prompt mỗi khi khởi tạo phiên. Nói cách khác: Claude biết dự án của bạn trước khi bạn kịp gõ prompt đầu tiên.
Ba tầng, tự kế thừa từ rộng đến hẹp
| Tầng | Vị trí | Dùng cho |
|---|---|---|
| Project-level | /CLAUDE.md | Check vào Git, cả team dùng chung: kiến trúc, lệnh build/test, các cạm bẫy đã biết. |
| User-level | ~/.claude/CLAUDE.md | Thói quen cá nhân: ngôn ngữ trả lời, format commit bạn thích. Không ảnh hưởng đồng đội. |
| Nested | /api/CLAUDE.md | Rule riêng cho một sub-folder trong monorepo. Claude tự gộp các tầng lại. |
Ba thao tác để nuôi file này
Khởi tạo bằng /init
Đừng ngồi viết từ đầu. Claude sẽ quét codebase, package.json và tự tạo bản draft đầu tiên khá chuẩn để bạn sửa lại.
Nuôi dưỡng bằng phím #
Bất cứ khi nào bạn phải sửa sai Claude, gõ # [rule mới]. Claude tự parse và ghi rule đó vào bộ nhớ vĩnh viễn. Ví dụ: # Luôn dùng named export thay vì default export.
Tham chiếu bằng @
Đừng copy-paste tài liệu vào file. Dùng @README.md hay @schema.prisma để Claude nạp file đó đúng lúc cần, tránh phình context vô nghĩa.
✍️
Thói quen đáng giá nhất Mỗi lần bạn phải nhắc Claude cùng một điều lần thứ hai, đó là tín hiệu để gõ
#. Sau vài tuần, CLAUDE.md sẽ tự tích luỹ thành tài liệu onboarding tốt nhất mà dự án bạn từng có — cho cả người mới lẫn AI.11. TÍNH NĂNG
8 tính năng cốt lõi của Claude Code
1
File operations
Đọc, sửa, tạo, xoá file. Hiểu cấu trúc thư mục lớn nhờ Glob/Grep.
2
Bash execution
Chạy mọi lệnh shell (npm/git/docker/aws cli…), đọc stdout/stderr để quyết định bước tiếp.
3
WebFetch & WebSearch
Đọc tài liệu online (API doc, changelog), tìm thông tin mới ngoài training data.
4
Subagent
Spawn agent con để chạy nhiệm vụ song song (vd. quét nhiều thư mục cùng lúc) — không tốn context cuộc chat chính.
5
Skill
Package quy trình tái sử dụng (vd. seo, review, security-review) — gọi bằng /skill-name.
6
Plan Mode
Buộc Claude xuất kế hoạch trước khi thực thi — bạn duyệt rồi mới cho chạy. Cốt lõi cho task lớn.
7
Hooks
Tự động chạy script khi sự kiện xảy ra (vd. format sau khi Claude sửa file, gửi notification khi xong).
8
MCP server
Kết nối Claude Code với hệ thống ngoài: GitHub, Linear, Notion, Postgres, browser… qua giao thức MCP.
12. SUBAGENT
Subagent — dùng đúng cách và dùng sai cách
🚫
Anti-pattern: Expert Persona Viết "You are a Python Expert" vào prompt không tạo ra năng lực mới. Claude đã có sẵn toàn bộ kiến thức Python. Câu đó chỉ tốn token và làm loãng ngữ cảnh.
Giá trị thật của subagent nằm ở chỗ khác: nó có context window hoàn toàn độc lập. Bạn giao cho nó một việc nặng về đọc (ví dụ: quét 50 file docs), nó xử lý trong môi trường riêng rồi chỉ trả về một bản tóm tắt 1 trang. Context chính của bạn vẫn sạch.
Đôi mắt thứ hai không thiên kiến
Đây là use case đắt giá nhất. Claude vừa viết xong một đoạn code sẽ mang theo thiên kiến của chính người viết — rất dễ kết luận "looks good" với sản phẩm của mình. Một subagent review được cấp quyền read-only không hề biết về hành trình gian nan để viết ra đoạn code đó, nên nó soi ra vấn đề khách quan và sắc bén hơn hẳn.
Khi nào gọi subagent?
Quá trình làm trung gian có quan trọng với bạn không?
✅ CÓ
→ Dùng Main Thread
Build feature từng bước, debug tương tác — bạn cần thấy từng nước đi
❌ KHÔNG
→ Gọi Subagent
Research, review code, audit — bạn chỉ cần kết luận
🔐
Least privilege cho subagent Khi định nghĩa subagent trong
.claude/agents/, chỉ cấp đúng quyền nó cần. Với một agent review: cấp Glob, Grep, Read, Bash — và tuyệt đối không cấp Edit. Một reviewer sửa được code là một reviewer không còn đáng tin.13. MỞ RỘNG
Skill, Hook hay MCP — chọn công cụ nào?
Ba cơ chế mở rộng này hay bị dùng lẫn lộn. Phân biệt được chúng là bạn tiết kiệm rất nhiều token và công sức.
| Cơ chế | Bản chất | Nạp khi nào | Dùng khi |
|---|---|---|---|
| CLAUDE.md | Sự thật (facts) | Mọi lúc, mọi task | Chuẩn coding chung, kiến trúc, lệnh build. |
| Skill | Quy trình (procedure) | Chỉ khi ngữ cảnh cần | Quy trình nhiều bước lặp lại. Không làm phình context khi chưa dùng. |
| Hook | Script tất định | Luôn luôn, 100% | Việc bắt buộc phải xảy ra, không được phép quên. |
| MCP | Cầu nối dữ liệu | Ngay khi kết nối | Lấy dữ liệu ngoài codebase: Jira, Figma, database nội bộ. |
⚖️ Quy tắc quyết định trong một câu
Cần Claude BIẾT cách làm? → Dùng Skill.
Cần BẢO ĐẢM việc đó luôn xảy ra? → Dùng Hook.
Vì sao Hook không thể thay bằng prompt
Prompt, CLAUDE.md và Skill đều mang tính xác suất — model đọc rồi tự quyết định có làm hay không, và đôi khi nó quên. Hook là tất định: một script chạy 100% mọi lần, không ngoại lệ, không phụ thuộc trí nhớ của AI. Ví dụ kinh điển: hook PostToolUse chạy linter sau mỗi lần Claude sửa file — từ đó không bao giờ còn lỗi CI lint nữa.
🪝 Cấu hình hook trong .claude/settings.json
{ "hooks": { "PostToolUse": "./.claude/hooks/lint.sh" } }
MCP: đừng bỏ quên chi phí context
💸
Sự thật ít người để ý Mỗi MCP server đã kết nối sẽ đẩy toàn bộ định nghĩa công cụ của nó vào context window — ngay cả khi bạn không dùng đến. Vài server nhàn rỗi có thể ngốn hàng chục nghìn token mỗi phiên.
Audit định kỳ bằng /mcp
Mỗi tháng một lần, liệt kê các server đang bật.
Tự hỏi: tháng vừa rồi có thực sự dùng không?
Nếu câu trả lời là không, đó là server zombie.
Tắt server zombie
Bật lại lúc cần chỉ mất vài giây, còn để bật suốt thì tốn token mọi phiên.
⚡
Nguyên tắc: CLI > MCP Nếu một CLI có sẵn đã làm tốt việc đó, đừng cài MCP server cho nó. Ví dụ: GitHub CLI (
gh) chạy qua Bash gần như miễn phí về context, trong khi một GitHub MCP server có thể ngốn cả chục nghìn token chỉ để nằm đó.14. ASYNC
Làm việc bất đồng bộ qua Pull Request
Claude Code không chỉ chạy trong lúc bạn ngồi trước máy. Ba cơ chế dưới đây cho phép công việc tiếp diễn khi bạn đã đóng laptop.
1
Tạo PR bằng một Skill
Đóng gói quy trình "gom diff → viết Conventional Commit → push đúng branch → tạo PR có mô tả đầy đủ" thành một skill của riêng bạn. Từ đó chỉ cần gọi một lệnh thay vì lặp lại bốn bước.
2Quay lại đúng ngữ cảnh với
Quay lại đúng ngữ cảnh với --from-pr
Sáng hôm sau CI báo lỗi hoặc có comment review. Chạy claude --from-pr 123 để mở lại đúng phiên đã gắn với PR đó — không phải kể lại từ đầu.
3
GitHub Action
Cài Claude Code GitHub Action rồi tag @claude ngay trong comment của PR để AI sửa trực tiếp trên GitHub, không cần ai mở máy.
🔍
Vẫn phải đọc diff Async không có nghĩa là không kiểm soát. Dù code do AI viết trên GitHub, người bấm merge vẫn chịu trách nhiệm. Hãy để subagent review chạy trước, rồi bạn đọc diff lần cuối.
15. USE CASE
6 workflow phổ biến nhất với Claude Code
1
Build feature từ A→Z
"Thêm trang /pricing với 3 tier, tích hợp Stripe checkout, viết test E2E." — Claude lên kế hoạch, sửa 5-10 file, viết test, chạy test, sửa lỗi đến khi pass.
2
Refactor đa file
"Đổi tất cả callback sang async/await trong /src/api." — Claude quét, sửa từng file, không bỏ sót.
3
Debug lỗi khó
"Test login_test.ts fail với 'timeout', kiểm tra lý do và sửa." — Claude đọc stack trace, log, sửa lỗi gốc.
4
Viết test bổ sung
"Module billing.ts đang 40% coverage — viết test để lên 90%." — Claude tự sinh test case bao phủ branch còn thiếu.
5
Code review PR
"/review PR#234" — dùng skill có sẵn để review PR đầy đủ: logic, security, edge case, suggest sửa.
6
Migration framework
"Nâng Next.js 13 → 15 cho cả dự án, đọc CHANGELOG và xử lý breaking change." — Claude làm dần, kiểm chứng từng bước.
16. NÂNG CAO
5 mẹo dùng Claude Code hiệu quả gấp 3
Đầu tư cho CLAUDE.md
Mỗi câu trong CLAUDE.md tiết kiệm hàng chục câu hỏi qua lại. Bao gồm: tech stack, lệnh chạy/test/deploy, convention, vùng cấm sửa, định nghĩa thuật ngữ riêng của dự án.
Dùng Plan Mode cho task > 30 phút
Buộc Claude lập kế hoạch trước — bạn phát hiện sớm hiểu nhầm, đỡ tốn token và thời gian. Bật bằng Shift+Tab hai lần.
Cấu hình hooks tự động
Hook PostToolUse chạy formatter sau khi Claude sửa file. Hook Notification ping bạn khi Claude xong và cần duyệt. Cấu hình trong .claude/settings.json.
Allowlist các lệnh đọc
Cho phép chạy git status, npm test, ls… mà không cần duyệt từng lần. Skill fewer-permission-prompts tự sinh allowlist từ lịch sử dùng.
Tạo slash command riêng
Lưu prompt hay dùng thành slash command (ví dụ /release-notes, /deploy-staging) — gọi 1 lần thay vì gõ lại prompt dài.
17. NGUYÊN TẮC
4 nguyên tắc vàng khi làm việc với Claude Code
1
Verify, don't trust
Luôn dùng subagent để review code. Chạy test, đọc kỹ diff trước khi commit lên nhánh chính. Tốc độ có được từ AI không đáng đổi bằng một sự cố production.
2
Prompt là Code, CLAUDE.md là Config
Viết prompt cẩn thận như viết function. Đưa CLAUDE.md vào quy trình PR review của team — nó là tài sản chung, không phải file nháp cá nhân.
3
Quản lý context chặt chẽ
Cứ 30 phút kiểm tra /context. Đổi task thì /clear. Không quăng file bừa bãi vào bộ nhớ chỉ vì "biết đâu cần".
4
Tự động hoá điểm đau
Làm tay một việc đến lần thứ ba thì đóng gói thành Skill. Thấy một lỗi nguy hiểm lặp lại thì cắm Hook phòng vệ.
🎯 Ranh giới giữa biết và làm
Claude mang đến Intelligence. Bạn mang đến Context, Expertise và Judgment. Judgment là thứ duy nhất không thể outsource — output của AI luôn là điểm bắt đầu, không bao giờ là điểm kết thúc.
18. CẢNH BÁO
Khi nào KHÔNG nên dùng Claude Code?
❌
Code chứa secret production
Đừng để Claude đọc trực tiếp .env chứa key thật. Dùng biến giả khi test hoặc thêm vào .gitignore + bảo Claude bỏ qua.
❌
Bạn chưa biết review code AI sinh
Claude rất giỏi nhưng không hoàn hảo. Nếu bạn không thể đọc-hiểu code nó viết, đừng merge vào main — học bài 1-10 trước rồi quay lại.
❌
Task nhỏ < 1 phút
Đổi tên 1 biến, sửa 1 typo — gõ trực tiếp nhanh hơn. Claude Code mạnh ở task nhiều bước, đa file.
FAQ
FAQ — 9 câu hỏi thường gặp về Claude Code
Claude Code có miễn phí không?+
Bản thân CLI miễn phí, nhưng cần subscription Claude (Pro $20/tháng, Max 5x $100/tháng, Max 20x $200/tháng, Team Standard $25/chỗ/tháng trả năm) hoặc API key Anthropic (tính theo token). Gói Free trên claude.ai không kích hoạt được Claude Code. Xem chi tiết ở trang Claude Price.
Claude Code khác gì GitHub Copilot và Cursor?+
Copilot là autocomplete trong IDE, Cursor là IDE riêng tích hợp AI. Claude Code chạy trên terminal và là agent — tự sửa nhiều file, chạy lệnh, lặp đến khi xong. Phù hợp cho task đa bước (refactor lớn, migration, build feature A→Z) hơn là gõ từng dòng. Nhiều dev dùng song song Copilot (gõ nhanh) + Claude Code (task lớn).
Có thể dùng Claude Code trên Windows không?+
Có. Claude Code chạy tự nhiên trên Windows 11 (PowerShell), macOS, Linux và WSL. Trên Windows nó tự nhận biết môi trường và dùng cú pháp PowerShell khi cần.
Claude Code có thể truy cập internet không?+
Có. Hai công cụ WebFetch và WebSearch cho phép Claude đọc tài liệu online, tra cứu API mới phát hành, đọc changelog… Mặc định bạn duyệt từng request trước khi thực hiện.
Dữ liệu code của tôi có bị Anthropic dùng để train AI không?+
Không, theo chính sách mặc định của Anthropic — dữ liệu code và prompt qua Claude Code không được dùng để train mô hình. Với gói Team/Enterprise, admin có thể cấu hình thêm về data residency và retention. Chi tiết ở trang Bảng giá → phần bảo mật.
Người không phải developer có dùng Claude Code được không?+
Được. Người làm ops dùng để chạy script tự động, copywriter edit hàng loạt file Markdown, nhà phân tích xử lý CSV… Tuy nhiên cần quen terminal cơ bản (lệnh cd, ls). Nếu hoàn toàn mới với CLI, học Bài 1-10 trước rồi quay lại.
Khi nào nên dùng /compact, khi nào nên dùng /clear?+
Còn đang dở task hiện tại thì dùng /compact — nó giữ lại tóm tắt việc đang làm và chỉ dọn các log read/grep cũ. Chuyển hẳn sang task khác thì dùng /clear để bắt đầu phiên sạch, không bị ám bởi ngữ cảnh cũ. Nên gõ /context mỗi 30–45 phút để biết token đang bị chiếm bởi nguồn nào.
Viết “You are a senior developer” vào prompt có làm Claude code giỏi hơn không?+
Không. Claude đã có sẵn kiến thức đó, nên câu role-playing chỉ tốn token và làm loãng ngữ cảnh. Muốn tách việc thì tách subagent — mỗi subagent có context window độc lập và trả về bản tóm tắt gọn, giữ context chính của bạn sạch sẽ.
Nên dùng Skill hay Hook cho một quy trình lặp lại?+
Hỏi một câu: bạn cần Claude BIẾT cách làm, hay cần BẢO ĐẢM việc đó luôn xảy ra? Cần biết cách làm → viết Skill (nạp theo ngữ cảnh, không phình context). Cần bảo đảm 100% mọi lần → cắm Hook, vì hook là script tất định, không phụ thuộc việc model có nhớ hay không.
Phần 4–5 và 7–14, 17 được biên soạn dựa trên tài liệu “Claude Code 101 — AI engineer ngay trong terminal” (nguồn: Anthropic Academy, bản tiếng Việt do Nguyen Ngoc Tuan trình bày), viết lại và đối chiếu với tài liệu chính thức Claude Code tháng 8/2026.
🚀 Sẵn sàng dùng Claude Code?
Chạy lệnh npm install -g @anthropic-ai/claude-code rồi bắt đầu task đầu tiên. Khi quen rồi, ghép với Claude Cowork trên web để xử lý cả việc cần GUI. Chưa rõ gói nào phù hợp? Xem trang Claude Price.
Cập nhật lần cuối: 15/08/2026. Lệnh, cờ và tính năng đối chiếu theo tài liệu chính thức: tổng quan Claude Code, danh sách lệnh và CLI reference. Lineup model tháng 8/2026: Fable 5, Opus 5, Sonnet 5 (context tới 1.000.000 token) và Haiku 4.5 (200.000 token).