مرحله دوم: ساخت اتصال آماده OpenCode در پاستا
- صفحه اتصال ابزارهای توسعه پاستا را باز کنید و OpenCode را انتخاب کنید.
- مدل مناسب را از کاتالوگ انتخاب کنید و سقف هزینه روزانه را تعیین کنید.
- اتصال را بسازید؛ پاستا یک کلید ۹۰ روزه و محدود به همان مدل ایجاد میکند.
- کلید و تنظیم تولیدشده را همان لحظه کپی کنید. کلید کامل فقط یکبار نمایش داده میشود.
برای Agent کدنویسی از کلید برنامه اصلی یا کلید مشترک تیم استفاده نکنید. کلید جدا باعث میشود مصرف OpenCode مستقل گزارش شود و بتوانید بدون اختلال در سرویسهای دیگر آن را لغو کنید.
مرحله سوم: تنظیم PAASTA_API_KEY
کلید را داخل opencode.json یا Repository قرار ندهید. در PowerShell برای نشست فعلی:
$env:PAASTA_API_KEY="کلید-دریافتی-از-پاستا"
در macOS، Linux یا WSL:
export PAASTA_API_KEY="کلید-دریافتی-از-پاستا"
اگر کلید را در فایل محیطی نگه میدارید، آن فایل باید در .gitignore باشد. کلید افشاشده را فوراً لغو و جایگزین کنید.
مرحله چهارم: ساخت opencode.json
تنظیم تولیدشده در پنل پاستا را در فایل opencode.json ریشه پروژه ذخیره کنید. ساختار آن شبیه نمونه زیر است؛ بهجای YOUR_MODEL_ID دقیقاً شناسه مدلی را بگذارید که هنگام ساخت کلید انتخاب کردهاید:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"paasta": {
"npm": "@ai-sdk/openai-compatible",
"name": "Paasta",
"options": {
"baseURL": "https://console.paasta.cloud/api/ai/v1",
"apiKey": "{env:PAASTA_API_KEY}"
},
"models": {
"YOUR_MODEL_ID": { "name": "YOUR_MODEL_ID" }
}
}
},
"model": "paasta/YOUR_MODEL_ID"
}
OpenCode برای Providerهای سازگار با Chat Completions از بسته @ai-sdk/openai-compatible استفاده میکند. baseURL باید دقیقاً شامل مسیر /v1 باشد.
روش جایگزین با دستور /connect
در رابط OpenCode دستور /connect را اجرا کنید، گزینه Other را بزنید، شناسه Provider را paasta وارد کنید و کلید را Paste کنید. سپس همان Provider را در opencode.json تعریف کنید. شناسه واردشده در هر دو محل باید یکسان باشد. در پایان با /models مدل پاستا را انتخاب کنید.
مرحله پنجم: اولین اجرای امن
cd مسیر-پروژه
git status
opencode
برای تست اول یک کار کوچک و فقطخواندنی بدهید:
ساختار این پروژه را بررسی کن و سه ریسک اصلی را توضیح بده.
هیچ فایل یا فرمانی را بدون تأیید من تغییر یا اجرا نکن.
بعد از دریافت پاسخ، یک تغییر کوچک بخواهید و خروجی git diff و تست مرتبط را خودتان بازبینی کنید. Agent جای Review و تست انسانی را نمیگیرد.
دسترسیها و امنیت OpenCode
OpenCode برای اقداماتی مانند Shell و ویرایش فایل Policy دسترسی دارد. در شروع، عملیات حساس را روی حالت پرسش نگه دارید و اجرای خودکار را فقط برای فرمانهای کمخطر و مشخص باز کنید. حالت Auto میتواند درخواستهای تأیید را خودکار بپذیرد؛ آن را روی Repository دارای Secret یا محیط production بدون Ruleهای محدودکننده فعال نکنید.
- کار را روی Branch جدا و با Working Tree تمیز آغاز کنید.
- فرمانهای حذف، Push، Deploy و Migration را نیازمند تأیید نگه دارید.
- فایلهای Secret، کلید SSH و تنظیم production را از محدوده Agent خارج کنید.
- قبل از Commit، Diff، تست و فهرست فایلهای تغییرکرده را بررسی کنید.
انتخاب مدل و کنترل هزینه
کارهای روزمره مانند توضیح کد یا تغییر کوچک معمولاً به گرانترین مدل نیاز ندارند. در اتصال پاستا میتوانید برای هر مدل یک کلید مستقل بسازید، سقف روزانه بگذارید و بعد از مشاهده مصرف واقعی تصمیم بگیرید. برای Refactor پیچیده یا Debug چندفایلی، مدل قویتر را در یک اتصال جدا امتحان کنید.
قیمت و موجودی مدلها ممکن است تغییر کند؛ بهجای جدول ثابت، کاتالوگ زنده مدلها و قیمت تومانی را ببینید.
رفع خطاهای رایج OpenCode
خطای 401 یا Unauthorized
متغیر PAASTA_API_KEY در همان محیطی که OpenCode اجرا شده موجود نیست، یا کلید لغو و منقضی شده است. مقدار کلید را در خروجی ترمینال چاپ نکنید؛ یک نشست تازه با متغیر درست باز کنید.
مدل در /models دیده نمیشود
شناسه مدل در بخش models با مدل مجاز کلید یکسان نیست، یا Provider داخل opencode.json تعریف نشده است. اگر از /connect استفاده کردهاید، شناسه آن باید دقیقاً paasta باشد.
خطای endpoint یا پاسخ نامعتبر
baseURL را با https://console.paasta.cloud/api/ai/v1 تطبیق دهید و برای این endpoint از @ai-sdk/openai-compatible استفاده کنید.
خطای 429 یا توقف مصرف
Rate Limit یا سقف روزانه کلید رسیده است. درخواست را کوچکتر کنید، اجرای همزمان را کاهش دهید و فقط پس از بررسی گزارش مصرف سقف را بالا ببرید.
چرا API هوش مصنوعی پاستا برای OpenCode مناسب است؟
OpenCode به یک API مدل قابلاعتماد نیاز دارد و پاستا مسیر اتصال آن را از قبل تولید میکند. بهجای تنظیم دستی چند سرویس، مدل را انتخاب میکنید و یک کلید مدلمحور با بودجه روزانه، انقضا و گزارش مصرف تومانی تحویل میگیرید. همان قرارداد OpenAI-compatible نیز جابهجایی مدل را بدون تغییر ابزار ممکن میکند.
برای جزئیات Streaming، خطاها و نمونه SDK به مستندات API هوش مصنوعی پاستا مراجعه کنید. برای شروع سریع، اتصال OpenCode را در پنل بسازید و نمونه تولیدشده را مستقیماً در پروژه قرار دهید.