نصب و استفاده از OpenCode
OpenCode یک ابزار کدنویسی عاملمحور است. این ابزار به عنوان برنامه ترمینال، برنامه دسکتاپ و افزونه IDE در دسترس است.
AI-School OpenCode را عمدتاً برای معلمان، مدیران و دانشآموزانی که تجربه برنامهنویسی زیادی دارند، توصیه میکند. OpenCode میتواند مستقلتر از Aider کار کند و در نتیجه تغییرات زیادی را سریعتر اعمال کند.
اطلاعات بیشتر در وبسایت OpenCode OpenCode-website و در مستندات رسمی 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 از .Providerهای سازگار با 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.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-school-coderen/gpt-5.6-luna",
"small_model": "ai-school-coderen/gpt-5.6-luna"
}
سپس کلید API را به عنوان متغیر محیطی قرار بدهید.
برای این کار میتوانید از فایل .env در پوشه پروژه استفاده کنید:
AI_SCHOOL_CODEREN_API_KEY=ais.jouw-api-sleutel
پس از باز کردن ترمینال جدید بررسی کنید که OpenCode بتواند این متغیر را بخواند. اگر OpenCode کلید را فرستاده نکرد، AI-School پیغام خطا میدهد که یک هدر Authorization با Bearer توکن ضروری است.
macOS و Linux
export AI_SCHOOL_CODEREN_API_KEY="ais.jouw-api-sleutel"
Windows
setx AI_SCHOOL_CODEREN_API_KEY "ais.jouw-api-sleutel"
سپس ترمینال جدیدی باز کنید.
آغاز OpenCode
به پوشه پروژه بروید:
cd pad/naar/je/project
OpenCode را راهاندازی کنید:
opencode
در OpenCode از گزینه مدل برای انتخاب مدل Coderen AI-School استفاده کنید اگر به طور خودکار این کار انجام نشده باشد.
رفع مشکلات
هدر Authorization با Bearer توکن اجباری است
این پیام معمولاً به این معنی است که OpenCode کلید API را ارسال نمیکند. بررسی کنید:
- آیا
AI_SCHOOL_CODEREN_API_KEYدقیقاً به همین نام نوشته شده است - آیا مقدار آن با
ais.آغاز میشود - آیا پس از
setxیک ترمینال جدید باز شده است - آیا فایل
.envدر پوشه پ روژهای که OpenCode را از آن اجرا میکنید وجود دارد
Unknown parameter
برخی ابزارها پارامترهایเพิ่มเติม مختص ارائهدهنده را میفرستند. اگر پیامی مانند Unknown parameter دریافت کردید، آن تنظیمات را از پیکربندی OpenCode حذف کنید یا از پیکربندی ارائهدهنده سادهتری استفاده کنید. نقطه پایانی Coderen انتظار درخواستهای چت سازگار با OpenAI با مدل، پیامها و تنظیمات پایه معمول را دارد.
کار ایمن با OpenCode
از آنجا که OpenCode به صورت عاملمحور کار میکند، بررسی تغییرات مهم است.
روش کار پیشنهادی:
- در یک مخزن گیت کار کنید.
- با وظایف کوچک شروع کنید.
- قبل از استفاده از کد، تفاوتها را بررسی کنید.
- پس از تغییرات، برنامه را آزمایش کنید.
- فقط تغییراتی را که میفهمید تعهد کنید.
برای دانشآموزان با تجربه کم، خوب است که OpenCode ابتدا با هدایت یک معلم به صورت نمایشی استفاده شود.
