Cách dùng Claude Code đúng nhất là coi nó như một đồng nghiệp làm việc trong terminal, chứ không phải một chatbot trả lời câu hỏi. Bạn mở terminal ngay tại thư mục dự án, gõ claude, rồi mô tả mục tiêu bằng ngôn ngữ tự nhiên. Claude Code sẽ tự đọc file, tự sửa nhiều file cùng lúc, chạy test và báo lại kết quả cho bạn duyệt.

Rất nhiều bạn cài xong rồi dùng nó y hệt ChatGPT: hỏi một câu, copy code ra ngoài, dán vào editor. Làm vậy là bỏ phí phần lớn giá trị của công cụ. Bài này dẫn bạn đi từ lúc chưa cài gì cho tới lúc chạy được một tác vụ thật, để bạn nắm cách dùng Claude Code trong dự án của mình.

Cập nhật lần cuối: 09/08/2026

Claude Code là gì và khác gì các công cụ AI code khác

Claude Code là công cụ lập trình AI dạng dòng lệnh (CLI) của Anthropic. Bạn chạy nó trong terminal, ngay bên trong thư mục dự án. Nó không phải là một editor, cũng không phải một extension.

Điểm cần nhớ: Claude Code có quyền đọc và ghi file thật trong máy bạn. Vì vậy nó làm được những việc mà cửa sổ chat không làm được.

Điểm khác biệt: agentic, chạy trong terminal, tự sửa nhiều file

Từ khóa quan trọng nhất ở đây là agentic (tự chủ theo mục tiêu). Bạn giao một mục tiêu, không phải một câu hỏi.

Hãy so sánh hai cách nói:

• Cách chatbot: “Viết cho tôi hàm validate email bằng JavaScript.”
• Cách agentic: “Thêm validate email cho form đăng ký, cập nhật cả test và chạy test cho tôi.”

Với cách thứ hai, Claude Code tự tìm file form, tìm file test tương ứng, sửa cả hai, rồi chạy test. Nó giống việc bạn giao một đầu việc cho thực tập sinh, thay vì hỏi một câu lý thuyết.

Ngoài ra, vì chạy trong terminal, Claude Code dùng được với mọi editor. Bạn đang dùng VS Code, JetBrains, Neovim hay Vim đều không sao.

So sánh nhanh với Cursor và GitHub Copilot

Tiêu chí	Claude Code	Cursor	GitHub Copilot
Hình thức	CLI chạy trong terminal	IDE riêng (fork VS Code)	Extension trong IDE
Thế mạnh	Tác vụ nhiều bước, sửa nhiều file	Vừa gõ code vừa nhờ AI	Gợi ý code khi đang gõ
Mức tự chủ	Cao	Trung bình đến cao	Thấp
Phù hợp với	Refactor, sửa bug xuyên nhiều file	Làm việc hằng ngày trong IDE	Tăng tốc gõ code
Ràng buộc editor	Không	Có	Có

Nói ngắn gọn: Copilot giúp bạn gõ nhanh hơn, Cursor giúp bạn làm việc trong IDE thoải mái hơn, còn Claude Code giúp bạn giao hẳn một đầu việc. Nếu bạn đang cân nhắc giữa các IDE có AI, bài so sánh Windsurf và Cursor sẽ hữu ích hơn cho quyết định đó.

Chuẩn bị trước khi cài Claude Code

Bước chuẩn bị chỉ mất vài phút, nhưng bỏ qua nó là nguyên nhân của phần lớn lỗi cài đặt.

Yêu cầu hệ thống

Bạn cần một trong hai thứ sau:

• Cài native (khuyến nghị): không cần Node.js, không cần npm. Anthropic hiện khuyến nghị cách này.
• Cài qua npm: cần Node.js phiên bản mới. Trước đây Node.js 18 là đủ, nhưng các bản gần đây yêu cầu Node.js 22 trở lên.

Kiểm tra Node.js bằng lệnh sau:

node --version

Nếu terminal báo lỗi command not found, bạn chưa có Node.js. Khi đó hãy chọn cách cài native.

Tài khoản và chi phí: Pro, Max, hay API key

Đây là câu hỏi tôi nhận nhiều nhất từ sinh viên. Claude Code không có bản miễn phí. Gói Claude.ai miễn phí không mở quyền dùng Claude Code.

Bạn có ba lựa chọn:

Lựa chọn	Giá tham khảo (2026)	Phù hợp với
Claude Pro	khoảng 20 USD/tháng	Sinh viên, dự án cá nhân, học tập
Claude Max 5x	khoảng 100 USD/tháng	Dev đi làm, dùng nhiều giờ mỗi ngày
Claude Max 20x	khoảng 200 USD/tháng	Dev dùng cường độ rất cao
API key (trả theo lượng dùng)	Trả theo token	Người dùng thất thường, hoặc tích hợp tự động

Một điểm cần lưu ý: hạn mức sử dụng của gói thuê bao được tính theo cửa sổ 5 giờ và có thêm trần theo tuần. Hạn mức này dùng chung với Claude trên web và app. Nghĩa là nếu bạn chat nhiều trên web, quota cho Claude Code cũng bị ảnh hưởng.

Anthropic không công bố con số token chính xác cho từng gói. Các con số bạn thấy trên blog thường chỉ là ước lượng của cộng đồng.

Với sinh viên mới bắt đầu, gói Pro là đủ để học và làm đồ án. Đừng vội mua Max.

Cách cài đặt Claude Code

Trên macOS / Linux

Cách nhanh nhất là dùng script cài native:

curl -fsSL https://claude.ai/install.sh | bash

Nếu bạn dùng macOS và thích Homebrew:

brew install --cask claude-code

Còn nếu bạn đã có Node.js sẵn và muốn cài qua npm:

npm install -g @anthropic-ai/claude-code

Trên Windows

Trên Windows bạn có hai đường. Đường thứ nhất là cài trực tiếp bằng PowerShell:

irm https://claude.ai/install.ps1 | iex

Đường thứ hai là dùng WSL (Windows Subsystem for Linux). Sau khi vào WSL, bạn làm y hệt phần macOS/Linux ở trên.

Xác nhận cài thành công và xử lý 3 lỗi thường gặp

Kiểm tra bằng lệnh:

claude --version

Nếu terminal in ra số phiên bản, bạn đã xong. Nếu chưa, hãy đối chiếu ba lỗi phổ biến dưới đây.

• claude: command not found – thư mục cài đặt chưa nằm trong PATH. Hãy mở lại terminal, hoặc thêm đường dẫn vào .zshrc / .bashrc.
• EACCES: permission denied – lỗi phân quyền thư mục global của npm. Đừng dùng sudo; hãy đổi thư mục global sang thư mục cá nhân, hoặc chuyển sang cài native.
• Node.js quá cũ – bản npm mới yêu cầu Node.js 22 trở lên. Nâng cấp Node.js, hoặc cài native để bỏ qua phụ thuộc này.

Cách dùng Claude Code: chạy lệnh đầu tiên trong 5 phút

Đến đây là phần thú vị. Chúng ta chạy thử trên một dự án thật.

Khởi động trong thư mục dự án

Điều quan trọng nhất: luôn khởi động Claude Code từ thư mục gốc của dự án. Nó lấy ngữ cảnh từ chính thư mục bạn đang đứng.

cd ~/projects/my-web-app
claude

Lần đầu chạy, công cụ hỏi bạn đăng nhập bằng tài khoản Claude hoặc API key.

Sau đó bạn sẽ thấy dấu nhắc. Gõ thẳng yêu cầu bằng tiếng Việt cũng được. Ví dụ:

Giải thích cấu trúc dự án này cho tôi. Đâu là điểm khởi đầu của ứng dụng?

Claude Code sẽ tự đọc các file cần thiết rồi trả lời. Bạn không cần copy code vào.

Cách viết prompt: điểm mấu chốt trong cách dùng Claude Code

Đây là chỗ nhiều người dùng sai. Prompt cho Claude Code nên giống một ticket công việc, không giống một câu hỏi.

Một prompt tốt thường có bốn phần:

1. Mục tiêu – bạn muốn kết quả gì.
2. Phạm vi – file hoặc thư mục nào được phép động vào.
3. Ràng buộc – quy chuẩn code, thư viện được dùng, thứ không được đổi.
4. Cách kiểm chứng – chạy test nào, hoặc kết quả đúng trông thế nào.

So sánh trực tiếp:

• Prompt yếu: “Sửa lỗi đăng nhập.”
• Prompt tốt: “Trong src/auth/login.js, người dùng nhập sai mật khẩu vẫn vào được. Hãy tìm nguyên nhân, sửa, viết thêm test cho trường hợp sai mật khẩu, rồi chạy npm test để xác nhận.”

Prompt thứ hai dài hơn, nhưng tiết kiệm thời gian hơn nhiều.

Ví dụ thực tế: sửa một bug có thật

Giả sử dự án của bạn có một hàm tính tổng tiền giỏ hàng. Nó bị sai khi giỏ hàng rỗng.

Bạn gõ vào Claude Code:

Hàm tính tổng giỏ hàng trả về NaN khi giỏ rỗng.
Tìm hàm đó trong thư mục src, sửa để trả về 0,
thêm một unit test cho trường hợp giỏ rỗng, rồi chạy test.

Quy trình nó thực hiện thường là:

1. Tìm kiếm trong src để định vị hàm.
2. Đọc file và chỉ ra dòng gây lỗi.
3. Đề xuất bản sửa, chờ bạn duyệt.
4. Ghi file, thêm test, chạy npm test.
5. Báo lại kết quả test cho bạn.

Bạn vẫn là người duyệt từng thay đổi. Đây là điểm khác biệt lớn so với việc dán code từ chatbot mà không đọc.

Cách dùng Claude Code hằng ngày: các lệnh cần nhớ

Bạn không cần nhớ hết. Vài lệnh dưới đây đã đủ cho phần lớn công việc.

Slash command cần nhớ

Gõ dấu / trong phiên làm việc, danh sách lệnh sẽ hiện ra. Claude Code hiện có hơn 60 lệnh dựng sẵn, nhưng bạn chỉ cần thuộc nhóm sau:

Lệnh	Công dụng
/init	Tạo file CLAUDE.md cho dự án
/clear	Xóa lịch sử hội thoại, làm sạch ngữ cảnh
/plan	Bật chế độ lập kế hoạch trước khi sửa
/model	Đổi mô hình đang dùng
/diff	Xem thay đổi file dạng diff
/help	Xem toàn bộ lệnh

Thêm file vào ngữ cảnh

Bạn có thể trỏ thẳng vào file bằng ký tự @. Ví dụ:

@src/utils/date.js hàm formatDate đang trả sai múi giờ, kiểm tra giúp tôi

Chế độ plan mode và tại sao nên dùng

Lệnh /plan bật chế độ lập kế hoạch. Ở chế độ này, Claude Code trình bày các bước dự định làm và chờ bạn duyệt trước khi động vào file.

Bạn nên bật plan mode trong ba trường hợp:

• Làm việc với codebase lạ, chưa nắm rõ cấu trúc.
• Chuẩn bị refactor lớn, ảnh hưởng nhiều file.
• Đang làm trên nhánh quan trọng, cần kiểm soát chặt.

Với sinh viên, tôi khuyên bật plan mode gần như mọi lúc trong giai đoạn đầu. Đọc kế hoạch của AI cũng là một cách học kiến trúc rất tốt.

Quản lý phiên làm việc

Mỗi phiên làm việc tích lũy ngữ cảnh. Ngữ cảnh càng dài, chi phí càng cao và chất lượng càng dễ trôi.

Nguyên tắc thực dụng: một tác vụ, một phiên. Làm xong một việc thì /clear rồi bắt đầu việc mới.

Bạn muốn học AI Coding bài bản? CodeGym Đà Nẵng có lộ trình AI Coding thực chiến dành cho sinh viên IT: từ prompt engineering, Claude Code, đến cách review code do AI sinh ra. Học trên dự án thật, có mentor kèm.

File CLAUDE.md: cách dạy Claude quy chuẩn dự án

Đây là thứ tạo ra khác biệt lớn nhất giữa người dùng thành thạo và người mới. CLAUDE.md là file hướng dẫn nằm ở gốc dự án. Claude Code đọc nó mỗi lần khởi động.

Tạo file bằng lệnh:

/init

Lệnh này quét dự án rồi sinh một bản CLAUDE.md nháp để bạn sửa lại cho đúng thực tế.

Nên viết gì trong CLAUDE.md

Chỉ viết những thứ mà một người mới vào dự án cần biết:

• Dự án làm gì, kiến trúc tổng thể ra sao.
• Các lệnh hay dùng: chạy dev, build, test, lint.
• Quy ước code: đặt tên, cấu trúc thư mục, chuẩn commit.
• Những thứ không được đụng vào.
• Thư viện được phép dùng và thư viện bị cấm.

Ngược lại, đừng nhồi cả tài liệu API vào đây. File càng dài thì mỗi phiên càng tốn token.

Mẫu CLAUDE.md copy được ngay

Copy khối dưới, đổi lại cho khớp dự án của bạn là dùng được.

# CLAUDE.md

## Về dự án
Web bán hàng, React 18 + Vite ở frontend, Node.js + Express ở backend.
Database: PostgreSQL, truy cập qua Prisma.

## Lệnh hay dùng
- npm run dev – chạy môi trường phát triển
- npm test – chạy unit test (Vitest)
- npm run lint – kiểm tra ESLint

## Quy ước code
- Component đặt tên PascalCase, file cùng tên component.
- Không dùng any trong TypeScript.
- Mọi hàm gọi API phải có xử lý lỗi.
- Commit theo Conventional Commits (feat, fix, chore).

## Không được đụng vào
- Thư mục src/legacy/ – code cũ, sẽ gỡ sau.
- File prisma/migrations/ – chỉ sửa qua lệnh migrate.

## Khi sửa code
- Sửa xong phải chạy npm test trước khi báo hoàn thành.
- Nếu thêm dependency mới, hỏi tôi trước.

Nâng cao: cách dùng Claude Code với MCP và subagent

Khi đã quen tay, bạn có thể mở rộng cách dùng Claude Code theo ba hướng dưới đây.

Kết nối MCP server

MCP (Model Context Protocol) là chuẩn giao tiếp giúp AI kết nối với công cụ và dữ liệu bên ngoài. Nhờ MCP, Claude Code có thể truy vấn database, đọc issue trên Jira, hay tra cứu tài liệu nội bộ.

Thêm một MCP server bằng lệnh:

claude mcp add <tên-server> -- <lệnh khởi chạy>

Có ba kiểu kết nối phổ biến: stdio cho server chạy cục bộ, http cho server từ xa, và OAuth khi cần đăng nhập. Bạn cũng chọn được phạm vi cấu hình: riêng cá nhân, hoặc chia sẻ cho cả nhóm qua file .mcp.json.

Nếu bạn chưa nắm khái niệm này, hãy đọc bài MCP là gì và AI agent cho developer trước.

Subagent và khi nào cần

Subagent là các trợ lý con. Mỗi subagent chạy trong cửa sổ ngữ cảnh riêng, với system prompt riêng và quyền truy cập công cụ riêng.

Bạn nên dùng subagent khi có nhiều đầu việc lớn, độc lập nhau. Ví dụ: một subagent lo viết test, một subagent lo cập nhật tài liệu.

Tích hợp với Git và IDE

Claude Code làm việc rất tốt với Git. Bạn có thể yêu cầu nó xem diff, viết commit message, hay tóm tắt các thay đổi trong nhánh.

Một mẹo an toàn: luôn commit trước khi giao việc lớn. Nếu kết quả không ưng ý, bạn git checkout là quay lại được ngay.

7 mẹo về cách dùng Claude Code hiệu quả và tiết kiệm token

1. Dọn ngữ cảnh thường xuyên. Xong một việc thì /clear. Ngữ cảnh cũ vẫn bị tính phí ở mỗi lượt trả lời.
2. Chỉ đích danh file bằng @. Điều này giúp công cụ khỏi quét cả repo, vốn rất tốn token.
3. Viết CLAUDE.md ngắn và đúng. Đây là khoản đầu tư sinh lời cao nhất.
4. Bật plan mode với việc lớn. Duyệt kế hoạch rẻ hơn nhiều so với sửa hậu quả.
5. Chia nhỏ yêu cầu. Một prompt ôm đồm năm việc thường cho kết quả kém hơn năm prompt rõ ràng.
6. Luôn đọc diff trước khi duyệt. Bạn chịu trách nhiệm cho code trong repo, không phải AI.
7. Dùng đúng mô hình cho đúng việc. Việc đơn giản không cần mô hình mạnh nhất. Lệnh /model giúp bạn đổi nhanh.

Một lưu ý về học tập: nếu bạn đang trong giai đoạn xây nền tảng, đừng giao hết cho AI. Hãy tự viết trước, rồi nhờ Claude Code review. Cách học đúng với AI được bàn kỹ hơn trong bài học lập trình bằng ChatGPT.

Lỗi thường gặp khi dùng Claude Code và cách xử lý

Hiện tượng	Nguyên nhân thường gặp	Cách xử lý
command not found: claude	PATH chưa có đường dẫn cài đặt	Mở lại terminal; thêm PATH vào .zshrc hoặc .bashrc
EACCES: permission denied	Phân quyền thư mục global npm	Đổi thư mục global npm, hoặc chuyển sang cài native
Báo lỗi phiên bản Node.js	Node.js cũ hơn yêu cầu	Nâng Node.js lên bản mới, hoặc cài native
Hết hạn mức giữa chừng	Cửa sổ 5 giờ hoặc trần tuần đã đầy	Đợi hết cửa sổ, dọn ngữ cảnh, hoặc nâng gói
Claude sửa nhầm file	Prompt không nêu phạm vi	Chỉ rõ file bằng @, bật plan mode
Câu trả lời lan man, sai trọng tâm	Ngữ cảnh phiên quá dài	Chạy /clear rồi mô tả lại yêu cầu
Không tìm thấy MCP server	Cấu hình sai transport hoặc lệnh	Kiểm tra lại claude mcp add, thử transport stdio

Nếu gặp lỗi lạ, hãy đọc tài liệu chính thức của Claude Code. Công cụ này cập nhật rất nhanh, nên tài liệu gốc luôn đáng tin hơn bài blog cũ.

Câu hỏi thường gặp

Claude Code có miễn phí không?

Không. Claude Code yêu cầu gói trả phí: Pro, Max, Team, Enterprise hoặc tài khoản API. Gói Claude.ai miễn phí không mở quyền dùng. Với sinh viên, gói Pro khoảng 20 USD/tháng là lựa chọn hợp lý nhất để học và làm đồ án. Nếu dùng thất thường, bạn có thể dùng API key và trả theo lượng token thực tế.

Dùng được trên Windows không?

Được. Bạn có hai cách: cài trực tiếp bằng PowerShell với script cài native, hoặc cài trong WSL rồi làm theo hướng dẫn Linux. Tôi khuyên dùng WSL vì môi trường ổn định hơn và giúp bạn quen với lệnh Linux. Cả hai cách đều không bắt buộc phải có Node.js nếu bạn chọn bản cài native.

Có cần biết code mới dùng được không?

Về mặt thao tác thì không. Nhưng để dùng hiệu quả thì có. Bạn cần đủ kiến thức để đọc diff, hiểu code AI viết, và phát hiện lỗi logic. Người không biết code vẫn chạy được lệnh, song sẽ không kiểm soát được chất lượng. Rủi ro lớn nhất là code chạy được nhưng sai ngầm mà bạn không nhận ra.

Claude Code có tự động commit code không?

Không tự động theo mặc định. Nó chỉ commit khi bạn yêu cầu rõ ràng. Tuy nhiên, nó ghi file trực tiếp vào dự án, nên thói quen an toàn là commit hoặc tạo nhánh mới trước khi giao việc lớn. Khi kết quả không ưng ý, bạn dùng git checkout hoặc git reset để quay lại trạng thái cũ.

Claude Code khác Cursor như thế nào?

Cursor là một IDE hoàn chỉnh, fork từ VS Code, mạnh khi bạn vừa gõ code vừa nhờ AI hỗ trợ. Claude Code là công cụ dòng lệnh, mạnh khi bạn giao hẳn một tác vụ nhiều bước. Nhiều dev dùng cả hai: Cursor để viết code hằng ngày, Claude Code cho refactor lớn hoặc sửa bug xuyên nhiều file.

Làm sao để không bị đốt token quá nhanh?

Ba việc quan trọng nhất: dọn ngữ cảnh bằng /clear sau mỗi tác vụ, chỉ đích danh file bằng @ thay vì để công cụ quét cả repo, và viết CLAUDE.md gọn gàng. Ngoài ra, hãy chia nhỏ yêu cầu và dùng mô hình nhẹ hơn cho việc đơn giản. Hạn mức tính theo cửa sổ 5 giờ, nên phân bổ công việc trong ngày cũng giúp ích.

Sinh viên chưa đi làm có nên học cách dùng Claude Code không?

Nên, nhưng đúng thời điểm. Cách dùng Claude Code không khó học. Nếu bạn còn đang học vòng lặp, mảng, hàm thì hãy tự viết tay trước. Khi đã làm được project nhỏ, hãy đưa Claude Code vào để tăng tốc và học cách review code. Nhà tuyển dụng năm 2026 đánh giá cao ứng viên biết dùng AI có kiểm soát, chứ không phải người phụ thuộc hoàn toàn.

Kết luận

Tóm lại ba điều cần nhớ về cách dùng Claude Code:

• Giao mục tiêu, đừng hỏi câu hỏi. Prompt tốt là một ticket công việc có mục tiêu, phạm vi, ràng buộc và cách kiểm chứng.
• CLAUDE.md là khoản đầu tư sinh lời nhất. Mười phút viết file này tiết kiệm hàng giờ giải thích lặp lại.
• Bạn vẫn là người chịu trách nhiệm. Đọc diff, chạy test, commit trước khi giao việc lớn.

Công cụ AI thay đổi rất nhanh. Thứ không đổi là nền tảng lập trình và khả năng đánh giá code. Đó mới là thứ giúp bạn dùng AI hiệu quả thay vì bị nó dẫn dắt.

Muốn học AI Coding một cách bài bản? Khóa AI Coding thực chiến tại CodeGym Đà Nẵng hướng dẫn bạn dùng Claude Code, Cursor và MCP trên dự án thật, kèm kỹ năng review code do AI sinh ra. Phù hợp với sinh viên IT và lập trình viên mới đi làm. Đăng ký tư vấn lộ trình miễn phí để được xếp lớp đúng trình độ.