Kết nối Cursor / Claude Code / Cherry Studio với AI Gateway tùy chỉnh

Hướng dẫn · 2026-11-20 · 7 phút đọc

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.

Điều kiện tiên quyết: bạn đã có khóa API. Nếu chưa, hãy hoàn tất đăng ký và tạo khóa qua «Kết nối AI API hợp nhất trong 5 phút». Bài dùng Base URL của 4-4 AI (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:

  1. Mở Settings → Models (hoặc trang cài đặt Models);
  2. Mở rộng vùng OpenAI API Key: nhập khóa gateway (sk-...);
  3. Đánh dấu/điền Override OpenAI Base URL: https://www.4-4.vip/v1;
  4. 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);
  5. 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"
Hai chi tiết: ① ANTHROPIC_BASE_URL không kèm hậu tố /v1 (đường dẫn giao thức Anthropic do công cụ tự ghép); ② nếu muốn Claude Code dùng mô hình ngoài họ Claude, hãy xác nhận kênh gateway đã cấu hình mapping mô hình tương ứng và dùng tên mô hình phía gateway.

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:

  1. Cài đặt → Dịch vụ mô hình: thêm/chọn một nhà cung cấp tương thích OpenAI;
  2. Địa chỉ API điền https://www.4-4.vip/v1 (một số bản tự điền /v1, chú ý đừng trùng);
  3. Khóa API điền khóa gateway;
  4. 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ìnhGiá trịCạm bẫy thường gặp
Base URLhttps://www.4-4.vip/v1Cô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 KeyKhó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ìnhTên như trong kênh của gatewayPhả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

404 Not Found

400 Model Not Found / không có kênh khả dụng

Streaming đứt / không phản hồi

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

Bắt đầu nhanh với 4-4 AI: Kết nối AI API hợp nhất trong 5 phút Giao diện tương thích OpenAI: một khóa cho GLM, DeepSeek, Qwen và hơn nữa. Ví dụ chạy được bằng ba ngôn ngữ. 7 thực hành kỹ thuật giúp giảm chi phí token của ứng dụng AI Định tuyến theo cấp mô hình, cắt gọn ngữ cảnh, cache tiền tố, rào chắn ngân sách — bảy thực hành bền vững có t
Sẵn sàng kết nối chưa?

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í