Hướng dẫn cài đặt Claude Code trên Ubuntu Linux: Từng bước chi tiết
Việc thiết lập các công cụ lập trình hỗ trợ bởi AI trên Linux không nhất thiết phải phức tạp. Hướng dẫn này sẽ chỉ cho bạn cách cài đặt Claude Code trên Ubuntu Linux, đưa khả năng lập trình AI tiên tiến của Anthropic trực tiếp vào terminal của bạn để bạn có thể làm việc nhanh hơn mà không cần phải chuyển đổi liên tục giữa các công cụ.
Claude Code CLI là gì?
Claude Code CLI là giao diện dòng lệnh của Anthropic dành cho việc lập trình hỗ trợ bởi AI. Không giống như các công cụ AI dựa trên trình duyệt hoặc các extension IDE yêu cầu chuyển đổi ngữ cảnh liên tục, Claude Code chạy trực tiếp trong terminal của bạn cùng với quy trình làm việc hiện có.
CLI này cung cấp khả năng truy cập lập trình vào các khả năng của Claude thông qua giao diện hội thoại. Bạn có thể yêu cầu tạo mã, hỗ trợ gỡ lỗi, đánh giá kiến trúc và đưa ra các đề xuất tái cấu trúc (refactoring) mà không cần mở các ứng dụng riêng biệt hoặc sao chép mã giữa các công cụ.
Cài đặt nhanh Claude Code trên Ubuntu Linux
Nếu bạn muốn Claude Code hoạt động ngay lập tức, đây là lộ trình nhanh nhất:
# Đầu tiên, cài đặt Node.js 20
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
# Cài đặt Claude Code toàn cục
npm install -g @anthropic-ai/claude-code
# Cấu hình API key
claude config
# Bắt đầu sử dụng
claude
Yêu cầu hệ thống cho Ubuntu Linux
Trước khi cài đặt Claude Code trên Ubuntu, hãy đảm bảo hệ thống của bạn đáp ứng các yêu cầu sau.
Phiên bản Ubuntu tối thiểu
Claude Code CLI hỗ trợ Ubuntu 20.04 LTS (Focal Fossa) trở lên, bao gồm Ubuntu 22.04 LTS và Ubuntu 24.04 LTS.
Yêu cầu phần cứng
Tin tốt là Claude Code chạy hiệu quả trên phần cứng khá khiêm tốn:
– RAM: Tối thiểu 4GB (khuyên dùng 8GB cho các dự án lớn).
– Bộ nhớ: 500MB cho cài đặt cộng với không gian làm việc của dự án.
– CPU: Bất kỳ bộ vi xử lý x86_64 hiện đại nào.
– Mạng: Kết nối internet để gửi yêu cầu API.
Các bước cài đặt chi tiết
Bước 1: Cài đặt Node.js trên Ubuntu
Sử dụng kho lưu trữ NodeSource để có phiên bản mới nhất:
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
Bước 2: Cài đặt Claude Code CLI qua npm
npm install -g @anthropic-ai/claude-code
Lưu ý quan trọng: Không bao giờ sử dụng sudo npm install -g cho Claude Code để tránh các vấn đề về quyền và bảo mật.
Cấu hình xác thực (Authentication)
Sau khi cài đặt, hãy xác thực Claude Code với tài khoản Anthropic của bạn.
Thiết lập Anthropic API Key
- Truy cập console.anthropic.com.
- Chuyển đến phần API Keys.
- Nhấp vào “Create Key” và sao chép mã được tạo.
Xác thực tương tác
Chạy lệnh cấu hình:
claude config
Bạn có thể chọn đăng nhập bằng gói đăng ký Claude Pro/Max hoặc thanh toán theo mức sử dụng.
Tích hợp với VS Code
Mặc dù Claude Code hoạt động trong terminal, bạn có thể tích hợp nó vào Visual Studio Code:
1. Mở VS Code trên Ubuntu.
2. Nhấn Ctrl+Shift+X để mở bảng Extensions.
3. Tìm kiếm “Claude Code” và cài đặt extension chính thức từ Anthropic.
Khắc phục các sự cố thường gặp
Lỗi quyền truy cập (Permission Denied)
Hãy đảm bảo bạn sở hữu thư mục dự án và có quyền ghi:
sudo chown -R $USER:$USER /path/to/your/project
Bắt đầu sử dụng Claude Code
Điều hướng đến thư mục dự án của bạn và chạy:
claude
Thử các câu lệnh:
– What does this project do? (Dự án này làm gì?)
– Explain the folder structure (Giải thích cấu trúc thư mục)
– Create a function to validate email addresses (Tạo một hàm để xác thực địa chỉ email)
Kết luận
Bằng cách cài đặt Claude Code, bạn đã trang bị cho mình một trợ lý AI mạnh mẽ ngay trong terminal. Nó không chỉ giúp tạo mã nhanh hơn mà còn hỗ trợ gỡ lỗi và hiểu sâu hơn về kiến trúc dự án của bạn.
Chúc bạn có những trải nghiệm lập trình tuyệt vời với Claude Code!
