Cách nhanh nhất để cài Claude Code là dùng trình cài đặt gốc: trên macOS, Linux và WSL chạy curl -fsSL https://claude.ai/install.sh | bash, còn trên Windows mở PowerShell và chạy irm https://claude.ai/install.ps1 | iex. Sau đó gõ claude --version để xác nhận, rồi gõ claude để đăng nhập lần đầu qua trình duyệt.
Tóm tắt nhanh
- Yêu cầu tối thiểu: macOS 13.0 trở lên hoặc Windows 10 phiên bản 1809 trở lên, RAM từ 4 GB, CPU x64 hoặc ARM64.
- Trình cài đặt gốc là lựa chọn được khuyến nghị vì nó tự cập nhật nền; bản cài qua Homebrew, WinGet hay npm thì phải nâng cấp thủ công.
- Trên Windows bạn có ba đường: chạy native, chạy trong WSL 2 hoặc WSL 1 — chỉ WSL 2 hỗ trợ sandbox.
- Claude Code cần tài khoản Pro, Max, Team, Enterprise hoặc Console. Gói Claude.ai miễn phí không dùng được.
- Ba lỗi Windows phổ biến nhất đều do gõ nhầm lệnh của shell khác:
irm không được nhận diện,token '&&' không hợp lệvàkhông tìm thấy tham số 'fsSL'. - Kiểm tra sức khỏe cài đặt bằng
claude doctor— lệnh này chỉ đọc, không mở phiên làm việc.
Máy của bạn có đủ điều kiện chạy Claude Code không?
Đủ, nếu máy không quá cũ. Tài liệu chính thức liệt kê các nền tảng được hỗ trợ gồm macOS 13.0 trở lên, Windows 10 bản 1809 trở lên hoặc Windows Server 2019 trở lên, Ubuntu 20.04 trở lên, Debian 10 trở lên và Alpine Linux 3.19 trở lên.
Về phần cứng, yêu cầu là từ 4 GB RAM và bộ xử lý x64 hoặc ARM64. Shell dùng được gồm Bash, Zsh, PowerShell hoặc CMD. Máy phải có kết nối internet vì Claude Code gọi về dịch vụ của Anthropic để làm việc.
Một điều kiện dễ bị bỏ sót ở Việt Nam: Claude Code chỉ hoạt động tại các quốc gia được Anthropic hỗ trợ. Nếu quá trình cài hoặc đăng nhập trả về thông báo App unavailable in region, đó không phải lỗi máy bạn mà là chặn theo khu vực — hãy kiểm tra danh sách quốc gia được hỗ trợ trước khi mất thời gian gỡ rối.
Cài Claude Code trên macOS như thế nào?
Mở Terminal và chạy trình cài đặt gốc:
curl -fsSL https://claude.ai/install.sh | bashNếu bạn quen Homebrew, có thể dùng brew install --cask claude-code. Lưu ý Homebrew cung cấp hai cask khác nhau: claude-code bám kênh phát hành ổn định, thường chậm hơn khoảng một tuần và bỏ qua các bản có lỗi lớn; còn claude-code@latest nhận bản mới ngay khi phát hành. Bản cài qua Homebrew không tự cập nhật, bạn phải chạy brew upgrade claude-code hoặc brew upgrade claude-code@latest tùy cask đã cài.
Sau khi cài xong, mở terminal ở thư mục dự án và gõ claude để bắt đầu phiên tương tác.
Cài Claude Code trên Windows: chọn native hay WSL?
Cả hai đều chạy được. Khác biệt nằm ở chỗ dự án của bạn ở đâu và bạn có cần sandbox không.
| Cách chạy | Yêu cầu | Sandbox | Nên dùng khi |
|---|---|---|---|
| Native Windows | Không bắt buộc gì thêm; Git for Windows là tùy chọn | Không hỗ trợ | Dự án và công cụ đều thuần Windows |
| WSL 2 | Đã bật WSL 2 | Có hỗ trợ | Dùng toolchain Linux hoặc cần chạy lệnh trong sandbox |
| WSL 1 | Đã bật WSL 1 | Không hỗ trợ | Chỉ khi máy không dùng được WSL 2 |
Chạy native: mở PowerShell và chạy irm https://claude.ai/install.ps1 | iex. Không cần quyền Administrator. Nếu bạn đang ở CMD thì dùng lệnh khác: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Cách phân biệt hai cửa sổ: dấu nhắc PowerShell hiển thị PS C:\, còn CMD chỉ hiển thị C:\ không có chữ PS.
Trên Windows native, cài thêm Git for Windows là tùy chọn nhưng nên làm: nó cấp Git Bash để Claude Code dùng công cụ Bash. Không có Git for Windows thì Claude Code chuyển sang dùng công cụ PowerShell. Nếu Git đã cài mà Claude Code không tìm thấy, bạn trỏ đường dẫn thủ công trong file settings bằng khóa CLAUDE_CODE_GIT_BASH_PATH, giá trị là đường dẫn tới bash.exe trong thư mục Git.
Chạy trong WSL: mở bản phân phối WSL của bạn rồi chạy đúng lệnh cài của Linux, tức curl -fsSL https://claude.ai/install.sh | bash. Cài và khởi chạy claude ngay bên trong terminal WSL, không phải từ PowerShell hay CMD. Cấu hình WSL không cần Git for Windows.
Ngoài ra, Windows còn có winget install Anthropic.ClaudeCode. Cách này tiện nếu công ty bạn quản lý phần mềm bằng WinGet, đổi lại nó không tự cập nhật — phải chạy winget upgrade Anthropic.ClaudeCode định kỳ, và việc nâng cấp có thể thất bại khi Claude Code đang chạy vì Windows khóa file thực thi.
Nên chọn cách cài nào?
Mình xếp theo mức độ ít phiền nhất về sau.
| Cách cài | Lệnh | Tự cập nhật | Ghi chú |
|---|---|---|---|
| Trình cài đặt gốc | curl -fsSL https://claude.ai/install.sh | bash hoặc irm https://claude.ai/install.ps1 | iex |
Có | Lựa chọn được khuyến nghị |
| Homebrew (macOS) | brew install --cask claude-code |
Không | Chọn cask theo kênh ổn định hay mới nhất |
| WinGet (Windows) | winget install Anthropic.ClaudeCode |
Không | Hợp môi trường doanh nghiệp |
| npm | npm install -g @anthropic-ai/claude-code |
Có, nếu thư mục global ghi được | Cần Node.js 22 trở lên kể từ bản 2.1.198 |
Với bản npm có một hiểu lầm phổ biến đáng làm rõ: gói npm này không chạy bằng Node lúc bạn dùng. Nó tải về đúng binary gốc theo nền tảng dưới dạng optional dependency rồi liên kết thành lệnh claude. Node chỉ cần cho bước cài. Và tuyệt đối không chạy sudo npm install -g — tài liệu cảnh báo thẳng cách này gây lỗi phân quyền và rủi ro bảo mật.
Đăng nhập và xác thực lần đầu ra sao?
Sau khi cài, chạy claude rồi làm theo hướng dẫn mở trên trình duyệt. Quy trình sáu bước cho lần chạy đầu tiên:
- Mở terminal tại thư mục dự án:
cd /đường/dẫn/tới/dự-án. - Chạy
claude --version. Kết quả hợp lệ là một số phiên bản kèm chữ(Claude Code), ví dụ2.1.211 (Claude Code). - Chạy
claudeđể mở phiên tương tác. Lần đầu, Claude Code sẽ nhắc đăng nhập. - Hoàn tất đăng nhập trên trình duyệt. Nếu trình duyệt không tự mở, bấm phím
cđể sao chép đường dẫn OAuth rồi dán vào trình duyệt thủ công. - Gõ
/helpđể xem danh sách lệnh, hoặc thử ngay một câu nhưdự án này làm gì?để kiểm tra Claude đọc được mã nguồn. - Chạy
claude doctorkhi cần chẩn đoán: lệnh này in tình trạng cài đặt, lỗi cấu hình và cảnh báo kèm gợi ý sửa, mà không mở phiên làm việc.
Về loại tài khoản, Claude Code yêu cầu gói Pro, Max, Team, Enterprise hoặc tài khoản Claude Console. Gói Claude.ai miễn phí không bao gồm Claude Code. Ngoài ra bạn có thể dùng qua nhà cung cấp bên thứ ba như Amazon Bedrock, Google Cloud hoặc Microsoft Foundry. Nếu máy đã đặt biến môi trường ANTHROPIC_API_KEY, Claude Code sẽ hỏi bạn duyệt khóa đó thay vì mở trình duyệt.
Lỗi thường gặp và cách sửa
Phần lớn lỗi cài đặt không phải lỗi phần mềm mà là chạy nhầm lệnh của shell khác. Dưới đây là những trường hợp hay gặp nhất kèm cách xử lý.
| Thông báo lỗi | Nguyên nhân | Cách sửa |
|---|---|---|
'irm' is not recognized |
Bạn đang ở CMD chứ không phải PowerShell | Mở PowerShell rồi chạy lại, hoặc dùng lệnh cài dành cho CMD |
The token '&&' is not a valid statement separator |
Bạn đang ở PowerShell nhưng chạy lệnh của CMD | Chạy irm https://claude.ai/install.ps1 | iex |
A parameter cannot be found that matches parameter name 'fsSL' |
Chạy lệnh cài của macOS/Linux trong PowerShell, nơi curl là bí danh của Invoke-WebRequest |
Dùng trình cài đặt PowerShell |
command not found: claude |
Thư mục cài chưa nằm trong PATH | Thêm ~/.local/bin (macOS/Linux) hoặc %USERPROFILE%\.local\bin (Windows) vào PATH rồi mở terminal mới |
running scripts is disabled on this system |
Chính sách thực thi PowerShell chặn file .ps1 do npm tạo |
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser, hoặc gọi claude.cmd |
The process cannot access the file |
Lần cài trước còn chạy, hoặc phần mềm diệt virus đang quét file tải dở | Xóa thư mục %USERPROFILE%\.claude\downloads rồi cài lại |
Claude Code does not support 32-bit Windows |
Mở nhầm cửa sổ Windows PowerShell (x86) | Kiểm tra bằng [Environment]::Is64BitOperatingSystem; nếu ra True thì mở đúng Windows PowerShell không có hậu tố x86 |
cannot execute binary file: Exec format error trong WSL |
Bạn đang ở WSL 1, gặp lỗi tương thích binary gốc | Chuyển sang WSL 2 bằng wsl --set-version <TênDistro> 2 |
Vài trường hợp khác đáng biết. Nếu chạy claude mà mở ra ứng dụng Claude Desktop thay vì công cụ dòng lệnh, nguyên nhân là bản Desktop cũ đăng ký một Claude.exe trong thư mục WindowsApps được ưu tiên trong PATH — cập nhật Claude Desktop lên bản mới nhất là xong.
Trên máy chủ Linux cấu hình thấp, quá trình cài có thể bị hệ điều hành giết với thông báo Killed và mã thoát 137. Đây là cơ chế thu hồi bộ nhớ khi máy hết RAM trống; tài liệu cho biết cần khoảng 512 MB bộ nhớ trống để cài, nên hãy giải phóng RAM hoặc thêm swap rồi chạy lại.
Còn nếu bạn đăng nhập thành công nhưng gặp lỗi 403 Forbidden, hãy kiểm tra gói đăng ký còn hiệu lực; với tài khoản Console thì xác nhận tài khoản có vai trò “Claude Code” hoặc “Developer”. Trường hợp thấy thông báo tổ chức bị vô hiệu hóa dù gói vẫn còn hạn, thủ phạm thường là biến ANTHROPIC_API_KEY cũ còn sót trong profile shell đang lấn át thông tin đăng nhập của gói thuê bao — gỡ biến đó đi rồi chạy lại.
Riêng với người dùng ở Việt Nam, hai tình huống mạng cần lưu ý. Thứ nhất, nếu công ty bạn dùng proxy, hãy đặt HTTP_PROXY và HTTPS_PROXY trước khi chạy trình cài đặt, vì trình cài tải file từ downloads.claude.ai. Thứ hai, nhiều máy ở Việt Nam cài phần mềm diệt virus của bên thứ ba khóa file đang tải trong thư mục downloads — đây đúng là nguyên nhân của lỗi “process cannot access the file” nêu trên, nên tạm dừng quét thời gian thực trong lúc cài sẽ tiết kiệm cho bạn kha khá thời gian.
Làm sao biết đã cài thành công?
Ba dấu hiệu, kiểm theo thứ tự này:
claude --versionin ra số phiên bản kèm(Claude Code). Nếu báo không tìm thấy lệnh, vấn đề nằm ở PATH chứ không phải cài hỏng.claude doctorchạy trôi và không báo lỗi cấu hình. Lệnh này in chẩn đoán chỉ đọc gồm tình trạng cài đặt, lỗi file settings và cảnh báo kèm gợi ý.claudemở được phiên tương tác, hiển thị phiên bản, model đang dùng và thư mục làm việc phía trên dấu nhắc.
Về cập nhật: bản cài gốc tự kiểm tra và tải bản mới ở nền, áp dụng ở lần khởi động kế tiếp. Muốn cập nhật ngay thì chạy claude update. Nếu môi trường của bạn cần độ ổn định hơn tính mới, đặt kênh phát hành sang stable trong file settings — kênh này chậm hơn khoảng một tuần và bỏ qua các bản có lỗi lớn.
Câu hỏi thường gặp
Cài Claude Code có cần Node.js không?
Không, nếu bạn dùng trình cài đặt gốc, Homebrew hay WinGet — các cách này cài binary gốc. Chỉ bản cài qua npm mới cần Node.js, và kể từ bản 2.1.198 gói npm yêu cầu Node.js 22 trở lên.
Windows có bắt buộc dùng WSL không?
Không. Claude Code chạy được native trên Windows. WSL 2 chỉ cần khi bạn làm việc với toolchain Linux hoặc muốn dùng tính năng sandbox, vốn không hỗ trợ trên Windows native và WSL 1.
Gói Claude miễn phí dùng được Claude Code không?
Không. Tài liệu ghi rõ Claude Code cần tài khoản Pro, Max, Team, Enterprise hoặc Console; gói Claude.ai miễn phí không bao gồm quyền truy cập.
Đăng nhập qua SSH hoặc WSL2 mà trình duyệt không mở thì làm sao?
Trình duyệt thường mở trên máy khác nên đường dẫn quay về không tới được. Sau khi đăng nhập, trình duyệt hiển thị một mã đăng nhập — dán mã đó vào terminal ở chỗ được nhắc. Nếu dán không ăn, dùng claude auth login vì lệnh này đọc mã từ đầu vào chuẩn.
Cài xong rồi, nên làm gì tiếp?
Học cách ra lệnh cho hiệu quả. Chất lượng kết quả phụ thuộc vào cách bạn mô tả yêu cầu nhiều hơn là vào cấu hình máy — xem bài bộ khung viết prompt cho Claude Code.
Gỡ Claude Code thế nào cho sạch?
Gỡ theo đúng cách bạn đã cài: xóa binary và thư mục phiên bản với bản cài gốc, brew uninstall --cask với Homebrew, winget uninstall Anthropic.ClaudeCode với WinGet, npm uninstall -g @anthropic-ai/claude-code với npm. Lưu ý xóa thêm thư mục cấu hình sẽ mất toàn bộ settings, danh sách công cụ đã cho phép, cấu hình MCP server và lịch sử phiên.
Kết luận
Cài Claude Code thực chất chỉ là một dòng lệnh; phần tốn thời gian là chọn đúng lệnh cho đúng shell và xử lý PATH. Nếu bạn mới bắt đầu, cứ dùng trình cài đặt gốc và bỏ qua npm — ít việc phải bảo trì về sau nhất.
Chạy được rồi, bước kế tiếp là hiểu công cụ này làm được gì: đọc bài trụ Claude Code là gì? Hướng dẫn cài đặt và dùng từ A–Z, sau đó nối thêm dữ liệu ngoài qua MCP hoặc đóng gói quy trình riêng bằng Claude Skills. Nếu bạn không phải dân lập trình, bài Claude Code cho người không biết code là điểm vào nhẹ nhàng hơn.
Nguồn tham khảo
- Claude Code Docs — Advanced setup — yêu cầu hệ thống, mọi phương thức cài, bảng lựa chọn Windows native/WSL, cập nhật và gỡ cài đặt (truy cập 09/09/2026).
- Claude Code Docs — Quickstart — quy trình phiên đầu tiên, loại tài khoản được hỗ trợ, lệnh cơ bản.
- Claude Code Docs — Troubleshoot installation and login — bảng đối chiếu lỗi và cách sửa, vấn đề PATH, proxy, WSL, đăng nhập OAuth.
- Git for Windows — nguồn tải Git Bash được tài liệu Claude Code khuyến nghị cho Windows native.
- Node.js — Download — nguồn tải Node.js 22 trở lên cho phương án cài bằng npm.
- Anthropic — Supported countries — danh sách quốc gia được hỗ trợ, cần kiểm khi gặp thông báo chặn theo khu vực.
