Cline با یوتاپن — provider سازگار با OpenAI در VS Code
تنظیم افزونهٔ Cline با یوتاپن: انتخاب OpenAI Compatible، آدرس و کلید، شناسهٔ مدل، Max Output Tokens برای مهار رزرو و جدول رفع خطاهای رایج.
به‌روزرسانی: ۳۱ شهریور ۱۴۰۵
Cline افزونهٔ ایجنت کدنویسی برای VS Code است و گزینهٔ OpenAI Compatible دارد؛ با همان گزینه به یوتاپن وصل می‌شود. این صفحه با مستندات و کد نسخهٔ 4.1.x بررسی شده است.
تنظیم در VS Code
۱. آیکون Cline را باز کن و روی چرخ‌دنده (Settings) بزن.
۲. در API Provider گزینهٔ OpenAI Compatible را انتخاب کن — نه OpenAI. گزینهٔ OpenAI سراغ Responses API می‌رود که یوتاپن آن را ندارد؛ حتی برای مدل‌های openai/… هم باید OpenAI Compatible را بگیری.
۳. فیلدها را پر کن:
| فیلد | مقدار |
|---|---|
| Base URL | https://api.uttapen.ir/v1 |
| OpenAI Compatible API Key | کلید sk-up-… از داشبورد ← کلیدها |
| Model ID | مثلاً anthropic/claude-sonnet-5 |
Cline فهرست مدل‌ها را از GET /v1/models همین آدرس می‌گیرد، پس بعد از واردکردن Base URL می‌توانی مدل را از فهرست انتخاب کنی یا شناسه را دستی بنویسی.
بخش Model Configuration
زیر همان صفحه، بخش MODEL CONFIGURATION را باز کن. مهم‌ترین دو فیلد:
- Max Output Tokens — همان
max_tokensدرخواست. اگر خالی بماند، بسته به موتور داخلی نسخه‌ات یا هیچ سقفی فرستاده نمی‌شود یا ۳۲٬۰۰۰ توکن. هر دو حالت برای کیف پول بد است: یا رزرو بیش از حد بزرگ می‌شود یا رزرو کوچک‌تر از مصرف واقعی درمی‌آید و موجودی موقتاً منفی می‌شود (قیمت‌گذاری). عدد8192برای کار روی کد انتخاب خوبی است. - Context Window Size — پیش‌فرض ۱۲۸٬۰۰۰. آن را روی context واقعی مدل (یا کمتر، برای prompt ارزان‌تر) بگذار؛ عدد هر مدل در فهرست مدل‌ها است.
فیلدهای Input Price و Output Price فقط برای نمایش برآورد هزینه در خود Clineاند و روی شارژ حساب اثری ندارند؛ عدد واقعی تومانی را در داشبورد ← مصرف ببین. گزینهٔ Supports Images را فقط برای مدلی روشن کن که ورودی تصویر دارد (Vision).
انتخاب مدل
شناسه را عیناً از فهرست مدل‌ها بردار. برای کار روی کد:
anthropic/claude-sonnet-5یاopenai/gpt-5وقتی کیفیت مهم‌تر از هزینه است.qwen/qwen3-coder،deepseek/deepseek-v3.2یاz-ai/glm-4.7برای کار روزمره با هزینهٔ کمتر.
Cline گزینهٔ Use different models for Plan and Act دارد: می‌توانی برای مرحلهٔ Plan یک مدل قوی و برای Act یک مدل ارزان‌تر بگذاری. برخلاف بعضی ابزارها، Cline مدل جداگانه‌ای برای عنوان‌گذاری یا خلاصه‌سازی ندارد؛ همان مدل فعال این کارها را می‌کند، پس Max Output Tokens تنها اهرم اصلی توست.
بررسی اتصال
یک پیام کوتاه بفرست («فایل‌های این پروژه را فهرست کن») و بعد در داشبورد ← مصرف درخواست را با نام کلید Cline ببین. اگر می‌خواهی قبل از هر چیز خود کلید را تست کنی:
curl https://api.uttapen.ir/v1/chat/completions \
-H "Authorization: Bearer $UTTAPEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"openai/gpt-5-mini","max_tokens":20,"messages":[{"role":"user","content":"ping"}]}'
عیب‌یابی
| خطا | علت در Cline | راه‌حل |
|---|---|---|
401 invalid_api_key | کلید در فیلد OpenAI Compatible API Key اشتباه یا لغوشده است | کلید تازه بساز و جایگزین کن |
404 model_not_found | Model ID دستی نوشته شده و با شناسهٔ واقعی فرق دارد | از فهرست کشویی انتخاب کن یا شناسه را از /models کپی کن (پیام 404 در uttapen.suggestions نزدیک‌ترین شناسه‌های محتمل را هم پیشنهاد می‌دهد) |
404 not_found | API Provider روی OpenAI مانده و درخواست به /v1/responses رفته | به OpenAI Compatible عوضش کن |
402 insufficient_balance | موجودی برای رزرو این درخواست کافی نیست | کیف پول را شارژ کن و Max Output Tokens را کم کن |
429 | سقف نرخ یا سقف ماهانهٔ کلید (محدودیت نرخ) | چند ثانیه صبر، یا سقف کلید را بالا ببر |
| پاسخ نیمه‌کاره | مدل به max_tokens خورده و finish_reason برابر length شده | Max Output Tokens را بالاتر بگذار |
اگر موجودی قابل‌استفاده‌ات کمتر از هزینهٔ کل max_tokens درخواست باشد، یوتاپن به‌جای رد کردن درخواست، سقف خروجی را تا حدی که موجودی اجازه می‌دهد پایین می‌آورد (کف آن ۱٬۰۲۴ توکن است) و عدد نهایی را در هدر X-Uttapen-Max-Tokens می‌گذارد. در این حالت ممکن است ویرایش کد ناتمام بماند؛ شارژ کن یا Max Output Tokens را کوچک‌تر بگذار. 402 فقط وقتی می‌آید که حتی همان ۱٬۰۲۴ توکن هم در موجودی جا نشود.
ابزارهای دیگر در یکپارچه‌سازی و فهرست کامل خطاها در خطاها.
با شماره موبایل ثبت‌نام کن، کیف پول را از ۱۰۰٬۰۰۰ تومان شارژ کن و کلید بساز. مدل‌های رایگان بدون شارژ هم کار می‌کنند — تا ۵۰ درخواست در روز. ساخت کلید API ←