Cline cho Mã VS là gì?
Cline là một tác nhân mã hóa nguồn mở cho VS Code, có thể sử dụng OpenAI-compatible API tùy chỉnh để đọc mã, đề xuất chỉnh sửa và chạy các công cụ được phê duyệt.
Thiết lập Cline VS Code này giữ thông tin xác thực nhà cung cấp của bạn và lựa chọn mô hình trong cài đặt riêng của Cline, sau đó xác minh kết nối bằng tác vụ mã hóa chỉ đọc trước khi bất kỳ quyền truy cập ghi nào được phê duyệt. Cline kết hợp các phản hồi của mô hình với quyền truy cập tệp, lệnh đầu cuối, hành động của trình duyệt và kiểm soát phê duyệt bên trong trình chỉnh sửa. Phản hồi trò chuyện thành công chỉ là lần kiểm tra đầu tiên: sử dụng không gian làm việc thử nghiệm, tắt phê duyệt tự động ngay từ đầu và xác minh native tool calling trước khi dựa vào mô hình để chỉnh sửa hoặc thực hiện các tác vụ tự động kéo dài.
Cline có thể định tuyến yêu cầu mô hình qua cổng API OpenAI compatible tương thích của TokenHub. Giữ nguyên cách cài đặt chính thức, sau đó thay API key, Base URL và model ID.
Endpoint TokenHub dùng trong hướng dẫn này là https://us-api.tokenhub.com/v1/chat/completions.
Khi nào nên dùng
Bắt đầu với repository nhỏ hoặc dự án thử nghiệm. Trước tiên yêu cầu công cụ đọc file, giải thích mã hoặc lập kế hoạch, rồi mới bật chỉnh sửa.
Cài đặt hoặc mở công cụ
Làm theo tài liệu chính thức của Cline để cài đặt hoặc mở công cụ. Nếu giao diện thay đổi, ưu tiên tài liệu hiện tại.
Với công cụ CLI, hãy kiểm tra executable trước khi thêm thông tin xác thực TokenHub:
# open the tool, then open its model or provider settingsChuẩn bị thông tin xác thực TokenHub
Tạo TokenHub API key và chọn một mô hình phù hợp từ danh sách mô hình TokenHub.
export TOKENHUB_API_KEY="sk-..."Lưu key trong shell cục bộ, kho bí mật của IDE hoặc trường API key an toàn của công cụ. Không commit key vào repository.
Cấu hình nhà cung cấp TokenHub
Trong phần Models, Providers, API Keys hoặc OpenAI Compatible, nhập các giá trị dưới đây.
Giá trị provider
| Trường | Giá trị |
|---|---|
| Nhà cung cấp | OpenAI Compatible hoặc Custom |
| Base URL | https://us-api.tokenhub.com/v1 |
| API Key | Giá trị của TOKENHUB_API_KEY |
| Mô hình | gpt-4.1 hoặc model ID TokenHub khác |
Vị trí file cài đặt
| Trường | Giá trị |
|---|---|
| Provider settings | Cline settings panel |
| Provider mode | OpenAI Compatible |
| Required fields | Base URL, API Key, Model ID |
Khi extension sở hữu schema riêng, hãy dùng UI cài đặt trước. UI sẽ lưu cùng giá trị vào user settings và tránh phải đoán private key có thể đổi theo phiên bản.
Lưu provider TokenHub trong UI của công cụ. Nếu công cụ tách Chat, Edit, Apply, Fast hoặc Autocomplete, hãy trỏ mọi slot tới TokenHub cho lần thử đầu tiên.
Nếu công cụ tách chat, edit, apply và fast models, hãy dùng cùng một mô hình TokenHub cho lần thử đầu tiên. Sau đó mới tách theo chi phí, độ trễ và năng lực suy luận.
Biến môi trường tạm thời chỉ để debug
Khi extension sở hữu schema riêng, hãy dùng UI cài đặt trước. UI sẽ lưu cùng giá trị vào user settings và tránh phải đoán private key có thể đổi theo phiên bản.
Chỉ dùng biến tạm thời để kiểm tra key, mạng và tên mô hình. Sau khi xác minh, chuyển cùng giá trị vào cấu hình bền vững ở trên.
Xác minh kết nối
Trước tiên dùng prompt chỉ đọc để xác nhận mô hình đọc được ngữ cảnh và không sửa file. Sau đó mới thử chỉnh sửa hoặc tác vụ agent.
Đọc README của dự án và tóm tắt trong ba câu. Không chỉnh sửa file.Sau khi prompt chạy thành công, kiểm tra log TokenHub để xác nhận tên mô hình, endpoint, lượng token và billing group.
Khắc phục sự cố
| Hiện tượng | Cách xử lý |
|---|---|
| 401 hoặc lỗi xác thực | Kiểm tra TOKENHUB_API_KEY còn hợp lệ và đã lưu trong cùng terminal, IDE hoặc profile client. |
| 404 hoặc không tìm thấy mô hình | Dùng model ID có trong workspace TokenHub và phù hợp với giao thức đã chọn. |
| Sai endpoint | Giữ Base URL đúng như phần trên. Công cụ tương thích OpenAI thường cần /v1; công cụ tương thích Claude thường không cần. |
| Request timeout | Kiểm tra đường mạng tới https://us-api.tokenhub.com, proxy settings và allowlist của workspace. |
| Công cụ dùng mô hình khác | Kiểm tra lại mọi trường chat, edit, apply, fast hoặc autocomplete. |
Chọn mô hình
Cline cho Mã VS API FAQ
Tôi nên lưu cấu hình TokenHub trong Cline ở đâu?
Lưu nó thông qua bảng cài đặt API Provider của Cline. Tài liệu nhóm có thể chia sẻ Base URL và ID mẫu, nhưng không bao giờ chia sẻ khóa API thực.
Tại sao Cline có thể trả lời câu hỏi nhưng không thể chỉnh sửa tệp?
Trước tiên, hãy xác nhận rằng mô hình này hỗ trợ sử dụng công cụ, sau đó kiểm tra cài đặt phê duyệt và quyền ghi tệp của Cline. Phản hồi bằng văn bản chỉ chứng minh rằng kết nối cơ sở hoạt động.
Tại sao nhà cung cấp lại thay đổi sau khi mở lại không gian làm việc?
Cấu hình cấp độ không gian làm việc có thể ghi đè cài đặt của người dùng. Kiểm tra xem nhà cung cấp đang hoạt động, Base URL và ID mẫu vẫn trỏ đến TokenHub.
Chi phí Cline API được tính như thế nào?
Tiện ích mở rộng và kiểu API là các lớp thanh toán riêng biệt. TokenHub tính phí theo mã thông báo thực tế của mô hình đã chọn và mức sử dụng bộ đệm hiện hành ở mức giá trên trang mô hình hiện tại.
Các quy tắc và .clinerules của Cline làm gì?
Chúng cung cấp các quy ước của dự án, các ràng buộc về lệnh và hướng dẫn quy trình làm việc. Chúng không thay thế khóa Provider Base URL, API hoặc cấu hình Model ID.
Tài liệu tham khảo
Cấu hình này dựa trên TokenHub và tài liệu chính thức; lần xác minh gần nhất: 2026-09-04。
