Canonical HTML: https://claudewiki.org/claude-code.html

# Hướng dẫn sử dụng Claude Code hiệu quả

Claude Code là công cụ lập trình theo tác vụ của Anthropic, có trên terminal, IDE, ứng dụng desktop và trình duyệt. Bài này hướng dẫn cài đặt, workflow và 8 tính năng nổi bật.

### 💡 Claude Code là gì?

**Claude Code là công cụ dòng lệnh (CLI) chính thức của Anthropic. Nó biến Claude AI thành một "lập trình viên agentic" chạy trong terminal: đọc/sửa nhiều file cùng lúc, chạy lệnh shell, gọi API, debug và lặp đến khi hoàn thành nhiệm vụ — chỉ cần bạn mô tả việc cần làm bằng tiếng Việt hoặc tiếng Anh.**

- **Phát hành:** 2025, Anthropic.
- **Chạy trên:** macOS, Linux, Windows, WSL.
- **Yêu cầu:** Hệ điều hành được hỗ trợ và tài khoản Claude trả phí hoặc API key; native installer không cần Node.js.
- **Bản chất:** agentic coding — Claude tự ra quyết định nhiều bước, không chỉ autocomplete.

### Chưa có Pro hoặc Max?

Xem Gift Claude đang có trong VQStore, rồi redeem trên chính tài khoản bạn sẽ dùng với Claude Code.

VQStore là bên bán độc lập, không thuộc Anthropic.

### 🎯 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ì?](https://claudewiki.org/claude-code.html#what)

Định nghĩa, khác biệt với Copilot/Cursor.

#### [2. Phù hợp cho ai?](https://claudewiki.org/claude-code.html#who)

6 nhóm người dùng và use case tiêu biểu.

#### [3. Cài đặt 5 bước](https://claudewiki.org/claude-code.html#install)

Kiểm tra hệ điều hành, native installer, login, verify, CLAUDE.md.

#### [4. Vòng lặp Agentic](https://claudewiki.org/claude-code.html#agentic-loop)

Gather → Act → Verify, và 3 lầm tưởng phổ biến.

#### [5. 3 chế độ phân quyền](https://claudewiki.org/claude-code.html#modes)

Default, Auto Accept, Plan Mode — đổi bằng Shift+Tab.

#### [6. Workflow cơ bản](https://claudewiki.org/claude-code.html#workflow)

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

#### [7. Quy trình EPCC](https://claudewiki.org/claude-code.html#epcc)

Explore-Plan-Code-Commit, hiệu chỉnh theo quy mô, /rewind.

#### [8. Công thức prompt C-T-R](https://claudewiki.org/claude-code.html#ctr)

Context - Task - Rules: prompt là brief, không phải mệnh lệnh.

#### [9. Quản lý context](https://claudewiki.org/claude-code.html#context)

/context, /compact, /clear và bẫy auto-compact.

#### [10. CLAUDE.md 3 tầng](https://claudewiki.org/claude-code.html#claude-md)

/init để khởi tạo, # để dạy rule, @ để tham chiếu.

#### [11. 8 tính năng nổi bật](https://claudewiki.org/claude-code.html#features)

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

#### [12. Subagent đúng cách](https://claudewiki.org/claude-code.html#subagent)

Đôi mắt thứ hai, anti-pattern persona, least privilege.

#### [13. Skill, Hook hay MCP?](https://claudewiki.org/claude-code.html#skill-hook)

Chọn đúng cơ chế mở rộng + kiểm soát chi phí MCP.

#### [14. Làm việc async qua PR](https://claudewiki.org/claude-code.html#async-pr)

Tạo PR bằng skill, --from-pr, GitHub Action.

#### [15. 6 use case phổ biến](https://claudewiki.org/claude-code.html#usecases)

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

#### [16. 5 mẹo nâng cao](https://claudewiki.org/claude-code.html#tips)

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

#### [17. 4 nguyên tắc vàng](https://claudewiki.org/claude-code.html#golden)

Verify don't trust, prompt là code, giữ context, tự động hoá.

#### [18. Khi nào KHÔNG nên dùng?](https://claudewiki.org/claude-code.html#avoid)

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 |

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](https://claudewiki.org/claude-basic/bai-1.html) và làm quen Claude trên web trước.

3. CÀI ĐẶT

## Cài đặt Claude Code trong 5 bước

#### Kiểm tra hệ điều hành

Dùng macOS 13+, Windows 10 1809+ hoặc bản Linux được hỗ trợ. Native installer là cách Anthropic khuyến nghị và không yêu cầu Node.js.

#### Chạy native installer

macOS/Linux/WSL: `curl -fsSL https://claude.ai/install.sh | bash`. Windows PowerShell: `irm https://claude.ai/install.ps1 | iex`. Có thể dùng `winget install Anthropic.ClaudeCode` trên Windows.

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

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

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

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 |

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

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. **Fable 5.1, Opus 5.5, Sonnet 5.5 và Haiku 5.5 đều hỗ trợ 1M context trong API**; ứng dụng công bố tới 1M tuỳ model và gói — 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 đó.

### 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**.

##### → `/compact`

Giữ mạch việc, chỉ dọn rác

##### → `/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.

#### Cập nhật bằng `/memory`

Dùng `/memory` để mở file hướng dẫn; hoặc yêu cầu rõ “Thêm quy tắc này vào CLAUDE.md”. Auto memory lưu những ghi nhớ riêng trong thư mục memory của dự án và có thể chỉnh/xoá.

#### Tham chiếu bằng `@`

Đừng copy-paste tài liệu vào file. Dùng `@README.md` để import tài liệu cần thiết; file import từ CLAUDE.md được nạp khi file hướng dẫn đó được nạp. Chỉ tham chiếu nội dung cần dùng thường xuyên, vì import cũng chiếm context.

## Claude Code hiện hành: nhiều nơi làm việc, cùng một tác vụ

Claude Code có trên terminal, IDE, desktop và web. Có thể theo dõi phiên qua Remote Control, dùng Skills, plugins và MCP theo quyền được cấp. Kiểm tra tính năng cụ thể trong [tài liệu Claude Code](https://code.claude.com/docs/en/overview).

**Message threads** đã có public beta ngày 02/11/2026: giảm dữ liệu phải gửi lại và độ trễ trong tác vụ dài. Đây không phải giảm số token Claude xử lý hoặc tăng hạn mức subscription. Xem [công bố message threads](https://claude.com/resources/articles/message-threads).

Bộ nhớ có `CLAUDE.md` và auto memory; dùng `/memory` để kiểm tra. Với Skills bật trên Claude.ai, có đồng bộ một chiều xuống Code khi đăng nhập cùng tài khoản và chính sách cho phép. Tài liệu mới nhất: [memory](https://code.claude.com/docs/en/memory), [Skills](https://code.claude.com/docs/en/skills) và [MCP tool search](https://code.claude.com/docs/en/mcp).

11. TÍNH NĂNG

## 8 tính năng cốt lõi của Claude Code

#### File operations

Đọc, sửa, tạo, xoá file. Hiểu cấu trúc thư mục lớn nhờ Glob/Grep.

#### Bash execution

Chạy mọi lệnh shell (npm/git/docker/aws cli…), đọc stdout/stderr để quyết định bước tiếp.

#### WebFetch & WebSearch

Đọc tài liệu online (API doc, changelog), tìm thông tin mới ngoài training data.

#### Subagent

Giao phần việc độc lập cho agent con; kết quả tóm tắt vẫn dùng context chính và mỗi agent phát sinh mức dùng riêng.

#### Skill

Package quy trình tái sử dụng (vd. `seo`, `review`, `security-review`) — gọi bằng `/skill-name`.

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

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

#### 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

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?

##### → 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

##### → Gọi Subagent

Research, review code, audit — bạn chỉ cần kết luận

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 được hệ thống gọi khi sự kiện và điều kiện cấu hình khớp; vẫn phải xử lý lỗi, timeout và kiểm tra đầu ra của script. Ví dụ kinh điển: hook `PostToolUse` chạy linter sau mỗi lần Claude sửa file — giúp phát hiện lỗi định dạng sớm; CI vẫn cần kiểm tra độc lập.

### 🪝 Cấu hình hook trong `.claude/settings.json`

`{ "hooks": { "PostToolUse": "./.claude/hooks/lint.sh" } }`

### MCP: đừng bỏ quên chi phí context

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

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.

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

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

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

15. USE CASE

## 6 workflow phổ biến nhất với Claude Code

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

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

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

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

#### Code review PR

"`/review PR#234`" — dùng skill có sẵn để review PR đầy đủ: logic, security, edge case, suggest sửa.

#### 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

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

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

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

#### 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 — 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 $100/tháng, Ultra $200/tháng, Team Standard $25/chỗ/tháng hoặc $20 khi 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](https://claudewiki.org/bang-gia-claude.html).

### Claude Code khác gì GitHub Copilot và Cursor?+

Claude Code thực hiện tác vụ trên codebase: đọc và sửa nhiều file, chạy lệnh, kiểm tra kết quả; có trên terminal, IDE, desktop và web. Chọn công cụ theo quy trình làm việc, quyền truy cập và kết quả kiểm chứng trên dự án của bạ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… Việc hỏi quyền phụ thuộc permission mode và các quy tắc cho phép/chặn đã cấu hình.

### Dữ liệu code của tôi có bị Anthropic dùng để train AI không?+

Với Free/Pro/Max/Ultra, việc dùng dữ liệu để cải thiện model phụ thuộc Model Improvement trong Settings > Privacy. Team/Enterprise/API không huấn luyện theo mặc định; việc opt-in hoặc gửi feedback có điều kiện riêng. Retention và data residency phụ thuộc sản phẩm, gói và cấu hình. Chi tiết ở [trang Bảng giá → phần bảo mật](https://claudewiki.org/bang-gia-claude.html#bao-mat).

### 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](https://claudewiki.org/claude-basic/bai-1.html) 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 chạy theo sự kiện → cấu hình Hook và kiểm tra lỗi của script; dùng CI hoặc kiểm tra độc lập cho điều kiện bắt buộc.

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 ngày 06/11/2026.

### 🚀 Sẵn sàng dùng Claude Code?

Chạy native installer phù hợp với hệ điều hành rồi bắt đầu task đầu tiên. Khi quen rồi, ghép với [Claude Cowork](https://claudewiki.org/claude-cowork.html) để xử lý cả việc cần GUI. Chưa rõ gói nào phù hợp? Xem [trang Claude Price](https://claudewiki.org/bang-gia-claude.html).

**Cập nhật lần cuối: 06/11/2026.** Lệnh, cờ và tính năng đối chiếu theo tài liệu chính thức: [hướng dẫn cài đặt](https://code.claude.com/docs/en/setup), [danh sách lệnh](https://code.claude.com/docs/en/commands) và [CLI reference](https://code.claude.com/docs/en/cli-reference). Lineup hiện tại: Fable 5.1, Opus 5.5, Sonnet 5.5 (context tối đa **1.000.000 token** trên gói trả phí) và Haiku 5.5 (**1.000.000 token**).

**Đối chiếu thông tin Claude: 06/11/2026.** Xem [các thay đổi, phạm vi truy cập và nguồn chính thức](https://claudewiki.org/cap-nhat-claude.html). Tính năng có thể triển khai theo đợt, khu vực và cấu hình tổ chức.

## Theo dõi hạn mức khi dùng Claude Code

Chat và Code có thể dùng chung hạn mức tài khoản. [Xem giới hạn Pro và cách kiểm tra Usage](https://claudewiki.org/claude-free-pro-bao-nhieu-token.html#goi-claude-pro-duoc-bao-nhieu-token).
