راهنمای راه‌اندازی OpenCode

نمای کلی

OpenCode ارائه‌دهندگان را از یک پیکربندی JSON می‌خواند. Routerah را با آداپتور سازگار با OpenAI اضافه کنید تا از هر مدل Routerah استفاده کنید.

پیکربندی سریع

این‌ها را در کلاینت بچسبانید. با ورود، کلید شما خودکار پر می‌شود.

نشانی پایه: https://api.routerah.app/v1
کلید API: YOUR_API_KEY

سازگاری

راه‌اندازی گام‌به‌گام

1. 1
   باز کردن فایل پیکربندی OpenCode

   پیکربندی OpenCode خود را در یک ویرایشگر متن باز کنید. اگر وجود ندارد بسازیدش.

   WindowsmacOSLinux

   powershell

   $f = "$env:USERPROFILE\.config\opencode\opencode.json"
   md -Force (Split-Path $f) | Out-Null; New-Item $f -ea 0 | Out-Null; Invoke-Item $f

   برای پر شدن خودکار کلید API وارد شوید

2. 2
   جایگزینی محتوای فایل

   بلوک ارائه‌دهنده Routerah را به پیکربندی خود اضافه کنید. با فایل موجود ادغامش کنید و بلوک‌های mcp یا agent قبلی را نگه دارید.

   json

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "routerah-live": {
         "name": "Routerah",
         "npm": "@ai-sdk/openai-compatible",
         "options": {
           "apiKey": "YOUR_API_KEY",
           "baseURL": "https://api.routerah.app/v1"
         },
         "models": {
           "minimax-m3.1-flash:free": {},
           "xing4.0-29b-a4b:free": {},
           "sage-a1.5:free": {},
           "nemotron-3.5-bolt-e4b:free": {},
           "ling-3.1-flash:free": {}
         }
       }
     }
   }

   برای پر شدن خودکار کلید API وارد شوید

3. 3
   تأیید بارگذاری مدل‌ها

   فایل را ذخیره و `opencode models` را در ترمینال اجرا کنید. هر شناسه‌ای که فهرست کرده‌اید با پیشوند کلید ارائه‌دهنده شما باید بیاید.

   bash

   opencode models

   برای پر شدن خودکار کلید API وارد شوید

4. 4
   انتخاب مدل

   انتخابگر مدل را باز کنید و به مدل جدید خود سوئیچ کنید. آداپتور، استریم و فراخوانی ابزار را مدیریت می‌کند.

مدل‌های پیشنهادی

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

نکات مهم

• !OpenCode کشف زنده مدل برای ارائه‌دهندگان سازگار با OpenAI ندارد. هر مدلی که می‌خواهید باید با شناسه دقیق در بلوک «models» باشد.
• !کلید ارائه‌دهنده را تنهایی «routerah» نگذارید. این شناسه از قبل در رجیستری models.dev هست و OpenCode به‌جای فهرست شما، از فهرست رجیستری استفاده می‌کند؛ پس مدل‌های جدیدتر جا می‌مانند. پسوند «-live» در بالا از این تداخل جلوگیری می‌کند.
• !از شناسه‌های دقیق مدل در کاتالوگ Routerah استفاده کنید. هر پیشوند ارائه‌دهنده‌ای که کپی-پیست اضافه کرده را بکنید و پسوند ‎:free را جایی که هست نگه دارید.
• !کلید ارائه‌دهنده سفارشی بدون بلوک «models» صفر مدل بارگذاری می‌کند؛ پس ارائه‌دهنده کلاً از انتخابگر حذف می‌شود.