← Tất cả ứng dụng · Mục Kết nối trên /docs
Hạn chế / tuỳ bảnCấu hình tay
Claude Desktop
Còn gọi: Claude app
Claude Desktop: kiểm tra phiên bản và tùy chọn khóa riêng/URL tùy chỉnh trước khi cấu hình.
Hướng dẫn đã xuất bản · Phiên bản ứng dụng: chưa xác minh
Ví dụ chat, ping, invoke hoặc tạo nội dung có thể gửi yêu cầu thật và phát sinh phí. Kiểm tra model, số dư, đơn giá và mức tối thiểu trước khi chạy; GET /v1/models chỉ kiểm tra xác thực và danh mục. Đặt biến môi trường an toàn
URL gốc phải dán
SDK OpenAI thường dùng URL kết thúc bằng /v1; SDK Anthropic dùng URL gốc. Tránh thêm /v1 hai lần. Giao thức tương thích không bảo đảm mọi tính năng của nhà cung cấp.
Xem ghi chú / theo protocolApp này có ngoại lệ — đọc mục Ghi chú bên dưới trước khi dán.
Chuẩn bị
- Claude Desktop đã cài
- API key CadHayVN (nếu bản Desktop của bạn có ô API / custom endpoint)
- Nếu không có BYOK: dùng Claude Code thay thế với cùng key
Model khuyến nghị: claude-fable-5
Cách nhanh — lệnh / cấu hình
1. Mở Claude Desktop → Settings
2. Tìm mục API key / Custom endpoint / Developer
3. Nếu CÓ ô Base URL + API key:
Base URL : https://api.cadhayvn.com
API Key : sk-cad-...
Model : claude-fable-5 (nếu chọn được)
4. Nếu KHÔNG có ô đó:
→ Cài Claude Code + api-cli configure claude
→ Hoặc dùng Studio AI / Chatbox trên CadHayVNBỏ file / điền Settings ở đâu
Giao diệnmacos
Claude → Settings
Tìm API/custom endpoint. Không có thì dừng — dùng Claude Code.
Giao diệnwindows
Claude Desktop → Settings
Giống macOS. Dữ liệu app thường dưới %APPDATA%\Claude — không sửa lung tung.
Giao diệnlinux
Settings trong app
Tuỳ bản đóng gói; ưu tiên Claude Code trên Linux.
Kiểm tra đã chạy đúng
- Nếu BYOK được: gửi tin nhắn → Dashboard Sử dụng có dòng mới.
- Nếu không BYOK: xác nhận Claude Code đã trừ ví CadHayVN thay thế.
Khắc phục sự cố
| Triệu chứng | Nguyên nhân | Cách xử lý |
|---|---|---|
| App chỉ yêu cầu login Claude.ai | Bản Desktop không hỗ trợ custom API gateway. | Dùng Claude Code / OpenClaw / Chatbox với key CadHayVN — đây là đường được hỗ trợ đầy đủ. |
| 401 sau khi dán key | Key sai hoặc app vẫn gửi tới api.anthropic.com. | Xác nhận Base URL là CadHayVN; thử curl troubleshooting trên /docs. |
Ghi chú
- Không hướng dẫn crack/patch Claude Desktop.
- MCP trong Desktop (nếu có) khác với việc đổi model gateway.
