Mình đã cài Claude Code trên Windows như thế nào (2026): Git, PATH, PowerShell, WSL và các lỗi dễ gặp

Nếu bạn đang cài Claude Code trên Windows, thứ làm mất thời gian nhất thường không phải là lệnh cài đặt.

Phần tốn thời gian nhất thường là mớ môi trường xung quanh nó: terminal nào nên dùng, Git đã cài chưa, Node có ổn không, PATH có đúng không, biến môi trường có được lưu lâu dài không, rồi cuối cùng là vì sao claude vẫn không chạy dù npm vừa báo cài thành công.

Mình thấy khá nhiều người gặp đúng những lỗi lặp đi lặp lại:

• cài xong nhưng lệnh claude không chạy
• Git đã cài nhưng PowerShell không nhận
• npm báo thành công nhưng terminal vẫn báo not recognized
• biến môi trường có trong cửa sổ hiện tại, mở cửa sổ mới thì biến mất
• dùng lẫn PowerShell, Git Bash và WSL nên càng sửa càng rối

Vì vậy bài này không đi theo kiểu “đưa một lệnh rồi xong”. Mình sẽ đi theo thứ tự từ đầu đến cuối, theo cách dễ debug nhất cho người mới dùng Windows.

Nếu muốn ít lỗi nhất, hãy dùng đúng một bộ môi trường này

Nếu mục tiêu của bạn là cài nhanh nhưng vẫn ổn định, mình khuyên nên bắt đầu với bộ sau:

• Windows Terminal
• PowerShell
• winget
• Git for Windows
• Node.js LTS
• npm để cài Claude Code global
• biến môi trường lưu ở cấp user

Lúc đầu, mình thật sự không khuyên trộn quá nhiều môi trường như:

• cmd
• Git Bash
• WSL

Không phải vì chúng tệ. Vấn đề là mỗi môi trường có cách nạp PATH, shell profile và biến môi trường khác nhau. Nếu có lỗi, bạn sẽ rất khó xác định lỗi nằm ở đâu.

Bước 1: Mở đúng terminal ngay từ đầu

Hãy mở Windows Terminal và chọn PowerShell.

Kiểm tra PowerShell:

$PSVersionTable.PSVersion

Nếu lệnh chạy bình thường, hãy dùng chính cửa sổ này cho toàn bộ quá trình cài đặt. Điều này giúp bạn tránh việc nửa chừng chuyển sang Git Bash hoặc cmd, rồi sau đó không biết vì sao kết quả giữa các terminal lại khác nhau.

Bước 2: Cài Git trước, đừng để đến cuối mới xử lý

Kiểm tra Git:

git --version

Nếu chưa có, cài bằng winget:

winget install --id Git.Git