Cline یک دستیار کدنویسی متن‌باز برای VS Code است که فایل می‌خواند، تغییر می‌دهد و فرمان اجرا می‌کند؛ هر قدم را هم پیش از اجرا به شما نشان می‌دهد. Roo Code از روی Cline ساخته شده و Kilo Code از روی هر دو، و هر سه یک گزینهٔ مشترک دارند: OpenAI Compatible. پس یک تنظیم برای هر سه کار می‌کند و با کلید گیسو، Claude، GPT، DeepSeek یا Kimi را در همان VS Code به کار می‌گیرید.
| API Provider | OpenAI Compatible |
| Base URL | https://gisoo.pro/api/v1 |
| API Key | کلید گیسو، sk-gisoo-v1-… |
| Model ID | شناسهٔ دقیق مدل گیسو، مثلاً openrouter/anthropic/claude-sonnet-5.5 |
Cline
- افزونه را نصب کنید
در VS Code از بخش Extensions، «Cline» را جست‌وجو و نصب کنید. نماد Cline در نوار کناری می‌نشیند.
- نوع اتصال را انتخاب کنید
در پنل Cline نماد چرخ‌دنده (تنظیمات) را بزنید و
API ProviderراOpenAI Compatibleبگذارید. - سه فیلد را پر کنید
Base URLبرابرhttps://gisoo.pro/api/v1،API Keyکلید گیسو وModel IDشناسهٔ مدل از جدول پایین. - مشخصات مدل را بدهید
در
Model Configurationاین‌ها را مطابق مدل انتخابی پر کنید؛ Cline مدل‌های سفارشی را نمی‌شناسد و بدون این‌ها از مقدارهای پیش‌فرض استفاده می‌کند. - با کاری بی‌خطر شروع کنید
در حالت
Planبنویسید «این پروژه را بخوانید و ساختارش را توضیح دهید». اگر جواب آمد و درخواست در «گزارش مصرف» اپ گیسو دیده شد، اتصال درست است.
| فیلد در Model Configuration | چه بگذارید |
|---|---|
Supports Images | روشن برای مدل‌هایی که تصویر می‌خوانند (Claude، GPT، Gemini)؛ برای بقیه خاموش. |
Context Window Size | پنجرهٔ ورودی همان مدل از جدول پایین (برای openrouter/anthropic/claude-sonnet-5.5: ۱٬۰۰۰٬۰۰۰). عدد کمتر هم اشکالی ندارد؛ Cline زودتر تاریخچه را خلاصه می‌کند. |
Max Output Tokens | حدود ۸٬۰۰۰ تا ۱۶٬۰۰۰. عدد خیلی بزرگ مبلغی را که پیش از هر درخواست کنار گذاشته می‌شود بالا می‌برد. |
Input Price و Output Price | قیمت دلاری هر یک میلیون توکن از جدول پایین. Cline با این‌ها هزینهٔ تقریبی هر کار را نشان می‌دهد؛ هزینهٔ واقعی همان است که گیسو کم می‌کند. |
Cline می‌تواند برای حالت‌های Plan و Act دو مدل جدا داشته باشد (گزینهٔ استفاده از مدل‌های متفاوت برای Plan و Act). یک ترکیب خوب: مدل قوی‌تر برای برنامه‌ریزی و مدل ارزان‌تر برای اجرا.
Roo Code و Kilo Code
- تنظیمات را باز کنید
در پنل Roo Code یا Kilo Code نماد چرخ‌دنده را بزنید و به بخش
Providersبروید. - همان سه مقدار
API ProviderراOpenAI Compatibleبگذارید وBase URL،API KeyوModelرا مثل جدول بالای صفحه پر کنید. گزینهٔ Azure را خاموش بگذارید و پاسخ جریانی (streaming) را روشن. - مشخصات مدل
اندازهٔ ورودی، سقف خروجی، پشتیبانی تصویر و قیمت‌ها را مثل Cline تنظیم کنید.
- برای هر حالت یک پروفایل
هر دو ابزار پروفایل تنظیم (Configuration Profile) دارند. مثلاً پروفایل «گیسو · Claude» برای حالت Architect و «گیسو · DeepSeek» برای حالت Code، هر دو با همان کلید.
کدام مدل را بگذارید
| برای | شناسهٔ مدل | پنجرهٔ ورودی (توکن) | ورودی / خروجی (دلار برای هر یک میلیون توکن) |
|---|---|---|---|
| ایجنت، کار روزمره ابزارهای Cline را دقیق صدا می‌زند و کمتر در حلقه می‌افتد. |
openrouter/anthropic/claude-sonnet-5.5 |
۱٬۰۰۰٬۰۰۰ | $3.0595 / $15.2975 |
| برنامه‌ریزی و کارهای سخت برای حالت Plan یا Architect. |
openrouter/anthropic/claude-opus-5.5 |
۱٬۰۰۰٬۰۰۰ | $6.119 / $30.595 |
| جایگزین از OpenAI | gpt-5.5 |
۱٬۰۵۰٬۰۰۰ | $7.00 / $42.00 |
| کدنویسی با هزینهٔ متوسط | openrouter/moonshotai/kimi-k2.7-code |
۲۶۲٬۱۴۴ | $1.0267 / $5.1246 |
| اجرا با هزینهٔ کم برای تغییرهای کوچک و پروژه‌های شخصی. |
deepseek-v4-flash |
۱٬۰۰۰٬۰۰۰ | $0.42 / $1.68 |
شناسه‌ها و قیمت‌ها هنگام باز شدن این صفحه از کاتالوگ خوانده می‌شوند و با تغییر قیمت سرویس‌دهنده عوض می‌شوند. فهرست کامل، با قیمت هر مدل به سکه، در صفحهٔ مدل‌ها است.
Cline و هم‌خانواده‌هایش با ابزار کار می‌کنند و هر پیامشان دستورالعمل بلندی دارد. مدل‌های خیلی کوچک یا قدیمی ابزار را اشتباه صدا می‌زنند، در حلقه می‌افتند و آخر کار گران‌تر تمام می‌شوند. از مدل‌های جدول بالا شروع کنید.
هزینه و اعتبار
- هر قدم ایجنت یک درخواست است و ورودی‌اش کل گفت‌وگو تا همان لحظه. یک کار متوسط ممکن است ده‌ها درخواست باشد؛ برای همین برای کلید این ابزارها سقف هزینه بگذارید.
- پیش از هر درخواست، مبلغی به‌اندازهٔ بیشترین هزینهٔ احتمالی آن (تا ۱۶٬۳۸۴ توکن خروجی) کنار گذاشته می‌شود و بعد فقط هزینهٔ واقعی کم می‌شود. با اعتبار خیلی کم، درخواست با
insufficient_creditرد می‌شود حتی اگر هزینهٔ واقعی‌اش کم باشد. - برای Claude نشانه‌های کش پرامپت (Prompt Caching) در مسیر گیسو حفظ می‌شوند؛ اگر ابزار آن‌ها را بفرستد، بخش تکراری ورودی ارزان‌تر حساب می‌شود.
- کارهای بزرگ را به چند کار کوچک بشکنید و برای هر کدام گفت‌وگوی تازه باز کنید تا ورودی هر درخواست کوچک بماند.
خطاهای رایج
| نشانه | علت | راه رفع |
|---|---|---|
404 model_not_found | شناسهٔ مدل دقیق نیست. | شناسه را از صفحهٔ مدل‌ها کپی کنید؛ پیشوند openrouter/ جزو شناسه است. |
| 404 برای هر مدلی | نشانی پایه بدون /v1 یا با /chat/completions اضافه. | دقیقاً https://gisoo.pro/api/v1. |
401 invalid_api_key | کلید ناقص یا با فاصله کپی شده. | کلید را دوباره بچسبانید یا کلید تازه بسازید. |
402 insufficient_credit | اعتبار برای مبلغ کنارگذاشتنی کافی نیست. | شارژ کنید یا Max Output Tokens را کمتر بگذارید. |
402 key_spend_limit_reached | سقف هزینهٔ همین کلید پر شده؛ سقف کار خودش را کرده است. | سقف را در اپ گیسو بالا ببرید. |
429 concurrency_limit یا rate_limit_exceeded | درخواست‌های پشت سر هم یا همزمان از سقف کلید گذشته‌اند. | چند ثانیه صبر کنید؛ Cline دوباره می‌فرستد. اگر همیشه لازم است، تیکت بفرستید. |
| خطای بیش از اندازه بودن ورودی (context length) | Context Window Size بزرگ‌تر از پنجرهٔ واقعی مدل است. | عدد را مطابق جدول کدام مدل را بگذارید تنظیم کنید یا گفت‌وگوی تازه باز کنید. |
| مدل ابزار را اشتباه صدا می‌زند یا در حلقه می‌افتد | مدل برای ایجنت ضعیف است. | یکی از مدل‌های جدول را بگذارید. |
همهٔ کدها در صفحهٔ خطاها آمده است.
پرسش‌های پرتکرار
خود Cline یا Roo Code پولی است؟
با کلید گیسو، هزینهٔ مصرف مدل فقط از اعتبار گیسو کم می‌شود. خود افزونه‌ها متن‌بازند و از بخش Extensions نصب می‌شوند؛ اگر سرویس پولی جدایی هم داشته باشند، برای این اتصال لازم نیست.
هزینه‌ای که Cline نشان می‌دهد درست است؟
تقریبی است و از قیمت‌هایی حساب می‌شود که خودتان در تنظیمات نوشته‌اید. هزینهٔ دقیق هر درخواست در «گزارش مصرف» اپ گیسو و با GET /requests/{id} است.
می‌توانم سرور MCP گیسو را هم به Cline بدهم؟
بله. Cline سرورهای MCP را می‌پذیرد و با سرور MCP گیسو ایجنت از داخل VS Code تصویر، صدا یا ویدیو هم می‌سازد.
از سرور یا شبکهٔ داخل ایران کار می‌کند؟
بله. VS Code درخواست را مستقیم به gisoo.pro می‌فرستد. برای آزمایش اتصال، API بدون فیلترشکن را ببینید.
راهنماهای مرتبط
پاسخ پرسشتان را پیدا نکردید؟
شناسهٔ درخواست (هدر X-Request-Id) را با پرسشتان در تیکت بفرستید تا دقیق بررسی کنیم.
