Tóm tắt nhanh: Claude Code CLI được cài đặt bằng một lệnh duy nhất, tự động tải xuống và cấu hình công cụ. Trên macOS và Linux, sử dụng tập lệnh shell chính thức từ tài liệu của Anthropic, trong khi người dùng Windows chạy lệnh PowerShell hoặc WSL. Sau khi cài đặt, xác thực bằng khóa API của bạn để bắt đầu sử dụng trợ lý mã hóa AI của Claude trên thiết bị đầu cuối của bạn.
Claude Code là một công cụ mã hóa theo tác nhân, hoạt động trên thiết bị đầu cuối của bạn và hiểu toàn bộ cơ sở mã của bạn. Theo tài liệu chính thức của Claude Code, nó có thể đọc tệp, thực thi lệnh, chỉnh sửa mã và tích hợp với các công cụ phát triển thông qua các cuộc trò chuyện bằng ngôn ngữ tự nhiên.
Nhưng để bắt đầu cần cài đặt đúng cách. Dưới đây là mọi thứ cần thiết để cài đặt Claude Code CLI và cấu hình nó chính xác.
Yêu cầu hệ thống trước khi cài đặt
Trước khi cài đặt Claude Code, hãy xác minh hệ thống đáp ứng các yêu cầu cơ bản. Theo tài liệu thiết lập nâng cao chính thức, hãy xóa hoàn toàn câu này.
Kiểm tra cài đặt Node.js bằng cách mở thiết bị đầu cuối và chạy:
| node –version |
Nếu Node.js chưa được cài đặt hoặc phiên bản dưới 18, hãy tải xuống từ trang web chính thức của Node.js. Phiên bản Hỗ trợ dài hạn (LTS) hoạt động hoàn hảo với Claude Code.
Ngoài Node.js, hệ thống cần các yêu cầu cơ bản: macOS 13.0 trở lên đối với người dùng Mac, Windows 10 trở lên đối với hệ thống Windows và hầu hết các bản phân phối Linux hiện đại hoạt động mà không gặp sự cố. Tài khoản Claude từ Anthropic cũng cần thiết để xác thực sau khi cài đặt.
Cài đặt Claude Code trên macOS và Linux
Quá trình cài đặt cho macOS và Linux sử dụng một lệnh shell duy nhất, tự động xử lý mọi thứ. Phương pháp này được ghi lại trong hướng dẫn bắt đầu nhanh chính thức của Claude Code.
Mở Terminal và chạy tập lệnh cài đặt:
| curl -fsSL claude.ai/install.sh | bash |
Tập lệnh tải xuống tệp nhị phân Claude Code, đặt nó vào thư mục chính xác và tự động cấu hình PATH. Toàn bộ quá trình thường hoàn thành trong vòng chưa đầy một phút.
Đối với người dùng macOS ưa thích Homebrew, có một phương pháp cài đặt thay thế mặc dù nó không được ghi lại chính thức trong các nguồn chính. Phương pháp curl vẫn là phương pháp được khuyến nghị theo tài liệu chính thức.
Xác minh cài đặt
Sau khi cài đặt hoàn tất, hãy xác minh rằng Claude Code có thể truy cập được:
| claude –version |
Lệnh này sẽ hiển thị số phiên bản đã cài đặt. Nếu xuất hiện lỗi cho biết "lệnh không tìm thấy", cấu hình PATH cần được điều chỉnh.
Theo tài liệu xử lý sự cố chính thức, các vấn đề về PATH là sự cố cài đặt phổ biến nhất. Cách khắc phục bao gồm thêm thư mục cài đặt của Claude vào tệp cấu hình shell.
Cài đặt Claude Code trên macOS và Linux
Quá trình cài đặt cho macOS và Linux dựa vào npm (Node Package Manager). Theo tài liệu chính thức, bạn phải cài đặt Node.js 18 trở lên trên hệ thống của mình trước khi tiếp tục. Không giống như các công cụ CLI truyền thống sử dụng tập lệnh shell, Claude Code được cài đặt toàn cục thông qua thiết bị đầu cuối của bạn để đảm bảo tất cả các phụ thuộc được xử lý chính xác.
Mở Terminal của bạn và chạy lệnh sau để cài đặt gói:
| export CLAUDE_CODE_RELEASE_ALPHA=1 && npm install -g @anthropic-ai/claude-code |
Lưu ý: Biến môi trường CLAUDE_CODE_RELEASE_ALPHA=1 hiện được yêu cầu trong giai đoạn beta/alpha công khai để xác nhận trạng thái xem trước của công cụ.
Lệnh này tải xuống gói từ kho npm chính thức và liên kết tệp thực thi claude với thư mục bin toàn cục của hệ thống bạn. Mặc dù một số người dùng có thể cố gắng tìm các công thức Homebrew, phương pháp npm là đường dẫn cài đặt được hỗ trợ và ghi lại chính thức duy nhất.
Xác minh cài đặt
Sau khi cài đặt hoàn tất, hãy xác minh rằng CLI được ánh xạ chính xác với môi trường của bạn bằng cách chạy:
| claude –version |
Lệnh này sẽ hiển thị số phiên bản hiện tại (ví dụ: 0.2.9). Nếu bạn gặp lỗi "lệnh không tìm thấy", thường có nghĩa là thư mục npm toàn cục của bạn không có trong PATH của hệ thống.
Theo tài liệu xử lý sự cố chính thức, bạn có thể khắc phục điều này bằng cách xác định tiền tố npm của mình bằng npm config get prefix và đảm bảo thư mục /bin kết quả được thêm vào tệp .zshrc hoặc .bashrc của bạn.
Cài đặt Claude Code trên Windows
Việc cài đặt trên Windows có hai phương pháp chính: cài đặt PowerShell gốc hoặc sử dụng Windows Subsystem for Linux (WSL). Tài liệu chính thức khuyến nghị PowerShell cho hầu hết người dùng.
Phương pháp cài đặt PowerShell
Mở PowerShell với quyền Quản trị viên (nhấp chuột phải vào menu Start và chọn "Windows PowerShell (Admin)"). Chạy lệnh này:
| irm claude.ai/install.ps1 | iex |
Tập lệnh PowerShell tự động xử lý việc tải xuống, cài đặt và cấu hình PATH. Sau khi hoàn thành, hãy đóng và mở lại PowerShell để đảm bảo các cập nhật PATH có hiệu lực.
Phương pháp cài đặt WSL
Các nhà phát triển đã sử dụng WSL có thể cài đặt Claude Code bằng phương pháp Linux. Mở thiết bị đầu cuối WSL và chạy cùng lệnh curl được sử dụng cho Linux:
| curl -fsSL claude.ai/install.sh | bash |
Cách tiếp cận WSL hoạt động giống hệt như cài đặt Linux gốc. Một ưu điểm: WSL cung cấp môi trường giống Unix hơn, phù hợp với cấu hình máy chủ sản xuất.
Theo tài liệu xử lý sự cố chính thức, người dùng WSL đôi khi gặp sự cố kết nối mạng. Nếu cài đặt bị treo, hãy xác minh rằng WSL có thể truy cập mạng bên ngoài và các quy tắc tường lửa không chặn lưu lượng truy cập.
Tìm tín dụng Claude và Công cụ AI ở một nơi
Cài đặt Claude Code CLI là một bước. Thanh toán cho các công cụ AI trong dài hạn là một bước khác. Get AI Perks tập hợp các khoản tín dụng khởi nghiệp và giảm giá phần mềm cho các công cụ AI và đám mây ở một nơi. Nó cung cấp cho người sáng lập quyền truy cập vào hơn 200 ưu đãi, bao gồm các ưu đãi từ Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom và những người khác. Nền tảng này cũng hiển thị các điều kiện ưu đãi và hướng dẫn để yêu cầu mỗi ưu đãi.
Tìm kiếm tín dụng Claude hoặc Anthropic?
Kiểm tra Get AI Perks để:
- tìm tín dụng và giảm giá công cụ AI ở một nơi
- xem xét các điều kiện ưu đãi trước khi đăng ký
- truy cập hướng dẫn yêu cầu các ưu đãi khởi nghiệp
👉 Truy cập Get AI Perks để xem các ưu đãi phần mềm Claude, Anthropic và các ưu đãi AI khác có sẵn.
Xác thực và Cấu hình ban đầu
Sau khi cài đặt, Claude Code yêu cầu xác thực trước khi nó có thể hoạt động. Công cụ sử dụng khóa API từ Anthropic để xác minh quyền truy cập.
Bắt đầu quá trình xác thực bằng cách chạy:
| claude |
Lần đầu tiên lệnh này chạy, Claude Code sẽ nhắc xác thực. Theo hướng dẫn bắt đầu nhanh chính thức, điều này sẽ mở một cửa sổ trình duyệt để đăng nhập vào tài khoản Anthropic.
Sau khi đăng nhập qua trình duyệt, CLI sẽ nhận được một mã thông báo xác thực tự động. Mã thông báo này được lưu trữ cục bộ và duy trì giữa các phiên, vì vậy không cần xác thực lặp đi lặp lại.
Cấu hình cài đặt cấp dự án
Claude Code hỗ trợ cấu hình ở nhiều cấp độ theo tài liệu cài đặt chính thức. Các cấp độ cấu hình phổ biến nhất là:
| Phạm vi | Vị trí | Trường hợp sử dụng |
|---|---|---|
| Người dùng | Thư mục ~/.claude/ | Tùy chọn cá nhân trên tất cả các dự án |
| Dự án | .claude/ trong kho lưu trữ | Cấu hình nhóm được chia sẻ |
| Cục bộ | .claude/settings.local.json | Ghi đè dành riêng cho máy |
Đối với thiết lập lần đầu, cấu hình cấp người dùng là đủ. Cài đặt cấp dự án trở nên quan trọng khi làm việc với các nhóm chia sẻ tiêu chuẩn mã hóa.
Bắt đầu phiên Claude Code đầu tiên của bạn
Với việc cài đặt và xác thực hoàn tất, hãy khởi chạy Claude Code bằng cách chạy lệnh không có đối số:
| claude |
Điều này khởi động chế độ tương tác nơi Claude phản hồi các yêu cầu bằng ngôn ngữ tự nhiên. Tài liệu chính thức mô tả chế độ tương tác là cách chính để sử dụng Claude Code cho các tác vụ phát triển.
Thử một lệnh kiểm tra đơn giản:
| Cho tôi xem cấu trúc của dự án này |
Claude Code phân tích thư mục hiện tại và cung cấp tổng quan về cấu trúc cơ sở mã. Điều này cho thấy rằng cài đặt đang hoạt động chính xác và Claude có quyền truy cập để đọc tệp.
Các lệnh thiết yếu cho việc sử dụng hàng ngày
Ngoài chế độ tương tác, Claude Code hỗ trợ một số mẫu lệnh được ghi lại trong tài liệu tham khảo CLI:
| Mẫu lệnh | Mục đích | Ví dụ |
|---|---|---|
| claude | Bắt đầu phiên tương tác | claude |
| claude “nhiệm vụ” | Thực hiện nhiệm vụ một lần | claude “sửa lỗi linting” |
| claude -p “truy vấn” | Truy vấn nhanh không cần phiên | claude -p “hàm này làm gì” |
Mẫu nhiệm vụ một lần đặc biệt hữu ích cho các quy trình CI/CD và tập lệnh tự động hóa, nơi chế độ tương tác không phù hợp.
Khắc phục sự cố cài đặt phổ biến
Ngay cả với các tập lệnh cài đặt tự động, đôi khi vẫn xảy ra sự cố. Tài liệu xử lý sự cố chính thức đề cập đến các vấn đề phổ biến nhất.
Lỗi Lệnh không tìm thấy
Nếu thiết bị đầu cuối hiển thị "lệnh không tìm thấy: claude" sau khi cài đặt, cấu hình PATH đã không hoàn thành chính xác. Đối với macOS và Linux, hãy thêm vị trí tệp nhị phân của Claude vào tệp cấu hình shell theo cách thủ công.
Đối với người dùng bash, hãy chỉnh sửa ~/.bashrc hoặc ~/.bash_profile và thêm:
| export PATH=”$HOME/.local/bin:$PATH” |
Đối với người dùng zsh (mặc định trên macOS hiện đại), hãy chỉnh sửa ~/.zshrc với cùng một dòng. Sau khi lưu, hãy tải lại cấu hình bằng source ~/.zshrc hoặc mở một cửa sổ terminal mới.
Sự cố mạng và tường lửa
Mạng công ty và tường lửa hạn chế đôi khi chặn tập lệnh cài đặt. Theo tài liệu xử lý sự cố, nếu cài đặt bị treo hoặc trả về HTML thay vì thực thi, quyền truy cập mạng vào máy chủ của Anthropic có thể bị chặn.
Cách khắc phục bao gồm tải xuống tập lệnh cài đặt riêng biệt:
| curl -fsSL code.anthropic.com/install.sh -o install.sh chmod +x install.sh ./install.sh |
Cách tiếp cận này cung cấp khả năng hiển thị rõ hơn về những gì đang lỗi nếu xảy ra lỗi trong quá trình tải xuống hoặc thực thi.
Sự cố dành riêng cho WSL
Người dùng Windows chạy WSL đôi khi gặp sự cố kết nối giữa hệ thống con Linux và Windows. Tài liệu chính thức đề cập rằng các quy tắc tường lửa có thể cần được điều chỉnh để cho phép lưu lượng truy cập WSL.
Nếu Claude Code cài đặt thành công nhưng không thể truy cập máy chủ của Anthropic để xác thực, hãy kiểm tra xem tường lửa Windows có cho phép truy cập mạng WSL hay không. Hướng dẫn xử lý sự cố cung cấp các lệnh PowerShell cụ thể để cấu hình quy tắc tường lửa.
Cập nhật Claude Code
Claude Code nhận được các bản cập nhật thường xuyên với các tính năng và cải tiến mới. Theo tài liệu chính thức, các bản cập nhật được cài đặt bằng cùng một lệnh như cài đặt ban đầu.
Chạy lại tập lệnh cài đặt:
| curl -fsSL code.anthropic.com/install.sh | sh |
Tập lệnh sẽ phát hiện cài đặt hiện có và nâng cấp nó lên phiên bản mới nhất. Không có cấu hình hoặc xác thực nào bị mất trong quá trình cập nhật.
Kiểm tra phiên bản hiện tại trước và sau khi cập nhật:
| claude –version |
Nhật ký thay đổi trong tài liệu chính thức của Claude Code liệt kê tất cả các thay đổi giữa các phiên bản, giúp xác định xem bản cập nhật có giới thiệu các tính năng liên quan đến quy trình công việc cụ thể hay không.
Các bước tiếp theo sau khi cài đặt
Với Claude Code đã được cài đặt và hoạt động, việc khám phá các tính năng nâng cao trở nên khả thi. Tài liệu chính thức mô tả một số lĩnh vực đáng để nghiên cứu:
- Kỹ năng và tùy chỉnh: Theo tài liệu kỹ năng chính thức, Claude Code hỗ trợ các kỹ năng tùy chỉnh được định nghĩa trong các tệp Markdown trong thư mục .claude/skills/. Các kỹ năng này mở rộng khả năng của Claude với các lệnh và quy trình công việc dành riêng cho dự án.
- Giao thức ngữ cảnh Mô hình (MCP): Tích hợp MCP cho phép Claude Code kết nối với các công cụ và dịch vụ bên ngoài. Điều này biến Claude thành một trung tâm có thể truy cập cơ sở dữ liệu, API và các tài nguyên phát triển khác.
- Cộng tác nhóm: Các tệp cấu hình cấp dự án trong thư mục .claude/ có thể được cam kết vào hệ thống kiểm soát phiên bản, chia sẻ cài đặt Claude Code trên toàn bộ nhóm phát triển.
- Tài liệu chính thức cung cấp hướng dẫn chi tiết cho từng lĩnh vực này, dựa trên thiết lập cơ bản được đề cập ở đây.
Câu hỏi thường gặp
Tôi có cần đăng ký Claude trả phí để sử dụng Claude Code CLI không?
Claude Code yêu cầu tài khoản Claude từ Anthropic, nhưng cấp độ đăng ký cụ thể cần thiết phụ thuộc vào việc sử dụng. Theo tài liệu chính thức, cần phải xác thực nhưng chi tiết về giá cả nên được xác minh trên trang web chính thức của Anthropic vì các gói thay đổi theo thời gian.
Tôi có thể cài đặt Claude Code mà không cần quyền quản trị viên không?
Trên macOS và Linux, Claude Code cài đặt vào thư mục chính của người dùng theo mặc định và không yêu cầu quyền truy cập quản trị viên. Người dùng Windows có thể cần quyền quản trị viên cho phương pháp cài đặt PowerShell, mặc dù cài đặt WSL không yêu cầu quyền quản trị viên.
Claude Code có hoạt động ngoại tuyến không?
Không. Claude Code là một công cụ hỗ trợ AI giao tiếp với máy chủ của Anthropic để xử lý các yêu cầu. Theo tài liệu chính thức, cần có kết nối internet đang hoạt động để Claude phân tích mã và tạo phản hồi.
Làm thế nào để gỡ cài đặt Claude Code?
Tài liệu thiết lập nâng cao chính thức giải thích rằng việc gỡ cài đặt bao gồm việc xóa tệp nhị phân và tệp cấu hình. Trên macOS và Linux, xóa thư mục ~/.claude và xóa sửa đổi PATH khỏi các tệp cấu hình shell. Người dùng Windows nên xóa thư mục cài đặt và xóa biến môi trường PATH.
Claude Code có thể truy cập toàn bộ hệ thống tệp của tôi không?
Theo mặc định, Claude Code hoạt động trong thư mục làm việc hiện tại và các thư mục con của nó. Theo tài liệu về quyền chính thức, quyền truy cập có thể được hạn chế thêm bằng cách sử dụng cài đặt sandbox trong các tệp cấu hình. Claude luôn yêu cầu xác nhận trước khi thực hiện các thao tác có khả năng gây phá hủy.
Sự khác biệt giữa Claude Code CLI và Claude Desktop là gì?
Claude Code CLI chạy trên thiết bị đầu cuối và tập trung vào quy trình công việc phát triển với quyền truy cập hệ thống tệp trực tiếp và thực thi lệnh. Claude Desktop là một ứng dụng độc lập với giao diện đồ họa. Cả hai công cụ đều phục vụ các trường hợp sử dụng khác nhau, với CLI được tối ưu hóa cho các nhà phát triển ưa thích quy trình công việc dựa trên thiết bị đầu cuối.
Tôi nên cập nhật Claude Code bao lâu một lần?
Các bản cập nhật có thể được cài đặt bất cứ khi nào thuận tiện. Nhật ký thay đổi chính thức ghi lại các tính năng mới và sửa lỗi. Đối với các nhóm, việc phối hợp cập nhật đảm bảo mọi người sử dụng các phiên bản tương thích, mặc dù Claude Code duy trì khả năng tương thích ngược với các tệp cấu hình trên các phiên bản.
Kết luận
Cài đặt Claude Code CLI chỉ mất vài phút bất kể hệ điều hành. Các tập lệnh cài đặt tự động xử lý cấu hình, thiết lập PATH và đặt tệp nhị phân mà không cần can thiệp thủ công.
Sau khi cài đặt và xác thực, Claude Code trở thành một trợ lý mã hóa AI mạnh mẽ có thể truy cập từ mọi thiết bị đầu cuối. Các lệnh ngôn ngữ tự nhiên cho phép các nhà phát triển viết mã, sửa lỗi và tự động hóa các tác vụ mà không cần rời khỏi dòng lệnh.
Sẵn sàng trải nghiệm phát triển được hỗ trợ bởi AI? Chạy lệnh cài đặt cho nền tảng của bạn và bắt đầu phiên Claude Code đầu tiên của bạn ngay hôm nay. Tài liệu chính thức tại code.claude.com cung cấp hướng dẫn toàn diện cho các tính năng nâng cao sau khi thiết lập cơ bản hoàn tất.
