خانه / راهنماها / Cline، Roo Code و Kilo Code با یک API رایگان

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 URLhttp://localhost:3001/v1
کلید API<unified-key>
شناسه مدلauto، یا یک شناسه کاتالوگ از GET /v1/models
وضعیت Roo Code: README مربوط به Roo Code می‌گوید افزونه در 15 مه 2026 بسته شد. مخزن بایگانی شده و فقط خواندنی است. مراحل زیر هنوز برای نصب موجود کاربرد دارند، اما کاربران جدید باید Cline یا Kilo Code را انتخاب کنند.

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، این مراحل را انجام دهید:

  1. پنل Cline را در VS Code باز کنید. روی نماد تنظیمات (چرخ‌دنده) کلیک کنید.
  2. API Provider را روی OpenAI Compatible بگذارید.
  3. Base URL را روی http://localhost:3001/v1 بگذارید.
  4. API Key را روی کلید یکپارچه خود بگذارید.
  5. Model ID را روی auto یا یک مدل از جدول زیر بگذارید.
  6. 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 را امروز بر اساس هوش نشان می‌دهد.

مدل‌های رایگان برای Cline، Roo Code و Kilo Code: فراخوانی ابزار و زمینه 128K+
مدلرایگان درمتن ورودیمحدودیت‌های رایگان (بهترین پیشنهاد)ابزارهابینایی
GLM 5.3UnoRouter1M1 درخواست در دقیقه
1 req/min per model
بلهخیر
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 درخواست در دقیقه
40 RPM
بلهبله
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaبلهبله
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceبلهخیر
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditبلهبله
Gemini 3.7 FlashGoogle AI Studio1M10 درخواست در دقیقه
20 درخواست در روز
250,000 توکن در دقیقه
~3M
بلهبله
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditبلهبله
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 درخواست در دقیقه
50 درخواست در روز
50 req/day account-wide (1,000 after a $10 purchase)
بلهبله
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 درخواست در دقیقه
50 درخواست در روز
Shared rate limit
بلهخیر
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 درخواست در دقیقه
250 درخواست در روز
70,000 توکن در دقیقه
~6M
بلهبله
Gemini 3.6 FlashGoogle AI Studio1M10 درخواست در دقیقه
20 درخواست در روز
250,000 توکن در دقیقه
~3M
بلهبله
Qwen 3.8 27BCloudflare Workers AI262KShared 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 را دوباره اجرا کنید تا مدل پیش‌فرض اول قرار گیرد
هر یک از این‌ها را با یک کلید استفاده کنید. FreeLLMAPI یک روتر متن‌باز و میزبانی‌شده روی سرور خودتان است. این روتر همه این سطوح رایگان را پشت یک نقطه پایانی سازگار با OpenAI قرار می‌دهد و وقتی یک سرویس به محدودیت نرخ برسد، به سرویس بعدی منتقل می‌شود. مرور کاتالوگ یا اجرای زنده.

پرسش‌های متداول

آیا می‌توانم 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 را روشن کنید.

راهنماهای مرتبط

منابع

همه راهنماها · مرور همه مدل‌های رایگان