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, lịch sử, 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. Workflow cơ bản

Vòng lặp gõ yêu cầu → review → accept → kiểm chứng.

5. 8 tính năng nổi bật

File ops, bash, web, subagent, skill, plan, hook, MCP.

6. 6 use case phổ biến

Build feature, refactor, debug, test, review, migration.

7. 5 mẹo nâng cao

CLAUDE.md, plan mode, hooks, allowlist, slash command.

8. 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.

ToolBản chấtPhù hợp khi
GitHub CopilotAutocomplete trong IDEGõ code từng dòng nhanh hơn
CursorIDE riêng có AI tích hợpĐổi sang môi trường mới có AI sâu
ChatGPT / Claude chatChat web, copy-paste codeHỏi đáp ngắn, học khái niệm
Claude CodeAgent CLI tự chạy đa bướcRefactor, 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 E2E

Khô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

1

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).

2

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.

3

Đă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.

4

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.

5

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.

📋 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. WORKFLOW

Vòng lặp dùng Claude Code mỗi ngày trông thế nào?

1

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."

2

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.

3

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.

4

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."

5

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.

5. 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.

6. 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.

7. NÂNG CAO

5 mẹo dùng Claude Code hiệu quả gấp 3

1

Đầ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.

2

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.

3

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.

4

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.

5

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.

8. 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

6 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ụ WebFetchWebSearch 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.

🚀 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.