Cơ bản
⏱ 15 phút
2
Cài đặt và Thiết lập
Hướng dẫn từng bước cài đặt Claude Code và cấu hình ban đầu
🎯 Mục tiêu bài học
- ✓ Cài đặt Node.js và Claude Code thành công
- ✓ Lấy và cấu hình Anthropic API key
- ✓ Chạy Claude Code lần đầu tiên
Yêu cầu hệ thống
- Node.js phiên bản 18 trở lên
- macOS, Linux, hoặc Windows (WSL2 khuyến nghị)
- Kết nối Internet
- Anthropic API key (trả phí, không có free tier)
Bước 1: Kiểm tra Node.js
node --version
# Phải là v18.0.0 trở lên, ví dụ: v20.11.0
npm --version
# Ví dụ: 10.2.4
Nếu chưa có Node.js, tải tại nodejs.org và chọn phiên bản LTS.
Bước 2: Cài đặt Claude Code
npm install -g @anthropic-ai/claude-code
Kiểm tra cài đặt:
claude --version
Bước 3: Lấy API Key
- Truy cập console.anthropic.com
- Đăng ký / Đăng nhập tài khoản
- Vào API Keys → Create new key
- Copy key (bắt đầu bằng
sk-ant-...)
⚠️ Lưu ý bảo mật
Không bao giờ commit API key lên Git. Thêm .env vào .gitignore và lưu key trong biến môi trường.
Bước 4: Chạy lần đầu
cd /path/to/your/project
claude
Lần đầu chạy, Claude Code sẽ hỏi API key. Nhập key vào và nhấn Enter.
Key được lưu tại ~/.claude/ và dùng cho các lần sau.
Cấu hình nâng cao
Bạn có thể set API key qua biến môi trường:
# macOS / Linux
export ANTHROPIC_API_KEY="sk-ant-your-key-here"
# Windows PowerShell
$env:ANTHROPIC_API_KEY = "sk-ant-your-key-here"
💡 Mẹo
Thêm dòng export ANTHROPIC_API_KEY="..." vào file ~/.bashrc hoặc ~/.zshrc để không cần nhập lại mỗi lần mở terminal.