Trang chủ / Bài 2
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

  1. Truy cập console.anthropic.com
  2. Đăng ký / Đăng nhập tài khoản
  3. Vào API Keys → Create new key
  4. 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.