# Hướng dẫn cấu hình Claude Code Fable 5

> Cài đặt Claude Code và kết nối với LLMoxy Gateway thông qua API Key và địa chỉ yêu cầu, để lập trình với mô hình Claude Fable 5.

## Các bước cài đặt

### 1. Cài đặt Node.js

Truy cập [trang chủ Node.js](https://nodejs.org/), tải xuống phiên bản LTS (phiên bản hỗ trợ dài hạn, ổn định hơn).

### 2. Cài đặt Claude Code

Mở terminal (macOS/Linux) hoặc PowerShell (Windows), cài đặt bằng npm:

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

## Lấy API Key

Vào [LLMoxy Console](https://llmoxy.com/) → Quản lý token → Tạo API Key mới, ở bước 1 “Thông tin cơ bản” trong **Nhóm Token** hãy chọn **Dành riêng cho Claude Fable 5** (thay vì nhóm mặc định), như vậy token mới có thể gọi mô hình Fable 5 bình thường. Các bước còn lại (phạm vi mô hình, ngân sách và hạn dùng, bảo mật) hãy điền theo nhu cầu; sau khi hoàn tất, hãy sao chép khóa đã tạo — **khóa đầy đủ chỉ hiển thị một lần**, vui lòng lưu giữ cẩn thận.

## Các bước cấu hình

Claude Code kết nối với LLMoxy thông qua hai biến môi trường:

- `ANTHROPIC_BASE_URL` — điền `https://llmoxy.com` (**không** kèm `/v1`)
- `ANTHROPIC_AUTH_TOKEN` — API Key của LLMoxy đã tạo ở bước trước

### macOS / Linux

```bash
{
echo ''
echo '# LLMoxy'
echo 'export ANTHROPIC_BASE_URL="https://llmoxy.com"'
echo 'export ANTHROPIC_AUTH_TOKEN="API Key LLMoxy của bạn"'
} >> ~/.zshrc   # Người dùng Bash đổi thành ~/.bashrc

source ~/.zshrc  # Hoặc source ~/.bashrc
```

Không chắc mình đang dùng Shell nào? Chạy `echo $SHELL`, `/bin/zsh` tương ứng với `~/.zshrc`, còn `/bin/bash` tương ứng với `~/.bashrc`.

### Windows (PowerShell)

```powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://llmoxy.com","User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","API Key LLMoxy của bạn","User")
```

Sau khi thiết lập, hãy **đóng rồi mở lại** một cửa sổ PowerShell mới để có hiệu lực.

Nhớ thay `API Key LLMoxy của bạn` bằng khóa thực tế bạn đã sao chép từ console.

## Khởi chạy và sử dụng Fable 5

Vào thư mục dự án, khởi động Claude Code:

```bash
claude
```

Nhập `/model`, chọn hoặc nhập tên mô hình:

```
claude-fable-5-2
```

Nhấn Enter để xác nhận, rồi bạn có thể bắt đầu lập trình với Claude Fable 5.

## Xác minh

```bash
echo "$ANTHROPIC_BASE_URL"   # macOS/Linux, phải hiển thị https://llmoxy.com
echo $env:ANTHROPIC_BASE_URL # Windows PowerShell
```

Nếu Claude Code trò chuyện bình thường, nghĩa là bạn đã kết nối thành công với LLMoxy.

## Câu hỏi thường gặp

**Biến môi trường không có hiệu lực**: xác nhận đã `source` tệp cấu hình hoặc đã mở lại cửa sổ terminal.

**`claude` command not found**: kiểm tra `node -v` có trả về phiên bản hay không, sau đó khởi động lại terminal.

**Lỗi quyền khi `npm install -g`**: đừng ép cài bằng `sudo npm install -g`; nên dùng nvm để quản lý Node.js, hoặc chạy `npm config set prefix ~/.npm-global` rồi thêm `~/.npm-global/bin` vào PATH.

Đây là bản markdown của https://vi.llmoxy.com/docs/code-tutorials/claude-code-fable5.
