Tải xuống Claude Code và cài đặt trên Windows: Cách chọn Desktop App, CLI, WSL (2026)

Khi tìm kiếm Claude Code download, cái bẫy dễ mắc phải nhất không phải là tải xuống thất bại, mà là chưa xác định rõ mình cần cài đặt cái nào trước:

• Nếu bạn muốn giao diện đồ họa, quản lý nhiều tác vụ song song, hãy tải Claude Desktop, vào tab Code trong đó;
• Nếu muốn gõ claude trong PowerShell, CMD, Git Bash hoặc terminal IDE, hãy cài Claude Code CLI;
• Nếu dự án và chuỗi công cụ chủ yếu chạy trên Linux, hoặc cần sandbox, hãy cài đặt vào WSL 2;
• Desktop và CLI có thể cài đồng thời, không phải là các lựa chọn loại trừ lẫn nhau.

Bài viết này được tổng hợp theo tài liệu chính thức tháng 8 năm 2026. Trang tải xuống chính thức chỉ công nhận hai cổng sau:

• Trang tải xuống chính thức của Claude
• Tài liệu cài đặt chính thức của Claude Code

Đừng tải xuống cái gọi là "gói cài đặt Claude Code" từ dịch vụ lưu trữ đám mây, trang tải phần mềm hoặc GitHub Release lạ.

Xem kết luận trước: Cách chọn Claude Code Desktop, CLI, WSL

Cách xác định đơn giản nhất:

• Lần đầu tiếp xúc với Claude Code, hãy cài Desktop trước;
• Nếu đã quen với terminal, hãy cài thẳng CLI;
• Nếu môi trường phát triển vốn đã ở trong WSL, đừng lằng nhằng qua hệ thống tệp, hãy cài thẳng vào WSL 2.

Tải xuống và cài đặt Claude Code Desktop App

Phiên bản desktop của Claude Code không phải là một sản phẩm độc lập tên là "Claude Code.exe". Nó nằm trong tab Code của ứng dụng Claude Desktop.

Bước 1: Chọn phiên bản từ trang tải xuống chính thức

Mở claude.com/download, người dùng Windows chọn theo bộ xử lý:

• Hầu hết máy tính Intel / AMD: tải Windows x64;
• Thiết bị Windows on ARM: tải Windows ARM64.

Sau khi cài đặt, khởi động Claude từ menu Start, đăng nhập tài khoản Anthropic, rồi nhấp vào Code ở phía trên.

Bước 2: Chọn môi trường chạy

Khi tạo phiên Code mới, phiên bản desktop thường cung cấp ba môi trường:

• Local: đọc và sửa trực tiếp các dự án trên máy tính này;
• Remote: chạy trong môi trường đám mây của Anthropic;
• SSH: kết nối đến máy Linux hoặc macOS từ xa do bạn quản lý.

Nếu bạn chỉ muốn Claude sửa đổi dự án trên máy, chọn Local, rồi chọn thư mục dự án là được. Phiên cục bộ trên Windows cần Git, khuyến nghị cài đặt Git for Windows trước.

Phiên bản Desktop phù hợp với những ai

Ưu điểm của Desktop không phải là "nhét terminal vào cửa sổ", mà là đặt nhiều phiên, trình soạn thảo tệp, terminal, đánh giá Diff, xem trước ứng dụng và trạng thái PR trong cùng một giao diện. Bạn có thể chạy song song nhiều Agent mà không cần chuyển qua lại giữa các tab terminal.

Nhưng nếu bạn cần khởi động bằng kịch bản, làm việc trong terminal hiện có, thường xuyên sử dụng slash command, thì CLI thường trực tiếp hơn.

Claude Code Desktop yêu cầu gói Pro, Max, Team hoặc Enterprise. Nếu chỉ cài đặt ứng dụng mà không thấy Code, hãy kiểm tra tài khoản đã đăng nhập và quyền đăng ký.

Claude Code CLI: Cài đặt gốc trên Windows

Hiện tại bộ cài đặt gốc được nhà phát hành khuyến nghị, không còn yêu cầu cài đặt Node.js toàn cục trước cho Claude Code nữa.

Cách 1: Cài đặt bằng PowerShell (khuyến nghị)

Mở PowerShell, chạy:

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

Sau khi cài đặt xong, đóng và mở lại terminal, rồi xác minh:

claude --version
claude

Lần đầu chạy claude sẽ hướng dẫn bạn đăng nhập. Sau khi vào thư mục dự án rồi mới khởi động, nó mới có thể đọc mã từ đúng thư mục làm việc:

cd D:\Projects\my-app
claude

Cách 2: Cài đặt bằng WinGet

Nếu bạn quen dùng trình quản lý gói Windows:

winget install Anthropic.ClaudeCode

Phiên bản WinGet sẽ không tự động cập nhật nền như bộ cài đặt gốc, sau này cần thực hiện thủ công:

winget upgrade Anthropic.ClaudeCode

Cách 3: Cài đặt bằng CMD

Nếu dấu nhắc của bạn là C:\Users\...>, không có PS phía trước, nghĩa là bạn đang dùng CMD. Chạy:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Lệnh PowerShell và CMD không thể dùng lẫn lộn. Nhiều trường hợp "tập lệnh cài đặt báo lỗi cú pháp" thực chất chỉ là dán lệnh CMD vào PowerShell, hoặc ngược lại.

Claude Code Windows: Bản gốc hay WSL 2

Claude Code đã hỗ trợ Windows gốc, không còn là "Windows bắt buộc phải cài WSL". Nhưng mỗi môi trường đều có sự đánh đổi.

Chọn Windows gốc nếu bạn:

• Dự án nằm ở C:\ hoặc D:\;
• Phụ thuộc vào các công cụ gốc như Visual Studio, PowerShell, Windows SDK;
• Muốn cài đặt đơn giản nhất;
• Không cần sandbox của Claude Code.

Ở chế độ gốc, khuyến nghị cài đặt Git for Windows. Claude Code sẽ ưu tiên dùng Git Bash để thực thi các công cụ Bash; nếu không có Git Bash, cũng có thể dùng công cụ PowerShell.

Chọn WSL 2 nếu bạn:

• Dự án chủ yếu dùng Linux, Docker, Node/Python và chuỗi công cụ phía máy chủ;
• Cần sandbox;
• Môi trường triển khai là Linux;
• Đã phát triển lâu dài trên terminal WSL.

Sau khi vào WSL 2, chạy lệnh cài đặt Linux:

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

Sau đó xác minh trong WSL:

claude --version
claude

Đừng lúc thì khởi động từ Windows PowerShell, lúc thì khởi động từ WSL, lại mong đường dẫn, Git, biến môi trường ở hai bên hoàn toàn giống nhau. Dự án ở môi trường nào, hãy cài đặt và chạy Claude Code trong môi trường đó.

Sự khác biệt giữa Claude Code Desktop App và CLI

Một tổ hợp thực dụng là: thường ngày dùng Desktop để xem nhiều phiên và Diff, khi cần tự động hóa hoặc ngữ cảnh terminal thì dùng CLI. Việc có cài CLI hay không không ảnh hưởng đến hoạt động bình thường của tab Code trong Desktop.

Các lỗi thường gặp khi cài đặt trên Windows

1. `The token '&&' is not a valid statement separator`

Bạn đã dán lệnh CMD vào PowerShell. Quay lại cách dùng PowerShell ở trên, sử dụng:

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

2. `'irm' is not recognized`

Bạn hiện đang dùng CMD, không phải PowerShell. Mở Windows PowerShell, hoặc chuyển sang dùng lệnh cài đặt CMD.

3. `claude` không phải là lệnh nội bộ hay lệnh bên ngoài

Trước tiên hãy đóng và mở lại terminal. Nếu vẫn không tìm thấy, kiểm tra xem %USERPROFILE%\.local\bin có trong PATH không, rồi chạy:

Get-Command claude

Cũng có thể chạy chẩn đoán chính thức:

claude doctor

4. Không tìm thấy Git Bash

Cài đặt Git for Windows; nếu cài trong thư mục tùy chỉnh, có thể chỉ định trong cài đặt Claude Code:

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

5. Không có tab Code trong Desktop, hoặc xuất hiện lỗi 403

Kiểm tra lần lượt:

1. Tài khoản hiện đang đăng nhập có phải là tài khoản đã mua gói Claude không;
2. Claude Desktop đã được cập nhật lên phiên bản mới nhất chưa;
3. Đăng xuất tài khoản, khởi động lại ứng dụng rồi đăng nhập lại;
4. Tài khoản nhóm có bị quản trị viên giới hạn Claude Code hay không.

Sau khi cài đặt, làm thế nào để tiếp tục Claude Code từ điện thoại hoặc trình duyệt

Cài đặt giải quyết "Claude Code chạy ở đâu", điều khiển từ xa giải quyết "làm thế nào để tiếp tục khi không ở trước máy tính".

Anthropic đã cung cấp các phương thức chính thức như Desktop, Web, Remote Control và Dispatch trên điện thoại. Nếu bạn chỉ sử dụng tài khoản Claude chính thức và mô hình chính thức, thường nên ưu tiên thử các tính năng này.

Nếu bạn còn cần các tình huống sau, có thể cân nhắc PandaNpc:

• Điều khiển từ xa Claude Code, OpenAI Codex và PandaCode trong cùng một giao diện;
• Agent tiếp tục chạy trên máy phát triển Windows / macOS / Linux của bạn;
• Sử dụng mô hình tùy chỉnh hoặc API endpoint của riêng bạn;
• Tiếp tục cùng một phiên từ iPhone, bất kỳ trình duyệt nào, một máy tính để bàn khác hoặc thanh bên Chrome;
• Xem từ xa đầu ra phát trực tiếp (streaming output), phê duyệt lời gọi công cụ, trả lời câu hỏi và xem thay đổi mã;
• Không mở cổng công cộng, máy phát triển và máy điều khiển chỉ thiết lập kết nối ra ngoài (outbound).

Trước tiên hãy xác nhận Claude Code chính thức đã chạy bình thường, rồi cài đặt pandapaw trên máy phát triển:

Windows PowerShell:

iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

macOS / Linux:

curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh

Sau khi cài đặt, mở PandaNpc Agent, các kết nối trên máy phát triển sẽ xuất hiện trong danh sách. Bạn cũng có thể sử dụng ứng dụng khách Windows / macOS / Linux hoặc ứng dụng iOS.

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

Claude Code là phần mềm desktop hay công cụ dòng lệnh?

Cả hai đều đúng. Tab Code trong Claude Desktop cung cấp giao diện đồ họa; Claude Code CLI thì khởi động từ terminal. Chúng phục vụ các quy trình làm việc khác nhau và có thể cài đặt đồng thời.

Claude Code trên Windows có bắt buộc dùng WSL không?

Không bắt buộc. Windows gốc đã được hỗ trợ. Dự án Windows nên ưu tiên cài đặt gốc; chỉ chọn WSL 2 khi dùng chuỗi công cụ Linux hoặc cần sandbox.

Claude Code download có cần Node.js không?

Desktop không cần. Bộ cài đặt CLI gốc chính thức cũng không cần. Chỉ khi vẫn dùng cách cũ npm install -g @anthropic-ai/claude-code thì mới cần Node.js.

Claude Code có phiên bản Windows ARM64 không?

Trang tải xuống chính thức của Claude Desktop cung cấp gói cài đặt Windows ARM64. Đối với CLI, hãy dựa trên nền tảng mà tập lệnh cài đặt chính thức hiện nhận diện.

Claude Code Desktop hỗ trợ Linux không?

Trải nghiệm Code trên desktop của Claude Code hiện hướng đến macOS và Windows. Người dùng Linux sử dụng CLI, hoặc thao tác phiên chạy trên Linux qua Web / ứng dụng khách từ xa.

Desktop và CLI cái nào tốt hơn?

Không có câu trả lời tuyệt đối. Muốn trực quan, nhiều phiên, Diff và xem trước, hãy chọn Desktop; muốn hiệu quả trên terminal, viết kịch bản và chuỗi công cụ phát triển hiện có, hãy chọn CLI; nhu cầu môi trường Linux và sandbox thì ưu tiên WSL 2.

Tóm tắt một câu

Chỉ muốn bắt đầu nhanh: cài Desktop từ trang tải xuống chính thức của Claude, mở tab Code.

Muốn dùng trong terminal Windows: chạy trong PowerShell:

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

Dự án nằm trong chuỗi công cụ Linux: vào WSL 2, chạy:

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

Trước tiên hãy cài đặt Claude Code chính thức cho đúng, rồi mới quyết định có cần dùng đồng thời Desktop, CLI hay không, cũng như có cần dùng PandaNpc để tiếp tục phiên từ xa từ điện thoại, trình duyệt hoặc máy tính khác hay không.