اتصال Cline به API هوش مصنوعی 1ai؛ راهنمای OpenAI Compatible در VS Code
Cline یکی از محبوب‌ترین دستیارهای عاملمحور برنامه‌نویسی در VS Code است، اما خودش مدلی ندارد و به یک API نیاز دارد. با وان ای آی (1ai) همین API را با شکل OpenAI در اختیار دارید: یک کلید `sk-1ai-…` برای مدل‌های چند سازنده، خرید اعتبار با پرداخت ریالی و سقف مصرف جداگانه برای هر کلید. در این راهنما تنظیمات دقیق Cline، انتخاب مدل مناسب، خطاهای رایج و راه‌های کنترل هزینه را قدم‌به‌قدم می‌بینید.
چرا با 1ai
یک کلید، چند خانواده‌ی مدل
با همان کلید بین Claude، GPT، Gemini، DeepSeek، Qwen و Kimi جابه‌جا شوید؛ فقط Model ID را در تنظیمات Cline عوض کنید.
پرداخت ریالی
اعتبار را با پرداخت ریالی میخرید و هر درخواست Cline به اندازهی توکن‌هایش از همان اعتبار کم میشود؛ کارت ارزی و حساب خارجی لازم نیست.
سقف مصرف برای هر کلید
برای کلیدی که به Cline می‌دهید سقف ماهانه، مدل‌های مجاز و تاریخ انقضا بگذارید تا یک حلقه‌ی طولانی عامل، کل اعتبار را خرج نکند.
گزارش هر درخواست
مصرف و لاگ درخواست‌های هر کلید را در پنل توسعه‌دهنده می‌بینید و می‌فهمید کدام Task پرهزینه بوده است.
استریم و فراخوانی ابزار
مسیر `chat/completions` با استریم و tool calling کار میکند؛ همان چیزی که Cline برای خواندن فایل، اجرای دستور و ویرایش کد لازم دارد.
در چند قدم
- ۱
Cline را نصب کنید
در VS Code بخش Extensions را باز کنید، Cline را جست‌وجو و نصب کنید. نسخه‌ی Cursor، Windsurf و VSCodium هم همین مسیر را دارد.
- ۲
کلید API بسازید
در پنل 1ai از بخش توسعه‌دهندگان ← کلیدها یک کلید با نام Cline بسازید، سقف ماهانه بگذارید و کلید را همان لحظه کپی کنید.
- ۳
OpenAI Compatible را انتخاب کنید
در تنظیمات Cline گزینهی API Provider را روی OpenAI Compatible بگذارید و Base URL، API Key و Model ID را وارد کنید.
- ۴
اولین Task را بدهید
در حالت Plan یک کار کوچک بخواهید، برنامه را بخوانید و بعد به Act بروید تا تغییرها را با تأیید شما انجام دهد.
مدل‌های مناسب Cline (با پشتیبانی از ابزار)
همه‌ی مدل‌هاGPT-6.1 Sol
پرچم‌دار اوپن‌ای‌آی برای کارهای دقیق، تحلیلی و چندمرحله‌ای
Gemini 3.8 Flash
سریع، چندوجهی و با حافظه‌ی متنی بسیار بلند
Claude Haiku 5.5
سریع‌ترین کلود؛ در سهمیه‌ی رایگان روزانه
سبک و ارزان؛ در سهمیه‌ی رایگان روزانه
DeepSeek V4.1 Flash
سریع و بسیار ارزان؛ در سهمیه‌ی رایگان روزانه
نمونه پرامپت‌ها
پرامپت را کپی کنید، در 1ai بگذارید و جزئیات خودتان را جایگزین کنید.
شناخت پروژه
Read this repository and give me a short map: main folders, entry points, how to run it locally and how tests are run. Do not change any file yet.
در حالت Plan اجرا کنید تا هیچ فایلی تغییر نکند.
نوشتن تست
Write unit tests for [مسیر فایل، مثلاً src/utils/date.js] that cover edge cases. Use the test framework this project already uses, run the tests and fix only the tests if they fail.
رفع خطا
Running `[دستور، مثلاً npm test]` fails with this error: [متن کامل خطا] Find the cause, explain it in two sentences, apply the smallest fix and run the command again.
بازنویسی امن
Refactor [نام فایل یا تابع] to remove duplicated code. Keep the public API unchanged, show me the plan first, then make the change and run the linter.
مستندسازی فارسی
برای پوشه‌ی [مسیر پوشه] یک README کوتاه به فارسی بنویس: کار این ماژول، ورودی‌ها و خروجی‌ها و یک مثال اجرا. اصطلاحات فنی و نام توابع را انگلیسی نگه دار.
Cline چیست و برای اتصال به 1ai چه لازم دارید؟
Cline یک دستیار برنامه‌نویسی متنباز و عاملمحور (agent) است: پروژه را می‌خواند، فایل می‌سازد و ویرایش میکند، دستور ترمینال اجرا میکند و برای هر قدم از شما اجازه می‌گیرد. دو حالت دارد: Plan برای فکر کردن و برنامه‌ریزی بدون تغییر فایل و Act برای اجرا. با Checkpoints هم می‌توانید تغییرها را برگردانید.
مدل‌ها را API تأمین میکند و 1ai آن را با شکل OpenAI میدهد؛ توضیح کلی در صفحه‌ی توسعه‌دهندگان آمده است.
پیش‌نیازها:
- VS Code یا یک ویرایشگر سازگار، به‌همراه افزونه‌ی Cline
- حساب 1ai با اعتبار کافی
- یک کلید
sk-1ai-…از بخش توسعه‌دهندگان ← کلیدها (فقط یک بار نمایش داده میشود) - شناسهی مدل با پیشوند سازنده، مثل
anthropic/claude-sonnet-5.5
تنظیمات Cline برای 1ai چیست؟
در نوار کناری Cline روی آیکن چرخ‌دنده بزنید و این مقادیر را وارد کنید:
| تنظیم | مقدار |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://1ai.ir/v1 |
| API Key | کلید sk-1ai-… |
| Model ID | anthropic/claude-sonnet-5.5 |
در بخش Model Configuration مقدار Context Window و Max Output Tokens را از صفحه‌ی همان مدل بردارید و اگر مدل تصویر می‌پذیرد، Image Support را روشن کنید. Input Price و Output Price فقط برای تخمین هزینه در خود Cline است و می‌توانید خالی بگذارید؛ کسر واقعی را پنل 1ai نشان میدهد.
برای این‌که برنامه‌ریزی با مدل قوی‌تر و اجرا با مدل ارزان‌تر انجام شود، گزینهی Use different models for Plan and Act را روشن کنید و برای هر حالت یک Model ID بگذارید.
پیش از Cline، کلید و آدرس را در ترمینال امتحان کنید:
curl https://1ai.ir/v1/models -H "Authorization: Bearer sk-1ai-..."اگر فهرست مدل‌ها برگشت، کلید و آدرس درست است.
کدام مدل برای Cline بهتر است؟
Cline برای خواندن فایل، اجرای دستور و ویرایش کد به فراخوانی ابزار تکیه میکند، پس فقط مدل‌هایی را انتخاب کنید که از ابزار (tools) پشتیبانی می‌کنند:
| کار | Model ID پیشنهادی |
|---|---|
| برنامه‌ریزی و تغییرهای چندفایلی | anthropic/claude-sonnet-5.5، openai/gpt-6.1-sol |
| اجرای روزمره با هزینهی کم | deepseek/deepseek-v4.1-flash، google/gemini-3.8-flash |
| کارهای طولانی و عاملمحور | qwen/qwen3.8-max، moonshotai/kimi-k3 |
فهرست زنده‌ی مدل‌ها، قیمت و اندازهی context هر کدام در مدل‌های گفتگو آمده است. شناسه را دقیقاً با پیشوند سازنده بنویسید. برای مقایسه‌ی کلی خانواده‌ها در کدنویسی، برنامه‌نویسی با هوش مصنوعی را ببینید.
خطاهای رایج Cline با 1ai و راه‌حل آن‌ها
- 401
invalid_api_key: کلید اشتباه، ناقص کپی‌شده، باطل یا منقضی است. اگر کلید را گم کرده‌اید، کلید تازه بسازید. - 404
model_not_found: شناسه بدون پیشوند سازنده نوشته شده (claude-sonnet-5.5به جایanthropic/claude-sonnet-5.5) یا آن مدل در API فعال نیست. - پاسخ HTML یا خطای Unexpected token: Base URL باید دقیقاً
https://1ai.ir/v1باشد؛/v1را حذف نکنید و/chat/completionsرا به انتهایش اضافه نکنید. - 403
model_not_allowed: مدل در فهرست «مدل‌های مجاز» همین کلید نیست. - 402: اعتبار تمام شده (
insufficient_credits) یا سقف ماهانه‌ی کلید پر شده (key_cap_reached). - 429
rate_limit_exceeded: سقف درخواست یا توکن در دقیقه پر شده؛ به اندازهی سرآیندretry-afterصبر کنید و Taskهای هم‌زمان را کم کنید. - ابزار اجرا نمی‌شود یا Cline در حلقه می‌ماند: مدل را به یکی از مدل‌های دارای tools عوض کنید و Task را از نو شروع کنید.
- پاسخ وسط کار قطع میشود: وقتی اعتبار برای کل خروجی کافی نباشد، سقف توکن خروجی کم میشود؛ اعتبار را شارژ کنید.
چطور هزینهی Cline را کنترل کنیم؟
هر قدم Cline یک درخواست جداست و کل گفتگو در هر درخواست دوباره فرستاده میشود؛ برای همین Taskهای طولانی زود گران می‌شوند.
- برای Cline کلید جداگانه بسازید و در «تنظیمات پیشرفته» سقف مصرف ماهانه، مدل‌های مجاز و تاریخ انقضا بگذارید. سقف درخواست و توکن در دقیقه را هم میشود برای همان کلید تعیین کرد.
- Auto Approve را فقط برای کارهای کم‌خطر روشن کنید.
- برای هر موضوع یک Task تازه باز کنید تا context بی‌دلیل بزرگ نشود.
- Plan را با مدل قوی و Act را با مدل ارزان‌تر اجرا کنید.
جزئیات بیشتر در راهنمای کلیدها و کنترل هزینه آمده و بسته‌های اعتبار در تعرفه‌ها است.
ابزارهای آماده
توضیح کد و رفع باگ
کد را بفهمید، خطایش را پیدا کنید و تمیزش کنید
ساخت عبارت باقاعده (Regex)
الگوی Regex با توضیح و نمونه‌ی آزمون
ساخت کوئری SQL
درخواست فارسی، کوئری درست و توضیح‌داده‌شده
دستیارهای مرتبط
برنامه‌نویس ارشد
نوشتن، مرور و اشکال‌زدایی کد با توضیح روشن
- «این کد را مرور کن و باگ‌ها و مشکلات امنیتی‌اش را بگو: »
- «یک API ساده برای مدیریت کارها با Node.js و Express بنویس»
سوالات متداول
آیا استفاده از Cline با 1ai هزینه دارد؟
خود Cline متنباز است و هزینهای ندارد. هزینهی مدل به اندازهی توکنهای ورودی و خروجی هر درخواست از اعتبار حساب 1ai کم میشود و اعتبار را با پرداخت ریالی میخرید. کارهای عاملمحور چون چند درخواست پشت سر هم میفرستند، از یک پرسش ساده پرمصرفترند.
میتوانم در Cline گزینهی Anthropic را با کلید 1ai انتخاب کنم؟
خیر. گزینهی Anthropic به API اختصاصی Anthropic (/v1/messages) وصل میشود که 1ai ندارد. Claude را از مسیر OpenAI Compatible و با شناسهی anthropic/claude-sonnet-5.5 انتخاب کنید؛ مدل همان است و فقط قالب درخواست فرق دارد.
Cline در Cursor یا JetBrains هم با 1ai کار میکند؟
بله. طبق مستندات Cline، افزونه روی Cursor، Windsurf، VSCodium و JetBrains هم نصب میشود و تنظیمات OpenAI Compatible در همه یکسان است. در Cursor، حالت Agent خود ویرایشگر با API سازگار با OpenAI محدودیت دارد و Cline راه سادهتری برای کار عاملمحور است؛ جزئیات در راهنمای Cursor.
برای اتصال Cline به 1ai فیلترشکن لازم است؟
برای ارسال درخواست به https://1ai.ir/v1 فیلترشکن لازم نیست و پرداخت هم ریالی است. اگر با فیلترشکن روشن خطای اتصال میگیرید، یک بار بدون آن امتحان کنید.
کد پروژهی من کجا فرستاده میشود؟
Cline بخشهایی از فایلها و خروجی دستورها را در متن درخواست میگذارد. این متن به 1ai و از آنجا به سازندهی مدل انتخابی میرسد. نام فایلهای حاوی رمز و کلید، مثل .env، را در .clineignore بنویسید (مستندات Cline گفته این قابلیت بهزودی جایگزین میشود؛ پس از هر بهروزرسانی آن را دوباره بررسی کنید) و کلید API را هرگز در مخزن کد ننویسید.
چطور بفهمم هر Task در Cline چقدر خرج کرد؟
Cline تعداد توکنها را نشان میدهد و اگر قیمت را در Model Configuration وارد کنید، تخمین هم میزند. عدد قطعی در پنل توسعهدهندهی 1ai است: مصرف هر کلید و لاگ تکتک درخواستها همراه با اعتبار کسرشده.
میتوانم در Cline اسکرینشات بفرستم؟
بله، اگر مدل تصویر بپذیرد. برای Claude، GPT و Gemini گزینهی Image Support را در Model Configuration روشن کنید تا بتوانید تصویر خطا یا طرح رابط کاربری را همراه پیام بفرستید.
مطالب مرتبط
استفاده از API سازگار با OpenAI در 1ai: راهنمای عملی با Python، Node.js و cURL
چطور پروژه‌ای را که با کتابخانه‌ی OpenAI نوشته شده، فقط با تغییر آدرس پایه و کلید به 1ai وصل کنید؛ با نمونه کد Python، Node.js و cURL، استریم، فهرست مدل‌ها و مدیریت خطا.
کلید API در 1ai: امنیت، محدودیت‌ها و کنترل هزینه
چطور کلیدهای API را امن نگه دارید و هزینه را مهار کنید: مدل‌های مجاز، سقف اعتبار ماهانه، محدودیت نرخ، تاریخ انقضا، کلیدهای تیمی و گزارش مصرف.
مقایسه ChatGPT، Claude و Gemini: کدام مدل برای چه کاری؟
سه خانواده‌ی مطرح مدل‌های زبانی، یعنی GPT از OpenAI، Claude از Anthropic و Gemini از گوگل، هر کدام کجا می‌درخشند و چطور برای کار خودتان بهترین را انتخاب کنید.
مدل زبانی بزرگ (LLM) چیست؟ راهنمای کاربردی برای فارسی
LLM موتور بسیاری از دستیارهای هوش مصنوعی است. با مثال‌های ساده، سازوکار آن، تفاوت مدل‌های باز و بسته و روش انتخاب مدل مناسب برای متن و کارهای فارسی را بشناسید.
صفحه‌های مرتبط
همه‌ی امکاناتاتصال Continue
Continue را با چند خط config.yaml به API سازگار با OpenAI در 1ai وصل کنید و برای چت، ویرایش، Agent و تکمیل خودکار مدل جداگانه بگذارید.
اتصال Cursor
کلید 1ai را در Cursor بگذارید و در حالت Ask با Qwen، DeepSeek، Kimi و GPT گفتگو کنید؛ با توضیح صریح این‌که Tab و Agent چه وضعیتی دارند.
اتصال OpenCode
OpenCode را با یک ارائه‌دهنده‌ی سفارشی در opencode.json به 1ai وصل کنید و در ترمینال با Claude، GPT، Qwen و DeepSeek از یک کلید کدنویسی کنید.
برنامه‌نویسی با هوش مصنوعی
کد بنویسید، خطا پیدا کنید، SQL و Regex بسازید و با API سازگار با OpenAI مدل‌ها را به ابزارهای خودتان وصل کنید.
اتصال Cline به API هوش مصنوعی 1ai؛ راهنمای OpenAI Compatible در VS Code
افزونه‌ی Cline را با گزینهی OpenAI Compatible به 1ai وصل کنید و با Claude، GPT، Gemini و DeepSeek از یک کلید و با پرداخت ریالی کدنویسی کنید.
ساخت کلید API