Hướng dẫn thực tế: Tích hợp Continue với API trung gian trong VS Code
Hướng dẫn tích hợp tiện ích mở rộng Continue: Thêm Provider tùy chỉnh trong config.yaml, cấu hình Base URL và khóa API sk- để điều phối thống nhất Claude / GPT / Gemini.
1. Continue là gì?
Continue là một tiện ích mở rộng lập trình AI mã nguồn mở miễn phí trên VS Code, hỗ trợ cấu hình nhiều Provider tùy chỉnh. Bằng cách trỏ Provider vào cổng kết nối (gateway) của chúng tôi, bạn có thể gọi Claude / GPT / Gemini một cách thống nhất và tính phí tập trung.
2. Chuẩn bị
- Đăng nhập vào bảng điều khiển API, tạo API Key
sk-xxxxxx(chỉ hiển thị một lần, vui lòng lưu lại). - Xác nhận slug của model bạn muốn sử dụng (ví dụ:
claude-sonnet-5,gpt-5.5,gemini-3.7-flash). - Xác nhận địa chỉ gateway:
https://www.relay-api.com.
3. Cấu hình Continue
Chỉnh sửa tệp ~/.continue/config.yaml (hoặc .continue/config.yaml), thêm Provider cho mỗi model:
models:
- title: Claude Sonnet 5
provider: anthropic
model: claude-sonnet-5
apiBase: "https://www.relay-api.com"
apiKey: sk-key_cua_ban
- title: GPT-5.4
provider: openai
model: gpt-5.5
apiBase: "https://www.relay-api.com/v1"
apiKey: sk-key_cua_ban
- title: Gemini 3.7 Flash
provider: gemini
model: gemini-3.7-flash
apiBase: "https://www.relay-api.com"
apiKey: sk-key_cua_ban
Sau khi lưu, hãy khởi động lại tiện ích và sử dụng /models để chuyển đổi giữa các model.
4. Đối chiếu địa chỉ giao diện (API)
| Nhóm model | Địa chỉ truy cập (apiBase) | Giao thức |
|---|---|---|
| Claude / Anthropic | https://www.relay-api.com | Anthropic Messages |
| GPT / OpenAI | https://www.relay-api.com/v1 | OpenAI Chat Completions |
| Gemini | https://www.relay-api.com | Google generateContent |
5. Khắc phục sự cố thường gặp
| Hiện tượng | Xử lý |
|---|---|
| 401 / 403 | Khóa API không hợp lệ, chưa được kích hoạt hoặc không đủ số dư; xác nhận sk- đúng và nạp thêm tiền. |
| 404 / Model không khả dụng | Tên model không khớp với slug trên nền tảng, hoặc model đó chưa được kích hoạt; kiểm tra lại ID model. |
Khuyến nghị bảo mật: Không đẩy khóa API lên các kho lưu trữ công khai; các tác vụ tạo nội dung tiêu tốn nhiều token, hãy chú ý đến số dư.
Giải thích về Base URL: Hệ thống của chúng tôi chấp nhận cả /v1beta/models/... và /v1beta/v1beta/models/... (cũng như /v1/... và /v1/v1/...), vì vậy dù máy khách có tự động thêm /v1beta hay không, bạn vẫn có thể điền Base URL là https://www.relay-api.com hoặc https://www.relay-api.com/v1beta để gọi API bình thường. Sau khi điền xong, hãy nhấp vào Connect / Kiểm tra trong Continue; nếu vẫn báo lỗi 404, trước tiên hãy xác nhận rằng ID model khớp với "ID Model" ở góc trên bên phải trang "Token" trong bảng điều khiển.
