Claude Code là gì? Cách cài và dùng từ A đến Z

Tháng trước tôi ngồi sửa một dự án Next.js cũ. Bốn mươi hai tệp, không ai viết test, và một hàm tính giá nằm ở đâu đó mà tìm mãi không ra. Tôi mở Terminal, gõ một câu hỏi, và công cụ trả lời kèm đúng số dòng của tệp chứa hàm đó.

Đó là Claude Code. Không phải một trang web trả lời câu hỏi. Một công cụ chạy trong Terminal, đọc được tệp trong máy bạn.

Bài này sẽ nói rõ nó là gì, khác gì so với hỏi Claude trên web, và những chỗ nó còn yếu mà bạn nên biết trước khi cài.

Claude Code là gì

Claude Code là công cụ lập trình chạy bằng dòng lệnh của Anthropic. Bạn cài nó lên máy, mở Terminal trong thư mục dự án, gõ claude, rồi nói chuyện với nó bằng tiếng Việt hoặc tiếng Anh bình thường.

Điểm khác biệt không nằm ở việc nó thông minh đến đâu. Nằm ở chỗ nó đứng ngay trong dự án của bạn.

Một trợ lý AI trên web chỉ đọc được thứ bạn dán vào ô chat. Claude Code thì đọc tệp trong thư mục dự án, sửa trực tiếp vào tệp đó, chạy lệnh Terminal, và xem kết quả trả về. Bạn nói "sửa lỗi này", nó mở đúng tệp, sửa, rồi chạy lệnh kiểm tra xem đã hết lỗi chưa.

Phiên bản mà tài liệu mình viết bám theo là 2.1.268, chạy trên macOS, Windows và Linux. Con số phiên bản này quan trọng: công cụ đổi khá nhanh, nên bài hướng dẫn trên mạng viết từ nửa năm trước có thể đã sai tên lệnh.

Cái tên gây nhầm lẫn nhất là chữ "Code" trong tên. Không chỉ dân lập trình dùng nó. Bất kỳ ai phải thao tác trên một thư mục tệp — đổi hàng loạt tên tệp, chuyển định dạng, viết kịch bản — đều dùng được.

Nó làm được gì mà công cụ khác không làm

Bốn thứ đáng kể.

Thứ nhất, nó sửa tệp thật. Không có bước chép tay. Bạn đọc lại phần nó sửa, đồng ý thì giữ, không đồng ý thì nói sửa lại.

Thứ hai, nó chạy lệnh rồi đọc kết quả. Đây là phần khiến công việc khác hẳn. Nó chạy npm test, thấy ba bài test đỏ, đọc thông báo lỗi, sửa, chạy lại. Vòng lặp đó diễn ra mà bạn không phải chép thông báo lỗi qua lại.

Thứ ba, nó nhớ dự án. Tệp CLAUDE.md đặt ở gốc dự án chứa các quy ước: dùng dấu nháy đơn hay nháy kép, đặt tên hàm kiểu gì, thư viện nào đã chốt không dùng. Từ lần sau, nó đọc tệp đó trước khi làm gì.

Thứ tư, nó sống trong Git. Bạn bảo nó tạo nhánh, commit, viết mô tả pull request. Nó làm được, nhưng có một điều kiện sống còn: dự án phải đang sạch và bạn phải tự xem lại thay đổi trước khi đẩy lên.

Cài đặt: ba bước, và một lỗi làm hỏng phần lớn bản cài

Cần Node.js bản 18 trở lên. Kiểm tra trước:

node -v
npm -v

Sau đó cài. Trên macOS hoặc Linux, mở Terminal và chạy npm install -g @anthropic-ai/claude-code. Trên Windows thì cài trong PowerShell; nếu bạn quen WSL thì cài thẳng trong WSL cũng được, nhưng đừng cài nửa vời ở cả hai bên, đường dẫn sẽ lệch nhau và phần mềm báo lỗi khó hiểu.

Đây là chỗ hỏng. Rất nhiều bài hướng dẫn trên mạng ghi sudo npm install -g .... Đừng làm vậy.

Khi chạy npm kèm sudo, các tệp do npm tạo ra thuộc quyền của tài khoản root. Lần sau bạn cập nhật phiên bản mà không có sudo, npm không ghi đè được lên tệp của root, và báo lỗi quyền mà thông báo không hề nhắc tới chuyện bạn từng dùng sudo. Cách sửa sạch nhất là gỡ ra, sửa quyền thư mục npm, rồi cài lại không có sudo. Cách phòng thì đơn giản: ngay từ đầu đừng dùng sudo.

Cài xong, gõ claude trong thư mục dự án. Nó hỏi đăng nhập. Xong bước này là vào được phiên làm việc.

Nếu bạn phải làm việc trên nhiều máy, hãy cài trong WSL trên Windows thay vì PowerShell. Đường dẫn tệp trong WSL giống trên Linux, nên kịch bản shell dùng chung được giữa máy bạn và máy chủ.

Bốn ký tự mở đầu — phần dùng hằng ngày

Gõ bốn ký tự này ở đầu dòng nhập liệu. Nhớ bốn ký tự là dùng được phần lớn công cụ.

Hai trong bốn cái này tiết kiệm nhiều thời gian nhất.

# là cách thêm quy ước vào CLAUDE.md mà không phải mở tệp bằng tay. Ngồi làm việc, bạn phát hiện dự án có quy ước ngầm chưa ai ghi lại — gõ # rồi viết. Từ đó nó nằm trong bộ nhớ.

@ là cách chỉ đúng tệp cần sửa. Không dùng @, nó phải tự tìm trong toàn dự án, vừa chậm vừa dễ sửa nhầm tệp trùng tên.

Lệnh gạch chéo thì nhiều, nhưng số dùng thật ít. /clear để bắt đầu lại ngữ cảnh. /context để xem ngữ cảnh đang đầy tới đâu. Vài lệnh dạng /tên-thư-mục:tên-lệnh gọi các lệnh riêng của dự án mà bạn tự viết, cộng lại thành một bộ lệnh riêng cho đơn vị mình.

Chế độ quyền — chỗ quyết định an toàn

Đây là phần nên đọc trước khi cài, không phải sau.

Claude Code không hỏi ý kiến bạn trước mỗi hành động nếu bạn đã cho nó quyền. Có bốn chế độ. Chế độ mặc định hỏi trước khi sửa tệp hoặc chạy lệnh. Có chế độ tự động chấp nhận sửa tệp. Có chế độ lập kế hoạch — nó chỉ trình bày dự định, không đụng vào gì. Và có chế độ bỏ qua hết các câu hỏi xác nhận.

Chế độ cuối là chế độ người ta hay bật vì thấy tiện, rồi hối hận. Trên máy có dữ liệu thật, nó đủ sức xoá nhầm một thư mục. Tôi để mặc định, và gõ ! khi cần chạy lệnh nhanh.

Cách kiểm soát tốt hơn là viết quy tắc trong tệp thiết lập, dạng cho phép, hỏi, chặn. Ví dụ: cho phép git status, git diff, npm run lint chạy không cần hỏi; luôn hỏi trước git push; chặn hẳn rm -rf. Viết một lần, dùng mãi.

Hook, skill và MCP

Ba chữ này hay bị gộp làm một. Chúng khác nhau.

Skill là một kỹ năng bạn viết ra một lần rồi gọi lại bằng lệnh gạch chéo. Ví dụ, đơn vị bạn có quy trình tạo trang hồ sơ theo mẫu riêng — viết thành skill, lần sau gõ một lệnh là ra.

Hook là tự động hoá theo sự kiện. Bạn đặt luật: sau mỗi lần sửa tệp .ts thì chạy lệnh kiểm tra kiểu dữ liệu; trước khi kết thúc phiên thì định dạng lại mã. Hook chạy tự động, bạn không phải nhớ.

MCP là cách nối công cụ ngoài vào. Một máy chủ MCP biến hệ thống bên ngoài thành bộ công cụ mà Claude Code gọi được — cơ sở dữ liệu nội bộ, hệ thống quản lý công việc, một API riêng.

Ba thứ này cộng lại là điểm khác biệt giữa người dùng ở mức cơ bản và người làm được việc thật. Nhưng đừng vội. Cài xong, dùng quen phần lệnh gạch chéo và CLAUDE.md đã, rồi mới dựng hook — dựng hook khi chưa hiểu luồng làm việc của mình chỉ tạo thêm thứ phải gỡ.

Ví dụ thật: một buổi chiều với dự án Next.js

Dự án đó có hàm tính giá nằm trong tệp src/lib/pricing.ts. Ba nơi gọi nó, và một trong ba nơi truyền thiếu tham số, nên giá ra sai vài đồng ở một số đơn hàng.

Cách làm của tôi:

Đầu tiên, @src/lib/pricing.ts để chỉ đúng tệp, kèm mô tả triệu chứng — giá lệch vài đồng với một số đơn, không phải mọi đơn. Mô tả triệu chứng quan trọng hơn mô tả cách sửa.

Nó tìm ra ba nơi gọi. Tôi đọc thay đổi nó đề xuất. Một trong ba chỗ nó định đổi không liên quan, tôi bảo bỏ.

Sau đó !npm test. Hai bài test đỏ. Nó đọc thông báo lỗi, sửa, chạy lại. Lần này xanh.

Cuối cùng, tôi bảo nó commit với mô tả nói rõ lỗi ở đâu và sửa thế nào. Tôi đọc git diff lần cuối trước khi đẩy lên.

Hết. Khoảng hai mươi phút, trong đó phần lớn là tôi đọc lại thay đổi chứ không phải gõ.

Chỗ này nói thẳng: nếu bạn không đọc lại thay đổi thì công cụ này nguy hiểm hơn là hữu ích. Nó sửa nhanh và sai cũng nhanh.

Những chỗ còn yếu, nói thẳng

Không có bản chạy được trong môi trường không có mạng nếu bạn đang dùng mô hình trên đám mây — nó cần gọi mô hình.

Nó tốn tiền theo lượng dùng. Chạy một việc dài trên dự án lớn thì chi phí không nhỏ, nhất là khi bạn để nó tự do tìm tòi trong toàn bộ mã nguồn. Nếu không theo dõi, hóa đơn cuối tháng gây bất ngờ. Tài liệu có phần nói về chọn mô hình và quản lý ngữ cảnh để hạn chế chuyện này.

Ngữ cảnh có hạn. Làm việc liên tục trên một dự án lớn trong nhiều giờ thì nó bắt đầu quên những gì đã nói lúc đầu. Cách xử lý là /clear khi chuyển sang việc khác hẳn, và viết những gì quan trọng vào CLAUDE.md chứ không tin vào trí nhớ phiên.

Nó không biết gì về nghiệp vụ của bạn. Nó viết hàm tính khối lượng bê tông nếu bạn mô tả đúng công thức, nhưng nếu công thức bạn đưa sai thì nó viết đúng theo cái sai đó, và chạy trơn tru.

Và cuối cùng, nó không kiểm tra hộ bạn. Test xanh không có nghĩa là làm đúng việc. Ranh giới cuối vẫn là con người đọc lại.

Nối Git vào luồng làm việc

Phần này đáng một mục riêng vì nó dễ gây tai nạn.

Quy tắc tôi giữ: mỗi việc một nhánh. Bắt đầu việc mới thì tạo nhánh mới trước khi để nó sửa tệp. Nhánh sạch là lưới an toàn — xong việc thấy sai thì bỏ cả nhánh, không phải ngồi gỡ từng tệp.

Đừng để nó commit thẳng lên nhánh chính. Và luôn đọc git diff trước khi đẩy lên. Nó viết mô tả commit khá tốt, nhưng mô tả tốt cho một thay đổi sai vẫn là thay đổi sai.

Một thói quen nữa: khi nó sửa nhiều tệp trong một lần, hãy yêu cầu nó dừng lại và giải thích từng tệp trước khi sửa. Nghe thì chậm, nhưng ít phải gỡ hơn.

Bao giờ thì nên dùng, bao giờ thì không

Dùng khi: việc lặp đi lặp lại trên nhiều tệp, tìm một thứ trong mã nguồn lớn, viết kịch bản nhỏ, dọn dẹp mã cũ, đọc hiểu một dự án người khác để lại.

Không nên dùng khi: việc đụng tới dữ liệu thật mà bạn không sao lưu, hoặc khi bạn chưa hiểu đủ để đọc lại thay đổi nó đề xuất. Công cụ này không thay được hiểu biết về dự án của bạn. Nó tăng tốc cho người đã biết mình muốn gì, và tăng rủi ro cho người chưa biết.

Tự động hoá: từ chỗ gõ lệnh tới chỗ chạy nền

Sau khi quen phần cơ bản, mấy việc này đáng làm.

Viết CLAUDE.md tử tế. Mười dòng quy ước đúng giá trị hơn một trăm dòng mô tả dự án. Nó đọc tệp này mỗi phiên.

Viết skill cho việc lặp lại. Nếu bạn làm cùng một chuỗi thao tác ba lần một tuần, viết thành skill. Cách viết nằm trong tài liệu, và mẫu cũng đơn giản.

Đặt hook cho việc kiểm tra. Hook hữu ích nhất là hook chạy kiểm tra tự động sau khi sửa tệp. Bạn không phải nhớ chạy, và lỗi bị bắt ngay lúc vừa sinh ra.

Chạy nền cho việc dài. Việc mất hơn vài phút thì để chạy nền, làm việc khác, xong quay lại xem.

Dùng trong VS Code hoặc JetBrains nếu bạn sống trong trình soạn thảo. Phần lớn người dùng thấy thuận hơn Terminal thuần, vì nhìn thấy tệp thay đổi ngay trên màn hình.

Mua tài liệu ở đâu

Tài liệu mình viết về Claude Code là file PDF 48 trang, song ngữ Việt – Anh, gồm 17 chương và 3 phụ lục. Nội dung đi từ cài đặt, bốn ký tự mở đầu, danh mục lệnh gạch chéo đầy đủ, phím tắt, cho tới chế độ quyền, CLAUDE.md, tệp thiết lập, tự viết skill và lệnh riêng, trợ lý con và gói mở rộng, hook, MCP, làm việc với Git và GitHub, chọn mô hình và quản lý ngữ cảnh – chi phí, chạy trong VS Code và JetBrains, chạy nền, và một chương xử lý sự cố kèm bảng tra nhanh. Phụ lục có bảng lệnh một trang, danh sách phím tắt đầy đủ, thuật ngữ Anh – Việt và sơ đồ toàn bộ tệp – thư mục.

Viết song ngữ Việt – Anh cạnh nhau, nên bạn đọc hiểu bằng tiếng Việt mà vẫn khớp đúng tên lệnh tiếng Anh mà công cụ in ra trên màn hình. Bản 1.0, tháng 9/2026, viết theo Claude Code 2.1.268.

Giá 99.000 đồng. Xem trước 5 trang đầu ngay trên trang sản phẩm để biết văn phong và mức chi tiết trước khi quyết định: https://globalmarket.vin/vi/product/huong-dan-claude-code

Thanh toán bằng chuyển khoản trong nước cho tiện đối chiếu. Nhận hàng trong 24 giờ sau khi chuyển khoản — file PDF gửi thẳng cho bạn, không phải chờ đợi gì thêm.

Một lưu ý nhỏ để bạn khỏi kỳ vọng sai: tài liệu này viết theo phiên bản 2.1.268. Claude Code cập nhật nhanh, nên một vài chi tiết giao diện có thể lệch so với bản bạn cài. Phần cốt lõi — bốn ký tự mở đầu, cấu trúc tệp thiết lập, cách viết hook và quy tắc quyền — thì ổn định hơn nhiều. Nếu bạn đang dùng bản cũ hơn hoặc mới hơn đáng kể, cứ nhắn Zalo hỏi trước, mình trả lời thẳng là có dùng được hay không.