نصب و استفاده از OpenCode
OpenCode یک ابزار کدنویسی هوشمحور است. این ابزار به صورت برنامه ترمینال، برنامه دسکتاپ و افزونه IDE در دسترس است.
AI-Public به توسعهدهندگان، مدیران و کاربران پیشرفته دیگر، OpenCode را پیشنهاد میدهد. OpenCode میتواند بهطور مستقل فایلها را ویرایش کند و کارها را انجام دهد. بنابراین همیشه تغییرات پیشنهادی را بررسی کنید.
اطلاعات بیشتر در وبسایت OpenCode (OpenCode-website) و در مستندات رسمی OpenCode (OpenCode documentation) یافت میشود.
نصب
سادهترین روش نصب بر اساس مستندات 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 سفارشی پشتیبانی میکند (providers سازگار با 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.4-mini": {
"name": "GPT-5.4 mini"
},
"gpt-5.4": {
"name": "GPT-5.4"
},
"gpt-5.5": {
"name": "GPT-5.5"
}
}
}
},
"model": "ai-public-coderen/gpt-5.4-mini",
"small_model": "ai-public-coderen/gpt-5.4-mini"
}
سپس کلید API را بهعنوان یک متغیر محیطی قرار دهید.
macOS و Linux
export AI_PUBLIC_CODEREN_API_KEY="aip.کلید-API-شما"
Windows
setx AI_PUBLIC_CODEREN_API_KEY "aip.کلید-API-شما"
سپس یک ترمینال جدید باز کنید.
راهاندازی OpenCode
به پوشه پروژه بروید:
cd مسیر/به/پروژه/شما
OpenCode را آغاز کنید:
opencode
در OpenCode، گزینه مدل را برای انتخاب مدل AI-Public Coderen استفاده کنید اگر قبلاً بهطور خودکار این کار انجام نشده است.
کار ایمن با OpenCode
از آنجا که OpenCode به صورت عاملمحور کار میکند، بررسی تغییرات اهمیت دارد.
روش کار پیشنهادی:
- در یک مخزن گیت کار کنید.
- با دستورات کوچک شروع کنید.
- قبل از استفاده از کد، تفاوتها را بررسی کنید.
- پس از تغییرات، برنامه را آزمایش کنید.
- فقط تغییراتی را Commit کنید که میفهمید.
متغیرهای محیطی و OpenCode
برای OpenCode میتوانید کلید API Coderen را در یک فایل محلی .env در پوشه پروژه ذخیره کنید:
AI_PUBLIC_CODEREN_API_KEY=aip.کلید-API-شما
اطمینان حاصل کنید که OpenCode این متغیر محیطی را به درستی بارگذاری کند. در PowerShell هم میتوانید این متغیر را موقتاً برای ترمینال فعلی تنظیم کنید:
$env:AI_PUBLIC_CODEREN_API_KEY="aip.کلید-API-شما"
اگر پیامی مانند Authorization header with Bearer token is required مشاهده کردید، کلید را بهعنوان Authorization: Bearer ... ارسال نمیکند. اگر پیامی مانند Unknown parameter دیدید، تنظیمات مرتبط با ارائهدهنده که ازendpoint Coderen در AI-Public پشتیبانی نمیکند را حذف کنید.