# 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 là công cụ lập trình dạng agent của Anthropic, chạy ngay trong terminal. Công cụ đọ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 ngôn ngữ tự nhiên. Cài bằng một dòng lệnh, rồi vào thư mục dự án gõ claude là dùng được.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-05-27 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/claude-code-tro-ly-lap-trinh-trong-terminal

Claude Code là một công cụ lập trình dạng agent do Anthropic làm, chạy ngay trong terminal của bạn. Bạn mở nó trong thư mục dự án, gõ yêu cầu bằng tiếng người, và nó đọc hiểu mã nguồ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. 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, người làm dự án nhỏ, hoặc người làm văn phòng có dính chút code (viết script, sửa file cấu hình, dọn dữ liệu). Bạn không cần thuộc hết lệnh git hay hiểu hết dự án người khác để lại. Bạn mô tả việc cần làm, công cụ lo phần còn lại.

Điểm đáng giá nhất: cài rất nhanh (một dòng lệnh), và dùng thẳng trong thư mục dự án nên nó nhìn thấy code thật của bạn thay vì bạn phải copy dán từng đoạn vào khung chat. Hiện repo có khoảng 155.000 sao và khoảng 25.000 fork, và vẫn được cập nhật trong vài tháng gần đây.

```repo
- repo | anthropics/claude-code
- kind | CLI
- desc | 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.
- stars | 155k
- lang | TypeScript
```

## Claude Code làm được gì

Theo mô tả của tác giả, công cụ xoay quanh ba nhóm việc chính.

**Hiểu codebase của bạn.** Công cụ chạy trong thư mục dự án nên nó đọc được cấu trúc và nội dung code. Lợi ích thực tế: khi bạn nhận một dự án lạ, bạn hỏi thẳng 'dự án này làm gì, file nào lo phần đăng nhập' thay vì tự lần từng thư mục.

**Làm các việc lặp đi lặp lại (routine tasks).** Những việc nhàm như sửa cùng một kiểu lỗi ở nhiều chỗ, viết đoạn code quen thuộc, đổi tên cho thống nhất. Bạn nói bằng lời, công cụ thực hiện. Bạn tiết kiệm thời gian cho phần cần suy nghĩ.

**Giải thích code phức tạp.** Gặp đoạn code khó hiểu, bạn nhờ nó giải thích từng bước bằng ngôn ngữ dễ hiểu. Với người mới, đây là cách học nhanh vì ví dụ là code thật của chính bạn.

**Xử lý git bằng lời.** README nhắc rõ khả năng 'handling git workflows'. Những thao tác git hay làm người mới rối, bạn có thể diễn đạt bằng câu thường thay vì nhớ cú pháp.

**Dùng ở nhiều nơi.** Terminal là chỗ chính, ngoài ra có thể dùng trong IDE hoặc gắn @claude trên GitHub. Repo cũng có thư mục plugins; plugin chính thức của Anthropic được phát triển ở một repo riêng tên claude-plugins-official.

**Báo lỗi ngay trong công cụ.** Có lệnh /bug để báo lỗi trực tiếp, không phải rời cửa sổ làm việc.

## Cần chuẩn bị gì

README rất gọn, nên phần này mình chỉ nói những gì có trong tư liệu:

- **Một terminal** để gõ lệnh. README có lệnh riêng cho macOS/Linux và cho Windows (PowerShell).
- **Một thư mục dự án** để chạy `claude` trong đó.
- **Trình quản lý gói tùy chọn**: Homebrew (macOS/Linux) hoặc WinGet (Windows) nếu bạn muốn cài bằng cách đó.

Còn những thứ README không nói: phiên bản hệ điều hành tối thiểu, yêu cầu phần cứng, loại tài khoản hay gói cước cần để đăng nhập, chi phí sử dụng. Tư liệu mình có chưa ghi các mục này. Bạn xem trang cài đặt chính thức ở https://code.claude.com/docs/en/setup trước khi bắt đầu, nhất là phần tài khoản.

```note
README cho biết cài bằng npm đã bị đánh dấu lỗi thời (deprecated). Hãy dùng các cách cài khuyến nghị bên dưới. Công cụ cũng thu thập dữ liệu phản hồi, gồm dữ liệu sử dụng và hội thoại liên quan, nên đừng đưa vào thư mục dự án những thứ bạn không muốn chia sẻ như mật khẩu, khóa bí mật.
```

## Cài đặt từng bước

```steps
- Mở terminal | Dùng macOS/Linux terminal hoặc PowerShell trên Windows
- Chạy lệnh cài | Chọn đúng lệnh cho hệ điều hành của bạn
- Vào thư mục dự án | Dùng cd để vào đúng thư mục bạn muốn làm việc
- Chạy claude | Gõ claude để khởi động công cụ
```

### Mở terminal đúng chỗ

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). Người mới hay vấp ở chỗ dán lệnh của macOS vào PowerShell, hoặc ngược lại. Hai hệ điều hành dùng hai lệnh khác nhau, đừng lẫn.

### Chạy lệnh cài đặt

README đưa ra nhiều cách. Bạn chọn một cách phù hợp.

**macOS/Linux (cách được khuyến nghị):**

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

Lệnh này tải script cài đặt rồi chạy luôn. Bạn chỉ cần dán nguyên dòng và nhấn Enter.

**Homebrew (macOS/Linux):**

```bash
brew install --cask claude-code
```

Dùng cách này nếu máy bạn đã có Homebrew.

**Windows (cách được khuyến nghị), chạy trong PowerShell:**

```powershell
irm https://claude.ai/install.ps1 | iex
```

**WinGet (Windows):**

```powershell
winget install Anthropic.ClaudeCode
```

**NPM (đã lỗi thời):**

```bash
npm install -g @anthropic-ai/claude-code
```

README ghi rõ cách npm đã deprecated. Mình liệt kê cho đủ, nhưng bạn nên ưu tiên các cách ở trên. Muốn biết thêm cách cài khác, cách gỡ cài đặt và xử lý sự cố, xem https://code.claude.com/docs/en/setup.

### Vào thư mục dự án và chạy claude

Bước 2 của README: đi tới thư mục dự án rồi chạy `claude`. Ví dụ bạn có dự án ở thư mục tên my-project:

```bash
cd my-project
claude
```

Chữ `cd` nghĩa là 'đi tới thư mục'. Hãy thay `my-project` bằng đường dẫn thật tới dự án của bạn. Điều quan trọng: phải chạy `claude` bên trong thư mục dự án, vì công cụ làm việc với code ở nơi bạn đang đứng.

Lần đầu chạy, công cụ có thể hỏi bạn các bước thiết lập như đăng nhập. README chưa mô tả chi tiết phần này, bạn làm theo hướng dẫn trên màn hình và xem tài liệu chính thức nếu cần.

## Kiểm tra đã chạy được chưa

README không đưa ra một lệnh kiểm tra riêng. Cách đơn giản nhất để biết đã thành công là làm đúng bước 2: vào thư mục dự án và gõ `claude`. Nếu công cụ khởi động và hiện giao diện nhập yêu cầu trong terminal, tức là cài thành công.

Sau đó thử một câu hỏi vô hại, ví dụ nhờ nó giải thích dự án:

```
Dự án này làm gì? Tóm tắt giúp mình cấu trúc thư mục.
```

Nếu bạn nhận được câu trả lời bám sát code thật trong thư mục, bạn đã dùng được. 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.

## Dùng vào việc thật

Dưới đây là các tình huống mình thấy khớp với khả năng README mô tả: hiểu codebase, làm việc lặp lại, giải thích code, xử lý git. Các câu lệnh mẫu chỉ là gợi ý cách diễn đạt, bạn tự sửa theo việc của mình.

### Nhận dự án cũ mà không ai giải thích

Bối cảnh: bạn là lập trình viên mới vào công ty, được giao một dự án do người khác viết và đã nghỉ việc. Tài liệu gần như không có.

Cách làm: vào thư mục dự án, chạy `claude`, rồi hỏi từng lớp một:

```
Dự án này làm gì? Giải thích cấu trúc thư mục cho người mới.
Phần đăng nhập nằm ở file nào? Giải thích luồng chạy từng bước.
```

Kết quả: sau vài câu hỏi, bạn có bản đồ sơ bộ của dự án mà không phải mở từng file. Bạn vẫn nên tự mở file quan trọng để đối chiếu, nhưng đã biết nên bắt đầu từ đâu.

> Cái khó nhất khi nhận code lạ không phải là viết, mà là biết nên đọc ở đâu trước.
>
> — Ông T

### Làm việc lặp lại cho nhanh

Bối cảnh: bạn làm website bán hàng nhỏ. Cần đổi cách đặt tên biến ở nhiều file cho thống nhất, một việc nhàm chán nếu làm tay.

Cách làm: mô tả việc bằng lời.

```
Trong thư mục này, những chỗ nào đang đặt tên biến không thống nhất? Đề xuất cách sửa, rồi sửa giúp mình.
```

Kết quả: công cụ tìm các chỗ cần sửa và thực hiện. Mẹo an toàn: làm việc trên một nhánh git riêng, hoặc commit code hiện tại trước, để bạn dễ xem lại và quay về nếu không ưng.

### Hiểu một đoạn code khó

Bối cảnh: bạn là nhân viên văn phòng biết chút Python, được giao sửa một script xử lý báo cáo mà bạn đọc không hiểu.

Cách làm: hỏi trực tiếp về script đó.

```
Giải thích script xử lý báo cáo này từng bước bằng tiếng Việt đơn giản. Chỗ nào dễ lỗi nhất?
```

Kết quả: bạn nhận được lời giải thích dễ đọc, gắn với code thật. Từ đó bạn dám sửa những chỗ nhỏ và biết chỗ nào cần hỏi người khác.

### Xử lý git không cần nhớ cú pháp

Bối cảnh: bạn mới học git, hay quên lệnh và sợ làm hỏng lịch sử.

Cách làm: nhờ công cụ hỗ trợ các thao tác git thường ngày bằng lời, ví dụ:

```
Mình vừa sửa vài file. Cho mình xem đã thay đổi những gì, rồi giúp mình viết một commit message rõ ràng.
```

Kết quả: bạn vừa hoàn thành việc, vừa học được thao tác git đang diễn ra. Với những thao tác khó đảo ngược, hãy đọc kỹ rồi mới đồng ý, đừng bấm đồng ý hàng loạt khi chưa hiểu.

## Lỗi hay gặp và cách xử lý

**Terminal báo không nhận ra lệnh `claude`.** Thường do cài xong nhưng cửa sổ terminal cũ chưa nhận thay đổi. Hãy đóng terminal, mở cửa sổ mới rồi gõ lại `claude`. Nếu vẫn lỗi, xem phần xử lý sự cố ở https://code.claude.com/docs/en/setup.

**Dán nhầm lệnh của hệ điều hành khác.** Lệnh `curl ... | bash` dành cho macOS/Linux, còn `irm ... | iex` dành cho PowerShell trên Windows. Dán sai chỗ sẽ báo lỗi cú pháp. Kiểm tra lại bạn đang ở hệ điều hành nào và dùng đúng mục.

**Chạy `claude` ở sai thư mục.** Nếu bạn chạy ở thư mục chứa nhiều thứ không liên quan (ví dụ cả ổ đĩa hay thư mục Downloads), công cụ sẽ nhìn vào sai chỗ. Hãy `cd` vào đúng thư mục dự án rồi chạy lại.

**Cài bằng npm rồi gặp trục trặc.** README đã đánh dấu npm là lỗi thời. Hãy gỡ theo hướng dẫn gỡ cài đặt trong tài liệu chính thức rồi cài lại bằng cách khuyến nghị (script, Homebrew hoặc WinGet).

**Kết quả công cụ sửa không như ý.** Đây không hẳn là lỗi cài đặt mà là chuyện bình thường khi dùng công cụ AI. Hãy commit trước khi giao việc, xem lại thay đổi trước khi giữ, và nếu thấy có bug của chính công cụ thì dùng lệnh `/bug` để báo.

## Có nên dùng không

**Điểm mạnh.** Cài đơn giản, chỉ một dòng lệnh cho mỗi hệ điều hành. Làm việc ngay trong thư mục dự án nên hiểu được code thật. Dùng ngôn ngữ tự nhiên nên người mới đỡ ngợp. Repo của Anthropic, có tài liệu chính thức, có cộng đồng trên Discord và được cập nhật gần đây.

**Giới hạn.** README ngắn, chưa nói rõ yêu cầu hệ thống, tài khoản cần có hay chi phí; bạn phải đọc thêm tài liệu chính thức. Công cụ có thu thập dữ liệu phản hồi (dữ liệu sử dụng, hội thoại liên quan, phản hồi qua `/bug`), nên với code nhạy cảm của công ty bạn cần đọc chính sách dữ liệu và hỏi bộ phận phụ trách trước. Mục giấy phép trong tư liệu mình có không ghi rõ, bạn tự xem file LICENSE.md trong repo nếu cần dùng cho mục đích thương mại.

**Khi nào chọn cách khác.** Nếu bạn không muốn dùng terminal hoàn toàn, hoặc chỉ cần hỏi đáp đơn giản không liên quan tới code trong máy, một khung chat thông thường có thể đủ. Còn nếu bạn thường xuyên làm việc với code, muốn một trợ lý nhìn thấy cả dự án và giúp các việc lặt vặt, Claude Code đáng để thử. Bạn bắt đầu bằng một dự án nhỏ, không quan trọng, để làm quen trước.

## Câu hỏi thường gặp

### Claude Code là gì và khác gì một khung chat AI thông thường?

Theo mô tả của tác giả, đây là công cụ lập trình dạng agent chạy trong terminal, hiểu codebase của bạn và làm việc qua câu lệnh ngôn ngữ tự nhiên. Khác với việc dán code vào khung chat, bạn chạy nó ngay trong thư mục dự án. Tư liệu không so sánh chi tiết với công cụ cụ thể nào khác.

### Claude Code có miễn phí không?

Tư liệu mình có không nói về giá hay gói cước. Bạn xem thông tin chính thức tại trang tài liệu code.claude.com để biết chi phí và loại tài khoản cần có.

### Cài Claude Code trên Windows được không?

Được. README có hai cách cho Windows: chạy irm https://claude.ai/install.ps1 | iex trong PowerShell, hoặc dùng WinGet với lệnh winget install Anthropic.ClaudeCode. Chi tiết yêu cầu phiên bản Windows tối thiểu thì README chưa ghi.

### Cài bằng npm còn dùng được không?

README ghi cách cài bằng npm đã lỗi thời (deprecated) và khuyên dùng các cách khác như script cài đặt, Homebrew hoặc WinGet. Bạn nên theo các cách khuyến nghị.

### Có cần GPU hay máy cấu hình mạnh không?

Tư liệu chưa nói gì về yêu cầu phần cứng. Bạn xem trang setup chính thức tại https://code.claude.com/docs/en/setup để biết yêu cầu hệ thống.

### Dữ liệu và code của mình có an toàn không?

README cho biết công cụ thu thập dữ liệu 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. Tác giả nói có áp dụng thời gian lưu giữ giới hạn, hạn chế truy cập dữ liệu phiên và có chính sách không dùng phản hồi để huấn luyện mô hình. Chi tiết nằm ở trang chính sách dữ liệu và điều khoản của Anthropic.

### Tôi báo lỗi hoặc hỏi cộng đồng ở đâu?

Dùng lệnh /bug ngay trong Claude Code 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.
