برو به محتوای اصلی

نصب و استفاده از OpenCode

OpenCode یک ابزار کدنویسی با قابلیت عامل‌گرا است. این ابزار به عنوان برنامه ترمینال، برنامه دسکتاپ و افزونه IDE در دسترس است.

AI-Public OpenCode را به توسعه‌دهندگان، مدیران و سایر کاربران پیشرفته پیشنهاد می‌کند. OpenCode می‌تواند فایل‌ها را به‌طور خودکار اصلاح کند و وظایف را انجام دهد. بنابراین همیشه تغییرات پیشنهادی را بررسی کنید.

اطلاعات بیشتر در وب‌سایت OpenCode OpenCode-website و در مستندسازی رسمی OpenCode OpenCode-dokumentation موجود است.

نصب​

ساده‌ترین روش نصب طبق مستندات OpenCode به‌شرح زیر است:

curl -fsSL https://opencode.ai/install | bash

همچنین می‌توانید OpenCode را با Node.js نصب کنید:

npm install -g opencode-ai

یا با Homebrew بر macOS و Linux:

brew install anomalyco/tap/opencode

اتصال به Coderen​

OpenCode از ارائه‌دهندگان سازگار با OpenAI سفارشی پشتیبانی می‌کند. در پوشه پروژه فایلی با نام opencode.json ایجاد کنید.

درون آن از نقطه پایانی Coderen و مدل‌های مجاز استفاده کنید:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-public-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-Public Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-public-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_PUBLIC_CODEREN_API_KEY}"
      },
      "models": {
        "gpt-5.6-luna": {
          "name": "GPT-5.6 Luna"
        },
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra"
        },
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol"
        }
      }
    }
  },
  "model": "ai-public-coderen/gpt-5.6-luna",
  "small_model": "ai-public-coderen/gpt-5.6-luna"
}

سپس کلید API را به‌عنوان متغیر محیطی قرار دهید.

macOS و Linux​

export AI_PUBLIC_CODEREN_API_KEY="aip.api-key شما"

Windows​

setx AI_PUBLIC_CODEREN_API_KEY "aip.api-key شما"

سپس ترمینال جدید را باز کنید.

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

به پوشه پروژه بروید:

cd مسیر/به/پروژه/شما

OpenCode را اجرا کنید:

opencode

در OpenCode از گزینه مدل برای انتخاب مدل AI-Public Coderen استفاده کنید اگر به طور خودکار این کار انجام نشده باشد.

کار ایمن با OpenCode​

از آنجا که OpenCode دارای قابلیت عامل‌گرا است، مهم است که تغییرات را بررسی کنید.

روش کار پیشنهادی:

  1. در یک مخزن گیت کار کنید.
  2. با وظایف کوچک شروع کنید.
  3. قبل از استفاده از کد، تفاوت‌ها (diff) را بررسی کنید.
  4. پس از تغییرات، برنامه را آزمایش کنید.
  5. فقط تغییراتی را Commit کنید که واقعاً می‌فهمید.

متغیرهای محیطی و OpenCode​

برای OpenCode می‌توانید کلید API Coderen را در یک فایل محلی .env در پوشه پروژه ذخیره کنید:

AI_PUBLIC_CODEREN_API_KEY=aip.api-key شما

اطمینان حاصل کنید OpenCode این متغیر محیطی را نیز بارگذاری کند. در PowerShell می‌توانید این متغیر را موقتاً برای ترمینال جاری تنظیم کنید:

$env:AI_PUBLIC_CODEREN_API_KEY="aip.api-key شما"

اگر پیامی مانند Authorization header with Bearer token is required مشاهده کردید، به این معنی است که ابزار کلید را به‌عنوان Authorization: Bearer ... همراه ارسال نمی‌کند. اگر پیامی مانند Unknown parameter دیدید، تنظیمات مخصوص ارائه‌دهنده را که Coderen endpoint AI-Public پشتیبانی نمی‌کند، حذف کنید.

WhatsApp