# Claude Code

> Dùng Claude Code với khoá KONG API AI. Đặt địa chỉ API và khoá trong file cấu hình shell hoặc file cài đặt của Claude Code, rồi kiểm tra bằng /status.

Source: https://kongapiai.com/docs/claude-code

Claude Code gửi yêu cầu tới KONG API AI khi bạn đặt địa chỉ API và khoá của bạn. Thay `gw_live_…` bằng khoá của bạn ở mọi bước dưới đây.

Trên Windows, [Kong Connect](https://kongapiai.com/docs/kong-connect) cài tự động cho Claude Code. Bạn chỉ dán khoá một lần.

## Cài Claude Code

Bỏ qua bước này nếu bạn đã có Claude Code.

macOS, Linux hoặc WSL:

```bash
curl -fsSL https://claude.ai/install.sh | bash
```

Windows, trong PowerShell:

```powershell
irm https://claude.ai/install.ps1 | iex
```

Hoặc dùng npm (cần Node.js 18 trở lên):

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

## Cách nhanh: một lệnh

Lệnh dưới đây hỏi khoá của bạn mà không hiện lên màn hình, kiểm tra khoá với KONG API AI, rồi ghi cấu hình cho Claude Code và Codex như các bước bên dưới. File cũ được sao lưu trước khi sửa.

macOS hoặc Linux:

```bash
curl -fsSL https://kongapiai.com/install.sh | bash
```

Windows, trong PowerShell:

```powershell
irm https://kongapiai.com/install.ps1 | iex
```

Để gỡ ra, chạy `curl -fsSL https://kongapiai.com/install.sh | bash -s -- --remove`, hoặc trên Windows chạy `$env:KONG_ACTION='remove'` rồi chạy lại lệnh cài. Muốn xem lệnh làm gì trước khi chạy, mở địa chỉ của lệnh trong trình duyệt.

## Cách 1: file cấu hình shell (macOS và Linux)

Thêm các dòng dưới đây vào `~/.zshrc` hoặc `~/.bashrc`:

```bash
export KONG_API_KEY="gw_live_…"
export ANTHROPIC_BASE_URL="https://kongapiai.com"
export ANTHROPIC_AUTH_TOKEN="$KONG_API_KEY"
export ANTHROPIC_API_KEY="" # Bắt buộc để trống
```

Chạy `source ~/.zshrc` (hoặc `source ~/.bashrc`), hoặc mở một terminal mới.

`ANTHROPIC_API_KEY` phải để trống. Nếu biến này còn giữ một khoá Anthropic, Claude Code dùng khoá đó thay cho khoá KONG API AI.

## Cách 2: file cài đặt của Claude Code (mọi hệ điều hành, gồm Windows)

Tạo file `.claude/settings.local.json` trong thư mục dự án:

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://kongapiai.com",
    "ANTHROPIC_AUTH_TOKEN": "gw_live_…",
    "ANTHROPIC_API_KEY": ""
  }
}
```

Muốn dùng cho mọi dự án, đặt cùng nội dung vào `~/.claude/settings.json` (trên Windows: `%USERPROFILE%\.claude\settings.json`).

Không đặt các giá trị này trong file `.env` của dự án: Claude Code không đọc file đó.

## Đăng xuất tài khoản Anthropic cũ

Nếu bạn từng đăng nhập Claude Code bằng tài khoản Anthropic, chạy `/logout` một lần trong Claude Code, rồi thoát và mở lại `claude`. Chưa từng đăng nhập thì bỏ qua bước này.

## Bắt đầu

```bash
cd /đường-dẫn/tới/dự-án
claude
```

## Kiểm tra

Trong Claude Code, chạy `/status`. Kết quả cần có hai dòng:

```text
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://kongapiai.com
```

Nếu dòng xác thực ghi `ANTHROPIC_API_KEY` hoặc một tài khoản Claude, cấu hình chưa tới được Claude Code: mở terminal mới rồi chạy lại `claude`. Sau vài yêu cầu, bạn thấy chúng trong trang [Hoạt động](https://kongapiai.com/app#activity) của console.

## Chọn model (không bắt buộc)

Mặc định, Claude Code tự chọn model. Để chọn model mới nhất của từng dòng đang bán trên KONG API AI, thêm vào cùng file cấu hình shell:

```bash
export ANTHROPIC_DEFAULT_FABLE_MODEL="claude-fable-5-2"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"
```

Với file cài đặt của Claude Code, đặt cùng tên và giá trị trong phần `env`. Sau đó chạy `/model` để xem. Khoá chỉ gọi được những model nó được phép dùng: xem trang [Model và giá](https://kongapiai.com/docs/models).

## Khi có lỗi

- **Không tìm thấy model:** thường do một phiên đăng nhập Anthropic cũ (chạy `/logout`), hoặc một khoá Anthropic còn nằm trong `ANTHROPIC_API_KEY`.
- **Lỗi 401:** khoá sai hoặc đã bị thu hồi. Sao chép lại khoá, hoặc tạo khoá mới trong console.
- **Lỗi 402:** hết số dư hoặc hết hạn mức tháng của khoá. Xem [Hạn mức và cách chọn nguồn](https://kongapiai.com/docs/limits).

Khoá trong file cấu hình shell được lưu dạng chữ thường. Đừng chia sẻ file đó.
