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

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

   

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

   

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

   

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

   

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ụ:

   

   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

   

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

   

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:

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:

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:

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

   

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

   

   

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ụ:

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

   

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

   

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

   

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

   

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

   

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:

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

Tài nguyên liên quan

• Tài liệu chính thức Claude Desktop
• Hướng dẫn cấu hình Claude Code CLI