Cài đặt Claude Code trong 10 phút

Bước 1 — Chạy lệnh cài đặt

Cách nhanh nhất trên macOS và Linux là script cài chính thức. Nếu bạn đã có Node.js, có thể dùng npm.

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

# Hoặc qua npm (cần Node 18+)
npm install -g @anthropic-ai/claude-code

# Windows (cmd)
curl -fsSL https://claude.ai/install.bat -o install.bat && install.bat

Bước 2 — Mở đúng thư mục dự án

Claude Code làm việc theo thư mục: nó đọc cấu trúc và file trong thư mục bạn đứng. Vì vậy hãy cd vào đúng dự án trước khi khởi động, đừng chạy từ thư mục HOME.

cd ~/du-an-cua-ban
claude

Bước 3 — Đăng nhập

Lần đầu chạy, Claude Code mở trình duyệt để bạn đăng nhập bằng tài khoản Claude. Nếu dùng API key, đặt biến môi trường ANTHROPIC_API_KEY trước khi chạy.

Đăng nhập xong, bạn sẽ thấy dấu nhắc hội thoại ngay trong terminal — mọi thứ diễn ra ở đây.

Bước 4 — Brief đầu tiên nên là câu hỏi

Trước khi cho Claude sửa gì, hãy để nó chứng minh đã hiểu dự án. Một câu hỏi đọc-hiểu là bài test an toàn nhất.

> Dự án này dùng framework gì? Tóm tắt cấu trúc thư mục
  và chỉ ra file quan trọng nhất.

Hiểu cơ chế xin phép

Mặc định Claude Code hỏi trước khi sửa file hay chạy lệnh — bạn duyệt từng hành động. Đây là tính năng, không phải phiền phức: giữ nguyên chế độ này cho tới khi bạn tin tưởng quy trình.

• Cho phép một lần: duyệt từng hành động cụ thể
• Cho phép cả phiên: khi hành động lặp lại nhiều lần và bạn đã hiểu nó
• Từ chối và nói lý do: Claude sẽ đổi hướng theo phản hồi của bạn

Lỗi hay gặp

Nếu vẫn kẹt, chạy claude --version để xác nhận bản cài và xem tài liệu chính thức tại docs.anthropic.com.

• Gõ claude báo "command not found": mở terminal mới, hoặc kiểm tra PATH sau khi cài
• Cài qua npm bị lỗi quyền: đừng dùng sudo — cấu hình npm prefix về thư mục người dùng
• Đăng nhập lặp vô hạn: kiểm tra trình duyệt mặc định và thử claude logout rồi đăng nhập lại
• Chạy trong thư mục HOME: Claude đọc quá nhiều file không liên quan — luôn cd vào dự án