Cấu hình Cline

Cline là AI coding assistant trong VS Code, hỗ trợ cấu hình provider OpenAI-compatible. Tài liệu này hướng dẫn dùng Cline với API key của ShopAIKey.

Endpoint

https://api.shopaikey.com/v1

1. Cài đặt Cline

1. Mở VS Code.
2. Vào Extensions.
3. Tìm Cline.
4. Cài extension chính thức.
5. Mở Cline từ sidebar của VS Code.

2. Mở phần cấu hình provider

Trong Cline:

1. Bấm biểu tượng cài đặt.
2. Tìm phần API Provider.
3. Chọn OpenAI Compatible.

Không chọn provider OpenAI mặc định nếu bạn cần nhập custom Base URL. Hãy chọn đúng OpenAI Compatible.

3. Nhập thông tin ShopAIKey

Điền các trường như sau:

Sau đó bấm Verify nếu Cline có nút kiểm tra kết nối.

4. Gợi ý model

Bạn có thể bắt đầu với một trong các model sau:

gpt-5.2
gpt-5.3-codex
claude-sonnet-4-5
claude-opus-4-5
deepseek-v3.2
qwen3-coder-plus

Nếu model không hoạt động, hãy kiểm tra lại danh sách model hiện có tại trang Models của ShopAIKey.

5. Thiết lập nâng cao

Trong phần model configuration của Cline, bạn có thể chỉnh:

• Max Output Tokens: số token tối đa cho câu trả lời.
• Context Window: ngữ cảnh tối đa của model.
• Image Support: bật nếu model hỗ trợ ảnh.
• Computer Use / Tool Use: chỉ bật khi model và Cline version đang hỗ trợ.
• Input Price / Output Price: có thể để mặc định nếu bạn chỉ cần dùng, không cần Cline tự tính chi phí.

6. Cách dùng

Sau khi cấu hình xong:

1. Mở một project trong VS Code.
2. Mở Cline ở sidebar.
3. Nhập yêu cầu, ví dụ:

Đọc project này và giải thích luồng đăng nhập.

Hoặc:

Viết test cho component thanh toán hiện tại.

7. Lưu ý quan trọng

• API key ShopAIKey phải còn credit.
• Base URL phải có /v1 ở cuối.
• Nếu dùng model Claude qua OpenAI-compatible provider, vẫn dùng endpoint https://api.shopaikey.com/v1.
• Không commit API key vào repository.
• Nếu Cline báo lỗi kết nối, hãy thử restart VS Code sau khi đổi provider.

8. Khắc phục sự cố

Invalid API Key

• Kiểm tra key đã copy đúng chưa.
• Kiểm tra key còn credit không.
• Kiểm tra key có bị thu hồi không.

Model Not Found

• Kiểm tra model id nhập đúng chưa.
• Thử model phổ biến như gpt-5.2 hoặc claude-sonnet-4-5.
• Xem danh sách model mới nhất ở trang Models.

Connection Error

• Kiểm tra Base URL là https://api.shopaikey.com/v1.
• Kiểm tra mạng.
• Restart VS Code rồi thử lại.