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 VS Code

发布时间2026年8月30日 09:08
语言vi

Hướng dẫn kết nối trung chuyển cho Cline, tác nhân lập trình AI mã nguồn mở trên 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.

一、Cline 是什么

Cline là tác nhân lập trình AI mã nguồn mở phổ biến trên VS Code, có khả năng đọc kho lưu trữ mã nguồn, sửa đổi tệp và chạy các lệnh terminal. Nó hỗ trợ sẵn nhiều nhà cung cấp như Anthropic / OpenAI / Google (Gemini). Chỉ cần trỏ API Provider của nó đến gateway trung chuyển và nhập khóa sk-, bạn có thể sử dụng hạn mức của nền tảng để gọi các mô hình Claude / GPT / Gemini và thanh toán theo token.

二、Công tác chuẩn bị

Đăng nhập vào bảng điều khiển API, tạo khóa sk-xxxxxx trong phần "API Key" (khóa 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 bạn muốn sử dụng (ví dụ: claude-sonnet-5, gpt-5.4, gemini-3.7-flash).
Xác nhận địa chỉ gateway: https://www.relay-api.com.

三、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.4

③ Gọi Gemini: Chọn Provider Google Gemini (hoặc OpenAI-compatible), Base URL sử dụng https://www.relay-api.com/v1beta, Model ID sử 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.

四、Đối chiếu địa chỉ giao diện (API)

Nhóm mô hình	Địa chỉ入口 (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

五、Khắc phục sự cố thường gặp

Hiện tượng	Cách xử lý
401 / 403	Khóa không hợp lệ, chưa được 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 của nền tảng, hoặc mô hình chưa được kích hoạt; kiểm tra lại Model ID.
Unknown model	Model ID nhập vào phải chính xác (bao gồm cả chữ hoa/thường), kiểm tra đối chiếu trong thư viện mô hình.

Lời khuyên bảo mật: Không viết trực tiếp khóa vào các 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ỗi khóa cho từng công cụ để dễ quản lý thống kê và giới hạn hạn mức.