مرحله دوم: ساخت کلید API مخصوص Cline در پاستا
- صفحه کلیدهای API هوش مصنوعی را باز کنید.
- یک کلید با نامی مانند
Cline VS Code بسازید.
- فقط مدل موردنظر را مجاز کنید و سقف هزینه روزانه و Rate Limit بگذارید.
- کلید را همان لحظه در Password Manager امن ذخیره کنید؛ مقدار کامل دوباره نمایش داده نمیشود.
برای هر دستگاه یا پروژه کلید جدا بسازید. اگر لپتاپ گم شد یا کلید لو رفت، میتوانید فقط دسترسی Cline همان دستگاه را لغو کنید.
مرحله سوم: اتصال Cline به API پاستا
در پنل Cline روی آیکون تنظیمات بزنید و اطلاعات زیر را وارد کنید:
API Provider: OpenAI Compatible
Base URL: https://console.paasta.cloud/api/ai/v1
API Key: کلید ساختهشده در پاستا
Model ID: شناسه دقیق مدل انتخابی
مطابق راهنمای رسمی OpenAI Compatible در Cline سه مقدار Base URL، API Key و Model ID هسته این اتصال هستند. آدرس پاستا باید شامل /v1 باشد؛ مسیر /chat/completions را دستی به آن اضافه نکنید.
شناسه مدل را از کاتالوگ زنده مدلها کپی کنید. نام نمایشی مدل کافی نیست و باید ID دقیق با مدل مجاز کلید یکسان باشد.
مرحله چهارم: تست اتصال
اولین درخواست را کوچک و فقطخواندنی نگه دارید:
این پروژه را فقط بررسی کن و هنوز هیچ فایل یا تنظیمی را تغییر نده.
فناوریها، فرمان تست و سه ریسک اصلی را همراه با مسیر فایل توضیح بده.
اگر پاسخ دریافت شد، اتصال مدل برقرار است. بعد یک تغییر کوچک بخواهید و پیشنهاد Cline را پیش از تأیید بررسی کنید.
Plan Mode و Act Mode در Cline
در Plan Mode، Cline باید سؤال بپرسد، کد را بخواند و برنامه قابلبازبینی بسازد. وقتی محدوده کار روشن شد به Act Mode بروید تا ویرایش آغاز شود. برای باگ مبهم، مهاجرت دیتابیس، پرداخت یا تنظیمات production مستقیماً از Act شروع نکنید.
- درخواست را به یک خروجی قابلسنجش محدود کنید.
- از Cline بخواهید قبل از تغییر، فایلهای مرتبط و تست پیشنهادی را نام ببرد.
- پس از تغییر،
git diff و خروجی تست را خودتان بررسی کنید.
- Commit و Push را از مرحله تولید کد جدا نگه دارید.
Checkpoint در Cline چه کاربردی دارد؟
Checkpoints از وضعیت فایلهای پروژه هنگام کار Agent Snapshot میگیرند و امکان مقایسه یا بازگردانی تغییر را فراهم میکنند. این قابلیت مفید است، اما جای Git و Backup را نمیگیرد؛ فایلهای خارج از Workspace، دیتابیس و عملیات خارجی الزاماً با بازگردانی Checkpoint برنمیگردند.
قبل از کار چندفایلی، وضعیت Git را تمیز کنید و برای تغییر پرریسک Commit جدا داشته باشید. اگر خروجی Cline مناسب نبود، ابتدا Diff را ببینید و سپس فقط تغییر مربوط را Restore کنید.
Auto Approve را چطور امن تنظیم کنیم؟
Auto Approve برای هر دسته Tool مشخص میکند Cline بدون توقف اجازه عمل داشته باشد یا نه. راهنمای رسمی Cline پیشنهاد میکند خواندن فایل پروژه را فعال و Edit، Command، Browser و MCP را تا زمان نیاز خاموش نگه دارید.
- فرمانهای مشاهده مانند
git status با نصب Dependency، حذف فایل و Deploy یکسان نیستند.
- YOLO Mode همه تأییدها را کنار میگذارد؛ آن را روی سیستم کاری یا Repository حساس فعال نکنید.
- Secretها، فایل محیط production، کلید SSH، kubeconfig و Dump مشتری را از Workspace خارج کنید.
- صفحه وب، Issue و کد شخص ثالث میتواند Prompt Injection داشته باشد؛ دستور داخل محتوا را قابلاعتماد فرض نکنید.
جزئیات هر سطح دسترسی در مستندات Auto Approve در Cline آمده است.
چطور هزینه Cline را کنترل کنیم؟
Agent ممکن است برای خواندن Context، برنامهریزی، ویرایش و رفع خطای تست چند درخواست پشتسرهم بفرستد. در پاستا کلید Cline را به یک مدل محدود کنید، سقف مصرف روزانه بگذارید و گزارش توکن ورودی و خروجی را بررسی کنید.
کار توضیحی و تغییر کوچک را با مدل اقتصادیتر آغاز کنید. برای Refactor یا Debug پیچیده میتوانید کلید جدا با مدل قویتر بسازید. نام و قیمت مدلها ثابت نیست؛ کاتالوگ زنده پاستا مرجع انتخاب است.
رفع خطاهای رایج Cline با API پاستا
خطای 401 یا Invalid API Key
کلید اشتباه، منقضی یا لغوشده است. مطمئن شوید کلید را از صفحه API پاستا گرفتهاید و فاصله اضافی ندارد. Secret را در Log یا Screenshot منتشر نکنید؛ در صورت تردید کلید قبلی را لغو و کلید تازه بسازید.
خطای 404 یا Connection Error
Base URL باید دقیقاً https://console.paasta.cloud/api/ai/v1 باشد. افزودن /v1 دوباره یا نوشتن مسیر کامل Chat Completions باعث خطا میشود.
خطای Model Not Found یا model_not_allowed
Model ID با شناسه کاتالوگ یا مدل مجاز کلید یکسان نیست. ID را دوباره کپی کنید یا برای مدل جدید کلید مستقل بسازید.
خطای 429 یا توقف بودجه
Rate Limit یا سقف مصرف روزانه پر شده است. Context و دامنه کار را کوچکتر کنید، گزارش مصرف را ببینید و فقط در صورت نیاز سقف را افزایش دهید.
Cline ابزارها را درست اجرا نمیکند
همه مدلها رفتار یکسانی در Tool Calling ندارند. مدل سازگار دیگری انتخاب کنید، درخواست را کوچکتر بنویسید و ابتدا در Plan Mode برنامه را بررسی کنید.
چرا API هوش مصنوعی پاستا برای Cline مناسب است؟
Cline از provider سفارشی OpenAI Compatible پشتیبانی میکند و پاستا همان قرارداد Chat Completions را با Streaming و Tool Call ارائه میدهد. بنابراین برای استفاده از مدلهای مختلف لازم نیست افزونه یا کد پروژه را عوض کنید؛ Base URL، کلید و Model ID را وارد میکنید.
مزیت عملی پاستا برای کاربر ایرانی، پرداخت تومانی، کلید مدلمحور، سقف مصرف، گزارش هزینه و کاتالوگ یکپارچه است. جزئیات endpoint، احراز هویت و نمونه درخواست در مستندات API هوش مصنوعی پاستا قرار دارد.