OpenCode
ابزار ترمینال·راهنمای رسمی اتصال

اتصال OpenCode به نقطه

ایجنت کدنویس متن‌باز ترمینال — با یک فایل کانفیگ به نقطه وصل می‌شود.

قدم‌های اتصال
۳ قدم
زمان راه‌اندازی
~۳ دقیقه
هزینه‌ی خود ابزار
رایگان
پیش‌نیاز
کلید پلن پرو

راهنمای اتصال

قدم‌به‌قدم تا اولین پاسخ

هر جا کد یا مقدار دیدی، با دکمهٔ کپی بردار و همان‌جا که گفتیم بگذار. کلید sk-noqte نداری؟ با پلن پرو در چند ثانیه می‌گیری.

  1. نصب OpenCode

    در ترمینال این دستور را اجرا کن (macOS / Linux):

    curl -fsSL https://opencode.ai/install | bash
  2. ساخت فایل کانفیگ

    OpenCode متغیر محیطی برای base URL نمی‌خواند و کانفیگ را از فایل می‌خواند. این فایل را بساز: • مک/لینوکس: ~/.config/opencode/opencode.json • ویندوز: %APPDATA%\opencode\opencode.json و این محتوا را داخلش بگذار. ⚠ مهم: مقدار baseURL حتماً باید با /v1/ (اسلش پایانی) ختم شود — OpenCode از new URL("messages", base) استفاده می‌کند که بدون اسلش پایانی، آدرس را به /messages اشتباه می‌فرستد (404 می‌گیری).

    {
      "$schema": "https://opencode.ai/config.json",
      "provider": {
        "anthropic": {
          "options": {
            "baseURL": "https://api.noqte.ai/v1/",
            "apiKey": "sk-noqte-…"
          }
        }
      },
      "model": "anthropic/claude-sonnet-5"
    }
  3. اجرا در دایرکتوری پروژه

    وارد دایرکتوری پروژه شو و بزن:

    opencode
    رابط OpenCode روی مدل نقطه (نمای بازسازی‌شده)
    رابط OpenCode روی مدل نقطه (نمای بازسازی‌شده)

رفع اشکال

سوالات پرتکرار دربارهٔ OpenCode

چرا OpenCode خطای 404 می‌دهد؟

مقدار baseURL باید دقیقاً با /v1/ (با اسلش پایانی) تمام شود. OpenCode آدرس نهایی را با new URL نسبی می‌سازد و بدون اسلش پایانی، درخواست به مسیر اشتباه /messages می‌رود. فایل opencode.json را اصلاح کن و دوباره اجرا کن.

روی ویندوز فایل کانفیگ کجاست؟

در مسیر %APPDATA%\opencode\opencode.json — معمولاً یعنی C:\Users\نام‌کاربری\AppData\Roaming\opencode\opencode.json. اگر پوشه‌ی opencode وجود ندارد، خودت بسازش.

چه مدلی را به‌عنوان پیش‌فرض بگذارم؟

anthropic/claude-sonnet-5 بهترین انتخاب برای کارهای ایجنتی است. مقدار model در opencode.json مدل پیش‌فرض هر سشن است و داخل خود OpenCode هم می‌توانی موقتاً عوضش کنی.

یک کلید، همهٔ مدل‌ها — با ظرفیت اشتراک خودت

کلید API در پلن‌های پرو فعال می‌شود؛ سهمش را بین ابزارها پخش کن و مصرف را زنده در داشبورد ببین — بدون کارت خارجی، بدون فیلترشکن، با پرداخت ریالی.

همین کلید در بقیهٔ ابزارها هم کار می‌کند