Bài viết này là hướng dẫn chi tiết để cài đặt và sử dụng Claude Code: từ bước chuẩn bị, cài đặt, xác thực, liên kết API Key cho đến cách khắc phục các lỗi phổ biến. Chỉ cần làm theo từng bước, trong vòng 10 phút bạn đã có thể chạy Claude Code trong terminal và sử dụng nó để tạo mã, sửa lỗi và hỗ trợ cộng tác phát triển đơn giản.
1. Chuẩn Bị Trước Khi Cài Đặt: Lưu ý Quan Trọng Về Phiên Bản Node.js
Claude Code yêu cầu môi trường Node.js. Bạn nên cài đặt Node.js phiên bản 18 trở lên trước, sau đó mở một cửa sổ terminal mới. Người dùng Windows có thể sử dụng trình cài đặt và nhấn "Next" cho đến khi hoàn tất. Người dùng macOS có thể sử dụng gói cài đặt chính thức hoặc trình quản lý gói như Homebrew. Sau khi cài đặt, hãy nhập lệnh node -v trong terminal để xác nhận số phiên bản hiển thị chính xác.
2. Cài Đặt Claude Code: Sử Dụng npm Toàn Cục và Nguồn Mirror (Nếu Cần)
Thực thi lệnh cài đặt toàn cục trong terminal: npm install -g @anthropic-ai/claude-code. Đây là cách cài đặt Claude Code phổ biến nhất. Nếu mạng của bạn truy cập vào registry npm chính thức chậm, bạn có thể chuyển sang sử dụng mirror (ví dụ: nguồn từ npmmirror.com): npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com. Sau khi cài đặt xong, hãy khởi động lại terminal và nhập lệnh claude --version để kiểm tra xem Claude Code đã sẵn sàng sử dụng chưa.
