Hướng dẫn kết nối CC Switch với Claude Desktop: dùng định tuyến cục bộ để chuyển đổi OpenRouter và DeepSeek

CC Switch v3.15.0 trở lên bắt đầu hỗ trợ quản lý Claude Desktop riêng biệt. Giá trị cốt lõi của nó không phải là “thêm một lớp vỏ giao diện”, mà là gom toàn bộ cấu hình suy luận bên thứ ba của Claude Desktop, ánh xạ mô hình và định tuyến cục bộ vào một bảng điều khiển trực quan, giảm việc chỉnh sửa cấu hình thủ công, điền endpoint, gán model ID. (Nếu bạn chưa nắm rõ mục đích cơ bản của CC Switch và các công cụ được hỗ trợ, hãy đọc trước bài “CC Switch là gì? Một bảng điều khiển để quản lý thống nhất công cụ lập trình AI và nhà cung cấp mô hình”.)

Claude Desktop chính thức đã có sẵn cổng tích hợp suy luận bên thứ ba. Đường dẫn bật thường là: Help → Troubleshooting → Enable Developer Mode, sau đó vào Developer → Configure third-party inference. Vấn đề là cấu hình thủ công không thân thiện với người mới: cần nhập địa chỉ Gateway, API Key, phương thức xác thực, danh sách model, v.v., và chỉ cần sai một trường là kết nối có thể thất bại.

Vai trò của CC Switch là gom các bước này vào một công cụ hoàn chỉnh. Đặc biệt nếu bạn muốn kết nối Claude Desktop với OpenRouter, DeepSeek hoặc các mô hình không phải dòng Claude, ánh xạ mô hình và định tuyến cục bộ của CC Switch sẽ rất hữu ích.

Một, nó giải quyết vấn đề gì?

Khi Claude Desktop kết nối nhà cung cấp bên thứ ba, có hai điểm phiền phức chính:

1. Điểm vào cấu hình quá sâu: phải bật chế độ nhà phát triển trước, rồi vào cửa sổ cấu hình suy luận bên thứ ba. 2. Vấn đề tương thích tên model: Claude Desktop thường hiểu model theo vai trò của Claude như Sonnet, Opus, Haiku; nhưng nền tảng bên thứ ba dùng ID model riêng như inclusionai/ring-2.6-1t, deepseek-v4-pro, deepseek-v4-flash.

CC Switch chèn một lớp chuyển tiếp:

Claude Desktop → CC Switch local route → Nhà cung cấp bên thứ ba

Lớp này đảm nhiệm ba việc:

• Chuyển tiếp yêu cầu từ Claude Desktop đến nhà cung cấp bên thứ ba;
• Ánh xạ các vai trò Sonnet / Opus / Haiku sang các model ID thực;
• Tự động ghi cấu hình suy luận bên thứ ba cần thiết cho Claude Desktop.

Hai, khi nào bắt buộc bật ánh xạ mô hình?

Tiêu chí nhận biết rất rõ:

Hai ví dụ trong bài viết đều thuộc mô hình không phải Claude, nên đều phải bật:

• “Cần ánh xạ mô hình”
• “Định tuyến cục bộ”

Chỉ cần dùng mô hình không phải Claude thì định tuyến cục bộ bắt buộc phải chạy. Tắt CC Switch hoặc tắt công tắc định tuyến sẽ làm Claude Desktop mất kết nối mô hình bên thứ ba.

Ba, chuẩn bị trước

Chuẩn bị 3 thứ trước khi bắt đầu:

1. CC Switch v3.15.0 hoặc cao hơn Trang chủ: https://ccswitch.io

2. Claude Desktop Tải chính thức: https://claude.ai/download

3. Tài khoản nhà cung cấp bên thứ ba và API Key Chọn một trong hai:

• OpenRouter：https://openrouter.ai
• DeepSeek Platform：https://platform.deepseek.com

Bốn, cài đặt hoặc nâng cấp CC Switch

Người đã cài CC Switch có thể cập nhật tự động.

Cài mới có thể tham khảo các cách sau:

## macOS
brew tap farion1231/ccswitch
brew install --cask cc-switch

Người dùng Windows tải gói cài đặt .msi; người dùng Linux chọn .deb, .rpm hoặc .AppImage theo bản phân phối.

Sau khi cài xong, mở CC Switch. Nếu trong trình chuyển App bạn thấy mục “Claude Desktop” riêng biệt và nó nằm cùng hàng với “Claude Code”, nghĩa là đã dùng phiên bản hỗ trợ quản lý Claude Desktop.

Năm, mở bảng điều khiển Claude Desktop

Trong bộ chuyển App ở bên trái hoặc trên cùng của CC Switch, chọn:

Claude Desktop

Sau đó nhấn “Add Provider” (Thêm nhà cung cấp), chọn nền tảng cần tích hợp, rồi điền API Key và URL endpoint.

Dưới đây là hai cấu hình điển hình.

Sáu, mẫu cấu hình A: OpenRouter + Ring 2.6 1T

OpenRouter là nền tảng tổng hợp model, cho phép truy cập nhiều model qua một cổng truy cập thống nhất. Nó hỗ trợ model miễn phí, tính phí theo lượng sử dụng và gói doanh nghiệp, phù hợp để thử nghiệm các model khác nhau hoặc chuyển nhà cung cấp tạm thời.

1. Tạo OpenRouter API Key

Mở OpenRouter:

https://openrouter.ai

Vào trang Keys để tạo API Key:

https://openrouter.ai/keys

2. Thêm OpenRouter trong CC Switch

Trong mục “Add Provider”, chọn preset OpenRouter rồi điền:

Lưu ý: nên tránh đặt dấu / ở cuối request URL.

3. Cách điền khuyến nghị cho ánh xạ mô hình

Ring 2.6 1T không phải model Claude, nên cần ánh xạ vai trò của Claude Desktop sang model ID thực trên OpenRouter.

Có thể thêm ba dòng:

Nghĩa là: dù bạn chọn Sonnet, Opus hay Haiku trong Claude Desktop, cuối cùng cũng sẽ gọi tới inclusionai/ring-2.6-1t trên OpenRouter.

Bảy, mẫu cấu hình B: DeepSeek V4 chính thức

Tài liệu DeepSeek cung cấp giao diện Anthropic-compatible, với base URL là:

https://api.deepseek.com/anthropic

Điều này có nghĩa có thể kết nối với một phần hệ sinh thái công cụ API của Anthropic. Tài liệu DeepSeek cũng đưa ví dụ biến môi trường cho Claude Code, bao gồm tên model như deepseek-v4-pro[1m], deepseek-v4-flash.

1. Tạo DeepSeek API Key

Mở DeepSeek Platform:

https://platform.deepseek.com

Vào trang API Keys để tạo Key. DeepSeek thường yêu cầu nạp tiền trước khi gọi API.

2. Thêm DeepSeek trong CC Switch

Trong “Add Provider”, chọn preset DeepSeek rồi điền:

Lưu ý: ở đây dùng /anthropic, không phải /v1.

3. Cách điền ánh xạ mô hình khuyến nghị

Có thể ánh xạ theo hướng “model rẻ xử lý tác vụ thường ngày, model mạnh xử lý tác vụ phức tạp”:

Như vậy, khi chọn Sonnet trong Claude Desktop sẽ gọi deepseek-v4-flash tiết kiệm hơn; khi chọn Opus sẽ gọi deepseek-v4-pro mạnh hơn.

Nếu bạn muốn thử cách viết 1M trong tài liệu DeepSeek, có thể dùng trong trường “mô hình yêu cầu thực tế”:

deepseek-v4-pro[1m]

Tính khả dụng phụ thuộc vào tài liệu chính thức DeepSeek và khả năng hỗ trợ của bản CC Switch hiện tại.

Tám, bật định tuyến cục bộ

Sau khi bật ánh xạ mô hình, vẫn cần bật định tuyến cục bộ.

Thông thường đường dẫn là:

CC Switch → Cài đặt → Route

Cần bật hai mục:

1. Công tắc tổng của định tuyến: sau khi bật, trạng thái nên hiển thị là đang chạy. 2. Claude app route: tích Claude để lưu lượng Claude Desktop đi qua định tuyến cục bộ.

Địa chỉ dịch vụ mặc định thường là:

http://127.0.0.1:15721

Thông thường không cần chỉnh.

Nên bật luôn “Hiển thị công tắc định tuyến cục bộ trên trang chính”, để kiểm tra nhanh trạng thái định tuyến từ bảng điều khiển chính.

Chín, bật nhà cung cấp và khởi động lại Claude Desktop

Sau khi cấu hình xong, trong bảng Claude Desktop của CC Switch chọn nhà cung cấp vừa thêm rồi nhấn “Enable” (Bật).

Sau đó khởi động lại Claude Desktop.

Lưu ý, phải thoát hoàn toàn, không phải chỉ đóng cửa sổ:

• macOS: dùng Command + Q để thoát.
• Windows: vào khay hệ thống, chuột phải biểu tượng Claude, chọn thoát.

Mở lại Claude Desktop, gửi một câu thử:

你好，用一句话回复我。

Nếu trả lời bình thường, quay lại CC Switch xem lưu lượng proxy. Nếu thấy bản ghi request, nghĩa là chuỗi kết nối đã hoạt động.

Mười, câu hỏi thường gặp

1. Muốn chuyển về tài khoản chính thức của Claude thì sao?

Trong bảng Claude Desktop của CC Switch, tắt nhà cung cấp bên thứ ba hiện tại hoặc chuyển về cấu hình chính thức, rồi khởi động lại Claude Desktop.

2. Chuyển đổi giữa nhiều nhà cung cấp như thế nào?

Trong bảng Claude Desktop, chọn nhà cung cấp khác, nhấn enable rồi khởi động lại Claude Desktop. Không cần chỉnh định tuyến cục bộ lặp lại.

3. Claude Code có kết nối như vậy được không?

Được. CC Switch quản lý Claude Code và Claude Desktop bằng các panel riêng. Khác biệt là Claude Code thường phù hợp hơn cho môi trường phát triển dòng lệnh, còn Claude Desktop phù hợp cho hội thoại hàng ngày, tổng hợp tài liệu và làm việc trên desktop.

Tài liệu chính thức DeepSeek cũng có cách cấu hình biến môi trường cho Claude Code, ví dụ ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_MODEL.

4. Gặp lỗi thì chẩn đoán thế nào?

Ưu tiên kiểm tra các mục sau:

1. Request URL có bị thừa dấu / ở cuối không; 2. API Key có được sao chép đầy đủ không; 3. Định dạng API có đang chọn Anthropic Messages không; 4. “Cần ánh xạ mô hình” có bật không; 5. Model ID thực trong ánh xạ mô hình có đúng không; 6. Công tắc tổng của định tuyến cục bộ có đang chạy không; 7. Claude app route có được chọn không; 8. Claude Desktop có thực sự thoát và khởi động lại chưa.

Phần lớn lỗi kết nối thường do API Key, endpoint, model ID hoặc chưa bật định tuyến cục bộ.

5. CC Switch có phải luôn bật không?

Nếu bạn dùng model không phải Claude và dựa vào ánh xạ mô hình, CC Switch phải chạy ngầm ở nền.

Bạn có thể bật Lightweight Mode (chế độ nhẹ), để đóng cửa sổ chính chỉ còn tiến trình khay, và định tuyến cục bộ vẫn hoạt động.

Mười một, nên dùng như thế nào?

Gợi ý của tôi:

• Viết nội dung hàng ngày, tinh chỉnh văn bản web: có thể dùng model có tỷ lệ chi phí-hiệu quả cao trên OpenRouter;
• Xử lý bài viết tiếng Trung dài, hỗ trợ mã, suy luận phức tạp: có thể thử DeepSeek V4 Pro;
• Kiểm thử chi phí thấp: ưu tiên model rẻ hoặc model miễn phí;
• Nhiệm vụ quan trọng: vẫn nên quay về Claude chính thức, OpenAI hoặc model trả phí ổn định.

Lợi thế lớn nhất của nhà cung cấp bên thứ ba là linh hoạt và giá rẻ, nhưng vẫn cần chú ý đến độ ổn định, quyền riêng tư, độ trễ và sự khác biệt năng lực mô hình. Không nên buộc tất cả luồng công việc quan trọng vào một nhà cung cấp giá rẻ duy nhất; nên giữ phương án dự phòng.

Mười hai, kết luận

Ý nghĩa của CC Switch v3.15.0 là biến việc tích hợp mô hình bên thứ ba vào Claude Desktop từ “điền cấu hình thủ công” thành “chuyển đổi nhà cung cấp bằng giao diện đồ họa”.

Toàn bộ quy trình cốt lõi có thể tóm gọn năm bước:

Cài CC Switch → Vào bảng Claude Desktop → Thêm nhà cung cấp → Cấu hình ánh xạ mô hình → Bật định tuyến cục bộ và khởi động lại Claude Desktop

Chỉ cần hiểu rõ hai khái niệm “ánh xạ mô hình” và “định tuyến cục bộ”, các model ngoài Claude như OpenRouter, DeepSeek sẽ có thể được tích hợp vào Claude Desktop khá suôn sẻ.

Tài liệu tham khảo

• Trang chủ CC Switch
• Tải Claude Desktop chính thức
• Tài liệu cấu hình suy luận bên thứ ba của Claude Desktop
• OpenRouter chính thức
• OpenRouter API Keys
• OpenRouter Pricing
• OpenRouter Models
• DeepSeek Platform
• Tài liệu Anthropic API của DeepSeek
• Tài liệu tích hợp Claude Code của DeepSeek