Kết nối Cursor / Claude Code / Cherry Studio với AI Gateway tùy chỉnh
Các công cụ AI chủ đạo đều hỗ trợ API tùy chỉnh — nghĩa là bạn có thể trỏ chúng về gateway của riêng mình (như 4-4 AI) và hợp nhất khóa lẫn thanh toán. Bài này bao gồm cách cấu hình ba công cụ được dùng nhiều nhất và tư duy xử lý lỗi chung.
https://www.4-4.vip/v1) làm ví dụ; gateway tương thích OpenAI khác cũng tương tự.Cursor
Mô hình hội thoại của Cursor có thể dùng giao diện tùy chỉnh tương thích OpenAI:
- Mở
Settings → Models(hoặc trang cài đặtModels); - Mở rộng vùng
OpenAI API Key: nhập khóa gateway (sk-...); - Đánh dấu/điền
Override OpenAI Base URL:https://www.4-4.vip/v1; - Thêm vào danh sách mô hình tên có sẵn trong gateway của bạn (khớp hoàn toàn với tên kênh của gateway, phân biệt chữ hoa-thường);
- Sau khi Verify qua, chỉ cần chuyển sang mô hình tùy chỉnh ở dưới khung hội thoại.
Lưu ý: gợi ý Tab tích hợp của Cursor và một phần Composer chạy trên dịch vụ riêng của Cursor nên không bị ảnh hưởng; mô hình tùy chỉnh chủ yếu dùng cho hội thoại.
Claude Code
Claude Code dùng giao thức Anthropic. Điều kiện để đi qua gateway là gateway hỗ trợ endpoint giao thức Anthropic (/v1/messages) — gateway trên nền new-api (gồm 4-4 AI) hỗ trợ chuyển đổi này; các yêu cầu giao thức Claude được chuyển đổi rồi định tuyến tới kênh mô hình thực tế.
Cấu hình bằng biến môi trường (trong terminal khởi chạy claude):
export ANTHROPIC_BASE_URL="https://www.4-4.vip"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_GATEWAY_KEY"
# start
claude
Trên Windows PowerShell:
$env:ANTHROPIC_BASE_URL = "https://www.4-4.vip"
$env:ANTHROPIC_AUTH_TOKEN = "sk-YOUR_GATEWAY_KEY"
Cherry Studio
Cherry Studio hỗ trợ nhà cung cấp tùy chỉnh tương thích OpenAI trực tiếp nhất:
Cài đặt → Dịch vụ mô hình: thêm/chọn một nhà cung cấp tương thích OpenAI;- Địa chỉ API điền
https://www.4-4.vip/v1(một số bản tự điền /v1, chú ý đừng trùng); - Khóa API điền khóa gateway;
- Trong quản lý mô hình, thêm thủ công tên mô hình khả dụng, lưu rồi chọn trong hội thoại.
Quy luật chung: mọi công cụ tương thích OpenAI
Hàng loạt công cụ (LobeChat, Open WebUI, Immersive Translate, nhiều plugin IDE) đều theo cùng một quy trình cấu hình — nhớ bộ ba:
| Mục cấu hình | Giá trị | Cạm bẫy thường gặp |
|---|---|---|
| Base URL | https://www.4-4.vip/v1 | Công cụ này cần /v1, công cụ kia không — gặp 404 hãy thử thêm/bỏ /v1 trước |
| API Key | Khóa gateway (sk-...) | Dấu cách đầu-cuối, khóa hết hạn, tín dụng cạn |
| Tên mô hình | Tên như trong kênh của gateway | Phải khớp tuyệt đối với phía gateway; tên không có trong preset của công cụ sẽ không dùng được |
Cẩm nang xử lý lỗi (tra nhanh)
401 Unauthorized
- Sao chép khóa dính dấu cách/xuống dòng → sao chép lại;
- Khóa bị vô hiệu hoặc tín dụng cạn → kiểm tra trang token trong bảng điều khiển gateway;
- Header Authorization sai định dạng → phải là
Bearer sk-....
404 Not Found
- Đường dẫn Base URL sai → thử qua lại giữa «có /v1» và «không /v1»;
- Endpoint giao thức mà công cụ yêu cầu gateway không hỗ trợ → xác nhận gateway có hỗ trợ giao thức đó (OpenAI /v1/chat/completions hoặc Anthropic /v1/messages).
400 Model Not Found / không có kênh khả dụng
- Tên mô hình không khớp kênh gateway → đối chiếu tên trong trang mô hình/kênh của bảng điều khiển;
- Kênh bị vô hiệu hoặc nhóm không có quyền → kiểm tra phạm vi mô hình và cài đặt nhóm của token.
Streaming đứt / không phản hồi
- Proxy công ty đệm SSE → thử trên mạng kết nối thẳng;
- Timeout của công cụ quá ngắn → tăng lên; nhiệm vụ văn bản dài ưu tiên xác nhận gateway không ép timeout.
Câu hỏi thường gặp (FAQ)
Dữ liệu có an toàn khi đi qua gateway không?
Yêu cầu của bạn đi qua gateway tới kênh mô hình thượng nguồn. Khi chọn gateway hãy kiểm tra chính sách log và quyền riêng tư của nó; với dữ liệu nhạy cảm, tắt lưu log hội thoại phía gateway hoặc dùng kênh không lưu dữ liệu.
Một công cụ có thể cấu hình nhiều gateway cùng lúc không?
Đa số công cụ hỗ trợ nhiều nhà cung cấp và chuyển đổi ngay lập tức (như Cherry Studio, Cursor). Dùng token khác nhau cho từng công cụ còn tách được thống kê sử dụng và hạn mức riêng.
Vì sao khuyến nghị gateway hợp nhất thay vì mỗi công cụ kết nối thẳng từng nhà cung cấp?
Ba lý do: quản lý khóa tập trung (thu hẹp bề mặt rò rỉ), thanh toán và sử dụng hiển thị hợp nhất (không phải đối chiếu trên nhiều nền tảng), mô hình thay thế bất cứ lúc nào (tách rời nhà cung cấp — chuyển đổi chỉ đụng cấu hình gateway).
Bài viết liên quan
Một khóa cho GLM, DeepSeek, Qwen và các mô hình hàng đầu: thanh toán hợp nhất và trực quan hóa mức sử dụng.
Xem mô hình và giá Dùng thử miễn phí