Cài đặt Claude Code từ A đến Z (kể cả khi gặp lỗi)

Cài đặt Claude Code chỉ mất 5 phút — nhưng nếu không làm đúng thứ tự, bạn sẽ mất cả buổi tối với lỗi không rõ nguyên nhân. Bài này giúp bạn làm đúng ngay từ đầu.

Yêu cầu hệ thống

• Node.js 18+ (kiểm tra: node --version)

• - npm hoặc yarn

• - API key từ Anthropic (đăng ký tại console.anthropic.com)

• - Terminal quen dùng (iTerm2, Windows Terminal, hoặc mặc định)

Bước 1: Cài Node.js (nếu chưa có)

Mac:

brew install node
```

**Windows:**
Tải trực tiếp từ nodejs.org, chọn bản LTS.

**Linux (Ubuntu/Debian):**
```bash
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
```

## Bước 2: Cài Claude Code

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

Sau khi cài xong, kiểm tra:
```bash
claude --version
```

## Bước 3: Lấy API Key

1. Vào console.anthropic.com
2. Đăng ký hoặc đăng nhập
3. Vào Settings → API Keys → Create Key
4. Copy key (dạng `sk-ant-...`)

## Bước 4: Chạy lần đầu

```bash
cd /path/to/your/project
claude
```

Lần đầu chạy, Claude Code sẽ hỏi API key. Paste vào và Enter.

## Xử lý lỗi thường gặp

**Lỗi: `command not found: claude`**
```bash
npm install -g @anthropic-ai/claude-code
# Hoặc thêm npm global vào PATH
export PATH="$PATH:$(npm prefix -g)/bin"
```

**Lỗi: `EACCES permission denied`**
```bash
sudo npm install -g @anthropic-ai/claude-code
# Hoặc dùng nvm để quản lý Node version
```

**Lỗi: `Invalid API key`**
- Kiểm tra lại key từ console.anthropic.com
- Đảm bảo đã thêm payment method (tài khoản mới cần nạp tối thiểu $5)

## Cấu hình thêm (tùy chọn)

Tạo file `~/.claude/config.json` để lưu cấu hình:
```json
{
  "defaultModel": "claude-opus-4-5",
  "autoApprove": false
}
```

Bài tiếp theo: Làm quen với giao diện và các lệnh cơ bản nhất của Claude Code.