پرش به محتوای اصلی
یکپارچه‌سازی

اتصال OpenCode به دات‌هوش

هر راهنما چند گام کوتاه دارد: کلید، آدرس پایه، شناسه مدل.

OpenCode

CLI
حدود ۲ دقیقهپروتکل OpenAI۴ گام

پیش‌نیاز: یک کلید API و موجودی کیف پول.

ساخت کلید
  1. نصب و کلید

    OpenCode یک عامل کدنویسی متن‌باز برای ترمینال است؛ با دات‌هوش روی مدل‌های مختلف و با کیف پول تومانی کار می‌کند. با یکی از دو دستور نصبش کنید و کلید را در متغیر محیطی بگذارید. مقدار واقعی کلید را به‌جای dh_live_… وارد کنید.

    terminal
    curl -fsSL https://opencode.ai/install | bash
    # or: npm i -g opencode-ai
    
    export DOTHOOSH_API_KEY="dh_live_…"
  2. دات‌هوش را به‌عنوان ارائه‌دهنده اضافه کنید

    دات‌هوش هنوز در فهرست آمادهٔ OpenCode نیست، پس با فایل پیکربندی اضافه‌اش می‌کنید. این متن مخصوص OpenCode نسخهٔ ۲ است؛ آن را در opencode.jsonc کنار پروژه یا در ~/.config/opencode/opencode.jsonc بگذارید. شناسهٔ مدل را از کاتالوگ مدل‌ها بردارید و در هر سه جای فایل بنویسید؛ پیشوند ارائه‌دهنده لازم نیست.

    opencode.jsonc
    {
      "$schema": "https://opencode.ai/config.json",
      "providers": {
        "dothoosh": {
          "name": "Dothoosh (دات‌هوش)",
          "env": ["DOTHOOSH_API_KEY"],
          "package": "@opencode/ai/providers/openai-compatible",
          "settings": { "baseURL": "https://gateway.dothoosh.com/v1" },
          "models": { "deepseek-flash": { "name": "deepseek-flash" } }
        }
      },
      "model": "dothoosh/deepseek-flash"
    }
  3. نسخهٔ ۱ و قدیمی‌تر

    نسخهٔ OpenCode را با opencode --version ببینید. اگر ۱ یا قدیمی‌تر است، به‌جای پیکربندی بالا از این استفاده کنید. کلید از همان متغیر محیطی خوانده می‌شود.

    opencode.json (v1)
    {
      "$schema": "https://opencode.ai/config.json",
      "provider": {
        "dothoosh": {
          "npm": "@ai-sdk/openai-compatible",
          "name": "Dothoosh (دات‌هوش)",
          "options": {
            "baseURL": "https://gateway.dothoosh.com/v1",
            "apiKey": "{env:DOTHOOSH_API_KEY}"
          },
          "models": { "deepseek-flash": { "name": "deepseek-flash" } }
        }
      },
      "model": "dothoosh/deepseek-flash"
    }
  4. اجرا و انتخاب مدل

    در پوشهٔ پروژه opencode را بزنید. اگر model را در فایل نوشته باشید همان مدل انتخاب است؛ وگرنه /models را بزنید، یکی از مدل‌های dothoosh/… را بردارید و اولین پیام را بفرستید.

    terminal
    opencode

اتصال یک‌مرحله‌ای با /connect و انتخاب دات‌هوش از فهرست ارائه‌دهنده‌های OpenCode در راه است، اما زمان مشخصی ندارد. تا آن زمان از پیکربندی بالا استفاده کنید.

کار نکرد؟

401 · api_key_invalid

کلید اشتباه کپی شده، لغو شده یا غیرفعال است. مطمئن شوید DOTHOOSH_API_KEY در همان ترمینالی که opencode را اجرا می‌کنید تنظیم شده و کلید را در کنسول بررسی کنید.

402 · insufficient_available_balance

موجودی کیف پول کافی نیست. کیف پول را شارژ کنید و دوباره امتحان کنید؛ بدهی ایجاد نمی‌شود.

404 · model_not_found

شناسهٔ مدل باید دقیقاً همان شناسهٔ کاتالوگ مدل‌ها باشد، بدون پیشوند ارائه‌دهنده. در فایل پیکربندی در هر سه جا یکی باشد.

کار طولانی و محدودیت context

در کار خیلی طولانی ممکن است گفت‌وگو از سقف context مدل بزرگ‌تر شود. اندازهٔ آن را در کاتالوگ ببینید، /compact را بزنید یا نشست تازه شروع کنید.

فهرست کامل خطاها در راهنمای خطاها است.