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

نصب و استفاده از 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 ایجاد کنید.

درون آن از نقطه دسترسی 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.4-mini": {
          "name": "GPT-5.4 mini"
        },
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  },
  "model": "ai-corporate-coderen/gpt-5.4-mini",
  "small_model": "ai-corporate-coderen/gpt-5.4-mini"
}

سپس کلید 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. قبل از استفاده از کد، تغییرات را دقیقاً بررسی کنید.
  4. پس از تغییرات، برنامه را تست کنید.
  5. فقط تغییراتی را Commit کنید که متوجه هستید.

متغیرهای محیطی و 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 را دیدید، تنظیمات خاص ارائه‌دهنده را که از پایان‌دهی Coderen AI-Corporate پشتیبانی نمی‌کند پاک کنید.