استفاده از OpenCode با یک LLM API رایگان
OpenCode یک عامل کدنویسی متنباز برای ترمینال و دسکتاپ است. هر ارائهدهنده سازگار با OpenAI را میپذیرد. این راهنما OpenCode را از طریق FreeLLMAPI به مدلهای رایگان وصل میکند. یک دستور، پیکربندی را مینویسد و کلید را ذخیره میکند.
کد، نام مدلها و برچسبهای زندهٔ کاتالوگ به زبان انگلیسی نمایش داده میشوند.
مرحله 1: نصب FreeLLMAPI
FreeLLMAPI یک درگاه متنباز است. این برنامه داخل Docker روی رایانه شما اجرا میشود و سطوح رایگان 45 ارائهدهنده را پشت یک کلید ترکیب میکند.
نصب روی macOS یا Linux
curl -fsSL https://freellmapi.co/install.sh | bashhttp://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اضافه کنید.
providers را شرح میدهد. مستندات میگویند قالب V1 بالا همچنان پشتیبانی میشود. دستور راهاندازی FreeLLMAPI قالب V1 را مینویسد.انتخاب مدل برای OpenCode
OpenCode یک عامل است. از طریق فراخوانی ابزار فایلها را میخواند، ویرایش میکند و دستورها را اجرا میکند. هر درخواست یک پرامپت سیستمی، تعریف ابزارها و محتوای فایلها را حمل میکند. از مدلهای دارای فراخوانی ابزار و پنجره زمینه بزرگ استفاده کنید.
| مدل | رایگان در | متن ورودی | محدودیتهای رایگان (بهترین پیشنهاد) | ابزارها | بینایی |
|---|---|---|---|---|---|
| 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). محدودیتهای رایگان اغلب تغییر میکنند. کاتالوگ هر روز بررسی میشود.
از freellmapi/auto استفاده کنید تا مسیریاب برای هر درخواست یک مدل انتخاب کند. برای هدایت درخواستها بر اساس هوش یا سرعت، auto:smart یا auto:fast را به نقشه models اضافه کنید. همچنین میتوانید پس از ساختن آن در داشبورد، یک پروفایل نامدار مثل auto:coding اضافه کنید.
محدودیتهای نرخ و نشستهای طولانی
یک وظیفه عامل میتواند دهها درخواست بفرستد. یک سطح رایگان بهتنهایی یک وظیفه طولانی را زود متوقف میکند. FreeLLMAPI درخواستها و توکنهای هر کلید را میشمارد. وقتی یک ارائهدهنده خطای 429 بفرستد، مسیریاب درخواست را به مدل بعدی زنجیره میفرستد و نشست ادامه پیدا میکند.
- کلیدهای چهار ارائهدهنده یا بیشتر اضافه کنید. ارائهدهندگان بیشتر، درخواست بیشتری در روز میدهند.
- انتقال زمینه را با
FREELLMAPI_CONTEXT_HANDOFF=on_model_switchدر فایل.envFreeLLMAPI روشن کنید. وقتی مدل عوض میشود، مدل بعدی یک یادداشت کوتاه دریافت میکند که میگوید در حال ادامه یک وظیفه است. - نشستهای چسبنده یک گفتگو را 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» | همه کلیدها به سقف خود رسیدهاند | کلیدهای ارائهدهندگان بیشتری اضافه کنید، یا منتظر دورههای استراحت بمانید |
پرسشهای متداول
آیا میتوانم 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 و هم برنامه دسکتاپ آن را پیدا میکنند.
راهنماهای مرتبط
- استفاده از Aider با یک API رایگان LLM
- استفاده از Codex CLI با مدلهای رایگان
- استفاده رایگان از Claude Code
- بهترین API مدلهای کدنویسی رایگان
- آدرسهای پایه API سازگار با OpenAI رایگان
منابع
- OpenCode docs: providers (V1 config) (بررسیشده در 20 November 2026)
- OpenCode docs: config (بررسیشده در 20 November 2026)
- OpenCode docs: migrate from V1 (بررسیشده در 20 November 2026)
- FreeLLMAPI CLI generators (بررسیشده در 20 November 2026)
- FreeLLMAPI docs: context handoff (بررسیشده در 20 November 2026)