Bỏ qua tới nội dung
Ông T.vn

claude-code: trợ lý lập trình ngay trong terminal — hướng dẫn cài đặt và dùng

10 phút đọcCập nhật

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 →

claude-code: trợ lý lập trình 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.

CLI

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.

★ 155kTypeScript
Xem repo trên GitHub

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 curl hoặ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

  1. Mở terminalDùng Terminal trên macOS/Linux hoặc PowerShell trên Windows
  2. Chạy lệnh càiChọn đúng một lệnh theo hệ điều hành của bạn
  3. Vào thư mục dự ánDùng cd để đi tới thư mục bạn muốn làm việc
  4. 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ị):

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

Lệ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:

Terminal
brew install --cask claude-code

Windows (README ghi là cách khuyến nghị), chạy trong PowerShell:

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

Hoặc dùng WinGet trên Windows:

PowerShell
winget install Anthropic.ClaudeCode

Cò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ũ:

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

Nế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:

Terminal
cd ten-du-an

Bạ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.

Terminal
claude

Sau đó 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:

  1. 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.
  2. Vào thư mục dự án và gõ claude.
  3. 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.
  4. 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:

Code
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õ:

Code
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ờ:

Code
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ụ:

Code
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.

3.9/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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.

Chuyển nhanh tới mục

  1. I.Claude Code làm được gì
    1. A.Hiểu mã nguồn của bạn
    2. B.Giải thích code phức tạp
    3. C.Làm các việc lặp đi lặp lại
    4. D.Xử lý quy trình git
    5. E.Dùng ở nhiều nơi và có hệ plugin
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Bước 1: Mở terminal
    2. B.Bước 2: Chạy lệnh cài
    3. C.Bước 3: Vào thư mục dự án
    4. D.Bước 4: Chạy claude
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Nhận một dự án lạ và cần hiểu nhanh
    2. B.Đọc hiểu một đoạn code khó
    3. C.Nhờ xử lý git thay mình
    4. D.Giao việc lặp đi lặp lại
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Gõ claude mà máy báo không tìm thấy lệnh
    2. B.Lệnh cài chạy không được trên Windows
    3. C.Đang đứng sai thư mục
    4. D.Cài bằng npm rồi gặp trục trặc
    5. E.Để công cụ sửa file mà không xem trước
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.