تخفیف‌های نمایش‌داده‌شده توسط خود ارائه‌دهندگان اصلی اعمال می‌شوند و بازه زمانی مشخصی ندارند. این تخفیف‌ها فقط روی مصرف (Usage) اعمال می‌شوند و هنگام خرید اعتبار اعمال نمی‌گردند. میزان تخفیف ممکن است در هر لحظه کاهش یابد؛ حتی در زمان تخفیف، درخواست‌ها ممکن است به ارائه‌دهندهٔ بدون تخفیف بروند و قیمت کامل محاسبه شود.

افزونه VS Code · Cline / Roo Code

آموزش تنظیم افزونه Cline و Roo Code در VS Code با API ریالی کایا

Cline و Roo Code دو عامل کدنویسی متن‌باز در VS Code هستند که می‌توانند با هر API سازگار با OpenAI کار کنند. با انتخاب Provider از نوع OpenAI Compatible و تنظیم Base URL روی https://kayaai.ir/api/v1، این افزونه‌ها به مدل‌های کدنویسی کایا وصل می‌شوند: پرداخت ریالی، بدون کارت ارزی و بدون تحریم‌شکن.

  • Provider: OpenAI Compatible
  • Base URL سفارشی
  • مدل‌های کدنویسی
  • پرداخت ریالی
ثبت‌نام رایگان و دریافت کلیددیدن مدل‌ها

خلاصه سریع

اگر فقط می‌خواهید وصل شود، همین چند خط کافی است. توضیح هر گام در ادامه آمده است.

تنظیمات Cline / Roo Code
API Provider : OpenAI Compatible
Base URL     : https://kayaai.ir/api/v1
API Key      : sk-llm-YOUR_KEY
Model ID     : anthropic/claude-sonnet-5.5

چرا از Provider سفارشی OpenAI Compatible استفاده کنیم؟

اگر در Cline یا Roo Code گزینه پیش‌فرض Anthropic یا OpenAI را انتخاب کنید، درخواست مستقیم به سرور همان سرویس می‌رود و عملاً به کارت ارزی و دسترسی بدون تحریم نیاز دارید. اما با انتخاب OpenAI Compatible می‌توانید هر Base URL سازگار با OpenAI را معرفی کنید.

کایا ای آی همین قرارداد را پیاده کرده است؛ پس افزونه‌های VS Code، درخواست‌های استاندارد POST /api/v1/chat/completions را به کایا می‌فرستند و پاسخ مدل انتخابی را می‌گیرند — با کسر هزینه به ریال از کیف پول شما.

  • پشتیبانی از انتخاب مدل در لحظه (بین مدل‌های کاتالوگ کایا)
  • استریم پاسخ‌ها، ابزارها (function calling) و درخواست‌های طولانی
  • قابل استفاده برای Embeddings و ایندکس کدبیس با همان کلید
  • بدون نیاز به پروکسی روی اینترنت ایران

پیش‌نیازها

  • Visual Studio Code نسخه دسکتاپ
  • افزونه Cline یا Roo Code از Marketplace (هر دو با یک تنظیم کار می‌کنند)
  • کلید API از پنل کلیدها
  • اعتبار ریالی؛ ۱۰۰ اعتبار هدیه ثبت‌نام برای شروع کافی است

تنظیم افزونه در شش گام

  1. ۱

    افزونه را نصب کنید

    در VS Code وارد پنل Extensions شوید (Ctrl/Cmd + Shift + X) و «Cline» یا «Roo Code» را جست‌وجو و نصب کنید. پس از نصب، آیکون افزونه در نوار کناری VS Code ظاهر می‌شود.

  2. ۲

    تنظیمات افزونه را باز کنید

    روی آیکون Cline/Roo Code در نوار کناری کلیک کنید، سپس از چرخ‌دنده (⚙) یا دکمه Settings وارد تنظیمات شوید. در صفحه اول می‌توانید گزینه «Use your own API key» را انتخاب کنید.

  3. ۳

    API Provider را روی OpenAI Compatible بگذارید

    در فهرست API Provider، گزینه OpenAI Compatible را انتخاب کنید. با این انتخاب، فیلدهای Base URL و API Key و Model ID به شما نمایش داده می‌شود.

    API Provider
    OpenAI Compatible
  4. ۴

    Base URL کایا را وارد کنید

    مقدار Base URL را دقیقاً این آدرس بگذارید:

    Base URL
    https://kayaai.ir/api/v1

    مسیر /chat/completions را خود افزونه اضافه می‌کند؛ آدرس را دستی کامل نکنید. اگر فیلد اختیاری «Azure API Version» یا مشابه آن را دیدید، آن را خالی بگذارید.

  5. ۵

    کلید API را بچسبانید

    کلید ساخته‌شده در پنل کلیدها را در فیلد API Key وارد کنید:

    API Key
    sk-llm-YOUR_KEY
  6. ۶

    شناسه مدل و تنظیمات مدل را وارد کنید

    شناسه کامل مدل را در Model ID بگذارید. اگر بخش Model Configuration در دسترس است، پنجره تقریبی زمینه (Context Window) را مقدار مناسبی بگذارید — برای مدل‌های Claude حدود ۲۰۰٬۰۰۰ توکن پیشنهاد می‌شود — و در صورت پشتیبانی نشدن تصویر، گزینه Supports Images را خاموش کنید.

    Model ID
    anthropic/claude-sonnet-5.5

    برای عوض کردن مدل لازم نیست دوباره تنظیم کنید؛ در همان صفحه، فیلد Model ID را با مدل دیگری از کاتالوگ جایگزین کنید.

کدام مدل برای چه کاری؟

در Cline و Roo Code هر تغییر مدل به‌معنای هزینه متفاوت است. ترکیب زیر هم برای کیفیت و هم برای کنترل هزینه مناسب است:

  • مسئله‌های بزرگ و کدبیس ناآشنا: anthropic/claude-sonnet-5.5
  • ویرایش‌های پرتعداد و مصرف بالا: deepseek/deepseek-v4.1-flash
  • تحلیل معماری و دیباگ سخت: openai/gpt-6.1-sol
  • برای ایندکس کردن کدبیس (در Roo Code) می‌توانید همان Base URL را در تنظیمات Embeddings هم بگذارید

نکات کاربردی برای کار روزمره

  • برای کارهای حساس از Plan Mode استفاده کنید و بعد اجازه اجرای تغییرات (Act Mode) بدهید
  • قواعد پروژه را در فایل .clinerules یا .roorules بنویسید تا مدل همیشه از استانداردهای تیم پیروی کند
  • برای تغییرات کوچک، از مدل ارزان‌تر استفاده کنید و فقط برای تصمیم‌های سخت به مدل گران‌تر سوئیچ کنید
  • مصرف و هزینه را در تاریخچه مصرف پایش کنید

عیب‌یابی سریع

علامتعلت احتمالیراه‌حل
خطای 401 یا Unauthorizedکلید اشتباه وارد شده استکلید را از پنل کلیدها کپی و دوباره ذخیره کنید
خطای 404 روی درخواست‌هاBase URL نادرست یا دارای مسیر اضافه استمقدار را دقیقاً https://kayaai.ir/api/v1 بگذارید
خطای 402اعتبار کافی نیستکیف پول را از داشبورد شارژ کنید
خطای 429درخواست‌های پرحجم همزمانکاهش تعداد عملیات همزمان و تلاش مجدد با backoff
مدل خطا می‌دهد یا در دسترس نیستشناسه مدل در کاتالوگ نیستشناسه دقیق را از صفحه مدل‌ها بردارید
پاسخ‌ها خیلی طول می‌کشدمدل استدلالی روی کار سنگینبرای کارهای معمول به deepseek/deepseek-v4.1-flash سوئیچ کنید

مدل‌های پیشنهادی برای کدنویسی در Cline و Roo Code

Claude Sonnet 5.5

anthropic/claude-sonnet-5.5

حالت پیشنهادی برای کارهای اصلی: ویرایش چندفایلی، اجرای تست و پیروی دقیق از دستورهای پروژه.

DeepSeek V4.1 Flash

deepseek/deepseek-v4.1-flash

کارهای حجمی و ارزان: تولید تست، مستندسازی، پاک‌سازی کد و تغییرات تکراری در فایل‌های زیاد.

GPT 6.1 Sol

openai/gpt-6.1-sol

بازبینی معماری و دیباگ مسائل پیچیده؛ مناسب Act Mode روی بخش‌های حساس کدبیس.

سوالات متداول

Cline و Roo Code چه تفاوتی در تنظیم دارند؟
هر دو Provider نوع OpenAI Compatible را پشتیبانی می‌کنند و تنظیم Base URL و API Key در آن‌ها یکسان است. تفاوت اصلی در رابط کاربری و قابلیت‌های جانبی مثل ایندکس کدبیس است؛ مراحل اتصال یکی است.
آیا می‌توانم برای Embeds یا ایندکس کدبیس هم از کایا استفاده کنم؟
بله. در بخش تنظیمات Embeddings، Provider را روی OpenAI Compatible بگذارید و همان Base URL (https://kayaai.ir/api/v1) و کلید را وارد کنید. دقت کنید مدل انتخابی یک مدل embedding از کاتالوگ کایا باشد.
برای استفاده از این افزونه‌ها در ایران به VPN نیاز دارم؟
نه. درخواست‌ها به دامنه kayaai.ir می‌روند که از داخل ایران در دسترس است و نیازی به تغییر آی‌پی ندارد.
چرا بین مدل‌ها سوئیچ کنم؟
هزینه و کیفیت مدل‌ها متفاوت است. برای ویرایش‌های تکراری مدل‌های ارزان مثل deepseek/deepseek-v4.1-flash منطقی‌ترند و برای تصمیم‌های معماری، مدل‌های قوی‌تر مثل anthropic/claude-sonnet-5.5 نتیجه بهتری می‌دهند.
مصرف و هزینه را کجا ببینم؟
در تاریخچه مصرف می‌توانید هر درخواست، مدل، تعداد توکن و هزینه ریالی آن را ببینید. موجودی کیف پول هم در داشبورد نمایش داده می‌شود.

مطالعه بیشتر

راهنماهای مرتبط

  • Cursor IDE

    گام‌به‌گام: افزودن مدل سفارشی در Cursor Settings → Models، تنظیم OpenAI API Key و Override OpenAI Base URL روی https://kayaai.ir/api/v1. استفاده از Claude Sonnet 5.5، GPT 6.1 و DeepSeek V4.1 در Cursor بدون تحریم و با پرداخت ریالی.

  • Claude Code

    اتصال Claude Code به کایا ای آی در سه دستور: پشتیبانی بومی از اندپوینت آنتروپیک /api/v1/messages، تنظیم ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN و اجرای claude بدون تحریم‌شکن و با پرداخت ریالی. انتخاب مدل Claude Sonnet 5.5 و Opus 5.5.

۳۰ ثانیه تا کلید API

همین حالا کلید API کایا را بگیرید و Cline و Roo Code را وصل کنید

ثبت‌نام رایگان، ساخت کلید API در کمتر از ۳۰ ثانیه و اجرای همان دستورهایی که در این راهنما دیدید. بدون کارت اعتباری بین‌المللی، بدون تحریم‌شکن و با پرداخت ریالی بر اساس مصرف واقعی.

ثبت‌نام رایگان و دریافت کلیدپنل کلیدهای من
  • ۱۰۰ اعتبار هدیه ثبت‌نام
  • پرداخت ریالی
  • بدون کارت ارزی
  • کلید API در ۳۰ ثانیه