Tóm tắt nhanh: Claude Code có thể được cài đặt thông qua trình cài đặt gốc trên macOS, Windows và Linux từ trang web chính thức của Claude Code. Người dùng Windows phải cài đặt WSL2 trước khi chạy Claude Code. Sau khi cài đặt, hãy xác thực bằng tài khoản Claude của bạn khi Claude Code mở cửa sổ trình duyệt để bạn đăng nhập khi khởi chạy lần đầu để bắt đầu viết mã với sự hỗ trợ của AI trực tiếp từ thiết bị đầu cuối hoặc ứng dụng dành cho máy tính để bàn của bạn.
Claude Code đại diện cho sự thúc đẩy của Anthropic vào các công cụ phát triển AI agentic. Trợ lý dòng lệnh này đọc mã nguồn, chỉnh sửa tệp, chạy lệnh và tích hợp với quy trình làm việc phát triển.
Nhưng việc cài đặt nó không phải lúc nào cũng dễ dàng. Các nền tảng khác nhau yêu cầu các phương pháp tiếp cận khác nhau. Windows cần thiết lập bổ sung. Và tài liệu, mặc dù toàn diện, có thể làm cho người mới bắt đầu bị choáng ngợp.
Hướng dẫn này giúp bạn vượt qua sự phức tạp. Nó bao gồm các yêu cầu hệ thống, các bước cài đặt dành riêng cho nền tảng, xác thực và xác minh—tất cả những gì cần thiết để Claude Code hoạt động đúng cách.
Yêu cầu hệ thống trước khi cài đặt
Theo tài liệu chính thức của Claude Code, công cụ này hỗ trợ macOS, Windows và Linux. Tuy nhiên, mỗi nền tảng có các điều kiện tiên quyết cụ thể.
Đối với macOS, các yêu cầu là tối thiểu. Hệ thống cần macOS 13.0 trở lên. Cả chip Intel và Apple Silicon đều hoạt động tốt.
Windows có nhiều phức tạp hơn. Hệ điều hành phải là Windows 10 Build 19041 trở lên hoặc Windows 11. Nhưng đây là điểm mấu chốt—Claude Code không chạy gốc trên Windows.
Windows Subsystem for Linux 2 (WSL2) là bắt buộc. Điều này tạo ra một môi trường Linux nơi Claude Code thực sự hoạt động. Nếu không có WSL2, quá trình cài đặt sẽ thất bại.
Người dùng Linux cần một bản phân phối 64-bit. Tài liệu chính thức xác nhận hỗ trợ cho Ubuntu, Debian, Fedora và các bản phân phối lớn khác. Alpine Linux và các hệ thống dựa trên musl yêu cầu cấu hình bổ sung.
Tất cả các nền tảng đều cần kết nối internet ổn định trong quá trình cài đặt. Kích thước tải xuống khác nhau nhưng thường dao động từ 50MB đến 500MB tùy thuộc vào những gì đã được cài đặt.
| Nền tảng | Phiên bản tối thiểu | Yêu cầu đặc biệt |
|---|---|---|
| macOS | 13.0 | Không có |
| Windows | 10 Build 19041 hoặc 11 | Yêu cầu WSL2 |
| Linux | Bản phân phối 64-bit | Ưu tiên dựa trên glibc |
Cài đặt Claude Code trên macOS
Quy trình cài đặt macOS sử dụng trình cài đặt gốc. Đây là con đường đơn giản nhất trong tất cả các nền tảng.
Đầu tiên, tải xuống trình cài đặt từ trang web chính thức của Claude Code. Trang tải xuống tự động phát hiện macOS và cung cấp gói phù hợp.
Mở tệp .dmg đã tải xuống. Kéo ứng dụng Claude Code vào thư mục Ứng dụng. Cài đặt macOS tiêu chuẩn—không có gì bất thường ở đây.
Một số người dùng gặp phải cảnh báo bảo mật khi khởi chạy lần đầu. macOS chặn các ứng dụng từ nhà phát triển không xác định theo mặc định. Nhấp chuột phải vào ứng dụng Claude Code và chọn "Mở" để bỏ qua cảnh báo một lần này.
Công cụ dòng lệnh được cài đặt tự động cùng với ứng dụng dành cho máy tính. Mở Terminal và gõ `claude --version` để xác minh. Nếu số phiên bản xuất hiện, quá trình cài đặt đã thành công.
Xác minh cài đặt macOS
Chạy các lệnh sau để xác nhận mọi thứ hoạt động:
| `claude --version` `claude --help` |
Cả hai lệnh đều nên trả về kết quả mà không có lỗi. Lệnh phiên bản hiển thị phiên bản Claude Code đã cài đặt. Lệnh trợ giúp hiển thị các tùy chọn và lệnh khả dụng.
Tạo một thư mục thử nghiệm giúp xác minh đầy đủ chức năng. Điều hướng đến một thư mục dự án và chạy `claude` để bắt đầu phiên tương tác. Công cụ sẽ khởi tạo và nhắc xác thực nếu chưa đăng nhập.
Cài đặt Windows với WSL2
Cài đặt Windows yêu cầu nhiều bước. Quy trình này mất nhiều thời gian hơn macOS nhưng vẫn có thể quản lý được.
WSL2 phải được cài đặt trước. Mở PowerShell với quyền Quản trị viên và chạy:
| `wsl --install` |
Lệnh này cài đặt WSL2 và Ubuntu theo mặc định. Hệ thống sẽ yêu cầu khởi động lại. Sau khi khởi động lại, Ubuntu sẽ tự động khởi chạy để hoàn tất thiết lập ban đầu.
Tạo tên người dùng và mật khẩu Unix khi được nhắc. Các thông tin đăng nhập này tách biệt với thông tin đăng nhập Windows.
Khi WSL2 đang chạy, quy trình cài đặt Linux sẽ được áp dụng. Mở terminal Ubuntu (đã cài đặt với WSL2) và tải xuống trình cài đặt Claude Code cho Linux.
Cài đặt Claude Code trong WSL2
Theo tài liệu chính thức, lệnh cài đặt tải xuống và chạy trình cài đặt gốc:
| `curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash` |
Tệp script này xử lý các phụ thuộc một cách tự động. Nó cài đặt Node.js nếu cần, thiết lập tệp nhị phân Claude Code và cấu hình biến PATH.
Quá trình cài đặt mất vài phút. Thanh tiến trình và thông báo trạng thái cho biết những gì đang xảy ra. Khi hoàn tất, hãy đóng và mở lại terminal để làm mới các biến môi trường.
Kiểm tra cài đặt tuân theo cùng một quy trình như macOS. Chạy `claude --version` để xác minh.
Quy trình cài đặt Linux
Người dùng Linux có con đường cài đặt đơn giản nhất. Trình cài đặt gốc hoạt động trực tiếp mà không cần thêm các lớp như WSL2.
Tải xuống và chạy tệp script cài đặt:
| `curl -fsSL claude.ai/install.sh | bash` |
Điều này tải xuống tệp nhị phân Claude Code, cài đặt các phụ thuộc và cấu hình môi trường shell. Tệp script phát hiện bản phân phối và điều chỉnh cho phù hợp.
Đối với các hệ thống dựa trên Ubuntu và Debian, tệp script sẽ cấu hình cài đặt. Tài liệu chính thức xác nhận hỗ trợ cho Ubuntu 20.04+, Debian 10+, và các bản phân phối khác.
Cân nhắc về Alpine Linux
Alpine Linux và các bản phân phối dựa trên musl cần các bước bổ sung. Tài liệu chính thức ghi nhận rằng các hệ thống này yêu cầu cấu hình thủ công.
Trình cài đặt tiêu chuẩn có thể thất bại trên Alpine. Thay vào đó, hãy tải xuống tệp nhị phân tương thích với musl trực tiếp từ trang phát hành. Giải nén nó vào một thư mục trong PATH của hệ thống, thường là `/usr/local/bin`.
Đặt quyền thực thi:
| `chmod +x /usr/local/bin/claude` |
Người dùng Alpine nên xác minh khả năng tương thích trước khi tiếp tục. Một số tính năng có thể không hoạt động giống hệt như trên các bản phân phối dựa trên glibc.
Xác thực và Thiết lập Tài khoản
Sau khi cài đặt Claude Code, hãy chạy `claude` trong terminal của bạn. Khi khởi chạy lần đầu, Claude Code sẽ mở một cửa sổ trình duyệt để bạn đăng nhập.
Điều này sẽ mở trang xác thực Claude. Đăng nhập bằng tài khoản Claude hiện có hoặc tạo tài khoản mới.
Trình duyệt sẽ hiển thị một mã ủy quyền. Sao chép mã này và quay lại terminal. Dán mã khi được nhắc.
Xác thực thành công sẽ lưu trữ thông tin đăng nhập cục bộ. Các phiên tiếp theo sẽ không yêu cầu đăng nhập trừ khi thông tin đăng nhập hết hạn hoặc bị xóa thủ công.
Xác thực Nhóm và Doanh nghiệp
Theo tài liệu xác thực chính thức, các nhóm sử dụng Claude for Teams hoặc Enterprise có các tùy chọn bổ sung. Tổ chức có thể cấu hình đăng nhập một lần (SSO) hoặc xác thực nhà cung cấp đám mây.
Thiết lập SSO yêu cầu cấu hình quản trị viên. Sau đó, các nhà phát triển cá nhân sẽ xác thực thông qua nhà cung cấp danh tính của tổ chức thay vì tài khoản Claude cá nhân.
Xác thực nhà cung cấp đám mây hoạt động cho các triển khai AWS, Google Cloud và Azure. Phương pháp này sử dụng thông tin đăng nhập đám mây hiện có thay vì tài khoản Claude riêng biệt.
| Phương thức xác thực | Trường hợp sử dụng | Độ phức tạp thiết lập |
|---|---|---|
| Tài khoản cá nhân | Các nhà phát triển cá nhân | Đơn giản |
| SSO cho Nhóm/Doanh nghiệp | Các tổ chức | Yêu cầu quản trị viên |
| Nhà cung cấp đám mây | Người dùng AWS/GCP/Azure | Trung bình |
Cài đặt ứng dụng dành cho máy tính
Claude Code cung cấp cả ứng dụng dòng lệnh và ứng dụng dành cho máy tính. Ứng dụng dành cho máy tính cung cấp giao diện đồ họa đồng thời duy trì chức năng terminal đầy đủ.
Tải xuống trình cài đặt dành cho máy tính từ trang web chính thức của Claude. Trang web cung cấp các phiên bản macOS, Windows và Windows ARM64. Chọn phiên bản phù hợp cho hệ thống.
Việc cài đặt macOS tuân theo quy trình .dmg tương tự như đã mô tả trước đó. Người dùng Windows có thể tải xuống ứng dụng dành cho máy tính để có giao diện đồ họa mà không yêu cầu thiết lập WSL2.
Ứng dụng dành cho máy tính bao gồm quyền truy cập terminal tích hợp. Nó có thể khởi chạy các phiên Claude Code mà không cần chuyển sang các ứng dụng terminal bên ngoài.
Một ưu điểm của ứng dụng dành cho máy tính là tính khả dụng nền. Theo trang tải xuống chính thức, ứng dụng "luôn sẵn sàng ở chế độ nền" và có thể được mở từ bất kỳ ứng dụng nào mà không cần chuyển đổi cửa sổ hoặc mất tập trung.
Sử dụng Get AI Perks để tìm các khoản tín dụng cho bộ công cụ Claude Code của bạn
Cài đặt là phần dễ dàng. Chi phí thực sự thường đến từ mọi thứ xung quanh nó: cơ sở hạ tầng, các công cụ hỗ trợ và các dịch vụ trả phí được sử dụng trong quá trình thiết lập và thử nghiệm. Get AI Perks có thể giúp bằng cách liệt kê các khoản tín dụng và giảm giá dành cho các công ty khởi nghiệp ở một nơi, cùng với hướng dẫn về cách áp dụng.
Với Get AI Perks, bạn có thể:
- Tìm các khoản tín dụng cho các công cụ đám mây và AI
- Kiểm tra điều kiện ưu đãi trước khi áp dụng
- Tránh lãng phí thời gian vào các ưu đãi mà bạn có thể không đủ điều kiện
- Giảm chi phí thiết lập của bạn
Truy cập Get AI Perks để xem liệu các ưu đãi có sẵn có phù hợp với các công cụ bạn dự định sử dụng với Claude Code hay không.
Tiện ích mở rộng IDE và Tích hợp
Ngoài cài đặt độc lập, Claude Code còn tích hợp với các môi trường phát triển phổ biến. Có các tiện ích mở rộng cho Visual Studio Code và IDE JetBrains.
Tiện ích mở rộng VS Code được cài đặt thông qua thị trường. Tìm kiếm "Claude Code" trong bảng Tiện ích mở rộng và nhấp vào Cài đặt. Tiện ích mở rộng yêu cầu công cụ dòng lệnh phải được cài đặt trước.
Một số người dùng báo cáo sự cố với tệp tiện ích mở rộng VS Code được đóng gói. Nếu cài đặt tự động thất bại với lỗi "Không tìm thấy chữ ký bản ghi cuối cùng của thư mục trung tâm", tệp .vsix được đóng gói có thể bị hỏng.
Giải pháp thay thế bao gồm cài đặt tiện ích mở rộng thủ công từ thị trường VS Code thay vì dựa vào phiên bản được đóng gói của CLI. Điều này tách hai thành phần và ngăn chặn xung đột cài đặt.
Tích hợp JetBrains hoạt động tương tự. Cài đặt plugin từ thị trường JetBrains trong IntelliJ IDEA, PyCharm, WebStorm hoặc các sản phẩm JetBrains khác.
Xác minh cài đặt thành công
Xác minh đúng cách đảm bảo Claude Code hoạt động chính xác trước khi bắt đầu các tác vụ phát triển thực tế.
Các kiểm tra xác minh cơ bản về tính khả dụng của lệnh:
| `claude --help` `claude --version` |
Các lệnh này nên được thực thi mà không có lỗi. Lệnh trợ giúp liệt kê các tùy chọn khả dụng. Lệnh phiên bản hiển thị bản phát hành đã cài đặt.
Kiểm tra chức năng yêu cầu bắt đầu một phiên. Tạo một thư mục thử nghiệm:
| `mkdir test-project` `cd test-project` `claude` |
Điều này khởi tạo một phiên Claude Code tương tác. Công cụ sẽ phân tích thư mục (trống trong trường hợp này) và hiển thị một lời nhắc.
Thử các lệnh cơ bản trong phiên. Gõ `help` để xem các hành động có sẵn. Yêu cầu các tác vụ đơn giản như "tạo tệp README" hoặc "giải thích những gì bạn có thể làm".
Các phản hồi thành công cho biết cài đặt đúng cách. Nếu xảy ra lỗi, chúng thường liên quan đến xác thực, kết nối mạng hoặc thiếu phụ thuộc.
Cập nhật và Quản lý Phiên bản
Claude Code tự động cập nhật theo mặc định. Tài liệu chính thức giải thích rằng công cụ kiểm tra các phiên bản mới và cài đặt chúng mà không cần sự can thiệp của người dùng.
Hành vi cập nhật có thể được cấu hình thông qua cài đặt Claude Code. Tài liệu chính thức bao gồm cấu hình kênh phát hành và các tùy chọn cập nhật thủ công.
Cập nhật thủ công yêu cầu chạy lại tệp script cài đặt. Cùng một lệnh được sử dụng để cài đặt ban đầu sẽ lấy phiên bản mới nhất:
| `curl -fsSL claude.ai/install.sh | bash` |
Việc cài đặt các phiên bản cụ thể là có thể để thử nghiệm hoặc vì lý do tương thích. Tài liệu thiết lập nâng cao bao gồm cấu hình ghim phiên bản và kênh phát hành.
Các kênh phát hành bao gồm ổn định, beta và đêm. Phiên bản ổn định được khuyến nghị cho công việc sản xuất. Các kênh beta và đêm cung cấp quyền truy cập sớm vào các tính năng mới nhưng có thể chứa lỗi.
Các vấn đề cài đặt phổ biến
Một số vấn đề xuất hiện thường xuyên trong các cuộc thảo luận cộng đồng về việc cài đặt Claude Code.
Cấu hình PATH gây ra nhiều vấn đề. Nếu lệnh `claude` không được tìm thấy sau khi cài đặt, thư mục tệp nhị phân không nằm trong PATH của hệ thống.
Trên macOS và Linux, việc thêm thư mục vào PATH thường liên quan đến việc chỉnh sửa các tệp cấu hình shell như `~/.bashrc`, `~/.zshrc` hoặc tương tự. Tệp script cài đặt thường xử lý việc này một cách tự động, nhưng việc xác minh thủ công giúp khắc phục sự cố.
Người dùng Windows trong WSL2 có thể cần đóng và mở lại terminal sau khi cài đặt. Các biến môi trường không làm mới trong các phiên hiện có.
Các hạn chế mạng chặn một số cài đặt. Tường lửa công ty hoặc máy chủ proxy có thể ngăn tải xuống trình cài đặt hoặc kết nối với máy chủ xác thực.
Cấu hình proxy yêu cầu các biến môi trường:
| `export HTTP_PROXY=proxy.example.com:8080` `export HTTPS_PROXY=proxy.example.com:8080` |
Các lỗi quyền xảy ra khi cài đặt vào các thư mục được bảo vệ. Trình cài đặt cần quyền ghi vào `/usr/local/bin` hoặc các vị trí tương đương. Chạy với `sudo` giải quyết được điều này nhưng nên tránh trừ khi cần thiết.
Câu hỏi thường gặp
Claude Code có chạy được khi không có kết nối internet không?
Không. Claude Code yêu cầu kết nối internet để hoạt động. Công cụ gửi mã và truy vấn đến máy chủ của Anthropic để xử lý. Bộ nhớ đệm cục bộ có thể cho phép một số hoạt động hoạt động tạm thời ngoại tuyến, nhưng chức năng đầy đủ yêu cầu kết nối hoạt động.
Claude Code có hoạt động với các công cụ mã hóa AI hiện có không?
Có. Claude Code có thể chạy song song với GitHub Copilot, Cursor hoặc các công cụ phát triển AI khác. Chúng hoạt động độc lập và không xung đột. Tuy nhiên, việc sử dụng đồng thời nhiều trợ lý AI có thể gây nhầm lẫn về việc công cụ nào đang xử lý nhiệm vụ nào.
WSL2 có bắt buộc đối với tất cả các tính năng của Windows không?
Công cụ dòng lệnh yêu cầu WSL2 trên Windows. Tuy nhiên, ứng dụng dành cho máy tính chạy gốc trên Windows mà không cần WSL2. Ứng dụng dành cho máy tính cung cấp chức năng tương tự thông qua giao diện đồ họa thay vì tương tác dòng lệnh thuần túy.
Claude Code sử dụng có giá bao nhiêu?
Giá cả thay đổi tùy thuộc vào việc sử dụng và bậc đăng ký. Kiểm tra trang web chính thức của Claude để biết giá hiện tại, vì chi phí và cấu trúc gói thay đổi theo thời gian. Một số tính năng yêu cầu đăng ký Claude Pro hoặc Enterprise.
Claude Code có thể chỉnh sửa các tệp bên ngoài thư mục dự án không?
Theo mặc định, Claude Code hạn chế quyền truy cập tệp vào thư mục dự án hiện tại để bảo mật. Các cài đặt cấu hình có thể mở rộng quyền, nhưng làm như vậy yêu cầu sự cho phép rõ ràng. Tài liệu về môi trường an toàn bao gồm chi tiết quản lý quyền.
Sự khác biệt giữa Claude Code và Claude API là gì?
Claude Code là một công cụ phát triển để hỗ trợ mã hóa tương tác. Claude API cung cấp quyền truy cập theo chương trình để xây dựng các ứng dụng sử dụng khả năng AI của Claude. Chúng phục vụ các mục đích khác nhau—một cho các nhà phát triển viết mã, một cho các ứng dụng tích hợp các tính năng AI.
Việc gỡ cài đặt có xóa tất cả dữ liệu Claude Code không?
Gỡ cài đặt sẽ xóa tệp nhị phân ứng dụng nhưng có thể để lại các tệp cấu hình và dữ liệu đã lưu vào bộ nhớ cache. Việc xóa hoàn toàn yêu cầu xóa thủ công thư mục `~/.claude` trên macOS và Linux, hoặc vị trí tương đương trong AppData trên Windows.
Bắt đầu sau khi cài đặt
Với Claude Code đã được cài đặt và xác minh, bước tiếp theo là hiểu cách sử dụng nó một cách hiệu quả.
Tài liệu hướng dẫn nhanh đề xuất bắt đầu với các tác vụ đơn giản. Điều hướng đến một dự án hiện có và chạy `claude` để bắt đầu một phiên tương tác.
Yêu cầu Claude giải thích cấu trúc dự án. Yêu cầu tóm tắt về chức năng của cơ sở mã. Các truy vấn khám phá này giúp hiểu cách công cụ diễn giải mã.
Thử thực hiện các thay đổi nhỏ. Yêu cầu Claude thêm chú thích vào các hàm, tạo các tệp thử nghiệm đơn giản hoặc tái cấu trúc các khối mã cơ bản. Các tác vụ này thể hiện khả năng chỉnh sửa mà không có rủi ro.
Tích hợp Git hoạt động tự động nếu dự án sử dụng kiểm soát phiên bản. Claude Code có thể tạo các commit, giải thích các diff và đề xuất cải tiến dựa trên các thay đổi.
Tài liệu chính thức bao gồm các ví dụ về quy trình làm việc cho các tác vụ phát triển phổ biến. Chúng bao gồm sửa lỗi, triển khai tính năng, đánh giá mã và kiểm thử tự động.
Claude Code là một công cụ đang phát triển. Cài đặt chỉ là nền tảng. Hiểu được khả năng, hạn chế và các phương pháp hay nhất của nó đòi hỏi sự thử nghiệm và thực hành.
Sẵn sàng cài đặt Claude Code? Tải xuống trình cài đặt phù hợp cho nền tảng của bạn từ trang web chính thức và làm theo các bước được nêu trong hướng dẫn này. Xác thực bằng tài khoản Claude của bạn, xác minh cài đặt hoạt động chính xác và bắt đầu khám phá phát triển có hỗ trợ AI.
