Trang chủ → Hướng dẫn → Dùng Cline với API tùy chỉnh: provider, base URL và model dùng tốt công cụ của nó

Dùng Cline với API tùy chỉnh: provider, base URL và model dùng tốt công cụ của nó

Cline chỉ cần ba thứ từ API: base URL, khóa và ID model. Điều quyết định agent có chạy được hay không lại kín đáo hơn — model có gọi công cụ đúng y các tham số Cline định nghĩa hay không. Chúng tôi đã thử điều đó trên sáu model trước khi viết bài này.

Kết nối Cline trong bốn bước

Mở bảng Cline trong VS Code và bấm biểu tượng bánh răng. Sau đó:

1. Ở API Provider, chọn OpenAI Compatible (dùng được mọi model), hoặc Anthropic cho Claude.
2. Nhập base URL theo bảng dưới. Với Anthropic, tick Use custom base URL trước.
3. Dán khóa API lấy từ bảng điều khiển.
4. Gõ ID model đúng như trong bảng, bấm Done rồi thử bằng một tác vụ ngắn.

API Provider	Base URL	Model ID
OpenAI Compatible	https://apiclan.us/v1	gpt-6.1-sol, deepseek-v4-pro, claude-opus-5-5
Anthropic (base URL tùy chỉnh)	https://apiclan.us	claude-opus-5-5, claude-fable-5-1

Hai base URL khác nhau có chủ ý. OpenAI Compatible tự thêm /chat/completions nên cần /v1; Anthropic tự thêm /v1/messages nên không được có. Đặt /v1 sai chỗ là nguyên nhân phổ biến nhất gây lỗi 404.

Dùng khóa thuộc đúng nhóm

Mỗi khóa API trên cổng này thuộc về một nhóm model và chỉ gọi được model trong nhóm đó. Muốn dùng Claude trong Cline thì tạo khóa ở nhóm Claude; GPT thì ở nhóm GPT; DeepSeek thì ở nhóm DeepSeek. Khi đổi dòng model trong Cline, hãy đổi cả khóa.

Cài đặt model cho OpenAI Compatible

Với OpenAI Compatible, Cline không tra được thông tin model nên hiện các ô Model Configuration: cửa sổ ngữ cảnh, số token đầu ra tối đa và hỗ trợ ảnh. Hãy điền giới hạn ngữ cảnh thật của model. Điền quá nhỏ thì Cline cắt hội thoại quá sớm; quá lớn thì tác vụ dài sẽ báo lỗi vượt độ dài ngữ cảnh thay vì được nén lại.

Thử nghiệm: model có gọi đúng công cụ kiểu Cline không?

Agent của Cline làm việc qua các công cụ như read_file. Chúng tôi đưa cho mỗi model một công cụ read_file chỉ có một tham số tên path, yêu cầu mở src/app.ts, rồi kiểm tra hai điều: có gọi công cụ đúng tên tham số khai báo trong schema không, và phản hồi đầu tiên mất bao lâu (trung vị, bật streaming). Tham số bị đổi tên là lý do thường gặp khiến một bước của agent thất bại mà không báo lỗi rõ ràng.

Model	Gọi công cụ đúng	Phản hồi đầu tiên
claude-opus-5-5	13 / 13	3.3 s
claude-fable-5-1	13 / 13	2.8 s
gpt-6.1-sol	3 / 3	2.6 s
gpt-5.6-sol	3 / 3	3.3 s
deepseek-v4-pro	3 / 3	2.6 s
deepseek-v4.1-flash	3 / 3	1.5 s

Mọi model đều gọi đúng công cụ ở tất cả các lần. Mẫu thử còn nhỏ — mỗi model Claude 13 lần, các model khác 3 lần — và một lần gpt-5.6-sol mất 40 giây do khởi động lạnh; bảng ghi giá trị trung vị. Thử nghiệm ngày 12/10/2026.

Nên chọn model nào

• Agent chạy dài trên mã nguồn thật: claude-opus-5-5 qua provider Anthropic — giao thức gốc của Claude, và trên đường này Cline gửi đánh dấu cache prompt.
• Phần lớn công việc với giá thấp hơn: gpt-6.1-sol hoặc claude-fable-5-1.
• Sửa nhanh, rẻ, nhiều bước nhỏ: deepseek-v4.1-flash, phản hồi nhanh nhất trong thử nghiệm.

Bốn lỗi hay gặp nhất

• 401 Unauthorized → khóa sai hoặc có khoảng trắng ở đầu hay cuối. Dán lại.
• 404 → base URL không khớp với provider: OpenAI Compatible cần /v1, Anthropic thì không.
• model_not_found (is not supported by any configured account in this group) → gõ sai ID model, hoặc khóa của bạn thuộc nhóm không có model đó.
• Hết thời gian ở các bước dài → dùng https://api.apiclan.us/v1 (hoặc https://api.apiclan.us cho Anthropic) để tránh giới hạn proxy 100 giây.

Cần cấu hình công cụ khác? Base URL cho Claude Code · Dùng Codex với API tùy chỉnh.

Bắt đầu sử dụng

Không thuê bao, không mức tối thiểu hàng tháng, không cần gọi cho nhân viên bán hàng. Nạp bằng USDT và tiêu đúng phần bạn dùng — 1 USDT cho bạn 2 tín dụng số dư API.

Đọc hướng dẫn nhanh 30 giây

Ngôn ngữ: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

Giá trên trang này được điền tự động từ dữ liệu thanh toán thực tế. Điều khoản bên thứ ba được trích từ tài liệu của chính họ.