Cursor ویرایشگر کدی بر پایهٔ VS Code است که هوش مصنوعی جزء اصلی آن است. اگر کلید شخصی (API Key) خودتان را به آن بدهید، گفت‌وگو و حالت ایجنت (Agent) با مدلی کار می‌کنند که خودتان انتخاب کرده‌اید. با کلید گیسو این مدل می‌تواند Claude، GPT، DeepSeek یا مدل‌های متنی دیگر کاتالوگ باشد و هزینه‌اش از اعتبار گیسوی شما کم می‌شود.
| OpenAI API Key | کلید گیسو، sk-gisoo-v1-… |
| Override OpenAI Base URL | https://gisoo.pro/api/v1 |
| Model | شناسهٔ دقیق مدل گیسو، مثلاً openrouter/anthropic/claude-sonnet-5.5 |
پیش از شروع
- حساب گیسو با کمی اعتبار. Cursor در هر پیام بخش بزرگی از کد پروژه را می‌فرستد، پس ورودی هر درخواست بلند است.
- یک کلید جدا برای Cursor با سقف هزینه. در بخش API اپ گیسو یک پروژه به نام «cursor» بسازید و برای کلیدش سقف بگذارید.
- فهرست IP مجاز را برای این کلید خالی بگذارید. درخواست‌ها از سرورهای Cursor به گیسو می‌رسند، نه از کامپیوتر شما؛ IP آن سرورها ثابت نیست.
راه‌اندازی، قدم به قدم
- تنظیمات Cursor را باز کنید
از منوی
Cursor Settings(میان‌برCtrl+Shift+J، در مکCmd+Shift+J) به بخشModelsبروید. - کلید را بگذارید
در قسمت
API Keys، کلید گیسو را در فیلدOpenAI API Keyبچسبانید. - نشانی پایه را عوض کنید
گزینهٔ
Override OpenAI Base URLرا روشن کنید وhttps://gisoo.pro/api/v1را بنویسید؛ با/v1در انتها و بدون/chat/completions. - مدل را اضافه کنید
در فهرست مدل‌ها با
Add model(یاAdd Custom Model) شناسهٔ مدل گیسو را دقیقاً همان‌طور که درGET /modelsآمده بنویسید و روشنش کنید. - آزمایش کنید
پنل چت را باز کنید، همین مدل را انتخاب کنید و یک پرسش بی‌خطر بفرستید، مثلاً «ساختار این پروژه را در پنج خط توضیح دهید». بعد در اپ گیسو «گزارش مصرف» را ببینید؛ درخواست باید با نام مدل و هزینه آنجا باشد.
اگر Cursor پیام خطا داد و نمی‌دانید از کلید است یا از مدل، اول همین را در ترمینال بیازمایید. اگر این جواب داد، کلید و شناسه درست‌اند و مشکل در تنظیم Cursor است:
برای سرورها و کاربران داخل ایران، در این نمونه نشانی gisoo.pro را با ir.gisoo.pro جایگزین کنید؛ مسیر و کلید همان‌اند.
# Before Cursor: is the key right and is the model id exact? (a few tokens, a tiny cost)
curl https://gisoo.pro/api/v1/chat/completions \
-H "Authorization: Bearer $GISOO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "openrouter/anthropic/claude-sonnet-5.5", "max_tokens": 5, "messages": [{"role": "user", "content": "ping"}]}'کدام مدل را بگذارید
| برای | شناسهٔ مدل | پنجرهٔ ورودی (توکن) | ورودی / خروجی (دلار برای هر یک میلیون توکن) |
|---|---|---|---|
| کار روزمره و ایجنت در ویرایش چندفایلی و فراخوانی ابزار دقیق است. |
openrouter/anthropic/claude-sonnet-5.5 |
۱٬۰۰۰٬۰۰۰ | $3.0595 / $15.2975 |
| بازنویسی‌های سخت قوی‌تر و گران‌تر؛ برای کارهایی که چند فایل به هم گره خورده‌اند. |
openrouter/anthropic/claude-opus-5.5 |
۱٬۰۰۰٬۰۰۰ | $6.119 / $30.595 |
| جایگزین از OpenAI | gpt-5.5 |
۱٬۰۵۰٬۰۰۰ | $7.00 / $42.00 |
| هزینهٔ کم برای پرسش‌های ساده و پروژه‌های شخصی. |
deepseek-v4-flash |
۱٬۰۰۰٬۰۰۰ | $0.42 / $1.68 |
| پرسش کوتاه سریع و ارزان؛ برای ایجنت کافی نیست. |
gpt-4o-mini |
۱۲۸٬۰۰۰ | $0.21 / $0.84 |
شناسه‌ها و قیمت‌ها هنگام باز شدن این صفحه از کاتالوگ خوانده می‌شوند و با تغییر قیمت سرویس‌دهنده عوض می‌شوند. فهرست کامل، با قیمت هر مدل به سکه، در صفحهٔ مدل‌ها است.
مدل‌هایی که فقط از مسیر Responses API جواب می‌دهند (مثل نسخه‌های Codex و Pro مدل‌های OpenAI) را در Cursor نگذارید؛ برای آن‌ها Codex CLI را ببینید.
چه چیزی با کلید گیسو کار می‌کند و چه چیزی نه
| قابلیت Cursor | با کلید گیسو |
|---|---|
| چت و پرسش دربارهٔ کد | با مدلی که انتخاب کرده‌اید، از اعتبار گیسو. |
| حالت ایجنت (Agent) و ویرایش فایل‌ها | با مدل‌هایی که فراخوانی ابزار دارند؛ همهٔ مدل‌های جدول بالا دارند. |
| فرستادن تصویر | با مدل‌هایی که تصویر می‌خوانند (Claude، GPT و Gemini). |
| تکمیل خودکار Tab و مدل‌های اختصاصی Cursor | عوض نمی‌شوند؛ با مدل‌های خود Cursor و حساب Cursor شما کار می‌کنند و از اعتبار گیسو چیزی کم نمی‌کنند. |
| این‌که کلید شخصی در کدام پلن Cursor پذیرفته شود | تصمیم Cursor است و ممکن است عوض شود؛ گیسو فقط مدل را فراهم می‌کند. |
علاوه بر مدل، می‌توانید سرور MCP گیسو را هم به Cursor بدهید تا ایجنت از داخل ویرایشگر تصویر، صدا یا ویدیو بسازد.
خطاهای رایج
| نشانه | علت | راه رفع |
|---|---|---|
401 invalid_api_key یا «Invalid API key» | کلید ناقص کپی شده یا فاصله دارد. | کلید را دوباره و کامل بچسبانید؛ کلید فقط یک بار نشان داده می‌شود، اگر گم شده کلید تازه بسازید. |
404 model_not_found | شناسهٔ مدل با کاتالوگ یکی نیست. | شناسه را از صفحهٔ مدل‌ها کپی کنید، با همان پیشوند (مثلاً openrouter/). |
| خطای ۴۰۴ برای همهٔ مدل‌ها | نشانی پایه بدون /v1 یا با مسیر اضافه نوشته شده. | دقیقاً https://gisoo.pro/api/v1 را بنویسید. |
402 insufficient_credit | پیش از هر درخواست مبلغی به‌اندازهٔ بیشترین هزینهٔ احتمالی آن کنار گذاشته می‌شود و ورودی Cursor بزرگ است. | حساب را شارژ کنید؛ بعد از پاسخ فقط هزینهٔ واقعی کم می‌شود و بقیه برمی‌گردد. |
403 ip_not_allowed | روی کلید فهرست IP مجاز گذاشته‌اید. | برای کلید Cursor فهرست IP را خالی کنید. |
403 model_not_allowed | کلید یا پروژه فقط مدل‌های خاصی را اجازه می‌دهد. | مدل را به فهرست مجاز کلید اضافه کنید. |
403 kyc_required | سقف مصرف پیش از احراز هویت پر شده است. | احراز هویت را در اپ گیسو کامل کنید. |
429 concurrency_limit | ایجنت چند درخواست را همزمان فرستاده است. | چند ثانیه بعد ادامه دهید؛ اگر همیشه لازم است، با تیکت سقف بیشتری بخواهید. |
| مدلی که نامش با claude شروع می‌شود به گیسو نمی‌رسد | اگر در Cursor کلید Anthropic هم گذاشته‌اید، ممکن است Cursor این مدل‌ها را به آن سمت بفرستد. | فیلد کلید Anthropic را خالی بگذارید و شناسهٔ کامل گیسو را با پیشوند openrouter/ بنویسید. |
همهٔ کدها در صفحهٔ خطاها آمده است.
هزینه را کنترل کنید
- برای کلید Cursor سقف هزینه بگذارید؛ وقتی پر شد، درخواست‌ها با خطای ۴۰۲ می‌ایستند و بیشتر از آن خرج نمی‌شود.
- مدل را با کار جور کنید: پرسش ساده با مدل ارزان، ایجنت با Claude، و Opus فقط وقتی مدل‌های دیگر از پس کار برنیامدند.
- گفت‌وگوهای خیلی طولانی را ببندید و تازه شروع کنید؛ هر پیام تازه کل تاریخچه را دوباره می‌فرستد.
- مصرف هر کلید را با GET /usage یا در «گزارش مصرف» اپ ببینید.
پرسش‌های پرتکرار
چرا IP درخواست‌ها در گزارش مصرف، خارجی است؟
چون Cursor درخواست را از سرورهای خودش به گیسو می‌فرستد، نه از کامپیوتر شما. این طبیعی است و دلیل همین است که برای کلید Cursor نباید فهرست IP مجاز گذاشت.
تکمیل خودکار Tab هم از اعتبار گیسو کم می‌کند؟
نه. Tab با مدل‌های خود Cursor کار می‌کند. از اعتبار گیسو فقط درخواست‌هایی کم می‌شود که با مدل انتخابی شما در چت و ایجنت فرستاده می‌شوند.
کد پروژه‌ام در گیسو ذخیره می‌شود؟
نه. گیسو فقط فراداده ثبت می‌کند (مدل، تعداد توکن، هزینه و زمان)؛ متن درخواست و پاسخ ذخیره نمی‌شود. متن به سرویس‌دهندهٔ مدل می‌رسد و سیاست نگهداری همان شرکت حاکم است.
Claude Code یا Cline را انتخاب کنم یا Cursor؟
اگر ویرایشگرتان Cursor است، همین راهنما کافی است. اگر VS Code دارید و ایجنت متن‌باز می‌خواهید، Cline را ببینید؛ اگر در ترمینال کار می‌کنید، Claude Code را.
راهنماهای مرتبط
پاسخ پرسشتان را پیدا نکردید؟
شناسهٔ درخواست (هدر X-Request-Id) را با پرسشتان در تیکت بفرستید تا دقیق بررسی کنیم.
