Hướng dẫn cấu hình Cline với Beeknoee

4:50

Cline là gì?

Cline là AI coding extension mạnh mẽ cho VS Code — hỗ trợ chỉnh sửa nhiều file, chạy lệnh terminal, và tương tác browser. Cline hoạt động như một AI coding agent, có thể tự động thực hiện các tác vụ phức tạp trong project của bạn.

💡 Cline hỗ trợ OpenAI-compatible API — chỉ cần nhập Base URL và API Key của Beeknoee là dùng được ngay.

Yêu cầu

• VS Code phiên bản mới nhất
• API Key từ Beeknoee Platform

📌 Bước 1: Tạo API Key

1. Truy cập https://platform.beeknoee.com/api-keys
2. Đăng nhập bằng tài khoản Google
3. Nhấn "Tạo API Key"
4. Copy API Key (dạng sk-bee-xxxx...)

⚠️ API key chỉ hiển thị 24 giờ đầu — copy và lưu ngay!

📌 Bước 2: Cài đặt Cline

1. Mở VS Code
2. Vào Extensions (Ctrl+Shift+X)
3. Tìm "Cline" → nhấn Install
4. Sau khi cài, icon robot 🤖 sẽ xuất hiện ở Activity Bar (thanh bên trái)

Hoặc mở Command Palette (Ctrl+Shift+P) → gõ "Cline: Open Panel"

📌 Bước 3: Cấu hình Beeknoee API

1. Nhấn vào icon Cline 🤖 ở Activity Bar → mở panel Cline
2. Nhấn vào nút Settings (⚙️) ở góc trên panel
3. Tại mục API Provider, chọn: OpenAI Compatible
4. Điền thông tin:

5. Nhấn Save hoặc Done

💡 Nên khai báo thêm Model Capabilities. Với provider OpenAI Compatible, Cline không tự biết model của bạn có khả năng gì, nên mặc định nó đoán khá dè dặt. Mở phần cấu hình nâng cao và điền:

Mục	Nên đặt
Context Window	Đúng context của model (xem trang Models) — để sai sẽ bị cắt hội thoại sớm
Max Output Tokens	Theo model, thường 8192–64000
Image Support	Bật nếu model đọc được ảnh (Claude, GPT, Gemini)
Computer Use / Tool Use	Bật — nếu tắt, Cline không gọi được tool và agent gần như vô dụng

Không điền thì Cline vẫn chạy, nhưng dễ gặp cảnh "agent không chịu sửa file" hoặc "quên mất đoạn đầu hội thoại".

⚠️ Base URL phải kết thúc bằng /v1: https://platform.beeknoee.com/v1

💡 Xem đầy đủ danh sách Model ID tại trang Text Models — ấn nút Copy ID trên mỗi card.

📌 Bước 4: Sử dụng

Sau khi cấu hình xong, bạn có thể chat trực tiếp trong panel Cline:

Các chế độ hoạt động

Ví dụ sử dụng

> Tạo component Button với variant và size props sử dụng TypeScript
> Fix lỗi TypeScript trong file UserService.ts
> Refactor file này theo SOLID principles
> Viết unit test cho function calculateTotal()

Context Management

• Gõ @file để thêm file cụ thể vào context
• Gõ @folder để thêm cả thư mục
• Cline tự động đọc file liên quan khi bạn mô tả task

📌 Nâng cao: MCP Integration

Cline hỗ trợ Model Context Protocol (MCP) — cho phép AI truy cập thêm context từ các nguồn bên ngoài:

1. Trong Cline Settings → mục MCP Servers
2. Thêm MCP server (ví dụ: Context7 để tự động tìm docs)
3. AI sẽ có thêm context để trả lời chính xác hơn

Models khuyên dùng với Cline

💡 Model ID chính xác và giá realtime xem tại trang Models trên Dashboard. Mẹo: dùng model mạnh (Claude Sonnet/Opus) cho tác vụ agent phức tạp, model rẻ (DeepSeek / GLM Flash) cho hỏi nhanh hoặc giải thích code.

🆓 Models miễn phí qua BeeSynapse

Khi đã kết nối email tại trang BeeSynapse Integrations, hệ thống tự động ưu tiên free quota:

Danh sách model free thay đổi theo quota nhà cung cấp — xem chính xác tại trang BeeSynapse Integrations. Bạn không cần thay đổi gì — Beeknoee tự route qua free quota trước, hết quota mới trừ VND.

Xử lý lỗi

"API Error" hoặc "Request failed"

• Kiểm tra API Provider đã chọn OpenAI Compatible (không phải OpenAI)
• Kiểm tra Base URL đúng: https://platform.beeknoee.com/v1

"401 Unauthorized"

• Kiểm tra API Key bắt đầu bằng sk-bee-
• Kiểm tra key chưa bị thu hồi tại API Keys
• Kiểm tra số dư tài khoản

"Model not found"

• Kiểm tra Model ID chính xác tại Text Models
• Model ID phân biệt HOA-thường

Cline không respond

• Thử đổi model sang deepseek/deepseek-v4-flash hoặc glm-4.7-flash để test kết nối
• Kiểm tra output panel (View → Output → chọn "Cline") để xem log lỗi

HOÀN TẤT! 🎉

Cần hỗ trợ thêm? Sử dụng Support Chat (góc dưới phải trên platform) hoặc liên hệ qua email.