# Claude Code + nhà cung cấp của bạn

Giữ Claude Code làm CLI và nối một cấu hình khởi chạy với nhà cung cấp mô hình tương thích Anthropic khác.

## Chuẩn bị thông tin nhà cung cấp

Cài Claude Code, sau đó lấy base URL tương thích Anthropic, khóa API và các ID mô hình từ nhà cung cấp của bạn. Chỉ có endpoint tương thích OpenAI thì không dùng được với Claude Code.

Ví dụ này tạo một mục riêng tên `Claude · work`. Các mục Claude Code khác của bạn vẫn giữ cài đặt hiện có.

## 1. Thêm cấu hình nhà cung cấp

Thêm cấu hình này vào facade.json (xem [Cài đặt agent](https://facadecode.com/vi/docs/settings/)). Thay URL, khóa và ID mô hình trong ví dụ bằng giá trị từ nhà cung cấp của bạn:

```json
{
  "clis": {
    "Claude · work": {
      "type": "claude",
      "model": "YOUR_MODEL_ID",
      "env": {
        "ANTHROPIC_BASE_URL": "https://api.example.com/anthropic",
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
        "ANTHROPIC_API_KEY": null,
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_SMALL_MODEL_ID"
      }
    }
  }
}
```

Hãy dùng mô hình mà nhà cung cấp hỗ trợ cho từng alias. Ánh xạ Haiku dùng cho các tác vụ nền nhỏ hơn, nên có thể dùng mô hình khác với mô hình chính.

## 2. Kiểm tra endpoint và ánh xạ mô hình

| Cài đặt | Tác dụng |
| --- | --- |
| `ANTHROPIC_BASE_URL` | Chuyển Claude Code sang API tương thích Anthropic của nhà cung cấp. |
| `ANTHROPIC_AUTH_TOKEN` | Cung cấp token của nhà cung cấp. |
| `ANTHROPIC_API_KEY: null` | Loại bỏ khóa API Anthropic được kế thừa cho cấu hình này. |
| `model` | Đặt mô hình khởi đầu cho mục này. |
| `ANTHROPIC_DEFAULT_…_MODEL` | Ánh xạ yêu cầu Opus, Sonnet và Haiku sang ID mô hình của nhà cung cấp. |

Ví dụ này lưu khóa ngay trong facade.json. Nếu muốn đọc một biến môi trường có sẵn, hãy dùng `"ANTHROPIC_AUTH_TOKEN": "${env:WORK_API_KEY}"`. Trình soạn thảo phải có biến đó trước khi agent khởi chạy.

Các biến này chỉ áp dụng cho agent khởi chạy bằng mục này. Bạn không cần sửa cài đặt Claude Code toàn cục.

## 3. Khởi chạy Claude Code với cấu hình này

Lưu facade.json, chọn **New Agent** và chọn `Claude · work`. Giao cho agent một nhiệm vụ ngắn trong dự án của bạn.

Nếu nhà cung cấp có báo cáo mức sử dụng, hãy xác nhận yêu cầu xuất hiện ở đúng tài khoản. Nếu agent không khởi chạy được hoặc yêu cầu thất bại, hãy chạy **Show Agent Launch** và chọn vị trí làm việc. Tìm mục này trong báo cáo để xem Facade sẽ khởi chạy nó như thế nào.

Với lỗi xác thực hoặc lỗi thiếu mô hình, xem [Khắc phục sự cố](https://facadecode.com/vi/docs/troubleshooting/).

## Ví dụ: QwenCloud

Với khóa QwenCloud Token Plan, hãy dùng `https://token-plan.maas.qwencloudapi.com/apps/anthropic` làm base URL. Chọn các ID mô hình có trong gói của bạn. Khóa trả theo mức sử dụng dùng endpoint theo khu vực.

[Endpoint và cài đặt mô hình hiện hành của QwenCloud ↗](https://docs.qwencloud.com/developer-guides/clients-and-developer-tools/claude-code)