خانه / راهنماها / استفاده از OpenCode با یک LLM API رایگان

استفاده از OpenCode با یک LLM API رایگان

OpenCode یک عامل کدنویسی متن‌باز برای ترمینال و دسکتاپ است. هر ارائه‌دهنده سازگار با OpenAI را می‌پذیرد. این راهنما OpenCode را از طریق FreeLLMAPI به مدل‌های رایگان وصل می‌کند. یک دستور، پیکربندی را می‌نویسد و کلید را ذخیره می‌کند.

کد، نام مدل‌ها و برچسب‌های زندهٔ کاتالوگ به زبان انگلیسی نمایش داده می‌شوند.

مرحله 1: نصب FreeLLMAPI

FreeLLMAPI یک درگاه متن‌باز است. این برنامه داخل Docker روی رایانه شما اجرا می‌شود و سطوح رایگان 45 ارائه‌دهنده را پشت یک کلید ترکیب می‌کند.

نصب روی macOS یا Linux

curl -fsSL https://freellmapi.co/install.sh | bash

http://localhost:3001 را باز کنید. حداقل دو کلید ارائه‌دهنده رایگان را در صفحه Keys اضافه کنید. Google AI Studio و Groq هر کدام در چند دقیقه یک کلید رایگان می‌دهند. کلید یکپارچه را از همان صفحه کپی کنید.

مرحله 2: اتصال OpenCode با یک دستور

یک دستور

npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key>
opencode

این دستور سه کار انجام می‌دهد:

  • یک ارائه‌دهنده freellmapi به ~/.config/opencode/opencode.json اضافه می‌کند. این ارائه‌دهنده مدل‌های کاتالوگ زنده شما را همراه با حد زمینه‌شان فهرست می‌کند.
  • freellmapi/auto را به عنوان مدل پیش‌فرض تنظیم می‌کند.
  • کلید را در فایل اعتبارنامه OpenCode، یعنی ~/.local/share/opencode/auth.json، ذخیره می‌کند. به متغیر محیطی نیازی نیست، نه در CLI و نه در برنامه دسکتاپ.

این دستور پیش از نوشتن، یک نسخه پشتیبان می‌گیرد. ارائه‌دهنده جدید را ادغام می‌کند، پس ارائه‌دهندگان دیگر شما باقی می‌مانند. اگر XDG_CONFIG_HOME یا XDG_DATA_HOME تنظیم شده باشد، دستور از آن پوشه‌ها استفاده می‌کند.

پیش از شروع یک وظیفه طولانی، مطمئن شوید که درگاه همین حالا می‌تواند یک درخواست را پاسخ دهد. این فراخوانی فقط مدل‌هایی را فهرست می‌کند که در این لحظه کلید قابل استفاده دارند:

بررسی مدل‌های آماده

curl "http://localhost:3001/v1/models?execution_status=ready" \
  -H "Authorization: Bearer <unified-key>"

مدلی با وضعیت exhausted کلید دارد، اما همه کلیدهایش اکنون به محدودیت رسیده‌اند. این وضعیت وقتی دوره‌های استراحت تمام شود پاک می‌شود. دستور npx freellmapi doctor را اجرا کنید تا مطمئن شوید درخواست‌های یک کلاینت به درگاه می‌رسند. لاگ درخواست داشبورد هر فراخوانی از OpenCode را نشان می‌دهد. هدر پاسخ X-Routed-Via ارائه‌دهنده و مدلی را که به هر درخواست پاسخ داد نام می‌برد. اگر یک درخواست جایگزین شده باشد، هدر X-Fallback-Trail هر مرحله ناموفق و دلیل آن را نام می‌برد.

راه‌اندازی دستی: بلوک ارائه‌دهنده opencode.json

برای تنظیم دستی، این بلوک را به ~/.config/opencode/opencode.json یا به opencode.json داخل پروژه‌تان اضافه کنید. OpenCode از @ai-sdk/openai-compatible برای endpointهای /v1/chat/completions استفاده می‌کند.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "freellmapi/auto",
  "provider": {
    "freellmapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "FreeLLMAPI",
      "options": {
        "baseURL": "http://localhost:3001/v1"
      },
      "models": {
        "auto": {
          "name": "Auto",
          "limit": { "context": 128000, "output": 8192 }
        }
      }
    }
  }
}

سپس کلید را اضافه کنید. OpenCode را شروع کنید، /connect را اجرا کنید، ارائه‌دهنده freellmapi را انتخاب کنید و کلید یکپارچه خود را جای‌گذاری کنید. شناسه ارائه‌دهنده در /connect باید با شناسه داخل پیکربندی یکی باشد. برای انتخاب مدل، /models را اجرا کنید.

  • limit.context حداکثر توکن ورودی مدل است. limit.output حداکثر توکنی است که مدل می‌تواند تولید کند.
  • کلید model در سطح بالا از قالب provider/model استفاده می‌کند. بدون آن، OpenCode مدلی را نگه می‌دارد که پیش‌تر استفاده می‌کرد.
  • هر شناسه مدلی که می‌خواهید استفاده کنید باید در نقشه models باشد. شناسه‌های بیشتر را از GET /v1/models اضافه کنید.
نکته درباره نسخه‌های پیکربندی: مستندات OpenCode اکنون یک قالب پیکربندی V2 با کلید providers را شرح می‌دهد. مستندات می‌گویند قالب V1 بالا همچنان پشتیبانی می‌شود. دستور راه‌اندازی FreeLLMAPI قالب V1 را می‌نویسد.

انتخاب مدل برای OpenCode

OpenCode یک عامل است. از طریق فراخوانی ابزار فایل‌ها را می‌خواند، ویرایش می‌کند و دستورها را اجرا می‌کند. هر درخواست یک پرامپت سیستمی، تعریف ابزارها و محتوای فایل‌ها را حمل می‌کند. از مدل‌های دارای فراخوانی ابزار و پنجره زمینه بزرگ استفاده کنید.

مدل‌های رایگان برای OpenCode: فراخوانی ابزار و زمینه 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). محدودیت‌های رایگان اغلب تغییر می‌کنند. کاتالوگ هر روز بررسی می‌شود.

از freellmapi/auto استفاده کنید تا مسیریاب برای هر درخواست یک مدل انتخاب کند. برای هدایت درخواست‌ها بر اساس هوش یا سرعت، auto:smart یا auto:fast را به نقشه models اضافه کنید. همچنین می‌توانید پس از ساختن آن در داشبورد، یک پروفایل نام‌دار مثل auto:coding اضافه کنید.

محدودیت‌های نرخ و نشست‌های طولانی

یک وظیفه عامل می‌تواند ده‌ها درخواست بفرستد. یک سطح رایگان به‌تنهایی یک وظیفه طولانی را زود متوقف می‌کند. FreeLLMAPI درخواست‌ها و توکن‌های هر کلید را می‌شمارد. وقتی یک ارائه‌دهنده خطای 429 بفرستد، مسیریاب درخواست را به مدل بعدی زنجیره می‌فرستد و نشست ادامه پیدا می‌کند.

  • کلیدهای چهار ارائه‌دهنده یا بیشتر اضافه کنید. ارائه‌دهندگان بیشتر، درخواست بیشتری در روز می‌دهند.
  • انتقال زمینه را با FREELLMAPI_CONTEXT_HANDOFF=on_model_switch در فایل .env FreeLLMAPI روشن کنید. وقتی مدل عوض می‌شود، مدل بعدی یک یادداشت کوتاه دریافت می‌کند که می‌گوید در حال ادامه یک وظیفه است.
  • نشست‌های چسبنده یک گفتگو را 30 دقیقه روی یک مدل نگه می‌دارند. این کار عامل را ثابت می‌کند.
  • برای هر وظیفه یک نشست جدید شروع کنید. زمینه کوچک‌تر، توکن کمتری در هر درخواست مصرف می‌کند.

عیب‌یابی

مشکلعلتراه‌حل
"Invalid API key" با کلید معتبریک apiKey خالی در پیکربندی، کلید را از /connect بازنویسی می‌کندapiKey را از options حذف کنید، یا setup-opencode را دوباره اجرا کنید
OpenCode ارائه‌دهنده جدید را استفاده نمی‌کندکلید model در سطح بالا تنظیم نشده است"model": "freellmapi/auto" را تنظیم کنید
Model not foundشناسه مدل در نقشه models ارائه‌دهنده نیستشناسه را به نقشه اضافه کنید، یا setup-opencode را دوباره اجرا کنید
کلید {env:VAR} خالی استOpenCode یک متغیر تنظیم‌نشده را با رشته خالی جایگزین می‌کندمتغیر را در همان پوسته export کنید، یا کلید را با /connect ذخیره کنید
فراخوانی ابزار شکست می‌خوردمدل فراخوانی ابزار ضعیف داردیک مدل از جدول بالا انتخاب کنید
پیام خطای «All models rate-limited after N attempts»همه کلیدها به سقف خود رسیده‌اندکلیدهای ارائه‌دهندگان بیشتری اضافه کنید، یا منتظر دوره‌های استراحت بمانید
هر یک از این‌ها را با یک کلید استفاده کنید. FreeLLMAPI یک روتر متن‌باز و میزبانی‌شده روی سرور خودتان است. این روتر همه این سطوح رایگان را پشت یک نقطه پایانی سازگار با OpenAI قرار می‌دهد و وقتی یک سرویس به محدودیت نرخ برسد، به سرویس بعدی منتقل می‌شود. مرور کاتالوگ یا اجرای زنده.

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

آیا می‌توانم OpenCode را رایگان استفاده کنم؟

بله. OpenCode متن‌باز است. آن را به عنوان یک ارائه‌دهنده سازگار با OpenAI به FreeLLMAPI وصل کنید. درگاه هر درخواست را به سطوح رایگان ارائه‌دهندگان می‌فرستد، پس هزینه استنتاج $0 است.

چطور یک ارائه‌دهنده سفارشی سازگار با OpenAI به OpenCode اضافه کنم؟

یک ارائه‌دهنده با npm برابر @ai-sdk/openai-compatible، options.baseURL و یک نقشه models به opencode.json اضافه کنید. سپس /connect را برای ذخیره کلید و /models را برای انتخاب مدل اجرا کنید.

کدام مدل رایگان برای OpenCode بهترین است؟

از مدلی با فراخوانی ابزار و حداقل زمینه 128K استفاده کنید. جدول این صفحه قوی‌ترین مدل‌های رایگانی را نشان می‌دهد که امروز هر دو قاعده را دارند. از freellmapi/auto استفاده کنید تا مسیریاب یکی را انتخاب کند.

OpenCode کلیدهای API را کجا ذخیره می‌کند؟

کلیدهایی که با /connect اضافه می‌شوند به ~/.local/share/opencode/auth.json می‌روند. دستور راه‌اندازی FreeLLMAPI کلید را همان‌جا می‌نویسد، پس هم CLI و هم برنامه دسکتاپ آن را پیدا می‌کنند.

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

منابع

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