Roo Code با یوتاپن — تنظیم نسخهٔ متوقف‌شده
Roo Code از اردیبهشت ۱۴۰۵ متوقف شده است. اگر هنوز نصبش داری، این تنظیم OpenAI Compatible و سقف خروجی را بگذار تا با یوتاپن کار کند.
به‌روزرسانی: ۳۱ شهریور ۱۴۰۵
تیم Roo Code در ۲۵ اردیبهشت ۱۴۰۵ (۱۵ مه ۲۰۲۶) توسعهٔ افزونه را متوقف کرد و مخزنش را بایگانی کرد؛ آخرین نسخه 3.54.0 است. اگر هنوز روی VS Code داری، با یوتاپن کار می‌کند، ولی دیگر اصلاح و به‌روزرسانی نمی‌گیرد. برای کار جدید Cline یا Kilo Code را نصب کن.
تنظیم در نسخهٔ ۳٫۵۴
۱. پنل Roo Code ← چرخ‌دنده (Settings). ۲. در API Provider گزینهٔ OpenAI Compatible را بگیر (نه OpenAI؛ آن سراغ Responses API می‌رود که یوتاپن ندارد). ۳. فیلدها:
| فیلد | مقدار |
|---|---|
| Base URL | https://api.uttapen.ir/v1 |
| API Key | کلید sk-up-… از داشبورد ← کلیدها |
| Model | از فهرستی که خودش از GET /v1/models می‌آورد انتخاب کن، یا «Use custom» و شناسهٔ دقیق |
سقف خروجی — مهم‌ترین تنظیم
Roo Code سقف خروجی را در فیلد max_completion_tokens می‌فرستد و رفتارش سه حالت دارد:
- تیک Include max output tokens خاموش: هیچ سقفی فرستاده نمی‌شود. یوتاپن با یک برآورد پیش‌فرض رزرو می‌کند و اگر مدل بیشتر بنویسد، مبلغ واقعی کامل کم می‌شود و موجودی می‌تواند موقتاً منفی شود (قیمت‌گذاری).
- تیک روشن ولی Max Output Tokens روی مقدار پیش‌فرض
-1: یوتاپن دیگر این را رد نمی‌کند؛ عدد صفر یا منفی را «سقفی نیامده» حساب می‌کند و درست مثل حالت بالا روی برآورد پیش‌فرض خودش رزرو می‌کند — یعنی همان ریسک موجودی منفی، نه خطای400. - تیک روشن و عدد مثبت (پیشنهاد ما:
8192): همان عدد فرستاده می‌شود، رزرو قابل‌پیش‌بینی می‌ماند و از هر دو ریسک بالا در امانی. همین حالت را انتخاب کن.
Context Window Size را هم روی context واقعی مدل بگذار (پیش‌فرضش ۱۲۸٬۰۰۰ است)؛ عدد هر مدل در فهرست مدل‌ها هست.
انتخاب مدل
Roo Code فقط با مدل‌هایی کار می‌کند که tool calling دارند؛ جایگزین XML ندارد. مدل‌های کدنویسی پیشنهادی: anthropic/claude-sonnet-5، openai/gpt-5، qwen/qwen3-coder، deepseek/deepseek-v3.2.
مدل جداگانه‌ای برای عنوان یا خلاصه‌سازی ندارد؛ همان پروفایل فعال همه‌کاره است. اگر چند پروفایل داری، برای هرکدام یک کلید جدا با سقف ماهانه بساز تا مصرفشان در داشبورد ← مصرف تفکیک شود.
فایل خروجی دکمهٔ Export در تنظیمات (roo-code-settings.json) کلید API را به‌صورت متن ساده نگه می‌دارد. آن را در گیت یا فضای ابری نگذار.
عیب‌یابی
| خطا | علت در Roo Code | راه‌حل |
|---|---|---|
401 invalid_api_key | کلید اشتباه یا لغوشده | کلید تازه بساز |
404 model_not_found | شناسهٔ دستی اشتباه | از فهرست انتخاب کن یا از /models کپی کن (پیام 404 در uttapen.suggestions نزدیک‌ترین شناسه‌های محتمل را هم پیشنهاد می‌دهد) |
404 not_found | Provider روی OpenAI مانده و به /v1/responses زده | OpenAI Compatible را انتخاب کن |
402 insufficient_balance | موجودی کمتر از رزرو لازم | شارژ کن یا سقف خروجی را کم کن |
429 | سقف نرخ یا سقف ماهانهٔ کلید (محدودیت نرخ) | صبر یا افزایش سقف |
وقتی موجودی برای کل سقف خروجی کافی نباشد، یوتاپن به‌جای رد کردن، سقف را تا اندازهٔ موجودی پایین می‌آورد (کف ۱٬۰۲۴ توکن) و عدد نهایی را در هدر X-Uttapen-Max-Tokens می‌گذارد؛ پاسخ ممکن است با finish_reason برابر length نیمه‌کاره بماند. 402 فقط وقتی است که همان کف هم در موجودی نگنجد.
فهرست کامل ابزارها در یکپارچه‌سازی و کدهای خطا در خطاها.
با شماره موبایل ثبت‌نام کن، کیف پول را از ۱۰۰٬۰۰۰ تومان شارژ کن و کلید بساز. مدل‌های رایگان بدون شارژ هم کار می‌کنند — تا ۵۰ درخواست در روز. ساخت کلید API ←