Cline

عامل کدنویسی متن‌باز برای VS Code که از API سازگار با OpenAI در OneProvider استفاده می‌کند.

عامل کدنویسی Cline برای VS Code

چه چیزی کار می‌کند

Cline درخواست‌های متنی و عامل کدنویسی سازگار با OpenAI را با شناسهٔ مدل سازگاری که از کاتالوگ انتخاب می‌کنید از طریق OneProvider می‌فرستد.

محدودیت کلاینت

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

راه‌اندازی

1. انتخاب OpenAI Compatible

   در تنظیمات API Provider در Cline گزینهٔ OpenAI Compatible را انتخاب کنید و کلید OneProvider خود را جایگذاری کنید.

   API Provider: OpenAI Compatible
   API Key: sk-your-key-here

2. تنظیم base URL سفارشی

   base URL را روی https://api.oneprovider.dev/v1 و شناسهٔ دقیق مدل را روی gpt-6.1-terra بگذارید.

   Base URL: https://api.oneprovider.dev/v1
   Model ID: gpt-6.1-terra

3. شروع یک کار متنی کوچک

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

بررسی اتصال

تأیید درخواست در «مصرف» داشبورد

درخواست باید مدل پیکربندی‌شده و یک ردیف مصرف سازگار با OpenAI با مبلغ کسرشده را نشان دهد.

مشخصات اتصال

پروتکل

openai-chat

Endpoint

https://api.oneprovider.dev/v1

امنیت کلید

از کلید اختصاصی با سقف‌های مدل، نرخ، مصرف و انقضا استفاده کنید؛ هرگز کلید را در تنظیمات فضای کاری کامیت نکنید.

کدام مدل را انتخاب کنیم

Cline از ارائه‌دهندهٔ OpenAI Compatible استفاده می‌کند، پس شناسهٔ مدل را دقیقاً مثل کاتالوگ وارد کنید. gpt-6.1-terra پیش‌فرض متعادل برای کارهای کدنویسی است، gpt-6.1-sol به کار چندفایلی بزرگ می‌خورد و gpt-5.6-luna برای پرسش‌های سریع ارزان است. شناسه‌های Claude هم از همین ارائه‌دهنده کار می‌کنند، مثلاً claude-sonnet-5-5. ورودی تصویر، استفاده از ابزار و اندازهٔ زمینه به مدل دقیق بستگی دارد، پس با یک کار کوچک فقط‌خواندنی شروع کنید. اگر Cline پنجرهٔ زمینه یا حداکثر خروجی خواست، مقادیر را از ردیف مدل در کاتالوگ کپی کنید.

خطاهای رایج و راه‌حل‌ها

404 یا «Invalid URL»

Base URL باید https://api.oneprovider.dev/v1 باشد: با /v1 و بدون /chat/completions.

401 Unauthorized

کلید یک نویسه کم دارد یا دور آن فاصله یا نقل‌قول هست، یا موجودی تمام شده است. کل کلید را دوباره جایگذاری کنید و حساب کاربری را بررسی کنید.

«Model not found» یا 400 دربارهٔ مدل

شناسه غلط املایی دارد یا در کاتالوگ نیست. آن را از صفحهٔ مدل‌ها کپی کنید؛ تطبیق دقیق است و به حروف بزرگ و کوچک حساس است.

429 «Insufficient balance»

موجودی یا سقف مصرف کلید تمام شده است. تلاش دوباره کمکی نمی‌کند: شارژ کنید یا سقف را بالا ببرید.

عامل بعد از یک گام متوقف می‌شود

ممکن است مدل انتخابی فراخوانی ابزار را خوب پشتیبانی نکند. یک مدل پیشرو یا متعادل انتخاب کنید و کار را کوچک نگه دارید.

استریم‌ها قطع می‌شوند یا هنگ می‌کنند

VPN یا پروکسی‌های VLESS را خاموش کنید: SSE را بافر می‌کنند. خود OneProvider این کار را نمی‌کند.

پرسش‌های متداول

در Cline کدام ارائه‌دهنده را انتخاب کنم؟

OpenAI Compatible. کلید OneProvider و base URL بالا را جایگذاری کنید.

می‌توانم در Cline از مدل‌های Claude استفاده کنم؟

بله، شناسهٔ Claude را در همان ارائه‌دهندهٔ OpenAI Compatible وارد کنید، یا اگر نسخهٔ شما پشتیبانی می‌کند از ارائه‌دهندهٔ Anthropic در Cline با base URL سفارشی https://api.oneprovider.dev استفاده کنید.

کلید من در مخزن ذخیره می‌شود؟

نه، Cline آن را در ذخیره‌گاه رازهای VS Code نگه می‌دارد. با این حال از کلید اختصاصی با سقف مصرف استفاده کنید و هرگز آن را در تنظیمات فضای کاری کامیت نکنید.

مصرف را کجا ببینم؟

در صفحهٔ «مصرف» داشبورد: هر درخواست مدل و مبلغ کسرشده را نشان می‌دهد.

پاسخ‌های سریع

از کدام base URL استفاده کنم؟

Claude Code و SDKهای Anthropic از https://api.oneprovider.dev استفاده می‌کنند. SDKهای OpenAI و کلاینت‌های سازگار با OpenAI از https://api.oneprovider.dev/v1 استفاده می‌کنند. یک کلید پشت هر دو آدرس کار می‌کند؛ فهرست مدل‌ها در صفحهٔ مدل‌ها و نرخ‌ها در صفحهٔ قیمت‌ها است.

چگونه احراز هویت کنم؟

کلید خام sk-… را در x-api-key یا Authorization: Bearer بفرستید: یکی از این دو، نه هر دو. کلید را در یک متغیر محیطی نگه دارید، نه در فایلی که commit می‌شود. اطلاعات بیشتر دربارهٔ احراز هویت .

کلید را از کجا بگیرم؟

حساب کاربری خود را در ربات Telegram به نام @oneprovider_robot یا در app.oneprovider.dev باز کنید، موجودی را شارژ کنید و «صدور کلید» را بزنید. هر کلید می‌تواند سقف مصرف مخصوص خودش را داشته باشد. حساب کاربری و کلیدهای API .

کدهای 401، 404 و 429 یعنی چه؟

401: کلید ارسال نشده، اشتباه تایپ شده یا در هدر نادرست فرستاده شده است؛ کلید را کامل و بدون گیومه و فاصله جای‌گذاری کنید. 404: معمولاً base URL نادرست است، مثلاً /v1 جا افتاده یا دوبار آمده است. 429 با پیام «Insufficient balance»: موجودی حساب کاربری یا سقف مصرف کلید تمام شده است؛ به‌جای تلاش دوباره، شارژ کنید. هر 429 دیگری محدودیت نرخ است؛ تا پایان زمان Retry-After صبر کنید. جزئیات: کدهای خطا و رفع اشکال .

چرا استریم‌ها قطع یا ریست می‌شوند؟

VPN و پروکسی‌های VLESS اغلب SSE را بافر می‌کنند یا مذاکرهٔ HTTP/2 را مختل می‌کنند. OneProvider هیچ محدودیت منطقه‌ای ندارد و استریم‌ها را بافر نمی‌کند؛ پروکسی را خاموش کنید و دوباره امتحان کنید.

اگر این‌ها کافی نبود از کجا بپرسم؟

در Telegram به @Oneproviderhelpbot پیام بدهید یا در حساب کاربری وب «پشتیبانی» را باز کنید و کد وضعیت HTTP و متن دقیق خطا را بفرستید. پشتیبانی چگونه کار می‌کند .