# Cài Claude Code trên Windows trong 10 phút: từng bước, lỗi hay gặp, cách kiểm tra

> Cài Claude Code trên Windows gồm 4 việc: mở PowerShell, chạy lệnh cài chính thức (hoặc cài qua npm nếu đã có Node.js), mở lại terminal, rồi gõ claude --version để kiểm tra. Phần lớn lỗi người mới gặp là 'claude không được nhận ra', chặn script hoặc thiếu Git, và đều sửa được trong vài phút.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Claude Code
- Đăng: 2026-04-30 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/cai-claude-code-tren-windows-10-phut

Cài Claude Code trên Windows mất khoảng 10 phút, và thực chất chỉ là chạy một lệnh trong PowerShell rồi kiểm tra bằng `claude --version`. Phần mất thời gian nhất thường không phải lệnh cài. Đó là lúc bạn lần đầu mở terminal và không biết gõ vào đâu, hoặc khi màn hình báo đỏ mà không hiểu nó nói gì.

Bài này đi cùng tập video của series "Claude Code từ con số 0" dành cho người chưa từng đụng terminal. Xem video ngắn bên dưới để thấy thao tác thật, còn bài viết giải thích thêm vì sao từng bước cần có, các lỗi hay vướng và cách tự kiểm tra. Mình không nói lại Claude Code là gì hay cách đăng nhập, vì đã có tập riêng. Bài này chỉ lo một việc: để máy bạn có lệnh `claude` chạy được.

Nếu đọc xong mà bạn tự cài được, tự kiểm tra được và tự đọc được thông báo lỗi cơ bản, bài đã đạt mục tiêu.

```video
- youtube | https://www.youtube.com/shorts/xLDt4ASTGT8
- facebook | https://www.facebook.com/reel/1619889119918193
- title | Cài Claude Code trên Windows trong 10 phút
```

## Bản chất của việc cài Claude Code

### Claude Code là chương trình chạy trong terminal

Khác với ứng dụng bạn bấm đúp để mở, Claude Code là một chương trình dòng lệnh. Bạn mở terminal, đi tới thư mục dự án, gõ `claude`, và nó chạy ngay tại đó. Vì vậy "cài xong" có nghĩa cụ thể là: hệ thống Windows biết chữ `claude` trỏ tới chương trình nào.

Điều này giải thích lỗi phổ biến nhất sau khi cài. Chương trình đã nằm trên máy, nhưng terminal đang mở chưa biết về nó. Mình sẽ quay lại ở phần lỗi.

### Terminal, PowerShell, Command Prompt: chọn cái nào?

Trên Windows có nhiều cửa sổ dòng lệnh. Bạn gặp nhiều nhất là PowerShell và Command Prompt (cmd). Với người mới, hãy dùng PowerShell, vì các hướng dẫn cài đặt hiện nay thường viết cho nó. Nếu bạn có Windows Terminal, nó chỉ là cái khung chứa PowerShell, dùng được luôn.

Cách mở nhanh: bấm phím Windows, gõ `PowerShell`, Enter. Một cửa sổ xanh hoặc đen hiện ra, có dòng chữ kết thúc bằng dấu `>` và con trỏ nhấp nháy. Đó là nơi bạn gõ lệnh.

### Hai đường cài và khác nhau ở đâu

Về cơ bản có hai cách:

- **Trình cài đặt chính thức (native installer):** bạn chạy một lệnh duy nhất trong PowerShell, nó tự tải và đặt chương trình vào đúng chỗ. Không cần cài thêm gì khác. Đây là đường gọn nhất cho người mới.
- **Cài qua npm:** dùng gói `@anthropic-ai/claude-code`. Cách này cần Node.js có sẵn trên máy. Hợp với bạn nếu đã là dev, đã dùng Node mỗi ngày và quen quản lý gói bằng npm.

Lệnh cài chính xác của trình cài đặt chính thức có thể thay đổi theo thời gian. Vì vậy mình không chép cứng vào đây. Hãy mở trang tài liệu chính thức của Anthropic về Claude Code, tìm phần cài đặt cho Windows và chép đúng lệnh ở đó. Video ngắn bên dưới cũng cho thấy lệnh đó chạy ra sao.

### Một điều kiện hay bị quên: Git

Claude Code làm việc nhiều với thư mục dự án và các lệnh dòng lệnh. Trên Windows, bản chạy trực tiếp thường cần Git for Windows có mặt trên máy. Nếu lúc cài hoặc lúc chạy lần đầu có thông báo nhắc về Git, hãy cài Git for Windows rồi mở lại terminal. Nếu bạn chạy qua WSL (Linux bên trong Windows), cách làm khác đi một chút, nhưng người mới không cần đi đường đó.

## Làm thế nào: cài và kiểm tra trong 10 phút

```steps
- Mở PowerShell | Bấm phím Windows, gõ PowerShell, Enter
- Chuẩn bị điều kiện | Có mạng ổn định; nếu cần thì cài Git for Windows
- Chạy lệnh cài | Chép lệnh cài Windows từ tài liệu chính thức, dán vào PowerShell, Enter
- Mở lại terminal | Đóng cửa sổ cũ, mở PowerShell mới để hệ thống nhận lệnh claude
- Kiểm tra | Gõ claude --version, thấy số phiên bản là xong
- Thử chạy | Vào một thư mục thử, gõ claude để thấy màn hình khởi động
```

### Bước 1: mở PowerShell và tạo một thư mục thử

Trước khi cài, hãy tạo sẵn một thư mục để thử, ví dụ `thu-claude` trong Documents. Bạn sẽ dùng nó ở cuối bài. Việc này giúp bạn không chạy Claude Code lần đầu trong một thư mục chứa dữ liệu thật, như Desktop đầy file kế toán.

Trong PowerShell, bạn có thể tạo và đi vào thư mục bằng:

```text
cd $HOME\Documents
mkdir thu-claude
cd thu-claude
```

`cd` là đi vào thư mục, `mkdir` là tạo thư mục mới. Gõ xong từng dòng thì bấm Enter.

### Bước 2: chạy lệnh cài

Dán lệnh cài lấy từ tài liệu chính thức. Trong PowerShell, bạn dán bằng chuột phải hoặc Ctrl+V, rồi Enter. Khi chạy, màn hình sẽ in vài dòng tiến trình. Hãy đợi đến khi dấu `>` hiện lại, nghĩa là lệnh đã xong.

Nếu bạn chọn đường npm, điều kiện là Node.js đã cài. Bạn kiểm tra bằng `node --version`. Có số phiên bản hiện ra thì dùng được. Báo không nhận ra lệnh thì bạn cần cài Node.js trước, hoặc quay về đường trình cài đặt chính thức cho đơn giản. Với npm, lệnh có dạng `npm install -g @anthropic-ai/claude-code`. Cờ `-g` nghĩa là cài toàn máy chứ không chỉ trong một thư mục.

### Bước 3: mở lại terminal

Đây là bước người mới hay bỏ qua nhất. Windows nạp danh sách "chương trình nào gọi bằng tên gì" (biến môi trường PATH) khi cửa sổ terminal được mở. Cửa sổ nào mở trước khi bạn cài sẽ không biết lệnh mới. Đóng hẳn PowerShell cũ, mở cái mới, rồi mới kiểm tra.

### Bước 4: kiểm tra bằng một lệnh

```text
claude --version
```

Nếu thấy một dãy số phiên bản, bạn đã cài đúng. Không cần đăng nhập mới chạy được lệnh này, vì nó chỉ hỏi "chương trình có đó không". Đây là phép thử rẻ và rõ ràng nhất: kết quả chỉ có hai khả năng, hoặc ra số, hoặc ra lỗi.

Claude Code còn có lệnh chẩn đoán `claude doctor`, dùng để kiểm tra cài đặt và hiện các cảnh báo. Nếu `--version` chạy được nhưng bạn thấy có gì lạ, thử lệnh này.

### Bước 5: chạy thử trong thư mục thử

Trong thư mục `thu-claude`, gõ `claude` rồi Enter. Lần đầu nó sẽ yêu cầu bạn đăng nhập. Phần đăng nhập có tập riêng trong series, nên bạn cứ xem tập đó rồi quay lại. Nếu bạn thấy màn hình khởi động của Claude Code, việc cài đặt đã hoàn tất. Gõ lệnh thoát hoặc đóng cửa sổ là xong.

```note
Chỉ chạy lệnh cài chép từ tài liệu chính thức của Anthropic. Đừng chạy lệnh dán từ bình luận, nhóm chat hay trang lạ: một dòng PowerShell có thể tải và chạy bất cứ thứ gì trên máy bạn. Và lần đầu hãy chạy claude trong thư mục thử, không phải thư mục chứa dữ liệu thật.
```

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

Cài xong chưa phải đích. Dưới đây là ba tình huống để bạn thấy bước cài "đúng" nghĩa là gì trong đời thật.

### Chủ shop nhỏ cài trên chiếc laptop dùng chung

Chị Lan bán đồ gia dụng online, dùng một laptop Windows vừa làm việc vừa cho con học bài. Chị muốn nhờ Claude Code sắp xếp file báo cáo bán hàng. Chị cài theo các bước trên, nhưng khi gõ `claude --version` thì báo lỗi.

Chị làm đúng thứ tự xử lý: đóng PowerShell, mở lại, gõ lại. Lần này ra số phiên bản. Chị tạo thư mục `bao-cao-thu` và chép vài file mẫu vào, không đụng tới thư mục báo cáo thật.

Câu giao việc đầu tiên chị thử:

```text
Hãy liệt kê các file trong thư mục này, cho mình biết file nào là báo cáo bán hàng theo tháng. Chưa sửa hay xóa gì cả.
```

Kết quả là một danh sách file kèm nhận xét ngắn. Chỗ cần kiểm tra lại: so danh sách với thư mục thật, vì Claude có thể đoán sai loại file dựa vào tên. Việc dặn "chưa sửa hay xóa" giúp lần đầu an toàn.

### Kế toán cần kiểm tra máy công ty trước khi cài

Anh Hưng là kế toán, máy công ty do bộ phận IT quản lý. Khi chạy lệnh cài, PowerShell báo không cho chạy script. Đây thường là chính sách bảo mật của máy, không phải lỗi của anh. Anh dừng lại và nhắn IT thay vì tìm cách tắt chính sách đó.

Tin nhắn anh gửi, bạn có thể dùng làm mẫu:

```text
Chào anh/chị IT, em muốn cài Claude Code (công cụ dòng lệnh của Anthropic) trên máy công việc để hỗ trợ xử lý file Excel. Cần chạy một lệnh PowerShell để cài. Máy đang chặn chạy script. Anh/chị có thể hỗ trợ cài hoặc cho em biết chính sách của công ty về công cụ này không? Em sẽ chỉ dùng trong thư mục thử, không đụng dữ liệu khách hàng.
```

Kết quả: IT biết chính xác anh cần gì, và anh không phải tự hạ mức bảo mật. Chỗ cần kiểm tra: công ty có cho phép đưa dữ liệu nội bộ vào công cụ AI hay không. Câu hỏi này quan trọng hơn bản thân việc cài đặt.

### Dev mới cài và gặp xung đột Node

Bạn Minh là lập trình viên mới đi làm, đã có Node.js từ trước. Bạn chọn cài qua npm. Lệnh cài chạy xong nhưng gõ `claude` thì báo không nhận ra. Minh không đoán mò, mà hỏi ngay Claude trên web để nhờ chẩn đoán:

```text
Mình dùng Windows 11, vừa chạy npm install -g @anthropic-ai/claude-code xong nhưng gõ claude thì PowerShell báo không nhận ra lệnh. Mình đã đóng và mở lại terminal rồi. Hãy chỉ mình cách kiểm tra thư mục npm toàn cục có nằm trong PATH không, từng lệnh một, giải thích từng lệnh làm gì.
```

Kết quả là các lệnh kiểm tra như `npm config get prefix` để biết npm đặt gói ở đâu. Minh thấy thư mục đó chưa có trong PATH và thêm vào qua cài đặt biến môi trường của Windows. Chỗ cần kiểm tra: đừng chép bừa lệnh sửa PATH mà bạn chưa hiểu. Nhập sai có thể xóa mất đường dẫn đang chạy tốt của chương trình khác.

## Góc nhìn khách quan

### Điểm mạnh thật sự

Cài đặt trên Windows ngày nay đơn giản hơn nhiều so với hồi các công cụ AI chạy trong terminal mới xuất hiện. Với trình cài đặt chính thức, bạn không cần nhớ cấu hình gì, và có một phép thử rõ ràng bằng `claude --version`. Cả quá trình ngắn đến mức người chưa từng mở terminal cũng làm được trong một buổi.

Khi đã cài xong, bạn được một thứ khác hẳn chatbot trên web: một công cụ làm việc ngay trên thư mục của bạn, đọc được file, đề xuất và thực hiện thay đổi. Việc cài đặt là cửa vào của khả năng đó.

> Cài xong không phải là biết dùng. Nhưng `claude --version` ra số là mốc rẻ nhất để biết mình đang đứng trên nền đúng.
>
> — Ông T

### Giới hạn và rủi ro

- **Phụ thuộc mạng:** cài và dùng đều cần kết nối Internet. Mạng yếu thì lệnh cài có thể đứt giữa chừng.
- **Quyền truy cập file:** Claude Code làm việc trong thư mục nơi bạn chạy nó. Chạy ở thư mục chứa dữ liệu nhạy cảm đồng nghĩa với việc để công cụ đó nhìn thấy dữ liệu ấy. Hãy chọn thư mục có chủ đích.
- **Chi phí lượt dùng:** dùng cần tài khoản phù hợp, và mức dùng bị giới hạn theo gói. Cài miễn phí không có nghĩa dùng thoải mái không giới hạn. Phần đăng nhập và gói có tập riêng.
- **Máy công ty:** chính sách bảo mật có thể chặn script hoặc cấm gửi dữ liệu ra ngoài. Hỏi IT trước khi tìm cách lách.
- **Lệnh cài đổi theo thời gian:** vì vậy luôn lấy lệnh từ tài liệu chính thức thay vì chép lại từ bài viết cũ.

### Khi nào nên chọn cách khác

Nếu bạn chỉ cần hỏi đáp, viết nội dung hoặc phân tích một file bạn dán vào, chatbot trên web như Claude hay ChatGPT đã đủ, không cần cài gì. Nếu bạn quen làm việc trong trình soạn code, các công cụ tích hợp thẳng vào trình soạn như Cursor hay GitHub Copilot có thể thuận tay hơn so với làm việc trong terminal. Nếu bạn muốn thử công cụ dòng lệnh của hãng khác, Codex CLI hay Gemini CLI cũng là lựa chọn, bạn nên tự đọc tài liệu và thử để so sánh. Claude Code hợp nhất khi bạn muốn giao cả một việc nhiều bước trên thư mục thật.

## Lỗi hay gặp và cách tránh

### Lỗi "claude không được nhận ra"

Đây là lỗi số một. Nguyên nhân thường là cửa sổ terminal mở trước khi cài, nên chưa nạp lại PATH. Cách sửa: đóng hẳn mọi cửa sổ PowerShell và mở cái mới. Nếu vẫn lỗi, khởi động lại máy rồi thử lại. Nếu cài bằng npm thì kiểm tra thư mục npm toàn cục có trong PATH chưa.

### PowerShell chặn chạy script

Thông báo kiểu "running scripts is disabled on this system" nghĩa là Windows đang áp chính sách không cho chạy script. Trên máy cá nhân, bạn có thể tìm hiểu cách cho phép chạy script ở mức người dùng hiện tại, và nên đọc kỹ tài liệu của Microsoft trước khi đổi. Trên máy công ty, đừng tự đổi, hãy nhờ IT. Không làm theo hướng dẫn "tắt hết bảo mật" từ nguồn lạ.

### Thiếu Git hoặc thiếu Node.js

Thông báo nhắc về Git hoặc báo lỗi `npm` không nhận ra nghĩa là thiếu thành phần đi kèm. Cài đúng thành phần được nhắc, mở lại terminal rồi chạy lại lệnh. Đừng cài lung tung nhiều phiên bản cùng lúc, vì sau này khó biết cái nào đang chạy.

### Chép lệnh từ nguồn không đáng tin

Bạn thấy một dòng lệnh "cài nhanh hơn" trong một nhóm chat và dán thẳng vào PowerShell. Đây là rủi ro an toàn thật. Cách tránh: chỉ dùng lệnh từ tài liệu chính thức, và nếu không hiểu lệnh làm gì, hãy hỏi Claude trên web giải thích từng phần trước khi chạy.

### Chạy lần đầu ở thư mục quan trọng

Người mới mở terminal ở Desktop hoặc ổ đĩa gốc rồi gõ `claude`, nghĩa là cho công cụ nhìn thấy cả đống file. Cách tránh: luôn `cd` vào một thư mục thử trước. Mọi thực hành đầu tiên nên nằm trong đó.

## Dự phóng: việc cài đặt công cụ AI sẽ đi về đâu

Phần này là nhận định của Ông T, không phải thông tin chính thức từ Anthropic.

**Cài đặt sẽ ngày càng ít bước.** Mức chắc chắn: khả năng cao. Hướng chung của công cụ AI agent là giảm rào cản ban đầu, vì mỗi bước thừa làm mất người dùng mới. Bạn nên chuẩn bị bằng cách đừng học thuộc lệnh, mà học cách tìm lệnh đúng từ tài liệu chính thức.

**Lệnh kiểm tra và chẩn đoán sẽ quan trọng hơn lệnh cài.** Mức chắc chắn: có thể. Khi công cụ cập nhật thường xuyên, câu hỏi "máy mình đang ở trạng thái nào" hay gặp hơn "cài thế nào". Bạn nên tập thói quen chạy `claude --version` và `claude doctor` khi có gì lạ trước khi hỏi người khác.

**Quản lý quyền theo thư mục sẽ được chú ý nhiều hơn.** Mức chắc chắn: khả năng cao. Công cụ đọc và sửa file thật thì câu hỏi "được đụng vào đâu" sẽ là mối quan tâm trung tâm của cả cá nhân lẫn doanh nghiệp. Bạn nên có thói quen tách thư mục thử và thư mục thật ngay từ đầu.

**Việc cài trên máy công ty sẽ gắn với chính sách của tổ chức.** Mức chắc chắn: còn bỏ ngỏ. Cách các công ty cho phép hay hạn chế công cụ AI dòng lệnh chưa thống nhất. Nếu bạn đi làm văn phòng, hãy chủ động hỏi quy định trước, thay vì đợi bị chặn.

## Bắt đầu từ đâu

Cài đặt là phần khô nhất của hành trình, và may là nó ngắn. Khi `claude --version` hiện ra số, bạn đã qua cửa đầu tiên. Từ đó mọi thứ là học cách giao việc, và các tập sau trong series sẽ dẫn bạn đi tiếp.

Ba việc làm được ngay hôm nay:

1. Mở PowerShell, tạo một thư mục thử tên `thu-claude`, rồi chép lệnh cài từ tài liệu chính thức và chạy.
2. Đóng terminal, mở lại, gõ `claude --version` để chắc chắn đã cài đúng.
3. Xem tiếp tập đăng nhập Claude Code trong series, rồi chạy `claude` trong thư mục thử để thấy màn hình khởi động.

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

### Cài Claude Code trên Windows có cần biết lập trình không?

Không. Bạn chỉ cần mở được PowerShell, dán một lệnh và kiểm tra kết quả. Việc dùng Claude Code sau đó cũng không đòi hỏi bạn viết code. Điều quan trọng hơn là biết mình đang chạy nó ở thư mục nào.

### Gõ claude --version báo không nhận ra lệnh thì làm sao?

Nguyên nhân phổ biến nhất là cửa sổ terminal mở trước lúc cài. Hãy đóng hẳn và mở PowerShell mới rồi gõ lại. Nếu vẫn lỗi, khởi động lại máy; với cài qua npm thì kiểm tra thư mục npm toàn cục đã nằm trong PATH chưa.

### Nên cài bằng trình cài đặt chính thức hay bằng npm?

Người mới nên chọn trình cài đặt chính thức vì không cần cài Node.js trước. Npm phù hợp nếu bạn đã là lập trình viên, đã có Node.js và quen quản lý gói. Cả hai đều dẫn tới cùng một lệnh claude.

### Có cần cài Git không?

Trên Windows, Claude Code thường cần Git for Windows có mặt. Nếu có thông báo nhắc về Git lúc cài hoặc chạy lần đầu, hãy cài rồi mở lại terminal. Yêu cầu cụ thể có thể thay đổi theo bản mới, nên đối chiếu với tài liệu chính thức.

### Máy công ty chặn chạy script thì có nên tự tắt chặn không?

Không nên. Đó thường là chính sách bảo mật do bộ phận IT đặt ra. Hãy nhờ IT hỗ trợ cài hoặc hỏi quy định về công cụ AI, đặc biệt nếu bạn xử lý dữ liệu khách hàng.

### Cài xong có dùng được ngay không cần đăng nhập?

Lệnh kiểm tra phiên bản chạy được mà không cần đăng nhập. Nhưng để thực sự làm việc với Claude Code, bạn cần đăng nhập bằng tài khoản phù hợp. Bước này có tập riêng trong series.

### Claude Code có thể xóa nhầm file của tôi không?

Về nguyên tắc, nó làm việc trong thư mục bạn chạy nó và có thể đề xuất hoặc thực hiện thay đổi file. Vì vậy hãy chạy trong thư mục thử trước, sao lưu dữ liệu quan trọng, và đọc kỹ các thay đổi trước khi đồng ý.
