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

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

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

AI-School توصیه می‌کند OpenCode را به ویژه برای معلمان، مدیران و دانش‌آموزانی که تجربه برنامه‌نویسی زیادی دارند، مفید بدانند. OpenCode می‌تواند نسبت به Aider مستقل‌تر عمل کند و بنابراین تغییرات زیادی را سریع‌تر اجرا کند.

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

چه زمانی OpenCode را انتخاب کنید؟​

OpenCode را زمانی انتخاب کنید که کاربر:

  • با ترمینال، ویرایشگرهای کد و گیت آشنا باشد
  • بفهمد که فایل‌های محلی چگونه تغییر داده می‌شوند
  • بتواند تغییرات را پیش از استفاده بررسی کند
  • می‌خواهد وظایف برنامه‌نویسی پیچیده‌تری را پیگیری کند

برای یادگیری کدنویسی به صورت کلاسیک با مبتدیان، معمولاً Aider مناسب‌تر است.

نصب​

ساده‌ترین روش نصب طبق مستندات 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-school-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-School Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_SCHOOL_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-school-coderen/gpt-5.4-mini",
  "small_model": "ai-school-coderen/gpt-5.4-mini"
}

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

برای این کار می‌توانید از فایل .env در پوشه پروژه استفاده کنید:

AI_SCHOOL_CODEREN_API_KEY=ais.api-key شما

پس از بازکردن ترمینال جدید بررسی کنید که OpenCode این متغیر را می‌خواند. اگر OpenCode کلیدی ارسال نکرد، AI-School پیغام خطای لازم مبنی بر وجود Authorization header با Bearer token را می‌دهد.

macOS و Linux​

export AI_SCHOOL_CODEREN_API_KEY="ais.api-key شما"

Windows​

setx AI_SCHOOL_CODEREN_API_KEY "ais.api-key شما"

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

اجرای OpenCode​

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

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

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

opencode

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

رفع مشکلات​

Authorization header با Bearer token اجباری است​

این پیغام معمولاً به این معنی است که OpenCode کلید API ارسال نکرده است. بررسی کنید:

  • آیا AI_SCHOOL_CODEREN_API_KEY دقیقاً به این شکل است
  • آیا مقدار با ais. شروع می‌شود
  • آیا پس از setx ترمینال جدیدی باز کرده‌اید
  • آیا فایل .env در پوشه پروژه‌ای که OpenCode را از آن اجرا می‌کنید وجود دارد

Unknown parameter​

برخی ابزارها پارامترهای اضافی مخصوص ارائه‌دهنده را ارسال می‌کنند. اگر پیامی مانند Unknown parameter مشاهده کردید، آن تنظیم را از پیکربندی OpenCode حذف کنید یا از پیکربندی ارائه‌دهنده ساده‌تری استفاده کنید. endpoint Coderen درخواست چت سازگار با OpenAI با مدل، پیام‌ها و تنظیمات پایه عادی را انتظار دارد.

حفظ امنیت در کار با OpenCode​

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

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

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

برای دانش‌آموزانی که تجربه کمی دارند، مناسب است که OpenCode را ابتدا به صورت демонстраاتی زیر نظر یک مدرس استفاده کنند.