canonical_url: https://yycode.net/docs/vi/claude-desktop-configuration
lang: vi
updated_at: 2026-07-04T13:33:48.616Z
source_html: https://yycode.net/docs/vi/claude-desktop-configuration

# Hướng dẫn cấu hình Provider bên thứ ba cho Claude Desktop

Hướng dẫn này sẽ chỉ bạn cách cấu hình API Provider bên thứ ba trong client Claude Desktop, để kết nối tới các dịch vụ AI khác nhau (như yycode, Kimi...) thông qua gateway tùy chỉnh.

## Chuẩn bị trước

Trước khi bắt đầu cấu hình, vui lòng đảm bảo:

1. Đã tải xuống và cài đặt client Claude Desktop
2. Có API Key của dịch vụ bên thứ ba
3. Biết địa chỉ Gateway (Base URL) của dịch vụ đó

### Tải Claude Desktop

Truy cập trang tải chính thức để lấy phiên bản mới nhất:

[Tải Claude Desktop](https://code.claude.com/docs/en/desktop-quickstart)

![Trang tải Claude Desktop](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423195403206.png)

## Quy trình cấu hình trên macOS

### Bước 1: Bật chế độ nhà phát triển

1. Mở client Claude Desktop

   ![Giao diện chính Claude Desktop](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423195504200.png)

2. Nhấp **Help** trên thanh menu trên cùng, lần lượt chọn **Troubleshooting** → **Enable Developer Mode**

   ![Bật chế độ nhà phát triển](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423195705084.png)

3. Nhấp **Enable** trong hộp thoại xác nhận, ứng dụng sẽ tự động khởi động lại

   ![Xác nhận bật chế độ nhà phát triển](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423195751066.png)

### Bước 2: Cấu hình giao diện bên thứ ba

1. Sau khi khởi động lại, vào màn hình chào mừng, **đừng đăng nhập vội**. Giữ client ở trạng thái được chọn, lúc này thanh menu trên cùng sẽ xuất hiện tùy chọn **Developer**

   ![Menu Developer](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423200035068.png)

2. Nhấp **Developer** → **Configure Provider** để mở bảng cấu hình

3. Điền thông tin giao diện bên thứ ba. Lấy DragonCode làm ví dụ:

   ![Cấu hình giao diện bên thứ ba](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423200226091.png)

   | Mục cấu hình | Giá trị |
      |--------|-----|
   | **Gateway base URL** | `https://yycode.net` |
   | **Gateway API key** | API Key yycode của bạn |

4. Nhấp **Apply locally** ở góc dưới phải

5. Trong hộp xác nhận bật lên, chọn **Relaunch now** để khởi động lại ứng dụng

   ![Xác nhận khởi động lại](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423200724818.png)

6. Sau khi khởi động lại, nhấp **Continue with gateway** để vào giao diện chính

   ![Continue with gateway](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423200842725.png)

### Giải thích giao diện

Sau khi vào giao diện chính, có thể dùng các phím tắt sau để chuyển view:

| Phím tắt | Chức năng |
|--------|------|
| `Command + 1` | Giao diện Cowork (mặc định) |
| `Command + 2` | Giao diện coding |

### Xác minh chức năng

Sau khi cấu hình xong, có thể xác minh kết nối bằng một cuộc trò chuyện đơn giản, ví dụ hỏi mô hình đang sử dụng:

![Xác minh kết nối mô hình](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423201548407.png)

### Giải thích plugin và kỹ năng

Nếu bạn đã cấu hình và bật plugin hoặc skill trong Claude Code CLI, phía Desktop sẽ tự động đồng bộ các cấu hình này. Bạn cũng có thể tải file skill lên thủ công trong Desktop:

![Đồng bộ plugin và kỹ năng](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423201918419.png)

### Cấu hình nâng cao

#### Cấu hình quyền cao nhất

Mặc định, khi Claude Desktop thực hiện thao tác nhạy cảm, hộp xác nhận sẽ bật lên. Nếu cần tắt nhắc xác nhận, có thể đặt quyền cao nhất:

1. Nhấp vùng trạng thái **Cowork 3P \| Gateway** ở góc dưới trái, hoặc nhấn `Command + ,` để mở cài đặt

   ![Mở cài đặt](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423202005781.png)

2. Điều chỉnh cấp quyền trong bảng cài đặt

   ![Lối vào cài đặt quyền](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423202235722.png)

   ![Chi tiết cấu hình quyền](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423202733059.png)

#### Giữ máy tính hoạt động

Khi thực hiện tác vụ dài, khuyến nghị bật tính năng **Keep computer awake** để tránh máy tính vào trạng thái ngủ làm gián đoạn tác vụ:

![Keep computer awake](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423202511953.png)

> **Lưu ý**: Tính năng này có thể ngăn máy tính vào trạng thái chờ, màn hình vẫn có thể tự động tắt. Nhưng **gập nắp laptop vẫn khiến thiết bị vào trạng thái sleep**.

### Cấu hình nhiều Provider

Claude Desktop hỗ trợ cấu hình nhiều giao diện bên thứ ba, thuận tiện chuyển đổi giữa các dịch vụ:

1. Lặp lại bước bật chế độ nhà phát triển
2. Vào **Developer** → **Configure Provider**
3. Nhấp menu thả xuống ở góc trên phải (hiển thị tên cấu hình hiện tại, như `default`)
4. Chọn **New configuration** để tạo cấu hình mới

   ![Tạo cấu hình mới](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423203331381.png)

5. Điền Gateway address và API Key mới (ví dụ thông tin cấu hình của Kimi)

   ![Cấu hình Kimi](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423203535749.png)

6. Sau khi áp dụng và khởi động lại, có thể tự do chuyển giữa các Provider đã cấu hình

   ![Chuyển Provider](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423203608823.png)

## Quy trình cấu hình trên Windows

Logic cấu hình phía Windows về cơ bản giống macOS, chỉ khác cách vào chế độ nhà phát triển:

### Bật chế độ nhà phát triển

1. Mở Claude Desktop, vào trang nhập email của màn hình chào mừng
2. Nhấn phím `Tab` để chuyển focus cho đến khi icon menu ở góc trên trái được chọn
3. Nhấn `Enter` để mở menu

   ![Lối vào menu Windows](https://virusoss.oss-cn-shanghai.aliyuncs.com/1e3b6e4fdc12d7e76d9b0a7e6205a633a6070ca4.png)

4. Chọn **Developer** → **Configure third-party interface**

   ![Menu Developer trên Windows](https://virusoss.oss-cn-shanghai.aliyuncs.com/018a18e47414f8267efc2f166471d9a00744c93d_2_513x500.png)

### Cấu hình thông tin giao diện

Điền Gateway address và API Key, nhấp **Apply locally** rồi khởi động lại để có hiệu lực:

![Form cấu hình Windows](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423204249997.png)

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

| Vấn đề | Cách xử lý |
|------|---------|
| Không thể kết nối sau khi cấu hình | Kiểm tra Gateway URL có bắt đầu bằng `https://` không, API Key có hợp lệ không |
| Mất hiệu lực sau khi chuyển Provider | Đảm bảo đã nhấp **Apply locally** và khởi động lại ứng dụng |
| Không đủ quyền để thực thi lệnh | Điều chỉnh cấp quyền lên cao nhất trong cài đặt |

## Tài nguyên liên quan

- [Tài liệu chính thức Claude Desktop](https://code.claude.com/docs/en/desktop-quickstart)
- [Hướng dẫn cấu hình Claude Code CLI](/docs/backend/ai/claude-code)