راهنمای ابزار

اتصال OpenCode به مرشد API

OpenCode یک دستیار برنامه‌نویسی است که روی کامپیوتر خودتان کار می‌کند. با این راهنما آن را به مرشد API وصل می‌کنید و با مدل‌هایی مثل Claude، DeepSeek و GLM کار می‌کنید. پرداخت هم ریالی و از کیف پول خودتان است.

قدم ساده
۵
قدم ساده
فایل تنظیمات
۱
فایل تنظیمات
نسخهٔ دسکتاپ آزمایش‌شده
v2.2
نسخهٔ دسکتاپ آزمایش‌شده
پرداخت از کیف پول
ریالی
پرداخت از کیف پول

پیش از شروع

این سه چیز را لازم دارید:

  • حساب مرشد APIبا حساب مرشد خود وارد پنل شوید.
  • کمی اعتبارهزینهٔ هر پیام از کیف پول کم می‌شود.
  • برنامهٔ OpenCodeنسخهٔ دسکتاپ یا ترمینال را از opencode.ai نصب کنید.

کیف پول را شارژ کنید

در پنل مرشد API صفحهٔ «اعتبار و خرید» را باز کنید و روی «خرید اعتبار» بزنید. پرداخت با درگاه زرین‌پال است و هزینهٔ هر پیام از همین اعتبار کم می‌شود.

صفحهٔ «اعتبار و خرید» در پنل مرشد API با دکمهٔ «خرید اعتبار»
صفحهٔ «اعتبار و خرید» در پنل. دکمهٔ «خرید اعتبار» را بزنید.
رفتن به «اعتبار و خرید»

یک کلید API بسازید

به صفحهٔ «کلیدهای API» بروید و «ساخت کلید جدید» را بزنید. یک نام مثل OpenCode بنویسید و «ساخت کلید» را بزنید. بقیهٔ فیلدها را می‌توانید همان‌طور که هست بگذارید.

تصویر متحرک: باز کردن صفحهٔ کلیدها، زدن «ساخت کلید جدید»، نوشتن نام و دیدن کلید ساخته‌شده
از صفحهٔ کلیدها تا کلید ساخته‌شده، در چند ثانیه.

کلید فقط یک بار کامل نشان داده می‌شود

همان لحظه دکمهٔ «کپی» را بزنید و کلید را جای امنی نگه دارید. کلید را به کسی ندهید و جایی منتشر نکنید، چون هرکس آن را داشته باشد از اعتبار شما خرج می‌کند. اگر کلید گم شد، یک کلید تازه بسازید و کلید قبلی را از همان صفحه ابطال کنید.
کلید تازه که فقط یک بار نشان داده می‌شود، با دکمهٔ «کپی»
کلید تازه با mk- شروع می‌شود. دکمهٔ «کپی» را بزنید.
رفتن به «کلیدهای API»

فایل تنظیمات OpenCode را بسازید

OpenCode تنظیماتش را از فایلی به نام opencode.json می‌خواند. جای این فایل ~/.config/opencode/opencode.json است. با دستور زیر پوشه و فایل را بسازید و فایل را باز کنید (در مک در برنامهٔ Terminal، در ویندوز در PowerShell):

mkdir -p ~/.config/opencode && cd ~/.config/opencode && touch opencode.json && open -e opencode.json

حالا این متن را کامل در فایل بگذارید. به‌جای mk-PASTE-YOUR-KEY-HERE کلیدی را که در قدم ۲ کپی کردید بنویسید و فایل را ذخیره کنید.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "morshed": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Morshed API",
      "options": {
        "baseURL": "https://api.morshed.ai/v1",
        "apiKey": "mk-PASTE-YOUR-KEY-HERE"
      },
      "models": {
        "claude-sonnet-5.5": { "name": "Claude Sonnet 5.5" },
        "deepseek-v4-pro": { "name": "DeepSeek V4 Pro" },
        "glm-5.3": { "name": "GLM 5.3" }
      }
    }
  }
}
baseURL
آدرس مرشد API. دقیقاً همین را بنویسید و چیزی مثل /chat/completions به آخرش اضافه نکنید.
apiKey
کلیدی که در قدم ۲ کپی کردید.
models
مدل‌هایی که می‌خواهید در OpenCode ببینید. شناسهٔ هر مدل باید دقیقاً مثل شناسهٔ آن در صفحهٔ مدل‌ها باشد. نام جلوی آن فقط برای نمایش است.
می‌خواهید فقط در یک پروژه از مرشد استفاده کنید؟ همین فایل را با نام opencode.json در پوشهٔ اصلی همان پروژه بگذارید.

بعد از ذخیره، OpenCode را کامل ببندید و دوباره باز کنید (در مک با ⌘Q). حالا در Settings › Providers باید Morshed API را زیر Connected providers ببینید.

تنظیمات OpenCode، بخش Providers: «Morshed API» زیر Connected providers
مرشد API به OpenCode وصل شده است.

مدل‌های مرشد را روشن کنید

این قدم را جا نیندازید

نسخهٔ دسکتاپ OpenCode مدل‌های فایل تنظیمات را خاموش اضافه می‌کند. تا روشنشان نکنید، در فهرست مدل‌ها دیده نمی‌شوند. بیشتر مشکل‌های «وصل نمی‌شود» از همین است.

به Settings › Models بروید، گروه Morshed API را پیدا کنید و کلید کنار هر مدلی را که می‌خواهید روشن کنید.

تصویر متحرک: روشن کردن مدل‌های Morshed API در بخش Models تنظیمات OpenCode
کلید کنار هر مدل را روشن کنید تا آبی شود.

مدل را انتخاب کنید و بپرسید

یک گفتگوی تازه باز کنید (New session). روی نام مدل زیر کادر پیام بزنید، morshed را تایپ کنید و یکی از مدل‌ها را انتخاب کنید. حالا سؤالتان را بنویسید.

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

از کجا بفهمم درست وصل شده؟

زیر کادر پیام باید Morshed API / نام مدل را ببینید، مثل تصویر زیر. اگر جواب آمد، همه‌چیز آماده است.
زیر کادر پیام OpenCode نوشته شده Morshed API / DeepSeek V4 Pro
مدل انتخاب‌شده: Morshed API / DeepSeek V4 Pro
یک پرسش و پاسخ فارسی در OpenCode که از طریق مرشد API جواب داده شده
یک پرسش و پاسخ فارسی که از طریق مرشد API جواب داده شده.

OpenCode در ترمینال

اگر از نسخهٔ ترمینالی OpenCode استفاده می‌کنید، همان فایل تنظیمات قدم ۳ کافی است. در این نسخه قدم روشن کردن مدل‌ها لازم نیست.

opencode را اجرا کنید، بعد /models را بنویسید و مدل مرشد را انتخاب کنید.

opencode
/models

نمی‌خواهید کلید داخل فایل باشد؟

در ترمینال /connect را بزنید و Other را انتخاب کنید. شناسهٔ ارائه‌دهنده را دقیقاً morshed بنویسید و کلید را بچسبانید. در این حالت لازم نیست کلید را در فایل بنویسید.

هزینه چقدر می‌شود؟

OpenCode با هر درخواست، دستورالعمل‌های خودش را هم می‌فرستد که حدود ۱۳ هزار توکن است. برای همین حتی یک سؤال کوتاه با DeepSeek V4 Pro حدود ۲ تا ۳ هزار تومان هزینه دارد و مدل‌های قوی‌تر گران‌ترند.

هزینهٔ هر درخواست را ببینید

در پنل، صفحهٔ «فعالیت‌ها» هزینهٔ تک‌تک درخواست‌ها را نشان می‌دهد.

مدل را به اندازهٔ کار انتخاب کنید

برای کارهای ساده مدل ارزان‌تر کافی است. قیمت هر مدل به تومان در صفحهٔ مدل‌ها آمده است.

رفع مشکل

اگر چیزی کار نکرد، اول این جدول را ببینید.

مدل‌های مرشد در فهرست مدل‌ها نیستندمدل‌ها در تنظیمات OpenCode خاموش‌اند.در Settings › Models گروه Morshed API را پیدا کنید و مدل‌ها را روشن کنید (قدم ۴).
گزینهٔ Morshed API در Providers نیستفایل تنظیمات در جای درست نیست یا متن آن خراب شده است.مسیر فایل را دوباره چک کنید. متن تنظیمات را با دکمهٔ «کپی» دوباره کامل بردارید تا هیچ ویرگول یا آکولادی جا نیفتد. بعد OpenCode را کامل ببندید و باز کنید.
خطای 401 (کلید نامعتبر)کلید ناقص کپی شده یا باطل شده است.یک کلید تازه بسازید و جای کلید قبلی در فایل بگذارید.
خطای 402 (اعتبار کافی نیست)موجودی کیف پول برای این درخواست کم است.کیف پول را شارژ کنید. مرشد برای هر درخواست کمی از اعتبار را موقتاً کنار می‌گذارد، پس وقتی موجودی خیلی کم است ممکن است پیش از رسیدن به صفر هم این خطا را ببینید. مقدار کوچک‌تر برای max_tokens این مبلغ را کمتر می‌کند.
خطای 404 (مدل پیدا نشد)شناسهٔ مدل در فایل با شناسهٔ مرشد یکی نیست.شناسه را دقیقاً از صفحهٔ مدل‌ها کپی کنید.
OpenCode بار اول گیر می‌کندگاهی اولین اجرا بعد از تغییر تنظیمات کامل بالا نمی‌آید.یک بار OpenCode را کامل ببندید و دوباره باز کنید.

آدرس پایه همیشه https://api.morshed.ai/v1 است. کدهای خطا را کامل در بخش خطاهای مستندات ببینید.

بازگشت به مستندات
راهنمای اتصال OpenCode به مرشد API · مرشد API