Cline، Roo Code و Kilo Code با یک API رایگان
Cline، Roo Code و Kilo Code عاملهای کدنویسی برای VS Code هستند. هر کدام میتوانند از یک API سازگار با OpenAI استفاده کنند. این راهنما آنها را از طریق FreeLLMAPI به مدلهای رایگان وصل میکند. همچنین نشان میدهد کدام مدلهای رایگان با پرامپتهای طولانی و پرابزار که این عاملها میفرستند کار میکنند.
کد، نام مدلها و برچسبهای زندهٔ کاتالوگ به زبان انگلیسی نمایش داده میشوند.
پیش از شروع
FreeLLMAPI یک درگاه متنباز است که روی رایانه شما اجرا میشود. سطوح رایگان 45 ارائهدهنده را پشت یک کلید ترکیب میکند. آن را با Docker نصب کنید، سپس حداقل دو کلید ارائهدهنده رایگان را در صفحه Keys اضافه کنید.
نصب روی macOS یا Linux
curl -fsSL https://freellmapi.co/install.sh | bashکلید یکپارچه را از صفحه Keys کپی کنید. هر سه عامل از مقادیر یکسان استفاده میکنند:
| فیلد | مقدار |
|---|---|
| Base URL | http://localhost:3001/v1 |
| کلید API | <unified-key> |
| شناسه مدل | auto، یا یک شناسه کاتالوگ از GET /v1/models |
Cline
سریعترین روش، دستور راهاندازی است. این دستور کاتالوگ زنده شما را میخواند، از تنظیمات موجود Cline نسخه پشتیبان میگیرد و یک ارائهدهنده OpenAI Compatible اضافه میکند.
یک دستور
npx freellmapi setup-cline --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-cline --url http://localhost:3001 --api-key <unified-key>خط اول تفاوتها را نشان میدهد و چیزی نمینویسد. خط دوم تغییر را مینویسد. برای تنظیم دستی Cline، این مراحل را انجام دهید:
- پنل Cline را در VS Code باز کنید. روی نماد تنظیمات (چرخدنده) کلیک کنید.
- API Provider را روی OpenAI Compatible بگذارید.
- Base URL را روی
http://localhost:3001/v1بگذارید. - API Key را روی کلید یکپارچه خود بگذارید.
- Model ID را روی
autoیا یک مدل از جدول زیر بگذارید. - Model Configuration را باز کنید. Context Window را روی زمینه مدل خود بگذارید. Image Support را فقط برای یک مدل بینایی روشن کنید.
Cline برای ارائهدهندگان OpenAI Compatible این یادداشت را نشان میدهد: «Cline از پرامپتهای پیچیده استفاده میکند، پس رفتار بین مدلها ممکن است متفاوت باشد.» برای مدلهای کوچکتر، مستندات Cline توصیه میکند Use Compact Prompt را در Cline Settings, Features روشن کنید.
Kilo Code
دستور راهاندازی را اجرا کنید. این دستور یک پیکربندی سراسری Kilo با یک ارائهدهنده openai-compatible مینویسد و آن را مدل پیشفرض میکند.
یک دستور
export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-kilo --url http://localhost:3001 --dry-run
npx freellmapi setup-kilo --url http://localhost:3001
kilo run "Say hello"پیکربندی به کلید با {env:FREELLMAPI_API_KEY} اشاره میکند، پس پیش از شروع Kilo متغیر را export کنید. Kilo فقط در پیکربندی مورد اعتماد مقدار {env:...} را جایگزین میکند، مثلاً در پوشه سراسری ~/.config/kilo. در پیکربندی پروژه، Kilo آن را نادیده میگیرد و یک هشدار ثبت میکند. پیکربندی تولیدشده این شکل را دارد:
پیکربندی سراسری Kilo (شکل)
{
"$schema": "https://app.kilo.ai/config.json",
"model": "openai-compatible/auto",
"provider": {
"openai-compatible": {
"options": {
"apiKey": "{env:FREELLMAPI_API_KEY}",
"baseURL": "http://localhost:3001/v1"
},
"models": {
"auto": {
"name": "Auto",
"tool_call": true,
"limit": { "context": 128000, "output": 8192 }
}
}
}
}
}در افزونه VS Code میتوانید ارائهدهنده را دستی هم اضافه کنید. Settings را باز کنید، سپس زبانه Providers و بعد روی Custom provider کلیک کنید. Provider API را روی OpenAI Compatible بگذارید. Base URL و کلید را وارد کنید، سپس روی Fetch models کلیک کنید تا فهرست مدل خوانده شود.
Roo Code (نصبهای موجود)
دستور راهاندازی یک فایل ورود برای افزونه VS Code مینویسد. همچنین یک پروفایل برای Roo CLI مینویسد.
یک دستور
npx freellmapi setup-roo --url http://localhost:3001 --api-key <unified-key>سپس به Roo Code بگویید فایل ورود را بارگذاری کند. این خط را به settings.json خود در VS Code اضافه کنید و پنجره را دوباره بارگذاری کنید. پروفایل freellmapi پروفایل جاری میشود.
settings.json در VS Code
"roo-cline.autoImportSettingsPath": "~/.roo/freellmapi.json"برای تنظیم دستی، تنظیمات Roo Code را باز کنید و API Provider را روی OpenAI Compatible بگذارید. Base URL، کلید و مدل را وارد کنید. Roo Code فقط از فراخوانی ابزار بومی استفاده میکند. مستندات آن میگوید مدلی که فراخوانی ابزار بومی ندارد، با Roo Code قابل استفاده نیست.
انتخاب مدل برای کار با عامل
این عاملها در هر درخواست یک پرامپت سیستمی بزرگ، تعریف ابزارها و محتوای فایلها میفرستند. از مدلهای دارای فراخوانی ابزار و پنجره زمینه بزرگ استفاده کنید. جدول، مدلهای رایگان دارای فراخوانی ابزار و حداقل زمینه 128K را امروز بر اساس هوش نشان میدهد.
| مدل | رایگان در | متن ورودی | محدودیتهای رایگان (بهترین پیشنهاد) | ابزارها | بینایی |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 درخواست در دقیقه 1 req/min per model | بله | خیر |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 درخواست در دقیقه 40 RPM | بله | بله |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | بله | بله |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | بله | خیر |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | بله | بله |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 درخواست در دقیقه 20 درخواست در روز 250,000 توکن در دقیقه ~3M | بله | بله |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | بله | بله |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 درخواست در دقیقه 50 درخواست در روز 50 req/day account-wide (1,000 after a $10 purchase) | بله | بله |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 درخواست در دقیقه 50 درخواست در روز Shared rate limit | بله | خیر |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 درخواست در دقیقه 250 درخواست در روز 70,000 توکن در دقیقه ~6M | بله | بله |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 درخواست در دقیقه 20 درخواست در روز 250,000 توکن در دقیقه ~3M | بله | بله |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | بله | بله |
نمایش 12 مدل رایگان مطابق از 109 مدل. مشاهده همه مدلها.
دادههای زنده از کاتالوگ FreeLLMAPI (نسخه 2026.11.19، بررسیشده در 2026-11-19). محدودیتهای رایگان اغلب تغییر میکنند. کاتالوگ هر روز بررسی میشود.
- از
autoاستفاده کنید تا مسیریاب برای هر درخواست یک مدل انتخاب کند. وقتی یک ارائهدهنده خطای 429 بفرستد، مسیریاب مدل بعدی را امتحان میکند. - برای برنامهریزی و باگهای دشوار، از
auto:smartاستفاده کنید. - پنجره زمینه عامل را روی زمینه واقعی مدل بگذارید. اگر مقدار بیش از حد باشد، عامل پرامپتهایی میفرستد که مدل آنها را رد میکند.
- وقتی زمینه بزرگ میشود، یک وظیفه جدید شروع کنید. زمینه کوچکتر، توکن کمتری در هر درخواست مصرف میکند.
عیبیابی
| مشکل | علت | راهحل |
|---|---|---|
| "Invalid API Key" | کلید، کلید یکپارچه FreeLLMAPI نیست | کلید یکپارچه را دوباره از صفحه Keys کپی کنید |
| "Model Not Found" | شناسه مدل در کاتالوگ شما نیست | از auto یا یک شناسه از GET /v1/models استفاده کنید |
| عامل پس از یک مرحله متوقف میشود، یا فراخوانی ابزار شکست میخورد | مدل فراخوانی ابزار ضعیف دارد یا اصلاً ندارد | یک مدل از جدول بالا انتخاب کنید |
| خطاهای پنجره زمینه در وظایف طولانی | تنظیم زمینه از زمینه واقعی مدل بزرگتر است | پنجره زمینه درست را تنظیم کنید، یا یک وظیفه جدید شروع کنید |
| پیام خطای «All models rate-limited after N attempts» | هر کلید در زنجیره به سقف خود رسیده است | کلیدهای ارائهدهندگان بیشتری اضافه کنید، یا منتظر دورههای استراحت (cooldown) بمانید |
Kilo: Model not found: openai-compatible/auto | مدل پیشفرض در نقشه مدلهای ارائهدهنده نیست | setup-kilo را دوباره اجرا کنید تا مدل پیشفرض اول قرار گیرد |
پرسشهای متداول
آیا میتوانم Cline را رایگان استفاده کنم؟
بله. Cline رایگان و متنباز است. ارائهدهنده API آن را روی OpenAI Compatible بگذارید و به FreeLLMAPI اشاره دهید. درگاه هر درخواست را به سطوح رایگان ارائهدهندگان میفرستد، پس هزینه استنتاج $0 است.
بهترین مدل رایگان برای Cline کدام است؟
از مدلی با فراخوانی ابزار و حداقل زمینه 128K استفاده کنید. Cline پرامپتهای پیچیده با تعریف ابزارها میفرستد. جدول این صفحه قویترین مدلهای رایگانی را نشان میدهد که امروز هر دو قاعده را دارند.
آیا Roo Code هنوز نگهداری میشود؟
خیر. README مربوط به Roo Code میگوید افزونه در 15 مه 2026 بسته شد و مخزن بایگانی شده است. نصبهای موجود همچنان با یک ارائهدهنده OpenAI Compatible کار میکنند.
چطور Kilo Code را با یک API سازگار با OpenAI سفارشی استفاده کنم؟
یک ارائهدهنده openai-compatible با baseURL و apiKey را در پیکربندی سراسری Kilo اضافه کنید، یا npx freellmapi setup-kilo را اجرا کنید. در افزونه VS Code از Settings، Providers و Custom provider استفاده کنید.
چرا Cline با مدلهای رایگان شکست میخورد؟
بیشتر شکستها از مدلهایی با فراخوانی ابزار ضعیف یا پنجره زمینه کوچک میآیند. مدلی با فراخوانی ابزار و زمینه 128K انتخاب کنید و برای مدلهای کوچکتر، Use Compact Prompt را روشن کنید.
راهنماهای مرتبط
- مدلهای هوش مصنوعی رایگان در VS Code
- Continue با API رایگان LLM
- بهترین API مدلهای کدنویسی رایگان
- LLM API رایگان با فراخوانی تابع
- استفاده رایگان از Claude Code
منابع
- Cline docs: OpenAI Compatible provider (بررسیشده در 20 November 2026)
- Cline docs: running models locally (بررسیشده در 20 November 2026)
- Kilo docs: custom models (بررسیشده در 20 November 2026)
- Kilo docs: OpenAI Compatible provider (بررسیشده در 20 November 2026)
- Roo Code repository (archived) (بررسیشده در 20 November 2026)
- Roo Code docs: settings management (بررسیشده در 20 November 2026)
- FreeLLMAPI docs: clients and coding agents (بررسیشده در 20 November 2026)