SaigonTech Vault
Loại: knowledge-doc 2026-09-29 active #wiki-import

Claude Code – Wiki nhập môn (Beginner → Intermediate)

> Tài liệu này tổng hợp, diễn giải lại và mở rộng từ các nguồn chính thức và trải nghiệm thực tế nhằm giúp người mới hiểu nhanh – dùng đúng – mở rộng tốt Claude Code.

1. Claude Code là gì?

Claude Code là một coding agent chạy trên máy local, cho phép bạn:

  • Giao tiếp với AI thông qua ngữ cảnh code thực tế (repo, file, git history)
  • Cho AI thực hiện hành động: tạo file, sửa code, chạy lệnh, tạo commit / PR
  • Tổ chức công việc theo agent → sub-agent → tool giống workflow của một đội kỹ sư

Nó không chỉ là chatbot, mà là một AI developer cộng tác trực tiếp với codebase.

2. Các cách dùng cơ bản cho người mới bắt đầu

Tham khảo nhanh:

2.1. Chế độ làm việc phổ biến

🔹 Hỏi – đáp trong context code

claude
  • Claude đọc được cấu trúc repo
  • Hiểu file, function, naming convention

  • Phù hợp để:

  • Hỏi logic

  • Refactor nhỏ
  • Giải thích code cũ

🔹 Thực hiện task cụ thể

Ví dụ:

> "Fix bug không load được PDF khi encoding UTF-8"

Claude có thể:

  • Tìm file liên quan
  • Đề xuất hoặc trực tiếp sửa code
  • Chạy test / build nếu được cho phép

🔹 Tạo commit / PR

Claude có thể:

  • Gom các thay đổi hợp lý
  • Viết commit message chuẩn
  • Mở pull request (khi tích hợp GitHub)

3. Tư duy Agent trong Claude Code

Đây là phần quan trọng nhất để dùng Claude Code hiệu quả.

3.1. Mô hình tổng quát

User (Bạn)
   ↓
Main Agent (Claude chính)
   ↓
Sub-agents (Agent chuyên môn)
   ↓
Tools (CLI, FS, Git, Test, Build…)

3.2. Ví dụ đời thường (bể cá 🐟)

Overview dễ hiểu:

  1. Người dùng (Chủ nhà)

> "Tôi muốn xây thêm một cái bể cá ở sân sau."

  1. Main Agent (Tổng thầu) Suy nghĩ:

> "Cần kiểm tra diện tích sân (dùng Tool thước) và gọi đội thợ hồ (Sub-agent)."

  1. Sub-agent (Thợ hồ)

  2. Có kỹ năng riêng (chống thấm, xây gạch)

  3. Dùng tool (máy trộn, bay)

  4. Thực hiện đúng phần việc được giao

  5. Kết quả

  6. Sub-agent báo cáo

  7. Main Agent kiểm tra lại
  8. Bàn giao cho bạn

➡️ Trong Claude Code, Main Agent không làm hết mọi thứ, mà biết chia việc cho đúng agent.

4. Sub-agent là gì và khi nào cần dùng?

Docs chính thức: https://code.claude.com/docs/en/sub-agents

4.1. Sub-agent

Sub-agent là:

  • Một agent phụ
  • Có vai trò rõ ràng
  • Chỉ tập trung giải quyết một mảng nhỏ

Ví dụ:

  • FrontendReviewer
  • BackendFixer
  • TestWriter
  • RefactorAgent

4.2. Khi nào nên dùng Sub-agent?

✅ Nên dùng khi:

  • Task phức tạp
  • Có nhiều domain khác nhau
  • Muốn kết quả ổn định, ít hallucination

❌ Không cần dùng khi:

  • Task rất nhỏ
  • Chỉ chỉnh 1–2 dòng

4.3. Cách giao việc tốt cho Sub-agent

Một prompt tốt thường có:

  • Vai trò rõ ràng
  • Input cụ thể
  • Output mong muốn
  • Giới hạn phạm vi

Ví dụ:

> "Bạn là Backend Agent. Hãy kiểm tra logic xử lý encoding PDF trong Lambda, không sửa frontend, chỉ đề xuất patch."

5. Tools – cánh tay của Agent

Agent không tự làm được gì nếu không có tool.

5.1. Các tool phổ biến

  • File system (read / write)
  • Git (status, diff, commit)
  • CLI (npm, make, gradle, test)
  • Build / Test

➡️ Tool = hành động thật, không phải text.

5.2. Permission Mode

  • acceptEdits: cho phép sửa file
  • readOnly: chỉ đọc
  • noTools: chỉ suy nghĩ

👉 Luôn kiểm soát permission để tránh agent phá repo.

6. Workflow nâng cao (theo kinh nghiệm thực tế)

Tổng hợp từ 2 blog:

6.1. Chia task nhỏ = kết quả tốt hơn

❌ Một prompt lớn:

> "Fix toàn bộ hệ thống auth"

✅ Tốt hơn:

  1. Phân tích auth flow
  2. Agent A: kiểm tra backend
  3. Agent B: kiểm tra frontend
  4. Tổng hợp

6.2. Claude Code không phải Autopilot

  • Nó không thay bạn suy nghĩ
  • Nó là đồng đội cấp senior

👉 Bạn cần:

  • Định hướng
  • Review kết quả
  • Điều chỉnh prompt

6.3. Prompting theo kiểu quản lý kỹ sư

Thay vì:

> "Làm cho nó chạy đi"

Hãy nói:

> "Phân tích nguyên nhân, liệt kê 3 hướng fix, chọn hướng an toàn nhất, rồi implement."

7. Checklist dùng Claude Code hiệu quả

  • [ ] Luôn nói rõ mục tiêu
  • [ ] Chỉ định vai trò agent
  • [ ] Giới hạn phạm vi sửa
  • [ ] Review diff trước khi commit
  • [ ] Không giao task mơ hồ

8. Kết luận

Claude Code mạnh nhất khi bạn:

  • Nghĩ như Tech Lead
  • Dùng agent như con người thật
  • Chia việc rõ ràng
  • Kiểm soát tool & permission

👉 Dùng đúng cách, Claude Code không chỉ viết code, mà giúp bạn xây workflow AI-first.