Hướng dẫn cấu hình Claude Desktop (ứng dụng desktop)
Claude Desktop là ứng dụng desktop chính thức của Anthropic (Windows / macOS). Nó có sẵn mục cấu hình "third-party inference gateway", nên không cần đăng nhập tài khoản chính thức cũng có thể chuyển các yêu cầu hội thoại sang NextHub.
Đừng nhầm Claude Desktop với Claude Code
Claude Desktop (ứng dụng desktop) và Claude Code (dòng lệnh / plugin VS Code) là hai sản phẩm độc lập, cấu hình không thông nhau và cần cấu hình riêng. Trang này nói về ứng dụng desktop; cấu hình dòng lệnh xem cấu hình thủ công Claude Code.
Chuẩn bị
- Một ApiKey của nhóm Claude: claude code (0.37x), Claude Max (0.5x) hoặc Claude-AWSB (0.7x), xem quản lý ApiKey. Claude Desktop dùng giao thức Anthropic Messages, định dạng địa chỉ giống Claude Code
- Tải bộ cài cho hệ điều hành của bạn từ claude.com/download
Lưu ý khi cài đặt trên Windows
Trình cài đặt trên Windows cần truy cập dịch vụ chính thức của Anthropic khi chạy. Nếu mạng của bạn không kết nối trực tiếp được, hãy mở cmd trong thư mục chứa trình cài đặt, đặt biến môi trường proxy rồi khởi động trình cài đặt (thay port bằng port của bạn):
set HTTP_PROXY=http://127.0.0.1:7897
set HTTPS_PROXY=http://127.0.0.1:7897
"Claude Setup.exe"Trên macOS chỉ cần cài đặt bình thường.
Cấu hình thủ công (chế độ nhà phát triển)
1. Bật chế độ nhà phát triển
Mở Claude Desktop và vào màn hình đăng nhập:
- Windows: nhấp chuột vào ô nhập email để lấy focus, dùng phím
Tabđể chuyển focus sang menu ở góc trên bên trái, nhấn Enter để vào lần lượt Help → Troubleshooting → Enable developer mode - macOS: vào trực tiếp từ menu ở góc trên bên trái Help → Troubleshooting → Enable developer mode
Sau khi bật, đợi phần mềm tự khởi động lại.
2. Cấu hình third-party inference gateway
Mở menu theo cách tương tự, vào lần lượt Developer → Configure third-party inference, rồi điền theo bảng sau:
| Trường | Nội dung điền |
|---|---|
| Gateway base URL | https://api.nexthub.cc |
| Gateway auth scheme | x-api-key |
| Gateway API key | ApiKey NextHub của bạn (nhóm Claude) |
| Skip login-mode chooser | Bật |
Nhấn Apply locally ở góc dưới bên phải để áp dụng cấu hình.
Đừng đợi thông báo "kiểm tra thành công"
Trang này dùng chế độ gateway của bên thứ ba, không phải xác thực đăng nhập tài khoản chính thức của Anthropic, nên sẽ không có và cũng không cần đợi một thông báo "kết nối thành công / kiểm tra thành công". Sau khi nhấn Apply locally, quay lại hộp thoại và gửi tin; nhận được phản hồi là cấu hình đã có hiệu lực.
3. Xác minh
Tạo hội thoại mới và gửi một tin, nếu nhận được phản hồi bình thường từ Claude là đã kết nối thành công.
Lệnh gọi nhỏ ở tin nhắn đầu tiên
Sau khi tạo hội thoại mới, trong lịch sử tiêu thụ có thể xuất hiện một lệnh gọi nhỏ khác với model bạn chọn -- đó là do client tự động đặt tiêu đề cho hội thoại, số tiền rất nhỏ và là hiện tượng bình thường.
Cấu hình bằng CC-Switch (tùy chọn)
Thấy quy trình thủ công rườm rà? CC-Switch có sẵn bảng Claude Desktop, hỗ trợ nhập một chạm các nhà cung cấp đã cấu hình trong Claude Code:
- Mở CC-Switch, chọn Claude Desktop trong bộ chuyển ứng dụng ở bên trái (nếu không thấy, vào Settings → General → App visibility để kiểm tra mục nhập chưa bị ẩn)
- Vào lần đầu, nhấn "Nhập các nhà cung cấp đã có trong Claude Code"; hoặc nhấn dấu
+ở góc trên bên phải để thêm thủ công: địa chỉ endpoint điềnhttps://api.nexthub.cc, API Key điền khóa (API) của nhóm Claude - Trên thẻ nhà cung cấp, nhấn "Bật", sau đó thoát hoàn toàn và mở lại Claude Desktop (nó không tải lại cấu hình nóng như Claude Code, đóng cửa sổ không đồng nghĩa với thoát chương trình)
Hai cảnh báo sau khi khởi động lại là báo nhầm
Sau khi khởi động lại hoàn toàn, trang hội thoại có thể hiện các thanh cảnh báo như "cấu hình chưa xác minh", "kết nối mạng" -- đây là báo nhầm thông thường của chế độ gateway, hãy bỏ qua; gửi và nhận tin bình thường là cấu hình đã có hiệu lực. Nếu không nhận được phản hồi, kiểm tra lần lượt: CC-Switch có đang chạy không, địa chỉ endpoint và ApiKey có điền đúng không, có quên khởi động lại hoàn toàn không.