Hướng dẫn kết nối API trung chuyển cho Cline: Cấu hình tác nhân lập trình trên VS Code
Hướng dẫn kết nối tác nhân lập trình AI mã nguồn mở Cline trong VS Code: Tạo khóa sk-, cấu hình API Provider và Base URL để gọi các mô hình Claude / GPT / Gemini.
I. Cline là gì?
Cline là một tác nhân (agent) lập trình AI mã nguồn mở phổ biến trong VS Code, có khả năng đọc kho lưu trữ mã nguồn, chỉnh sửa tệp và chạy các lệnh terminal. Nó hỗ trợ mặc định nhiều nhà cung cấp (Provider) như Anthropic / OpenAI / Google (Gemini). Bạn chỉ cần trỏ API Provider đến cổng trung chuyển (gateway), nhập khóa sk-, là có thể sử dụng hạn mức của nền tảng để gọi Claude / GPT / Gemini và tính phí theo token.
II. Chuẩn bị
- Đăng nhập vào bảng điều khiển API của chúng tôi, tạo khóa
sk-xxxxxxtrong mục "API Key" (chỉ hiển thị một lần, vui lòng lưu lại). - Xác nhận slug của mô hình 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.
III. Cấu hình trong Cline
Mở Cline → biểu tượng bánh răng (Settings) → API Provider, chọn theo loại mô hình:
① Anthropic (dùng cho Claude)
Base URL : https://www.relay-api.com
API Key : sk-khóa_của_bạn
Model ID : claude-sonnet-5② OpenAI Compatible (dùng cho GPT)
Base URL : https://www.relay-api.com/v1
API Key : sk-khóa_của_bạn
Model ID : gpt-5.5③ Dùng cho Gemini: Chọn Provider là Google Gemini (hoặc OpenAI-compatible), Base URL dùng https://www.relay-api.com/v1beta, Model ID dùng gemini-3.7-flash (tên mô hình đi theo URL).
Sau khi điền xong, nhấn Connect / Continue để xác thực. Sử dụng Base URL tương ứng trong bảng dưới đây.
IV. Bảng đối chiếu địa chỉ giao diện
| Nhóm mô hình | Cổng vào (Base URL) | 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/v1beta | Google generateContent |
V. Xử lý sự cố thường gặp
| Hiện tượng | Xử lý |
|---|---|
| 401 / 403 | Khóa không hợp lệ, chưa kích hoạt hoặc không đủ số dư; kiểm tra lại khóa sk- và nạp tiền. |
| 404 / Mô hình không khả dụng | Tên mô hình không khớp với slug trên nền tảng, hoặc mô hình chưa được bật; kiểm tra lại Model ID. |
| Unknown model | ID mô hình cần chính xác (bao gồm cả chữ hoa/thường), kiểm tra tại mục Model Plaza. |
Khuyến nghị bảo mật: Không để khóa API trong kho lưu trữ công khai, hãy sử dụng .env hoặc biến môi trường; tạo riêng một Khóa cho mỗi công cụ để dễ dàng thống kê và quản lý hạn mức.
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 việc client tự thêm /v1 hoặc /v1beta hay không đều không ảnh hưởng đến việc gọi API: Bạn có thể điền Base URL là gốc tên miền hoặc địa chỉ có kèm /v1beta đều hoạt động. Vui lòng tra cứu và sao chép Model ID tại mục "Model ID" ở góc trên bên phải trang "Token" trong bảng điều khiển.