claude-code: trợ lý lập trình trong terminal, nói chuyện bằng tiếng người — 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 (anthropics/claude-code) là công cụ dòng lệnh của Anthropic. Nó chạy trong terminal, đọc hiểu dự án của bạn, giải thích code, làm các việc lặp lại và xử lý git qua câu lệnh bằng ngôn ngữ thường. Cài đặt chỉ cần một lệnh, sau đó vào thư mục dự án và gõ claude.
Claude Code là một công cụ lập trình dạng tác tử (agentic) do Anthropic làm, chạy ngay trong terminal. Bạn mô tả việc cần làm bằng ngôn ngữ thường, nó đọc hiểu mã nguồn trong thư mục của bạn rồi giúp bạn làm: 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. README cũng cho biết bạn có thể dùng nó trong IDE, hoặc gắn thẻ @claude trên GitHub.
Repo này phù hợp với lập trình viên mới muốn có người chỉ đường trong một dự án lạ, và với người làm kinh doanh, văn phòng có chút quen thuộc với dự án phần mềm hay file kỹ thuật. Bạn không cần nhớ cú pháp lệnh phức tạp. Bạn chỉ cần nói điều mình muốn.
Điểm đáng giá nhất là sự đơn giản: một lệnh để cài, một lệnh claude để bắt đầu. Repo hiện có khoảng 155.507 sao và 24.966 fork, và vẫn được cập nhật trong vài tháng gần đây. Đây là một trong những repo được quan tâm nhiều nhất ở mảng công cụ lập trình có AI.
anthropics/claude-code
Claude Code là công cụ lập trình dạng tác tử chạy trong terminal, hiểu mã nguồn của bạn và làm việc theo câu lệnh tự nhiên.
I.Claude Code làm được gì
Dựa trên mô tả của tác giả và README, các việc chính gồm:
- Hiểu codebase của bạn. Bạn chạy nó trong thư mục dự án, nó nắm được cấu trúc và nội dung để trả lời. Lợi ích thực tế: bạn không phải copy từng đoạn code dán vào khung chat.
- Giải thích code phức tạp. Gặp một file khó đọc, bạn hỏi bằng tiếng thường để biết nó làm gì. Rất hợp khi nhận lại dự án của người khác.
- Làm các việc lặp lại. Những tác vụ thường ngày trong lập trình có thể giao qua câu lệnh tự nhiên, đỡ phải làm tay từng bước.
- Xử lý quy trình git. Tác giả nêu rõ việc này trong phần mô tả. Bạn có thể nhờ nó làm các thao tác git thay vì nhớ lệnh.
- Dùng ở nhiều nơi. README nói bạn dùng được trong terminal, trong IDE, hoặc tag @claude trên GitHub.
- Plugin. README cho biết các plugin của Anthropic được phát triển ở một repo riêng tên claude-plugins-official. Repo này cũng có thư mục plugins và file khai báo trong .claude-plugin. Nếu cần mở rộng, bạn xem thêm ở đó.
- Báo lỗi ngay trong công cụ. Lệnh
/bugcho phép gửi lỗi trực tiếp mà không cần rời terminal.
II.Cần chuẩn bị gì
README ghi rất gọn, nên mình chỉ nêu những gì có trong đó:
- Hệ điều hành: macOS, Linux và Windows đều có lệnh cài riêng (xem phần dưới).
- Một terminal: bạn cần mở terminal (hoặc PowerShell trên Windows) để gõ lệnh.
- Một thư mục dự án: README bảo bạn đi tới thư mục dự án rồi chạy
claude. - Node.js: không bắt buộc cho cách cài khuyến nghị. README chỉ nhắc npm khi nói về cách cài cũ, và ghi rõ cách đó đã bị đánh dấu lỗi thời (deprecated).
Về tài khoản, khoá API, phần cứng hay chi phí sử dụng: README của repo chưa ghi. Bạn xem trang hướng dẫn cài đặt chính thức tại https://code.claude.com/docs/en/setup và tổng quan tại https://code.claude.com/docs/en/overview.
Các lệnh cài kiểu curl ... | bash hoặc irm ... | iex tải một đoạn script từ internet rồi chạy ngay. Hãy chắc bạn gõ đúng địa chỉ như trong README, đừng chép từ nguồn lạ. Ngoài ra, khi chạy Claude Code trong một thư mục, hãy chọn thư mục dự án của bạn, không phải thư mục chứa giấy tờ nhạy cảm.
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
- Chạy claudeGõ claude để bắt đầu trò chuyện với công cụ
A.Mở terminal đúng chỗ
Trên Windows, bấm Start, gõ PowerShell rồi mở. Trên macOS, mở ứng dụng Terminal. Người mới hay vấp ở chỗ dùng lệnh của hệ này cho hệ kia, nên hãy xem kỹ lệnh nào dành cho hệ điều hành của bạn.
B.Chạy lệnh cài
README đề xuất nhiều cách. Bạn chỉ cần chọn một.
macOS hoặc Linux (cách được khuyến nghị):
curl -fsSL https://claude.ai/install.sh | bashLệnh này tải script cài đặt rồi chạy luôn. Gõ xong nhấn Enter và chờ nó chạy hết.
Nếu bạn dùng Homebrew trên macOS hoặc Linux:
brew install --cask claude-codeWindows (cách được khuyến nghị), mở PowerShell rồi gõ:
irm https://claude.ai/install.ps1 | iexNếu bạn quen dùng WinGet trên Windows:
winget install Anthropic.ClaudeCodeCòn cách cài qua npm, README ghi là đã lỗi thời (deprecated) và khuyên dùng các cách ở trên. Mình chép lại để bạn nhận ra nếu thấy hướng dẫn cũ nào nhắc tới:
npm install -g @anthropic-ai/claude-codeTuỳ chọn cài khác, cách gỡ cài và xử lý sự cố nằm ở trang https://code.claude.com/docs/en/setup.
C.Vào thư mục dự án
Bạn cần đứng trong thư mục dự án trước khi chạy. Ví dụ bạn có sẵn một dự án ở thư mục tên du-an-cua-toi:
cd du-an-cua-toiNếu chưa có dự án nào, bạn có thể thử với một repo mẫu bằng cách clone về trước (thay đường dẫn bằng repo của bạn):
git clone https://github.com/anthropics/claude-code.git
cd claude-codeD.Chạy claude
Trong thư mục dự án, gõ:
claudeĐây là bước README ghi: đi tới thư mục dự án và chạy claude. Từ lúc này bạn trò chuyện với công cụ bằng câu thường. README không mô tả các bước đăng nhập hay màn hình đầu tiên, nên nếu công cụ hỏi thêm điều gì, bạn làm theo hướng dẫn trên màn hình hoặc xem tài liệu chính thức.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra đơn giản nhất theo README: vào thư mục dự án, gõ claude, và thấy công cụ mở ra giao diện trò chuyện ngay trong terminal. Nếu được vậy là cài thành công.
Sau đó thử một câu hỏi nhỏ, ví dụ: "Dự án này dùng để làm gì?". Nếu nó đọc thư mục và trả lời được, nghĩa là nó đã nhìn thấy mã nguồn của bạn. README không nêu một dòng kết quả mẫu cụ thể nào, nên mình không hứa trước hình thức câu trả lời.
Nếu terminal 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
Dưới đây là các tình huống bám theo những gì repo mô tả: hiểu codebase, giải thích code, làm việc lặp lại, xử lý git. Các câu lệnh mẫu là gợi ý để bạn gõ vào sau khi chạy claude.
A.Nhận lại dự án của người khác
Bạn là lập trình viên mới vào công ty, được giao một dự án chưa từng thấy. Thay vì mở từng file đoán mò, bạn vào thư mục dự án, chạy claude rồi hỏi:
Hãy giải thích cấu trúc dự án này. Thư mục nào làm gì? Tôi nên đọc file nào trước?Bạn nhận được bản tóm tắt để biết bắt đầu từ đâu. Sau đó hỏi tiếp từng phần: "File này làm gì?", "Hàm này được gọi từ đâu?". Đây là đúng thế mạnh "hiểu codebase" mà tác giả nêu.
Cái khó nhất khi vào một dự án lạ không phải là viết code, mà là biết nên đọc gì trước.
Ông T
B.Hiểu một đoạn code khó
Bạn là nhân viên văn phòng phụ trách một file xử lý số liệu do đồng nghiệp cũ để lại, và không dám sửa vì không hiểu. Bạn nhờ:
Giải thích file này từng bước bằng tiếng Việt dễ hiểu, chỉ ra chỗ nào dễ gây lỗi.Kết quả là lời giải thích theo ngôn ngữ thường, đủ để bạn tự tin hơn trước khi nhờ người khác sửa. Hãy luôn kiểm lại với người hiểu nghiệp vụ trước khi dùng vào số liệu quan trọng.
C.Làm việc git bằng câu thường
Bạn đã sửa vài file và muốn lưu lại nhưng không nhớ lệnh git. Bạn nói:
Xem tôi đã thay đổi những gì, rồi giúp tôi commit với một lời nhắn ngắn gọn, đúng nội dung.Công cụ làm các thao tác git thay bạn theo yêu cầu. Bạn nên đọc kỹ nội dung nó định làm và đồng ý từng bước nếu nó hỏi, nhất là với thao tác ảnh hưởng đến lịch sử.
D.Giao việc lặp đi lặp lại
Bạn là chủ một shop nhỏ có website tự dựng, trong code có nhiều chỗ ghi cùng một thông tin liên hệ cần cập nhật. Bạn mô tả việc cần làm:
Tìm mọi chỗ trong dự án có số điện thoại cũ và liệt kê cho tôi trước khi sửa.Bạn xem danh sách trước, rồi mới bảo nó sửa. Cách làm hai bước này giúp tránh sửa nhầm.
VI.Lỗi hay gặp và cách xử lý
Gõ claude báo không tìm thấy lệnh. Rất hay xảy ra ngay sau khi cài. Hãy đóng cửa sổ terminal rồi mở lại để máy nạp lại đường dẫn. Nếu vẫn lỗi, xem mục xử lý sự cố ở https://code.claude.com/docs/en/setup.
Dùng nhầm lệnh cài cho hệ điều hành. Lệnh curl ... | bash dành cho macOS/Linux, còn irm ... | iex dành cho Windows PowerShell. Dán sai chỗ sẽ báo lỗi ngay. Hãy kiểm tra lại bạn đang ở hệ nào và đang mở terminal loại nào.
Cài bằng npm theo hướng dẫn cũ. README ghi rõ cách này đã lỗi thời. Nếu bạn đang đọc một bài hướng dẫn cũ bảo dùng npm, hãy chuyển sang một trong các cách khuyến nghị.
Chạy sai thư mục. Nếu bạn chạy claude ở thư mục không phải dự án (ví dụ thư mục chính của máy), công cụ sẽ không nhìn thấy code bạn muốn hỏi, và bạn có thể vô tình cho nó truy cập nhiều hơn cần thiết. Luôn dùng cd vào đúng thư mục dự án trước.
Giao việc chung chung nên kết quả lệch. Nếu yêu cầu quá mơ hồ, kết quả sẽ khó dùng. Hãy nói rõ file nào, mục tiêu gì, và yêu cầu nó cho bạn xem kế hoạch hoặc danh sách thay đổi trước khi làm thật.
VII.Có nên dùng không
Điểm mạnh: cài nhanh bằng một lệnh, dùng được trên macOS, Linux và Windows, trò chuyện bằng ngôn ngữ thường, biết cả việc giải thích code lẫn xử lý git. Repo được cập nhật gần đây, có tài liệu chính thức và cộng đồng Discord để hỏi khi vướng.
Giới hạn: README không nói rõ về giấy phép trong phần mô tả repo, cũng không nêu chi phí hay yêu cầu tài khoản, nên bạn cần đọc tài liệu chính thức trước khi dùng cho công việc quan trọng. README cũng nói công cụ thu thập dữ liệu phản hồi như thông tin sử dụng (chẳng hạn 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 /bug. Hãy đọc chính sách sử dụng dữ liệu và điều khoản trước khi đưa mã nguồn của công ty vào.
Khi nên chọn cách khác: nếu bạn không dùng terminal, hoặc chỉ cần một khung chat để hỏi đáp chung chung không gắn với dự án, một công cụ chat thông thường sẽ hợp hơn. Nếu dự án chứa dữ liệu bí mật mà công ty chưa cho phép dùng dịch vụ bên ngoài, hãy hỏi bộ phận phụ trách trước.
Nếu bạn làm việc với code hằng ngày, đây là công cụ rất đáng thử: cài mất vài phút, và bạn tự đánh giá được ngay trên dự án thật của mình.
Câu hỏi thường gặp
Claude Code là gì?
Theo tác giả, đây là một công cụ lập trình dạng tác tử chạy trong terminal. Nó hiểu mã nguồn của bạn và giúp làm việc nhanh hơn bằng cách thực hiện các tác vụ lặp lại, giải thích code phức tạp và xử lý quy trình git qua câu lệnh ngôn ngữ tự nhiên.
Claude Code chạy được trên Windows không?
Được. README có lệnh cài riêng cho Windows: irm https://claude.ai/install.ps1 | iex trong PowerShell, hoặc winget install Anthropic.ClaudeCode. macOS và Linux cũng có lệnh cài riêng.
Cài Claude Code có cần Node.js hay npm không?
Với các cách cài khuyến nghị trong README thì không thấy yêu cầu này. Cách cài bằng npm vẫn còn trong README nhưng được ghi rõ là đã lỗi thời (deprecated), nên bạn nên dùng một trong các cách khác.
Dùng Claude Code có miễn phí không, có cần tài khoản hay API key không?
README của repo chưa ghi thông tin về chi phí, tài khoản hay API key. Bạn nên xem tài liệu chính thức tại https://code.claude.com/docs/en/setup và trang tổng quan để biết điều kiện sử dụng mới nhất.
Dữ liệu và mã nguồn của tôi có an toàn không?
README cho biết công cụ có thu thập phản hồi, gồm dữ liệu sử dụng như việc 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 bằng lệnh /bug. Tác giả nêu có các biện pháp như giới hạn thời gian lưu giữ thông tin nhạy cảm và hạn chế truy cập vào phiên làm việc của người dùng. Chi tiết nằm trong chính sách sử dụng dữ liệu, Điều khoản thương mại và Chính sách quyền riêng tư mà README dẫn link.
Tôi cần GPU hoặc máy mạnh để chạy không?
README không đề cập yêu cầu về GPU hay cấu hình phần cứng. Chưa có thông tin cụ thể ngoài việc công cụ chạy trong terminal.
Gặp lỗi thì báo ở đâu?
Bạn gõ lệnh /bug ngay trong Claude Code để báo lỗi trực tiếp, hoặc tạo một issue trên GitHub của repo. README cũng giới thiệu Discord của Claude Developers để hỏi cộng đồng.


