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

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

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

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

برای اطلاعات بیشتر به وب‌سایت OpenCode و به مستندات رسمی OpenCode مراجعه کنید.

نصب​

ساده‌ترین روش نصب با توجه به مستندات 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 بسازید.

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

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-corporate-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-Corporate Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-corporate.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_CORPORATE_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-corporate-coderen/gpt-5.6-luna",
  "small_model": "ai-corporate-coderen/gpt-5.6-luna"
}

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

macOS و Linux​

export AI_CORPORATE_CODEREN_API_KEY="aic.jouw-api-sleutel"

Windows​

setx AI_CORPORATE_CODEREN_API_KEY "aic.jouw-api-sleutel"

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

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

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

cd pad/naar/je/project

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

opencode

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

کار ایمن با OpenCode​

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

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

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

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

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

AI_SCHOOL_CODEREN_API_KEY=ais.jouw-api-sleutel

اطمینان حاصل کنید OpenCode این متغیر محیطی را واقعاً لود می‌کند. در PowerShell می‌توانید متغیر را موقتا برای ترمینال فعلی تنظیم کنید:

$env:AI_SCHOOL_CODEREN_API_KEY="ais.jouw-api-sleutel"

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

WhatsApp