Tóm tắt nhanh: Cài đặt Claude Code trên Windows yêu cầu thiết lập WSL2 (Windows Subsystem for Linux), cài đặt Ubuntu và chạy một tập lệnh cài đặt đơn giản. Quy trình này cho phép người dùng Windows truy cập trợ lý lập trình AI của Anthropic thông qua terminal của họ. Các tệp nhị phân gốc của Windows có sẵn, tuy nhiên WSL2 vẫn là phương pháp tốt nhất cho cài đặt trên Windows.
Claude Code là một trợ lý lập trình được hỗ trợ bởi AI hoạt động trực tiếp trong terminal, giúp các nhà phát triển xây dựng tính năng, sửa lỗi và tự động hóa các tác vụ phát triển. Nhưng có một điểm trừ đối với người dùng Windows.
Claude Code có sẵn dưới dạng tệp thực thi gốc của Windows và có thể được cài đặt qua npm hoặc tải xuống tệp nhị phân trực tiếp mà không cần WSL2. Tuy nhiên, nó yêu cầu Windows Subsystem for Linux (WSL2), và phương pháp cài đặt chính thức vẫn dựa vào WSL2.
Đây là cách để nó hoạt động trên Windows 11 hoặc Windows 10.
Yêu cầu hệ thống
Trước khi bắt đầu cài đặt, hãy xác minh máy Windows đáp ứng các yêu cầu sau:
- Windows 10 1809 trở lên hoặc Windows Server 2019 trở lên
- Windows 11 (bất kỳ phiên bản nào)
- Ít nhất 4GB RAM khả dụng
- Quyền quản trị trên hệ thống
- Kết nối Internet để tải xuống WSL2 và Ubuntu
Việc cài đặt yêu cầu dung lượng đĩa cho WSL2, Ubuntu và Claude Code.
Bước 1: Bật Windows Subsystem for Linux
WSL2 cung cấp một môi trường Linux trực tiếp trong Windows. Đây là nền tảng cho phép Claude Code hoạt động.
Mở PowerShell với quyền Quản trị viên. Nhấp chuột phải vào nút Start và chọn “Windows PowerShell (Admin)” hoặc “Terminal (Admin)” trên Windows 11.
Chạy lệnh này:
wsl –install
Lệnh này bật các tính năng Windows cần thiết và cài đặt Ubuntu làm bản phân phối Linux mặc định. Hệ thống có thể sẽ yêu cầu khởi động lại.
Sau khi khởi động lại, WSL2 sẽ hoàn tất thiết lập tự động. Ubuntu sẽ khởi chạy và yêu cầu tên người dùng và mật khẩu. Thông tin đăng nhập này chỉ dành cho môi trường Linux—chúng không cần khớp với thông tin đăng nhập Windows.
Bước 2: Xác minh cài đặt WSL2
Sau khi hệ thống khởi động lại và Ubuntu hoàn tất thiết lập ban đầu, hãy xác minh WSL2 đang hoạt động chính xác.
Mở terminal Ubuntu (tìm kiếm “Ubuntu” trong menu Start) và chạy:
wsl –version
Thao tác này sẽ hiển thị thông tin phiên bản WSL. Tìm kiếm “WSL version: 2.x.x” trong kết quả.
Nếu lệnh hiển thị WSL1 thay vào đó, hãy nâng cấp lên WSL2 bằng lệnh:
wsl –set-default-version 2
Bước 3: Cài đặt Claude Code
Bây giờ là phần cài đặt Claude Code thực tế. Tài liệu chính thức cung cấp một tập lệnh cài đặt một dòng.
Trong terminal Ubuntu, chạy:
curl -fsSL claude.ai/install.sh | bash
Tập lệnh sẽ tải xuống tệp nhị phân Claude Code, thiết lập các quyền cần thiết và thêm nó vào PATH của hệ thống. Thời gian cài đặt sẽ khác nhau tùy thuộc vào tốc độ internet và thông số kỹ thuật của hệ thống.
Theo tài liệu chính thức của Claude Code, trình cài đặt sẽ tự động phát hiện kiến trúc hệ thống và tải xuống phiên bản tệp nhị phân phù hợp.
Các sự cố cài đặt thường gặp
Một số người dùng Windows báo cáo gặp lỗi “command not found: claude” sau khi cài đặt. Điều này thường xảy ra do biến PATH chưa được làm mới.
Đóng và mở lại terminal Ubuntu, sau đó thử lại. Nếu sự cố vẫn tiếp diễn, cấu hình đường dẫn này có thể giúp khắc phục dưới dạng giải pháp tạm thời không chính thức:
echo ‘export PATH=”$HOME/.claude/bin:$PATH”’ >> ~/.bashrc
source ~/.bashrc
Bước 4: Xác thực Claude Code
Claude Code yêu cầu xác thực bằng tài khoản Anthropic trước khi sử dụng.
Chạy lệnh này:
claude
Terminal sẽ hiển thị một URL và yêu cầu xác thực. Quy trình sẽ hơi khác một chút đối với người dùng cá nhân so với tài khoản nhóm:
| Loại tài khoản | Phương thức xác thực | Những gì được yêu cầu |
|---|---|---|
| Cá nhân | Khóa API cá nhân | Tài khoản Anthropic có quyền truy cập API |
| Nhóm/Tổ chức | Mã thông báo tổ chức | Mã thông báo xác thực do quản trị viên cung cấp |
Mở URL được cung cấp trong trình duyệt, đăng nhập vào tài khoản Anthropic và cấp quyền cho Claude Code. Terminal sẽ xác nhận xác thực thành công.
Làm việc với các dự án Windows trong WSL2
Đây là lúc mọi thứ trở nên phức tạp. Hệ thống tệp của Windows và hệ thống tệp của WSL2 là riêng biệt.
Các tệp Windows có thể truy cập được từ WSL2 tại /mnt/c/ (cho ổ C:), /mnt/d/ (cho ổ D:) trở đi. Nhưng có một chi phí hiệu suất. Các cuộc thảo luận cộng đồng chỉ ra sự khác biệt về hiệu suất giữa các thư mục được gắn trên Windows và các thư mục gốc của WSL2.
Để có hiệu suất tốt nhất, hãy sao chép các tệp dự án vào thư mục chính của WSL2:
cp -r /mnt/c/Users/YourName/Projects/your-project ~/projects/your-project
Sự đánh đổi? Tích hợp IDE trở nên phức tạp hơn. Visual Studio Code xử lý điều này tốt với tiện ích mở rộng Remote-WSL của nó, nhưng các IDE khác có thể gặp khó khăn.
Kiểm tra cài đặt
Xác minh Claude Code hoạt động chính xác với một bài kiểm tra đơn giản.
Điều hướng đến thư mục dự án (hoặc tạo một thư mục kiểm tra):
mkdir ~/claude-test
cd ~/claude-test
claude “tạo một tập lệnh Python hello world đơn giản”
Claude Code sẽ phản hồi, tạo tệp và hiển thị mã. Điều này xác nhận cài đặt đã thành công.
Ngừng trả phí quá cao, hãy nhận các khoản tín dụng AI có sẵn trước
Việc cài đặt Claude Code trên Windows thường nhanh chóng. Chi phí thực sự xuất hiện sau này khi các nhà phát triển bắt đầu thử nghiệm các lời nhắc, chạy tập lệnh và tích hợp mô hình vào các ứng dụng. Giai đoạn thử nghiệm đó có thể tạo ra nhiều lệnh gọi API, và nhiều nhóm chỉ nhận ra chi phí sau khi họ bắt đầu xây dựng.
Trước khi chi tiền cho việc sử dụng, bạn nên kiểm tra xem bạn có đủ điều kiện nhận tín dụng AI hoặc các chương trình đối tác hay không. Get AI Perks thu thập các cơ hội này ở một nơi, liệt kê các khoản tín dụng và giảm giá từ các nhà cung cấp AI, nền tảng đám mây và công cụ dành cho nhà phát triển, cùng với các hướng dẫn đơn giản về cách yêu cầu chúng.
Trước khi bạn chạy dự án Claude Code đầu tiên, hãy kiểm tra Get AI Perks và yêu cầu các khoản tín dụng AI có thể chi trả chi phí phát triển của bạn.
Câu hỏi thường gặp
Claude Code có thể chạy gốc trên Windows mà không cần WSL2 không?
Có, nhưng WSL2 vẫn là phương pháp cài đặt tốt nhất cho Windows.
Claude Code có hoạt động với Windows Terminal không?
Có. Windows Terminal có thể mở các tab Ubuntu, cho phép truy cập Claude Code mà không cần chuyển sang cửa sổ Ubuntu riêng biệt. Trong Windows Terminal, nhấp vào mũi tên thả xuống và chọn Ubuntu từ danh sách cấu hình.
Các công cụ phát triển Windows hiện có của tôi có hoạt động với Claude Code không?
Điều đó tùy thuộc vào công cụ. Visual Studio Code tích hợp tốt thông qua tiện ích mở rộng Remote-WSL. JetBrains IDE và các công cụ khác có thể yêu cầu cấu hình bổ sung. Tài liệu chính thức đề cập đến VS Code và JetBrains là các nền tảng được hỗ trợ.
Làm thế nào để cập nhật Claude Code trên Windows?
Claude Code tự động cập nhật theo mặc định. Để cập nhật thủ công, hãy chạy `claude update` trong terminal Ubuntu. Tính năng tự động cập nhật có thể bị vô hiệu hóa thông qua các tệp cấu hình nếu cần cho môi trường doanh nghiệp.
Sự khác biệt giữa Claude Code và Claude API là gì?
Claude Code là một trợ lý lập trình dựa trên terminal thực thi lệnh và chỉnh sửa tệp. Claude API cung cấp quyền truy cập theo chương trình vào mô hình ngôn ngữ của Claude để xây dựng các ứng dụng tùy chỉnh. Chúng phục vụ các mục đích khác nhau và yêu cầu các quy trình thiết lập khác nhau.
Tôi có thể sử dụng Claude Code với các dự án .NET trên Windows không?
Có, nhưng có những lưu ý. Các cuộc thảo luận cộng đồng chỉ ra rằng hỗ trợ .NET SDK trong WSL2 hoạt động, nhưng yêu cầu cài đặt phiên bản Linux của .NET SDK trong Ubuntu. .NET được cài đặt trên Windows sẽ không thể truy cập được từ WSL2.
Claude Code có giá bao nhiêu?
Giá cả phụ thuộc vào mức sử dụng và loại tài khoản. Kiểm tra trang web chính thức của Anthropic để biết các bậc giá hiện tại và gói dành cho nhóm, vì chi phí sẽ khác nhau dựa trên mức tiêu thụ API và yêu cầu của tổ chức.
Các bước tiếp theo sau khi cài đặt
Sau khi cài đặt Claude Code, hãy bắt đầu khám phá khả năng của nó. Tài liệu hướng dẫn nhanh đề xuất bắt đầu với các tác vụ đơn giản như giải thích mã trước khi chuyển sang các hoạt động phức tạp hơn.
Thử các lệnh sau để làm quen:
- claude “giải thích hàm này” – Nhận giải thích mã
- claude commit – Tạo thông báo commit Git
- claude -c – Tiếp tục cuộc trò chuyện gần đây nhất
Tài liệu chính thức cung cấp các hướng dẫn chi tiết về tích hợp IDE, cài đặt plugin và các tùy chọn cấu hình nâng cao. Đối với các nhóm, cài đặt được quản lý trên máy chủ và theo dõi phân tích cung cấp thêm quyền kiểm soát việc triển khai Claude Code.
Thiết lập WSL2 có vẻ tốn thêm các bước so với các ứng dụng Windows gốc, nhưng đây hiện là con đường duy nhất để chạy Claude Code trên Windows. Tin tốt? Sau khi cấu hình, nó hoạt động trơn tru và tích hợp với hầu hết các quy trình làm việc phát triển.
