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

> Cài đặt Claude Code, kết nối LLMoxy bằng CC Switch hoặc biến môi trường để lập trình trong terminal với các mô hình Claude.

Claude Code là tác nhân terminal của Anthropic: đọc trực tiếp kho mã, sửa tệp và chạy lệnh. Mặc định nó kết nối với API chính thức, chỉ cần trỏ cổng sang LLMoxy.

Trước khi bắt đầu, hãy chuẩn bị một [mã thông báo LLMoxy](https://vi.llmoxy.com/docs/get-started/get-token), nên dùng nhóm **auto**.

## Cài đặt

Ưu tiên dùng script chính thức (npm không còn được khuyến nghị):

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

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
```

Cũng có thể dùng:

```bash
brew install --cask claude-code          # macOS
winget install Anthropic.ClaudeCode      # Windows
```

Kiểm tra:

```bash
claude --version
```

## Kết nối LLMoxy

Claude Code dùng giao diện tương thích Anthropic, địa chỉ **không có** `/v1`.

| Biến | Giá trị |
| --- | --- |
| `ANTHROPIC_BASE_URL` | `https://llmoxy.com` |
| `ANTHROPIC_AUTH_TOKEN` | API Key LLMoxy của bạn |

### Cách 1: CC Switch (khuyến nghị)

Chuyển đổi nhà cung cấp bằng giao diện đồ họa, không cần sửa biến môi trường thủ công. Xem phần tải xuống và ảnh chụp từng bước tại [Hướng dẫn CC Switch](https://vi.llmoxy.com/docs/code-tutorials/cc-switch).

- Tên nhà cung cấp: LLMoxy
- API Key: mã thông báo của trang
- Địa chỉ yêu cầu: `https://llmoxy.com`
- Mô hình chính: `claude-opus-5-5`

### Cách 2: Biến môi trường

**macOS / Linux** (Zsh dùng `~/.zshrc`, Bash dùng `~/.bashrc`):

```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
source ~/.zshrc
```

**Windows PowerShell** (sau khi thiết lập phải mở cửa sổ mới):

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

Kiểm tra: `echo "$ANTHROPIC_BASE_URL"` phải in ra `https://llmoxy.com`.

## Khởi động

Vào thư mục dự án:

```bash
claude
```

Nhập `/model`, chọn tên mô hình vừa cấu hình (ví dụ `claude-opus-5-5`). Nhập `/` để xem tất cả lệnh.

![Màn hình chào](https://vi.llmoxy.com/docs-assets/migrated/tutorial-claudecode-runoob/welcome.png)

![Lệnh gạch chéo](https://vi.llmoxy.com/docs-assets/migrated/tutorial-claudecode-runoob/slash.png)

Tùy chọn: chạy `claude doctor` để kiểm tra môi trường.

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

**`claude: command not found`**
Xác nhận `claude --version` có kết quả, rồi mở lại terminal.

**Vẫn yêu cầu đăng nhập tài khoản Claude**
Xác nhận `ANTHROPIC_BASE_URL` và `ANTHROPIC_AUTH_TOKEN` đã có hiệu lực. Khi đã cấu hình cổng tùy chỉnh thì dùng API Key, không cần đăng nhập claude.ai.

**Lỗi quyền khi cài npm toàn cục**
Không dùng `sudo npm install -g`. Hãy dùng script chính thức, Homebrew hoặc nvm.

**Không kết nối được**
Dùng `curl -I https://llmoxy.com` để kiểm tra mạng; khi cần proxy, đặt `HTTPS_PROXY`.

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