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

Aider ابزار خط‌فرمان جفت‌برنامه‌نویسی است که مستقیم روی مخزن گیت شما تغییر اعمال و کامیت می‌کند. برای مدل‌های سازگار با OpenAI، Aider فلگ‌های --openai-api-base و --openai-api-key دارد و نام مدل با پیشوند openai/ داده می‌شود تا LiteLLM درون آن بداند از کدام پروتکل استفاده کند.

چون Aider تغییرات را کامیت می‌کند، حتماً روی شاخه‌ی جداگانه کار کنید و تغییرات را قبل از ادغام مرور کنید.

پیش‌نیازها

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

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

1. ۱نصب

   Aider را با pipx یا pip نصب کنید.

   کپی

   python -m pip install aider-install
   aider-install

2. ۲اجرا با فلگ‌ها

   آدرس، کلید و مدل را در دستور بدهید.

   کپی

   cd my-project
   aider --openai-api-base https://api.picoai.ir/v1 \
         --openai-api-key YOUR_API_KEY \
         --model openai/claude-sonnet-5-5

3. ۳با متغیر محیطی

   برای راحتی می‌توانید این‌ها را در شل یا .env بگذارید.

   کپی

   export OPENAI_API_BASE=https://api.picoai.ir/v1
   export OPENAI_API_KEY=YOUR_API_KEY
   aider --model openai/gpt-6-sol

4. ۴فایل .aider.conf.yml

   تنظیمات دائمی پروژه را در فایل پیکربندی بگذارید.

   کپی

   openai-api-base: https://api.picoai.ir/v1
   model: openai/gpt-6-sol

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

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

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

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

• کلید را در .aider.conf.yml داخل گیت نگذارید؛ از متغیر محیطی استفاده کنید.
• با دستور /add فقط فایل‌های لازم را به گفتگو اضافه کنید تا توکن کمتری مصرف شود.
• Aider پیشنهاد می‌کند مدل ضعیف جداگانه برای خلاصه‌سازی تاریخچه تعریف شود (--weak-model).

عیب‌یابی

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

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