اتصال Cline به پیکو هوش

Cline افزونه‌ی VS Code برای کدنویسی ایجنتی است که فایل‌ها را می‌خواند، دستور اجرا می‌کند و تغییر پیشنهاد می‌دهد. Cline ارائه‌دهنده‌ای به نام OpenAI Compatible دارد که Base URL، کلید و Model ID را از شما می‌گیرد، پس اتصال به پیکو هوش چند فیلد ساده است.

Cline درخواست‌های زیادی با زمینه‌ی بزرگ می‌فرستد. بهتر است یک کلید اختصاصی با سقف ماهانه برای آن بسازید و مصرف را در داشبورد زیر نظر بگیرید.

پیش‌نیازها

• یک حساب پیکو هوش و یک کلید API از داشبورد (کلید فقط یک‌بار کامل نمایش داده می‌شود).
• شناسه‌ی دقیق مدل از کاتالوگ؛ در مثال‌ها از gpt-6-sol و claude-sonnet-5-5 استفاده شده است.
• کمی موجودی در کیف پول تومانی یا اعتبار؛ تعرفه را در صفحه‌ی قیمت‌ها ببینید.

راه‌اندازی گام‌به‌گام

1. ۱نصب افزونه

   در VS Code از بخش Extensions، Cline را نصب کنید.

2. ۲انتخاب ارائه‌دهنده

   در تنظیمات Cline، API Provider را روی OpenAI Compatible بگذارید.

3. ۳پر کردن فیلدها

   سه فیلد اصلی را بنویسید.

   کپی

   Base URL:  https://api.picoai.ir/v1
   API Key:   YOUR_API_KEY
   Model ID:  claude-sonnet-5-5

4. ۴تست

   یک تسک ساده مثل «README را خلاصه کن» بدهید. اگر پاسخ آمد، اتصال برقرار است.

تست سریع اتصال

پیش از نوشتن منطق برنامه، یک بار فهرست مدل‌ها را بگیرید. اگر پاسخ ۲۰۰ و فهرستی از شناسه‌ها برگشت، کلید، شبکه و آدرس درست است و هر مشکل بعدی مربوط به تنظیمات Cline خواهد بود.

curl https://api.picoai.ir/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

نکته‌های کاربردی برای Cline

• حالت Plan را برای طرح اولیه و حالت Act را برای اعمال تغییرات استفاده کنید تا توکن کمتری مصرف شود.
• فایل‌های بزرگ و node_modules را با .clineignore کنار بگذارید.
• تأیید دستی اجرای دستورها را خاموش نکنید مگر در محیط ایزوله.

عیب‌یابی

هزینه و صورتحساب

هر درخواست قبل از اجرا مقداری از موجودی را رزرو می‌کند و پس از پاسخ موفق بر پایه‌ی توکن‌های واقعی تسویه می‌شود؛ مابه‌التفاوت برمی‌گردد و درخواست ناموفق چیزی کم نمی‌کند. جدول قیمت هر مدل در صفحه‌ی قیمت‌ها منتشر شده و مصرف هر درخواست در داشبورد قابل مشاهده است. اگر قبلاً از سرویس دیگری استفاده می‌کردید، راهنمای مهاجرت و صفحه‌ی مقایسه را ببینید.