VS Code Hướng dẫn cấu hình
Kết nối LLM API Gateway Token trong VS Code + Cline bằng phương thức tương thích OpenAI Compatible.
Mục tiêu: Cài đặt Cline trong VS Code và kết nối LLM API Gateway Token qua phương thức tương thích OpenAI Compatible. Sau khi cấu hình, bạn có thể nhờ AI đọc code, sửa code, viết lệnh và giải thích lỗi ngay trong VS Code.
| Mục cấu hình | Nội dung điền | Ghi chú |
|---|---|---|
| API Provider | OpenAI Compatible | Cline hỗ trợ chính thức nhà cung cấp tương thích OpenAI. |
| Base URL | https://api.llm-token.cn/v1 | Không điền đường dẫn /chat/completions đầy đủ. |
| API Key | sk-xxxxxxxx | Dán toàn bộ Key của bạn. |
| Model ID | Sao chép tên model đầy đủ từ danh sách model | Khi model không tồn tại, hầu hết là do điền sai ở đây. |
1. Chuẩn bị
- Cài đặt VS Code: https://code.visualstudio.com/
- Cài đặt Git: https://git-scm.com/downloads
- Người dùng Windows sau khi cài Git nên khởi động lại máy một lần để biến môi trường có hiệu lực.
2. Cài đặt tiện ích mở rộng Cline
- Mở VS Code, bấm Extensions ở bên trái để vào chợ tiện ích mở rộng.
- Tìm kiếm Cline, bấm Install.
- Sau khi cài xong, biểu tượng Cline xuất hiện ở bên trái.
- Nếu biểu tượng không xuất hiện, khởi động lại VS Code.
Ảnh minh họa giao diện tìm kiếm plugin Cline trong VS Code. Ở bên trái c…
3. Mở cài đặt Cline
Bấm biểu tượng Cline ở bên trái, vào bảng Cline rồi mở cài đặt.
Ảnh chụp giao diện bước cài đặt Cline trong VS Code, tương ứng bước mở c…
Ảnh hiển thị giao diện cài đặt của plugin Cline trong VS Code. Bên trái…
Ảnh trên chỉ dùng để định vị các trường của Cline. Địa chỉ http://... và tên model bên thứ ba trong ảnh không phải cấu hình của LLM API Gateway, đừng sao chép theo; giá trị thực tế lấy theo HTTPS Base URL trong bảng của bài viết và danh sách model trên trang này.
4. Điền giao diện LLM API Gateway Token
- API Provider: Chọn OpenAI Compatible.
- Base URL: Điền
https://api.llm-token.cn/v1. - API Key: Dán Key bắt đầu bằng
sk-của bạn. - Model ID: Điền Model ID đầy đủ, ví dụ
claude-sonnet-4-6. - Lưu cấu hình rồi tạo task mới để kiểm thử.
Nếu lưu bị báo lỗi: Trước tiên xác nhận Base URL không viết thành https://api.llm-token.cn/v1/chat/completions. Cline cần điền API đường dẫn gốc, tức là /v1.
5. Kiểm thử và xử lý sự cố
| Hiện tượng | Cách xử lý |
|---|---|
| Không điền được URL | Xác nhận đã chọn OpenAI Compatible, không phải nhà cung cấp chính thức OpenAI thông thường. |
| Model Not Found | Model ID phải khớp hoàn toàn với danh sách model. |
| Kết nối thất bại | Kiểm tra Key, Base URL, proxy mạng; mạng cơ quan hoặc mạng trường có thể đổi sang hotspot để thử. |
| Không có biểu tượng Cline | Khởi động lại VS Code; vẫn không có thì cài lại tiện ích mở rộng. |