Cài đặt Claude Code trên Ubuntu/Linux: Từ cài Node.js đến chạy lệnh đầu tiên

Định nghĩa

Claude Code là AI coding agent của Anthropic chạy trực tiếp trên terminal, biến cửa sổ dòng lệnh thành một pair programmer thông minh. Trên Ubuntu/Linux, đây là ứng dụng Node.js phân phối qua npm, đòi hỏi thiết lập đúng chuẩn về API key và biến môi trường PATH để tránh lỗi "command not found" hay permission denied thường gặp khi cài đặt trên hệ thống multi-user.

Giải thích chi tiết

Kiểm tra Node.js và chuẩn bị môi trường

Trước khi cài, verify máy đã có Node.js đủ version:

node --version  # Yêu cầu >= 18.0.0
npm --version   # Yêu cầu >= 8.0.0

Nếu chưa có, khuyên dùng nvm (Node Version Manager) để linh hoạt chuyển đổi giữa các dự án legacy và modern:

# Cài nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
# Cài Node.js 20 LTS (ổn định cho Claude Code)
nvm install 20
nvm use 20
nvm alias default 20

Nếu không muốn dùng nvm, cài trực tiếp qua apt (Ubuntu/Debian):

sudo apt update
sudo apt install nodejs npm
sudo npm install -g n
sudo n 20  # Nâng lên version 20

Cài đặt Claude Code global

Cài package toàn hệ thống để gọi lệnh claude ở mọi thư mục:

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

Lưu ý quan trọng về Permission: Nếu gặp lỗi EACCES: permission denied, mkdir..., tuyệt đối không dùng sudo để cài npm global. Thay vào đó, cấu hình npm dùng thư mục user-level:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @anthropic-ai/claude-code

Cách này tránh được rủi ro bảo mật khi chạy npm bằng root và giúp quản lý package sạch sẽ hơn.

Thiết lập Anthropic API Key

Claude Code cần biến môi trường ANTHROPIC_API_KEY để xác thực. Lấy key từ console.anthropic.com → Settings → API Keys, sau đó thêm vào shell:

# Thêm vào ~/.bashrc (hoặc ~/.zshrc nếu dùng Zsh)
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-..."' >> ~/.bashrc
source ~/.bashrc

Mẹo cho developer dùng nhiều project: Tạo file ~/.anthropic_key và source trong .bashrc để dễ rotate key mà không sửa trực tiếp vào rc file:

# Thêm vào ~/.bashrc
[ -f ~/.anthropic_key ] && source ~/.anthropic_key

Xử lý lỗi "claude: command not found"

Đây là lỗi phổ biến nhất trên Linux khi npm global bin chưa được thêm vào PATH. Kiểm tra:

which claude  # Nếu không trả về đường dẫn thì PATH thiếu
echo $PATH    # Kiểm tra có chứa ~/.npm-global/bin không

Fix bằng cách thêm đúng prefix vào ~/.bashrc:

# Nếu dùng npm global mặc định (không dùng nvm)
export PATH="$PATH:$(npm config get prefix)/bin"

# Nếu dùng nvm (đảm bảo nvm được load)
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

Sau khi sửa, chạy source ~/.bashrc và thử lại which claude.

Verify cài đặt thành công

Chạy các lệnh kiểm tra:

claude --version  # Hiển thị version là thành công
claude            # Khởi động interactive mode

Nếu thấy prompt > màu xanh lá cây, không báo lỗi API key invalid, và có thể gõ /help để xem danh sách lệnh, bạn đã sẵn sàng để "vibe coding" trên Linux.

Ví dụ thực tế

Developer backend làm hệ thống gọi xe tại Hà Nội Anh Minh, backend developer cho startup gọi xe nội địa, dùng ThinkPad T480 chạy Ubuntu 22.04. Thay vì mở VS Code nặng nề, anh chạy claude . trong thư mục microservice Node.js, yêu cầu AI refactor API tính giá cước từ callback sang async/await. Claude đọc toàn bộ codebase, tự động sửa 12 file liên quan, chạy npm test để verify không break logic tính phí surge pricing (giá cao điểm), rồi tự động commit với message rõ ràng — tất cả trong terminal.

DevOps quản lý hệ thống thanh toán VietQR Chị Lan, DevOps tại công ty fintech ở TP.HCM, quản lý VPS chạy Ubuntu Server 24.04 trên cloud provider Việt Nam (Azdigi/MatBao). Cài Claude Code bằng user deploy (không dùng root), thiết lập API key trong ~/.bashrc. Khi hệ thống báo lỗi Nginx 502 Bad Gateway với API VietQR, chị SSH vào server, chạy claude -p "analyze /var/log/nginx/error.log and suggest fix for upstream timeout". AI đọc log, nhận diện vấn đề proxy timeout, đề xuất tăng proxy_read_timeout trong config, và tự apply patch qua MCP Filesystem mà không cần mở nano hay vim.

Sinh viên Bách Khoa phân tích dữ liệu Shopee Bạn Nam, sinh viên năm 3 ĐH Bách Khoa, dùng laptop cũ chạy Linux Mint (Core i5, 8GB RAM) không đủ sức mở IDE nặng. Dùng Claude Code để làm đồ án "Phân tích sentiment review sản phẩm trên Shopee": gõ claude, paste yêu cầu viết script Python crawl và phân tích cảm xúc bằng transformers, để AI giải thích từng dòng code ngay trong terminal. Sau đó chạy thử bằng python3 script.py và debug lỗi encoding tiếng Việt ngay trên CLI mà không cần môi trường đồ họa phức tạp.

Ứng dụng

Developer chuyên nghiệp trên Linux workstation

• Dùng làm IDE chính kết hợp với Neovim/Tmux trên máy Dell ThinkPad/HP EliteBook chạy Ubuntu/Fedora
• Remote develop trên cloud server qua SSH mà không cần X11 forwarding hay VS Code Server
• Tích hợp vào workflow Zsh với Oh My Zsh, tận dụng plugin z để nhảy nhanh giữa các dự án

Freelancer và Startup Việt Nam

• Cài trên VPS giá rẻ (DigitalOcean, Vultr, hay cloud Việt như Tiến Lên, iNET) để có môi trường dev đồng nhất giữa các dự án outsource cho khách hàng nước ngoài
• Dùng kết hợp với tmux hoặc screen để giữ Claude session chạy background khi đóng laptop (detach/reattach), tiết kiệm pin và không mất context làm việc
• Tiết kiệm tài nguyên RAM/CPU so với chạy Docker Desktop hay các IDE đồ họa nặng như IntelliJ IDEA trên máy tính cấu hình trung bình

Sinh viên và người mới học lập trình

• Học Linux command line và Git thông qua AI tutoring tương tác: yêu cầu Claude giải thích từng flag trong ls -lah hay cách hoạt động của git rebase
• Làm bài tập lập trình Python/Java không cần cài IDE nặng trên máy cũ, chỉ cần terminal và trình duyệt để lấy API key
• Hiểu sâu cách shell và filesystem hoạt động nhờ giải thích trực tiếp trong CLI, chuẩn bị tốt cho các kỳ thi DevOps hay System Admin

So sánh

Insight: Cài đặt trên Linux native cho trải nghiệm "đất vàng" cho Claude Code vì hầu hết các công cụ AI agent đều được optimize cho môi trường POSIX. Đặc biệt nếu bạn thường xuyên SSH vào server Ubuntu để deploy ứng dụng Django/Node.js cho khách hàng Việt Nam, việc dùng Claude Code trên chính máy local Linux giúp môi trường dev và prod đồng nhất tuyệt đối.

Bài viết liên quan

Cùng cụm "Cài đặt & Thiết lập"

• Hướng dẫn cài đặt Claude Code từ đầu — Tổng quan các phương pháp cài đặt trên mọi nền tảng
• Cài đặt Claude Code trên macOS — Dành cho người dùng MacBook và iMac
• Cài đặt Claude Code trên Windows WSL — Phổ biến nhất cho developer VN dùng Windows
• Phiên làm việc đầu tiên — Sau khi cài xong thì làm gì? Từ API key đến Hello World

Đọc tiếp

• Agent loop và core concepts — Hiểu cách Claude Code "nghĩ" và "hành động" trước khi dùng sâu
• Workflow hàng ngày với slash commands — Bắt đầu dùng Claude Code hiệu quả mỗi ngày với /plan, /commit, /loop