Hướng dẫn Claude Code Series 5: Cách cài đặt Claude Code?

Cách cài đặt Claude Code

Quá trình cài đặt Claude Code không có giao diện đồ họa với nút "Tiếp theo", mọi thứ đều thực hiện qua dòng lệnh. Nếu bạn đã quen với npm, toàn bộ quá trình sẽ không quá hai phút.

Điều kiện tiên quyết

Trước khi bắt đầu, hãy đảm bảo bạn có những thứ sau:

Node.js 18 hoặc cao hơn
Kiểm tra: chạy node -v trong terminal. Nếu phiên bản thấp hơn 18, hãy nâng cấp bằng nvm, fnm hoặc truy cập nodejs.org.
Một tài khoản Anthropic
Đăng ký tại https://console.anthropic.com. Tài khoản sẽ cung cấp API Key, cần dùng sau khi cài đặt. Đăng ký miễn phí, chi phí tính theo mức sử dụng.
Mạng có thể truy cập endpoint API của Anthropic
Tên miền mặc định là api.anthropic.com. Nếu môi trường cần cấu hình proxy, hãy đặt biến HTTP_PROXY hoặc HTTPS_PROXY trong terminal.

Cách cài đặt 1: npm toàn cục

Đây là cách phổ biến nhất, cài một lần dùng được mọi nơi.

npm install -g @anthropic-ai/claude-code

Sau khi hoàn tất, chạy claude --version, nếu hiển thị số phiên bản là cài đặt thành công. Sau khi cài toàn cục, lệnh claude có thể gọi trực tiếp từ bất kỳ thư mục nào.

Nếu gặp lỗi quyền (thường gặp trên macOS tại /usr/local/lib), có hai cách xử lý:

Dùng sudo để cài đặt (tiện lợi nhưng có tranh cãi về bảo mật).
Cấu hình npm sử dụng thư mục người dùng để tránh sudo:
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Sau đó thêm ~/.npm-global/bin vào biến PATH và mở lại terminal.

Cách cài đặt 2: npx dùng tạm

Nếu bạn không muốn cài đặt toàn cục bất kỳ thứ gì, hoặc chỉ muốn dùng thử tạm thời, npx là lựa chọn trực tiếp hơn.

npx @anthropic-ai/claude-code

npx sẽ tải xuống gói mới nhất tạm thời, chạy xong không để lại lệnh toàn cục. Mỗi lần sử dụng đều kiểm tra cập nhật, vì vậy luôn ở phiên bản mới nhất. Nhược điểm là hơi chậm (phải tải mỗi lần) và không thích hợp để viết vào script tự động gọi thường xuyên.

Phù hợp cho: trải nghiệm lần đầu, dùng tạm trên máy người khác, hoặc thỉnh thoảng dùng một lần.

Xác nhận có thể khởi động hay không

Sau khi cài đặt, đừng vội xác thực. Chạy một câu lệnh đơn giản để xem công cụ có khởi động được không:

claude --help

Nếu hiển thị thông tin trợ giúp, tệp nhị phân hoạt động tốt. Bước tiếp theo là kết nối tài khoản của bạn, sẽ được hướng dẫn sau.

Hai cách cài đặt đều cho cùng một bản cài đặt, các bước xác thực và sử dụng sau đó hoàn toàn giống nhau. Hãy chọn cách bạn thấy tiện nhất.

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

Phiên bản Node quá thấp
Dưới 18 sẽ báo lỗi ngay, không phải cảnh báo. Nâng cấp Node là giải pháp trực tiếp nhất.
Mạng bị timeout
Cả khi npm kéo gói và kết nối API sau đó đều có thể bị chặn bởi proxy hoặc tường lửa. Trước tiên hãy kiểm tra curl https://api.anthropic.com có thông không, rồi mới thực hiện các bước tiếp theo.
Sử dụng cmd gốc trên Windows
Mặc dù về lý thuyết có thể, nhưng khuyên dùng Git Bash, WSL2 hoặc Windows Terminal để tránh các vấn đề chuyển đổi đường dẫn kỳ lạ.