Hướng dẫn cấu hình VS Code
Dùng Guishu Token qua OpenAI Compatible trong VS Code + Cline.
Mục tiêu: Cài Cline trong VS Code, rồi kết nối Guishu Token theo cách OpenAI Compatible. Sau khi cấu hình xong, bạn có thể trực tiếp yêu cầu 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 chính thức hỗ trợ các nhà cung cấp tương thích OpenAI. |
| Base URL | https://api.llm-token.cn/v1 | Không điền đầy đủ đường dẫn /chat/completions. |
| API Key | sk-xxxxxxxx | Dán đầy đủ Key của bạn. |
| Model ID | Sao chép đầy đủ tên mô hình từ danh sách mô hình | Khi mô hình không tồn tại, gần như luôn là do điền sai ở đây. |
I. Chuẩn bị trước
- Cài VS Code: https://code.visualstudio.com/
- Cài Git: https://git-scm.com/downloads
- Người dùng Windows nên khởi động lại máy một lần sau khi cài Git để bảo đảm biến môi trường có hiệu lực.
II. Cài extension Cline
- Mở VS Code, nhấp vào chợ extension Extensions ở thanh bên trái.
- Tìm Cline, rồi nhấp Install.
- Sau khi cài xong, biểu tượng Cline sẽ xuất hiện ở thanh bên trái.
- Nếu biểu tượng chưa xuất hiện, hãy khởi động lại VS Code.
Hình này hiển thị giao diện tìm plugin Cline trong VS Code. Bên trái có…
III. Mở cài đặt Cline
Nhấp biểu tượng Cline ở thanh bên trái, sau khi vào bảng điều khiển Cline thì mở cài đặt.
Hình này là ảnh chụp màn hình giao diện trong bước cài đặt Cline của VS…
Hình này hiển thị giao diện cài đặt của plugin Cline trong VS Code. Bên…
IV. Điền giao diện Token của Guishu
- 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 đầy đủ model ID, ví dụ
claude-sonnet-4-6. - Sau khi lưu cấu hình, tạo tác vụ mới để kiểm tra.
Nếu lưu mà báo lỗi: hãy xác nhận trước rằng Base URL không bị điền thành https://api.llm-token.cn/v1/chat/completions. Cline cần điền đường dẫn gốc của API, tức là /v1.
V. Kiểm tra và xử lý sự cố
| Hiện tượng | Cách xử lý |
|---|---|
| Không thể điền URL | Xác nhận bạn đã chọn OpenAI Compatible, không phải nhà cung cấp OpenAI chính thức thông thường. |
| Model Not Found | Model ID phải hoàn toàn trùng khớp với danh sách mô hình. |
| Kết nối thất bại | Kiểm tra Key, Base URL, proxy mạng; nếu đang dùng mạng công ty 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; nếu vẫn không có thì cài lại extension. |