Claude Code: trợ lý lập trình ngay trong terminal — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về anthropics/claude-code — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: Claude Code: trợ lý lập trình chạy ngay trong terminal — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
Claude Code là công cụ lập trình dạng agent của Anthropic, chạy ngay trong terminal. Nó đọc hiểu dự án của bạn, giải thích code, làm việc lặp lại và xử lý git qua câu lệnh tự nhiên. Cài bằng một dòng lệnh trên Windows, macOS hoặc Linux, rồi vào thư mục dự án gõ claude là dùng được.
Claude Code là một công cụ lập trình dạng "agent" của Anthropic, chạy ngay trong terminal (cửa sổ dòng lệnh) của bạn. Nó đọc hiểu mã nguồn của dự án, rồi giúp bạn làm việc nhanh hơn: thực hiện các việc lặp đi lặp lại, giải thích đoạn code khó hiểu và xử lý các thao tác git, tất cả bằng câu lệnh viết như nói chuyện bình thường. Ngoài terminal, README còn cho biết bạn có thể dùng nó trong IDE hoặc gọi @claude trên GitHub.
Ai nên đọc bài này? Lập trình viên mới muốn có người "ngồi cạnh" giải thích code. Dev đã có kinh nghiệm muốn giao bớt việc vặt. Cả người làm kinh doanh, văn phòng có một thư mục dự án nhỏ (website, script, tài liệu) và muốn nhờ máy đọc hiểu hộ. Bạn không cần thuộc cú pháp lệnh phức tạp, chỉ cần mô tả việc cần làm bằng lời.
Điểm đáng giá nhất: cài chỉ một dòng lệnh, và cách dùng cũng gọn: vào thư mục dự án, gõ claude. Repo hiện có khoảng 155.507 sao và 24.966 fork, và vẫn được cập nhật trong 3 tháng gần đây. Bài này mình hướng dẫn từ lúc cài đến lúc dùng vào việc thật, bám theo những gì README ghi.
anthropics/claude-code
Công cụ lập trình dạng agent chạy trong terminal: hiểu mã nguồn, giải thích code, làm việc lặp lại và xử lý git bằng câu lệnh tiếng người.
I.Claude Code làm được gì
Theo mô tả của tác giả và README, công cụ này tập trung vào ba nhóm việc chính.
A.Hiểu mã nguồn của bạn
Claude Code "understands your codebase", tức là nó đọc dự án bạn đang đứng trong đó. Lợi ích thực tế: bạn không phải copy từng đoạn code dán vào khung chat. Bạn vào đúng thư mục, hỏi "phần đăng nhập nằm ở đâu?", và nó tự tìm trong dự án để trả lời.
B.Làm các việc lặp lại và giải thích code phức tạp
README nói nó giúp bạn "executing routine tasks" (thực hiện các tác vụ quen thuộc) và "explaining complex code" (giải thích code phức tạp). Với người mới, phần giải thích là thứ đáng giá nhất: bạn nhận một dự án người khác viết, và có thể hỏi từng phần nó làm gì bằng tiếng thường.
C.Xử lý quy trình git bằng lời
Git hay làm người mới ngợp: commit, nhánh, gộp code. Claude Code nhận các yêu cầu về git qua câu lệnh tự nhiên, nên bạn mô tả điều muốn làm thay vì nhớ từng cờ lệnh.
D.Dùng ở nhiều nơi
README ghi bạn dùng được trong terminal, trong IDE, hoặc tag @claude trên GitHub. Repo cũng có thư mục plugin; các plugin chính thức của Anthropic được phát triển ở một repo riêng tên claude-plugins-official, và README trỏ sang đó để xem thêm.
E.Báo lỗi ngay trong công cụ
Bạn gõ lệnh /bug bên trong Claude Code để báo lỗi trực tiếp cho nhóm phát triển. Ngoài ra có thể mở issue trên GitHub, hoặc vào Discord "Claude Developers" để hỏi cộng đồng.
II.Cần chuẩn bị gì
README rất ngắn gọn ở phần này, nên mình chỉ nêu những gì có trong tư liệu:
- Một terminal. Trên macOS/Linux là Terminal; trên Windows là PowerShell.
- Một thư mục dự án để chạy lệnh
claudetrong đó. - Tùy cách cài: Homebrew (macOS/Linux) hoặc WinGet (Windows) nếu bạn chọn các cách này.
README không nói về phiên bản Node, phần cứng hay GPU, cũng không nêu rõ cần loại tài khoản hay API key nào. Với cách cài khuyến nghị, README không yêu cầu cài Node trước. Chi tiết về điều kiện sử dụng và đăng nhập, bạn xem trang tài liệu chính thức (mục setup) mà README trỏ tới.
Claude Code đọc dự án của bạn và README nói rõ có thu thập dữ liệu sử dụng, hội thoại liên quan và phản hồi qua lệnh /bug. Trước khi chạy trong thư mục chứa thông tin nhạy cảm (mật khẩu, dữ liệu khách hàng), hãy đọc chính sách dữ liệu của Anthropic mà README dẫn tới. Chưa có thông tin về chi phí trong README, nên hãy kiểm tra ở trang tài liệu chính thức.
III.Cài đặt từng bước
- Mở terminalTerminal trên macOS/Linux, PowerShell trên Windows
- Chạy lệnh càiChọn đúng lệnh theo hệ điều hành của bạn
- Vào thư mục dự ánDùng lệnh cd tới thư mục bạn muốn làm việc
- Gõ claudeKhởi động Claude Code trong thư mục đó
A.Mở terminal
Trên Windows, tìm "PowerShell" trong menu Start rồi mở. Trên macOS, mở ứng dụng Terminal. Người mới hay vấp ở chỗ dán lệnh của hệ điều hành này vào nhầm hệ điều hành kia, nên hãy chọn đúng mục bên dưới.
B.Chạy lệnh cài
README đề xuất các cách sau. Chỉ cần chọn MỘT cách.
macOS/Linux (cách được khuyến nghị):
curl -fsSL https://claude.ai/install.sh | bashLệnh này tải script cài đặt và chạy luôn. Nó không có bước hỏi nhiều nên bạn chỉ cần dán và nhấn Enter.
Hoặc dùng Homebrew (macOS/Linux):
brew install --cask claude-codeWindows (cách được khuyến nghị), chạy trong PowerShell:
irm https://claude.ai/install.ps1 | iexHoặc dùng WinGet (Windows):
winget install Anthropic.ClaudeCodeCòn một cách cũ là npm, nhưng README ghi rõ là đã bị "deprecated" (không còn khuyến khích). Mình chỉ chép lại để bạn nhận ra nếu gặp trong tài liệu cũ, còn bạn nên dùng các cách ở trên:
npm install -g @anthropic-ai/claude-codeNếu cài không suôn sẻ, hoặc bạn muốn gỡ cài đặt, README chỉ sang trang tài liệu setup chính thức để xem thêm các tuỳ chọn cài, cách gỡ và xử lý sự cố.
C.Vào thư mục dự án
README viết: vào thư mục dự án rồi chạy claude. Bạn dùng lệnh cd để di chuyển. Ví dụ (đổi tên thư mục cho đúng với máy bạn):
cd ten-thu-muc-du-anChỗ hay vấp: nếu đường dẫn có dấu cách, hãy đặt trong dấu ngoặc kép. Và nên đứng đúng thư mục dự án, vì Claude Code làm việc dựa trên thư mục bạn đang đứng.
D.Gõ claude
claudeĐây là bước khởi động. README không mô tả chi tiết màn hình lần chạy đầu. Nếu có bước đăng nhập hay cấp quyền xuất hiện, hãy làm theo hướng dẫn trên màn hình và đối chiếu với trang tài liệu setup chính thức.
Nếu bạn muốn có sẵn code để thử mà chưa có dự án nào, có thể lấy repo này về (README không yêu cầu điều đó, đây chỉ là cách phổ thông):
git clone https://github.com/anthropics/claude-code.git
cd claude-codeIV.Kiểm tra đã chạy được chưa
README không ghi lệnh kiểm tra riêng. Cách đơn giản nhất để biết cài thành công: mở terminal mới, vào thư mục dự án, gõ claude. Nếu công cụ khởi động và cho bạn một khung để gõ yêu cầu, tức là đã cài được.
Sau đó thử một câu hỏi vô hại, chỉ đọc chứ không sửa gì, ví dụ:
Dự án này làm gì? Giải thích ngắn gọn cấu trúc thư mục.Nếu nó trả lời dựa trên nội dung thư mục bạn đang đứng, nghĩa là nó đã "đọc" được dự án. Nếu terminal báo không tìm thấy lệnh claude, xem phần lỗi hay gặp bên dưới.
V.Dùng vào việc thật
README không đưa ví dụ prompt cụ thể. Các tình huống dưới đây là cách áp dụng đúng theo ba khả năng nó nêu: hiểu code, giải thích code, xử lý git. Câu lệnh mẫu mình tự soạn, bạn chỉnh theo dự án của mình.
A.Chủ shop nhận lại website do người khác làm
Bối cảnh: bạn thuê người làm website bán hàng, giờ họ đã nghỉ và để lại một thư mục code. Bạn không biết trong đó có gì.
Cách làm: vào thư mục, gõ claude, rồi hỏi:
Giải thích cho người không rành kỹ thuật: dự án này gồm những phần nào, phần nào lo việc đặt hàng?Kết quả: bạn nhận một bản giải thích bằng tiếng thường về cấu trúc dự án. Từ đó biết cần nhờ thợ sửa phần nào, thay vì nhìn một đống file lạ.
Bạn không cần thuộc lệnh, chỉ cần nói rõ mình muốn gì.
Ông T
B.Lập trình viên mới đọc code của team
Bối cảnh: bạn vào công ty, được giao sửa một chức năng trong dự án lớn và không biết bắt đầu từ đâu.
Cách làm: hỏi nó về đúng phần đó.
Đoạn xử lý thanh toán nằm ở file nào? Giải thích luồng chạy từng bước.Kết quả: bạn có một bản đồ ban đầu để tự đọc tiếp. Hãy luôn mở file ra đối chiếu, vì công cụ có thể giải thích chưa đúng hoàn toàn.
C.Nhờ xử lý git khi bạn ngại gõ lệnh
Bối cảnh: bạn vừa sửa vài file và không nhớ lệnh để lưu lại thay đổi cho gọn.
Cách làm: mô tả việc bằng lời:
Xem mình đã thay đổi những file nào, rồi giúp mình commit với một lời nhắn rõ ràng.Kết quả: nó thực hiện các thao tác git thay bạn. Nên đọc kỹ những gì nó định làm trước khi đồng ý, đặc biệt với thao tác đẩy code lên kho chung.
D.Dùng ngay trên GitHub của team
Bối cảnh: team bạn dùng GitHub để quản lý công việc và muốn hỏi nhanh ngay chỗ đang thảo luận.
Cách làm: README nói bạn có thể tag @claude trên GitHub. Chi tiết cách bật tính năng này README chưa ghi, bạn xem trang tài liệu chính thức.
VI.Lỗi hay gặp và cách xử lý
A.Gõ claude báo không tìm thấy lệnh
Thường do terminal đang mở chưa nhận lệnh mới cài. Hãy đóng terminal, mở cửa sổ mới rồi thử lại. Nếu vẫn không được, kiểm tra bạn đã chạy đúng lệnh cho hệ điều hành của mình chưa (bash cho macOS/Linux, PowerShell cho Windows), rồi xem mục sự cố trong tài liệu setup.
B.Dán nhầm lệnh giữa các hệ điều hành
Lệnh curl ... | bash dành cho macOS/Linux, còn irm ... | iex dành cho PowerShell trên Windows. Dán nhầm sẽ báo lỗi cú pháp. Chọn lại đúng lệnh ở phần cài đặt.
C.Dùng cách cài npm cũ
README ghi cài qua npm đã bị deprecated. Nếu bạn làm theo một hướng dẫn cũ và gặp trục trặc, hãy chuyển sang một trong các cách được khuyến nghị (script cài, Homebrew hoặc WinGet).
D.Chạy sai thư mục
Nếu bạn gõ claude ở thư mục không phải dự án, câu trả lời sẽ không bám vào code của bạn. Thoát ra, cd đúng thư mục rồi chạy lại.
E.Lo lắng về dữ liệu
Đừng chạy trong thư mục chứa mật khẩu hoặc thông tin khách hàng nếu bạn chưa đọc chính sách dữ liệu. Với file nhạy cảm, hãy chuyển sang thư mục khác hoặc tách riêng trước khi dùng.
VII.Có nên dùng không
Điểm mạnh: cài đơn giản, một dòng lệnh cho mỗi hệ điều hành; dùng bằng lời thường nên người mới dễ tiếp cận; làm được nhiều việc quanh code (hiểu, giải thích, git) và dùng được ở terminal, IDE, GitHub. Repo được cộng đồng quan tâm nhiều và còn được cập nhật.
Giới hạn: README khá ngắn, không nêu rõ yêu cầu tài khoản, chi phí hay phiên bản hệ thống, nên bạn phải đọc thêm tài liệu chính thức. Repo cũng không ghi rõ giấy phép. Công cụ có thu thập dữ liệu sử dụng và phản hồi theo README, nên cân nhắc kỹ với dự án nhạy cảm. Và như mọi công cụ AI, kết quả cần được bạn kiểm tra lại, nhất là trước khi đẩy code lên chỗ dùng thật.
Khi nào nên chọn cách khác? Nếu bạn không dùng terminal và chỉ cần hỏi đáp chung chung về code, một khung chat thông thường có thể đủ. Còn nếu bạn có dự án thật và muốn một trợ lý đứng ngay trong thư mục đó, Claude Code là lựa chọn đáng thử.
Câu hỏi thường gặp
Claude Code có miễn phí không?
README không nói về chi phí hay gói sử dụng. Bản thân việc cài đặt chỉ là chạy một dòng lệnh. Về điều kiện và chi phí khi dùng, bạn xem trang tài liệu chính thức mà README dẫn tới.
Claude Code chạy được trên Windows không?
Có. README có hai cách cài cho Windows: chạy lệnh irm https://claude.ai/install.ps1 | iex trong PowerShell (cách được khuyến nghị) hoặc dùng winget install Anthropic.ClaudeCode. macOS và Linux cũng được hỗ trợ.
Có cần GPU hay máy cấu hình mạnh không?
README không nêu yêu cầu phần cứng nào và không nhắc đến GPU. Chưa có thông tin chi tiết hơn trong tư liệu.
Cài bằng npm có được không?
README ghi cài qua npm (npm install -g @anthropic-ai/claude-code) đã bị deprecated, tức không còn được khuyến khích. Bạn nên dùng script cài, Homebrew hoặc WinGet.
Dữ liệu và code của mình có an toàn không?
README cho biết có thu thập dữ liệu sử dụng (như chấp nhận hoặc từ chối code), dữ liệu hội thoại liên quan và phản hồi gửi qua /bug. Anthropic nói có áp dụng thời gian lưu giữ hạn chế, hạn chế quyền truy cập và chính sách không dùng phản hồi để huấn luyện mô hình. Chi tiết đầy đủ nằm ở chính sách dữ liệu và điều khoản mà README dẫn tới.
Claude Code làm được những việc gì?
Theo README, nó hiểu mã nguồn của bạn, thực hiện các việc lặp lại, giải thích code phức tạp và xử lý quy trình git bằng câu lệnh tự nhiên. Bạn dùng được trong terminal, IDE hoặc tag @claude trên GitHub.
Báo lỗi hoặc hỏi cộng đồng ở đâu?
Trong Claude Code, bạn gõ lệnh /bug để báo lỗi trực tiếp, hoặc mở issue trên GitHub của repo. README cũng mời tham gia Discord Claude Developers để hỏi đáp và chia sẻ.


