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ụ dòng lệnh của Anthropic, chạy ngay trong terminal. Nó đọc hiểu mã nguồn của bạn và làm theo yêu cầu viết bằng ngôn ngữ tự nhiên: giải thích code, làm việc lặt vặt, xử lý git. Cài chỉ mất một lệnh, 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 do Anthropic làm, chạy ngay trong terminal. Bạn mô tả việc cần làm bằng tiếng người, nó đọc hiểu mã nguồn trong thư mục dự án rồi giúp bạn thực hiện: giải thích đoạn code khó, làm các việc lặp đi lặp lại, xử lý các thao tác git. Ngoài terminal, README còn nói bạn có thể dùng nó trong IDE hoặc gắn thẻ @claude trên GitHub.
Repo này dành cho ai? Lập trình viên mới muốn có người giải thích code đang đọc. Dev lâu năm muốn giao bớt việc vặt. Cả người làm kinh doanh, văn phòng có chút quen terminal và muốn nhờ máy xử lý các tập tin trong một thư mục. Bạn không cần thuộc cú pháp lệnh phức tạp, vì cách ra lệnh chính là viết câu bình thường.
Điều đáng giá nhất là sự đơn giản khi bắt đầu. Cài bằng một lệnh, mở thư mục dự án, gõ claude. Repo hiện có khoảng 155 nghìn sao và khoảng 25 nghìn fork, và vẫn được cập nhật trong 3 tháng gần đây. Đây là một trong những repo được quan tâm nhiều nhất trong nhóm công cụ lập trình có AI.
anthropics/claude-code
Claude Code là 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ặt vặt 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ả, công cụ này xoay quanh ba việc chính. Mình giải thích từng việc theo góc nhìn người dùng.
A.Hiểu mã nguồn của bạn
Claude Code chạy trong thư mục dự án và hiểu codebase ở đó. Bạn không phải copy từng đoạn code dán vào khung chat. Bạn chỉ cần hỏi như hỏi một đồng nghiệp: dự án này làm gì, phần đăng nhập nằm ở đâu, tại sao hàm này trả về kết quả lạ. Lợi ích thực tế là tiết kiệm thời gian khi nhận một dự án lạ.
B.Giải thích code phức tạp
Gặp đoạn code người khác viết mà đọc không ra, bạn có thể nhờ nó giải thích bằng ngôn ngữ dễ hiểu. Với người mới học lập trình, đây giống như có một người hướng dẫn ngồi cạnh, hỏi bao nhiêu lần cũng được.
C.Làm các việc lặp đi lặp lại
README nhắc đến việc thực hiện các tác vụ thường ngày (routine tasks). Đó là những việc tốn công nhưng không cần sáng tạo, bạn mô tả bằng một câu và nhờ nó làm.
D.Xử lý quy trình git
Git là chỗ nhiều người mới hay vấp. Claude Code xử lý các thao tác git theo lệnh bằng ngôn ngữ tự nhiên, nên bạn không phải nhớ từng cú pháp.
E.Dùng ở nhiều nơi và có hệ plugin
Ngoài terminal, README ghi bạn dùng được trong IDE hoặc gắn thẻ @claude trên GitHub. 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, còn thư mục plugins trong repo này giải thích thêm về chúng.
II.Cần chuẩn bị gì
README của repo không liệt kê yêu cầu hệ thống chi tiết. Những gì README nói rõ là:
- Có cách cài cho macOS, Linux và Windows. macOS/Linux cài bằng lệnh
curlhoặc Homebrew. Windows cài bằng PowerShell hoặc WinGet. - Bạn cần một cửa sổ terminal (hoặc PowerShell trên Windows) và một thư mục dự án để chạy.
- Cách cài bằng npm đã bị đánh dấu là lỗi thời (deprecated), nên bạn không cần cài Node.js chỉ để dùng công cụ này.
README chưa nói về loại tài khoản, cách đăng nhập hay gói cước. Những thông tin đó nằm ở trang tài liệu chính thức (code.claude.com/docs/en/overview) và trang hướng dẫn cài đặt (setup) mà README dẫn tới. README cũng không nêu yêu cầu phần cứng, nên mình không đoán.
Mình chưa có thông tin trong tư liệu về chi phí hay tài khoản cần dùng. Trước khi dùng cho công việc thật, bạn hãy đọc trang tài liệu chính thức để biết cách đăng nhập và các điều khoản liên quan.
III.Cài đặt từng bước
- Mở terminalDùng Terminal trên macOS/Linux hoặc PowerShell trên Windows
- Chạy lệnh càiChọn đúng một lệnh theo hệ điều hành của bạn
- Vào thư mục dự ánDùng cd để đi tới thư mục bạn muốn làm việc
- Gõ claudeKhởi động công cụ trong thư mục đó
A.Bước 1: Mở terminal
Trên macOS hoặc Linux, mở ứng dụng Terminal. Trên Windows, mở PowerShell (gõ PowerShell vào ô tìm kiếm của Start). Chỗ người mới hay vấp là mở nhầm Command Prompt cũ, trong khi lệnh Windows bên dưới là lệnh PowerShell.
B.Bước 2: Chạy lệnh cài
README đưa ra nhiều cách. Bạn chỉ cần chọn một cách hợp với máy mình.
macOS hoặc Linux (README ghi là cách khuyến nghị):
curl -fsSL https://claude.ai/install.sh | bashLệnh này tải một đoạn script cài đặt từ địa chỉ chính thức rồi chạy luôn. Nếu bạn thích dùng Homebrew thì có lệnh sau:
brew install --cask claude-codeWindows (README ghi là cách khuyến nghị), chạy trong PowerShell:
irm https://claude.ai/install.ps1 | iexHoặc dùng WinGet trên Windows:
winget install Anthropic.ClaudeCodeCòn cách cài qua npm thì README ghi rõ là đã lỗi thời, nên mình không khuyên dùng. Mình ghi lại chỉ để bạn nhận ra nếu thấy nó trong tài liệu cũ:
npm install -g @anthropic-ai/claude-codeNếu cài gặp trục trặc, README chỉ bạn sang trang setup chính thức, nơi có thêm tuỳ chọn cài, cách gỡ và cách xử lý sự cố.
C.Bước 3: Vào thư mục dự án
Dùng lệnh cd để đi tới thư mục bạn muốn làm việc. Ví dụ, nếu dự án của bạn nằm ở thư mục có tên ten-du-an:
cd ten-du-anBạn thay ten-du-an bằng tên thư mục thật. Lưu ý: Claude Code làm việc dựa trên thư mục bạn đang đứng, nên đứng sai thư mục là nó sẽ nhìn nhầm dự án.
D.Bước 4: Chạy claude
README chỉ ghi: đi tới thư mục dự án rồi chạy claude.
claudeSau đó làm theo hướng dẫn trên màn hình. README không mô tả các bước đăng nhập, nên nếu được hỏi gì mà bạn chưa rõ, hãy xem trang tài liệu chính thức.
IV.Kiểm tra đã chạy được chưa
README không nói cụ thể màn hình thành công trông thế nào. Cách kiểm tra đơn giản và hợp lý như sau:
- Sau khi cài xong, đóng terminal cũ rồi mở cái mới. Việc này giúp máy nhận ra lệnh mới cài.
- Vào thư mục dự án và gõ
claude. - Nếu công cụ khởi động và cho bạn nhập yêu cầu bằng ngôn ngữ tự nhiên, nghĩa là bạn đã cài được.
- Thử một câu hỏi nhẹ, chỉ đọc không sửa gì, ví dụ: Dự án này làm gì? Hãy tóm tắt cấu trúc thư mục.
Nếu máy báo không tìm thấy lệnh claude, xem phần lỗi thường gặp bên dưới.
V.Dùng vào việc thật
README không đưa ví dụ sử dụng cụ thể. Các tình huống dưới đây mình dựng dựa trên ba khả năng mà tác giả mô tả: hiểu codebase, giải thích code, xử lý git. Câu lệnh mẫu là câu bạn gõ bằng tiếng người trong giao diện của công cụ, không phải lệnh cố định.
A.Nhận một dự án lạ và cần hiểu nhanh
Bạn là dev mới vào công ty, được giao một dự án có hàng trăm tập tin. Thay vì mở từng file, bạn vào thư mục dự án, gõ claude, rồi hỏi:
Hãy giải thích dự án này làm gì, các thư mục chính dùng để làm gì, và nên đọc file nào trước.Kết quả bạn nhận được là một bản tóm tắt cấu trúc dự án bằng tiếng người. Bạn có điểm bắt đầu rõ ràng thay vì đọc mò.
Cách nhanh nhất để hiểu code người khác là hỏi thẳng, thay vì đọc từng dòng.
Ông T
B.Đọc hiểu một đoạn code khó
Bạn là người mới học lập trình, đang xem một hàm dài mà không hiểu nó chạy sao. Bạn gõ:
Giải thích giúp mình hàm xử lý đơn hàng trong dự án này, từng bước một, dùng ngôn ngữ đơn giản.Bạn nhận về lời giải thích từng bước. Nếu chưa hiểu, cứ hỏi tiếp: ví dụ đoạn này để làm gì, vì sao viết như vậy. Đây là cách học nhanh hơn nhiều so với đọc tài liệu khô.
C.Nhờ xử lý git thay mình
Bạn vừa sửa vài file và không nhớ lệnh git để gom thay đổi và ghi lại. Bạn nhờ:
Xem mình đã thay đổi những gì, rồi giúp mình tạo commit với nội dung mô tả rõ ràng.Kết quả là công cụ xem các thay đổi, đề xuất nội dung commit và thực hiện theo yêu cầu. Với người mới, việc này giảm nỗi sợ làm hỏng lịch sử git. Dù vậy, bạn nên đọc kỹ những gì nó định làm trước khi đồng ý.
D.Giao việc lặp đi lặp lại
Bạn là chủ một shop nhỏ có website do mình tự quản, trong thư mục có nhiều file nội dung. Bạn có thể nhờ những việc lặp như đổi cùng một thông tin ở nhiều file, hoặc rà lại chỗ nào còn ghi sai. Ví dụ:
Tìm tất cả chỗ trong dự án có ghi số hotline cũ và liệt kê ra, chưa sửa gì vội.Bạn xem danh sách trước, thấy ổn rồi mới yêu cầu sửa. Cách làm hai bước này an toàn hơn nhiều so với giao sửa luôn.
VI.Lỗi hay gặp và cách xử lý
README không có mục xử lý lỗi, mà chỉ dẫn sang trang setup chính thức. Dưới đây là các tình huống rất dễ xảy ra với loại công cụ dòng lệnh này.
A.Gõ claude mà máy báo không tìm thấy lệnh
Thường là do terminal đang mở chưa nhận ra chương trình vừa cài. Hãy đóng hẳn cửa sổ terminal, mở lại rồi thử lần nữa. Nếu vẫn lỗi, mở trang setup chính thức (code.claude.com/docs/en/setup) để xem phần troubleshooting.
B.Lệnh cài chạy không được trên Windows
Lệnh irm ... | iex chỉ chạy trong PowerShell, không chạy trong Command Prompt cũ. Hãy kiểm tra bạn đang mở đúng PowerShell. Nếu vẫn không được, thử cách WinGet ở trên.
C.Đang đứng sai thư mục
Nếu câu trả lời nói về một dự án không phải của bạn, hoặc nói không thấy file nào, có thể bạn gõ claude ở thư mục khác. Thoát ra, dùng cd vào đúng thư mục dự án rồi chạy lại.
D.Cài bằng npm rồi gặp trục trặc
README ghi cách npm đã lỗi thời. Nếu bạn đang dùng cách này và gặp lỗi, hãy chuyển sang một trong các cách khuyến nghị ở trên thay vì cố sửa.
E.Để công cụ sửa file mà không xem trước
Đây không hẳn là lỗi của công cụ, nhưng là lỗi rất hay xảy ra. Hãy tập thói quen yêu cầu liệt kê hoặc đề xuất trước, rồi mới cho phép thực hiện. Với dự án quan trọng, bạn nên sao lưu hoặc có git lưu lại trạng thái trước khi nhờ sửa nhiều file.
VII.Có nên dùng không
Điểm mạnh. Cài nhanh bằng một lệnh. Dùng ngôn ngữ tự nhiên nên người mới dễ bắt đầu. Có mặt ở terminal, IDE và GitHub. Có tài liệu chính thức, Discord cộng đồng và lệnh /bug để báo lỗi ngay trong công cụ. Repo vẫn được cập nhật đều.
Giới hạn. Bạn phải làm quen với terminal, và đây là rào cản thật với người chưa từng dùng. README không nêu rõ yêu cầu tài khoản, chi phí hay giấy phép, nên bạn cần tự đọc tài liệu chính thức trước khi dùng cho công việc nghiêm túc. Giấy phép của repo mình chưa xác định được từ tư liệu.
Về dữ liệu. README cho biết khi dùng, Anthropic thu thập phản hồi, gồm dữ liệu sử dụng (như việc chấp nhận hay từ chối code), dữ liệu hội thoại liên quan và phản hồi gửi qua lệnh /bug. Họ nêu các biện pháp bảo vệ như giới hạn thời gian lưu trữ thông tin nhạy cảm, hạn chế truy cập vào dữ liệu phiên và chính sách không dùng phản hồi để huấn luyện mô hình. Nếu bạn làm việc với dữ liệu nhạy cảm của công ty, hãy đọc kỹ chính sách sử dụng dữ liệu và điều khoản trước khi dùng.
Khi nên chọn cách khác. Nếu bạn không thích terminal và chỉ cần hỏi đáp thông thường, một ứng dụng chat có giao diện đồ hoạ sẽ dễ chịu hơn. Nếu công ty cấm gửi mã nguồn ra ngoài, bạn nên hỏi bộ phận IT trước. Còn nếu bạn muốn thử cho biết, cứ cài ở một thư mục dự án nhỏ, chưa quan trọng, và bắt đầu bằng những câu hỏi chỉ đọc, không sửa.
Câu hỏi thường gặp
Claude Code có miễn phí không?
Tư liệu README không nói gì về giá hay gói cước, nên mình chưa có thông tin chắc chắn. Bạn nên xem trang tài liệu chính thức (code.claude.com/docs/en/overview) để biết điều kiện sử dụng hiện hành. Chỉ riêng việc cài đặt thì README không đề cập khoản phí nào.
Claude Code chạy được trên Windows không?
Được. README có hai cách cho Windows: chạy lệnh irm https://claude.ai/install.ps1 | iex trong PowerShell (cách được ghi là khuyến nghị), hoặc dùng WinGet với lệnh winget install Anthropic.ClaudeCode. macOS và Linux cũng được hỗ trợ.
Cài Claude Code có cần Node.js không?
Với các cách cài khuyến nghị trong README (curl, Homebrew, PowerShell, WinGet) thì README không yêu cầu Node.js. Cách cài qua npm vẫn còn nhưng đã bị ghi là lỗi thời (deprecated). Nếu bạn mới bắt đầu, nên dùng cách khuyến nghị.
Claude Code có cần card đồ hoạ (GPU) không?
README không nêu yêu cầu phần cứng nào, kể cả GPU. Tư liệu cũng không giải thích công cụ xử lý ở máy bạn hay ở nơi khác, nên mình chưa có thông tin để khẳng định. Bạn xem thêm ở trang setup chính thức.
Dữ liệu và mã nguồn của mình có an toàn không?
README cho biết Anthropic thu thập phản hồi gồm dữ liệu sử dụng, dữ liệu hội thoại liên quan và phản hồi qua lệnh /bug. Họ nêu các biện pháp như giới hạn thời gian lưu trữ thông tin nhạy cảm, hạn chế truy cập dữ liệu phiên và chính sách không dùng phản hồi để huấn luyện mô hình. Với dữ liệu nhạy cảm, bạn nên đọc kỹ chính sách sử dụng dữ liệu và điều khoản trước.
Claude Code dùng ở đâu ngoài terminal?
Theo README, bạn có thể dùng trong terminal, trong IDE, hoặc gắn thẻ @claude trên GitHub. README không mô tả chi tiết cách cài cho IDE hay GitHub, nên bạn cần xem tài liệu chính thức.
Báo lỗi hoặc hỏi cộng đồng ở đâu?
Bạn có thể gõ lệnh /bug ngay trong Claude Code để báo lỗi, hoặc tạo issue trên GitHub của repo. README cũng mời tham gia Discord Claude Developers để hỏi đáp và chia sẻ với những người dùng khác.


