Cài Claude Code trên Ubuntu và VPS: từ zero đến prompt đầu

Chia sẻ bài viết

Trả lời nhanh: Cài Claude Code trên Ubuntu chỉ một dòng: curl -fsSL https://claude.ai/install.sh | sh, sau đó gõ claude trong thư mục dự án và đăng nhập tài khoản Claude (Pro trở lên). Trên VPS không có trình duyệt, công cụ hiện đường link kèm mã, bạn mở link đó bằng trình duyệt trên máy cá nhân, đăng nhập, dán mã trở lại terminal là xong. Tổng thời gian với người mới: chưa tới 5 phút.

Bài này gom một chỗ mọi tình huống cài Claude Code trên Ubuntu: máy bàn cài Ubuntu, Windows chạy WSL, và phổ biến nhất, VPS thuê ngoài truy cập qua SSH. Kèm những vướng mắc người Việt hay gặp ở bước đăng nhập trên server và checklist đáng chạy ngay sau khi cài.

Tóm tắt nhanh

Một dòng curl là cài xong; script tự lo mọi phụ thuộc trên Ubuntu 22.04/24.04 sạch
Trên VPS: đăng nhập kiểu hiện-link-dán-mã, không cần trình duyệt trên server
Sau cài: chạy /init tạo CLAUDE.md, thử một việc nhỏ, rồi mới giao việc thật
Chạy trong tmux ngay từ đầu để phiên sống độc lập với kết nối SSH

Chuẩn bị: máy cần gì

Yêu cầu rất nhẹ: Ubuntu 20.04 trở lên (22.04/24.04 đều mượt), vài GB RAM trống, kết nối internet. Tài khoản Claude gói Pro trở lên hoặc API key. Với VPS, gói 4-6 GB RAM là thoải mái cho một phiên agent kèm dev server, cấu hình chi tiết theo cỡ dự án xem bài cấu hình VPS tối thiểu.

Cài đặt: một dòng cho mọi trường hợp

curl -fsSL https://claude.ai/install.sh | sh

Script tự tải bản phù hợp và đặt lệnh claude vào PATH. Cài xong, mở terminal mới (hoặc source ~/.bashrc) rồi kiểm tra:

claude --version

Trên Windows: cài WSL trước (wsl --install trong PowerShell, khởi động lại, chọn Ubuntu) rồi làm y hệt bên trong WSL. Claude Code chạy trong môi trường Linux của WSL nên mọi hướng dẫn Ubuntu áp dụng nguyên xi.

Đăng nhập trên VPS không có trình duyệt

Gõ claude lần đầu, công cụ cần bạn đăng nhập. Trên máy có giao diện, nó tự mở trình duyệt. Trên VPS chỉ có dòng lệnh, nó in ra một đường link: copy link đó, mở bằng trình duyệt trên laptop/điện thoại của bạn, đăng nhập tài khoản Claude, trang sẽ hiện một mã xác nhận, dán mã trở lại terminal trên VPS là hoàn tất. Phiên đăng nhập được lưu, các lần sau vào thẳng.

Trường hợp dùng API key (máy chạy tự động, CI): bỏ qua đăng nhập, đặt biến môi trường là đủ:

echo 'export ANTHROPIC_API_KEY=sk-ant-...' >> ~/.bashrc && source ~/.bashrc

Checklist 5 phút sau khi cài

Vào tmux trước đã: tmux new -s work: thói quen số một trên server, phiên agent sống sót qua mọi lần rớt SSH. Chưa quen tmux xem bài hướng dẫn 10 phút.
Clone dự án và /init: git clone ... && cd du-an && claude, gõ /init để agent tự viết CLAUDE.md mô tả dự án.
Thử việc nhỏ: "liệt kê các route chính của dự án này", xem agent đọc dự án có mượt không.
Kiểm tra công cụ dự án cần: Node/Bun/Python, database... thiếu gì cứ bảo agent tự cài, nó làm tốt việc này.
Commit mốc an toàn: git add -A && git commit -m 'moc truoc khi giao viec'.

Lỗi thường gặp khi cài

Gõ claude báo command not found: mở terminal mới hoặc source ~/.bashrc; vẫn không được thì xem script cài in đường dẫn nào và thêm vào PATH.
VPS RAM quá nhỏ (1 GB): cài được nhưng dự án lớn sẽ ì ạch, thêm swap tạm hoặc lên gói RAM lớn hơn.
Mạng công ty chặn: lỗi tải về giữa chừng thường do proxy/firewall, thử mạng khác hoặc cài trên VPS (server đặt tại datacenter hiếm khi gặp vấn đề này).
Phiên bản cũ lỗi vặt: claude update trước khi đi tìm nguyên nhân xa xôi.

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

Cài Claude Code có cần cài Node.js trước không?

Không bắt buộc, script cài chính thức tự lo phần chạy của công cụ. Nhưng dự án của bạn (Next.js, Node app...) vẫn cần runtime riêng của nó; cứ để agent tự cài khi bắt tay vào dự án.

Một tài khoản Claude dùng được trên mấy máy?

Đăng nhập được trên nhiều máy (laptop + VPS là kiểu phổ biến). Hạn mức tính theo tài khoản, dùng chỗ nào cũng trừ chung một túi.

Cài trên VPS rồi thì code nằm ở đâu, an toàn không?

Code nằm trên ổ của VPS. An toàn phụ thuộc bạn: đặt mật khẩu SSH mạnh hoặc dùng key, bật firewall, chọn nhà cung cấp có backup định kỳ. Ưu điểm ngược lại: laptop mất hay hỏng, dự án và phiên làm việc vẫn nguyên trên server.

Ubuntu 24.04 hay 22.04 tốt hơn cho Claude Code?

Cả hai đều chạy tốt. Máy mới nên chọn 24.04 cho vòng đời hỗ trợ dài; máy đang chạy 22.04 ổn định thì không cần nâng chỉ vì Claude Code.

Hạ tầng NVMe Enterprise của TND

VPS ổ Enterprise U.2 NVMe, CPU xung cao, đặt tại Việt Nam

Muốn có sân tập sạch ngay bây giờ? VPS NVMe của TND bàn giao Ubuntu trong 5 phút, SSH vào, dán một dòng curl là bắt đầu. Ổ Enterprise U.2 NVMe RAID 10 giúp bước clone repo, cài dependency chạy vèo vèo, và bạn có thể dùng tmux để agent code tiếp ngay cả khi tắt laptop.

Xem VPS ổ Enterprise U.2 NVMe tại Việt Nam