> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexusapi.link/llms.txt
> Use this file to discover all available pages before exploring further.

# Thiết lập Claude Code

> Cài Claude Code và kết nối NexusAPI bằng cấu hình Anthropic gốc.

Claude Code dùng Anthropic Messages gốc. Base URL NexusAPI là `https://nexusapi.link`; **không thêm `/v1`**.

## 1. Cài Claude Code

Dùng trình cài chính thức:

```bash theme={"system"}
curl -fsSL https://claude.ai/install.sh | bash
```

```powershell theme={"system"}
irm https://claude.ai/install.ps1 | iex
```

Có thể dùng `winget install Anthropic.ClaudeCode` trên Windows hoặc `brew install --cask claude-code` trên macOS. Kiểm tra cài đặt:

```bash theme={"system"}
claude --version
claude doctor
```

## 2. Tạo NexusAPI Key

Trong **Quản lý token → Thêm token**, chọn nhóm có mô hình Claude cần dùng và đặt hạn mức. Đừng chỉ dựa vào tên mô hình; xác nhận ở Chợ mô hình hoặc [ma trận khả năng](/vi/developer/capability-matrix).

## 3. Tạo cấu hình cấp người dùng

| Hệ thống            | Đường dẫn                               |
| ------------------- | --------------------------------------- |
| macOS / Linux / WSL | `~/.claude/settings.json`               |
| Windows             | `%USERPROFILE%\\.claude\\settings.json` |

Trên macOS, Linux, WSL hoặc Git Bash:

```bash theme={"system"}
mkdir -p ~/.claude
touch ~/.claude/settings.json
```

Gộp các giá trị sau vào `env` hiện có, không ghi đè MCP hoặc quyền khác:

```json theme={"system"}
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_NEXUSAPI_KEY",
    "ANTHROPIC_BASE_URL": "https://nexusapi.link"
  }
}
```

Lưu trong thư mục người dùng, không lưu trong kho dự án.

## 4. Khởi động và kiểm tra

Mở terminal mới, chạy `claude`, rồi dùng `/status`. Xác nhận **Anthropic base URL** là `https://nexusapi.link` và gửi một câu hỏi ngắn.

## Vấn đề thường gặp

### `Invalid API Key · Please run /login`

Kiểm tra hai biến, trạng thái key và việc mở lại terminal. Không sửa trực tiếp các tệp trạng thái đăng nhập nội bộ của Claude.

### `fetch failed`

1. Gửi một câu hỏi ngắn thông thường. Nếu thành công, vấn đề có thể là WebFetch hoặc chức năng mạng độc lập khác.
2. Nếu mọi cuộc gọi mô hình đều lỗi, chạy `claude doctor` và kiểm tra Base URL bằng `/status`.
3. Kiểm tra DNS, firewall, mạng công ty hoặc proxy đáng tin có chặn `nexusapi.link` không.
4. Mở terminal mới và chỉ thử một lần. Nếu lỗi tiếp diễn, lưu phiên bản, đầu ra doctor, lỗi đầy đủ và Request ID rồi làm [tự kiểm tra](/vi/faq/self-check).

### Trạng thái `offline`

Một số chức năng phụ kiểm tra dịch vụ riêng. Hãy xác nhận lời gọi gateway thực tế bằng `/status` và yêu cầu mô hình ngắn trước khi coi NexusAPI đang lỗi.

* [Cài đặt chính thức](https://code.claude.com/docs/en/installation)
* [Biến môi trường](https://code.claude.com/docs/en/env-vars)
* [Cấu hình gateway](https://code.claude.com/docs/en/llm-gateway)