Continue یک دستیار کدنویسی متن‌باز برای VS Code و JetBrains است: گفت‌وگو دربارهٔ کد، ویرایش بخشی از فایل با یک دستور، حالت ایجنت (Agent) و جست‌وجو در کد پروژه. همهٔ تنظیمش در یک فایل است و برای هر مدل می‌گویید کدام نقش (role) را بازی کند. با کلید گیسو، برای هر نقش هر مدلی از کاتالوگ را می‌گذارید.
| provider | openai |
| apiBase | https://gisoo.pro/api/v1 |
| apiKey | کلید گیسو، بهتر است از فایل .env خوانده شود |
| model | شناسهٔ دقیق مدل گیسو، مثلاً openrouter/anthropic/claude-sonnet-5.5 |
راه‌اندازی
- افزونه را نصب کنید
در VS Code از Extensions یا در JetBrains از Plugins، «Continue» را نصب کنید.
- فایل تنظیم را باز کنید
در پنل Continue از منوی انتخاب مدل یا نماد چرخ‌دنده، تنظیم محلی (local config) را باز کنید. فایل
~/.continue/config.yamlاست. - کلید را در .env بگذارید
کنار همان فایل،
~/.continue/.envرا بسازید تا کلید داخل فایل تنظیم نوشته نشود. - مدل‌ها را تعریف کنید
نمونهٔ پایین را بچسبانید و ذخیره کنید. Continue تنظیم را دوباره می‌خواند و مدل‌ها در فهرست انتخاب مدل ظاهر می‌شوند.
- آزمایش کنید
«Gisoo · Claude» را انتخاب کنید و دربارهٔ یک فایل باز سؤال کنید. درخواست باید در «گزارش مصرف» اپ گیسو دیده شود.
# ~/.continue/.env — Continue reads secrets from here; keep this file out of git
GISOO_API_KEY=sk-gisoo-v1-...برای سرورها و کاربران داخل ایران، در این نمونه نشانی gisoo.pro را با ir.gisoo.pro جایگزین کنید؛ مسیر و کلید همان‌اند.
# ~/.continue/config.yaml (Windows: %USERPROFILE%\.continue\config.yaml)
name: Gisoo
version: 1.0.0
schema: v1
models:
- name: Gisoo · Claude
provider: openai
model: openrouter/anthropic/claude-sonnet-5.5
apiBase: https://gisoo.pro/api/v1
apiKey: ${{ secrets.GISOO_API_KEY }}
roles: [chat, edit, apply]
capabilities: [tool_use, image_input]
defaultCompletionOptions:
contextLength: 200000
maxTokens: 8192
- name: Gisoo · DeepSeek
provider: openai
model: deepseek-v4-flash
apiBase: https://gisoo.pro/api/v1
apiKey: ${{ secrets.GISOO_API_KEY }}
roles: [chat, edit]
capabilities: [tool_use]
defaultCompletionOptions:
contextLength: 200000
maxTokens: 8192
- name: Gisoo · embeddings
provider: openai
model: text-embedding-3-small
apiBase: https://gisoo.pro/api/v1
apiKey: ${{ secrets.GISOO_API_KEY }}
roles: [embed]هر بخش چه می‌کند
| بخش | کارش |
|---|---|
provider: openai | یعنی درخواست‌ها با قالب OpenAI فرستاده شوند. برای Claude و DeepSeek هم همین را بگذارید؛ گیسو درخواست را به سرویس‌دهندهٔ هر مدل می‌رساند. |
roles | chat گفت‌وگو، edit ویرایش بخش انتخاب‌شده، apply اعمال پیشنهاد روی فایل و embed ساختن نمایهٔ جست‌وجوی کد. |
capabilities | Continue توانایی‌های مدل را از نامش حدس می‌زند و شناسه‌های گیسو را نمی‌شناسد. tool_use حالت ایجنت را روشن می‌کند و image_input فرستادن تصویر را. |
contextLength و maxTokens | اندازهٔ ورودی و سقف خروجی. سقف خروجی خیلی بزرگ، مبلغی را که پیش از هر درخواست کنار گذاشته می‌شود بالا می‌برد. |
${{ secrets.GISOO_API_KEY }} | مقدار را از .env می‌خواند. اگر خوانده نشود، همین متن به‌جای کلید فرستاده می‌شود و خطای ۴۰۱ می‌گیرید. |
کدام مدل را بگذارید
| برای | شناسهٔ مدل | پنجرهٔ ورودی (توکن) | ورودی / خروجی (دلار برای هر یک میلیون توکن) |
|---|---|---|---|
| گفت‌وگو، ویرایش و ایجنت | openrouter/anthropic/claude-sonnet-5.5 |
۱٬۰۰۰٬۰۰۰ | $3.0595 / $15.2975 |
| گفت‌وگو و ویرایش با هزینهٔ کم | deepseek-v4-flash |
۱٬۰۰۰٬۰۰۰ | $0.42 / $1.68 |
| جایگزین از OpenAI | gpt-5.5 |
۱٬۰۵۰٬۰۰۰ | $7.00 / $42.00 |
شناسه‌ها و قیمت‌ها هنگام باز شدن این صفحه از کاتالوگ خوانده می‌شوند و با تغییر قیمت سرویس‌دهنده عوض می‌شوند. فهرست کامل، با قیمت هر مدل به سکه، در صفحهٔ مدل‌ها است.
برای نقش embed، مدل text-embedding-3-small ارزان است و برای متن فارسی و انگلیسی هر دو به کار می‌رود؛ قیمتش در امبدینگ آمده است.
تکمیل خودکار (Autocomplete)
تکمیل خودکار Continue، یعنی پیشنهاد کد هم‌زمان با تایپ، از روش «پر کردن وسط» (FIM) استفاده می‌کند: متن پیش و پس از مکان‌نما با هم به مدل می‌رود.
endpoint /completions گیسو فیلد suffix را نمی‌فرستد و این روش را پشتیبانی نمی‌کند. برای همین در نمونهٔ بالا نقش autocomplete به مدل گیسو داده نشده است.
گفت‌وگو، ویرایش، ایجنت و جست‌وجوی کد با گیسو کامل کار می‌کنند.
خطاهای رایج
| نشانه | علت | راه رفع |
|---|---|---|
401 invalid_api_key | کلید از .env خوانده نشده یا ناقص است. | نام متغیر در دو فایل یکی باشد؛ برای آزمایش، کلید را موقتاً مستقیم در apiKey بنویسید. |
404 model_not_found | شناسهٔ مدل دقیق نیست. | شناسه را از صفحهٔ مدل‌ها کپی کنید. |
| حالت Agent در فهرست نیست یا ابزارها کار نمی‌کنند | capabilities تعریف نشده است. | tool_use را به مدل اضافه کنید و مدلی بگذارید که فراخوانی ابزار دارد. |
402 insufficient_credit | اعتبار برای مبلغ کنارگذاشتنی کافی نیست. | شارژ کنید یا maxTokens را کمتر بگذارید. |
| نمایه‌سازی کد کند است یا خطای ۴۲۹ می‌دهد | Continue برای پروژهٔ بزرگ درخواست‌های امبدینگ پشت سر هم می‌فرستد. | چند دقیقه صبر کنید تا نمایه کامل شود؛ پوشه‌هایی مثل node_modules و vendor را از نمایه بیرون بگذارید. |
پرسش‌های پرتکرار
در JetBrains هم همین فایل کار می‌کند؟
بله. Continue در VS Code و JetBrains یک فایل تنظیم مشترک دارد؛ هر تغییر در هر دو اثر می‌کند.
چرا provider را anthropic نگذارم وقتی Claude می‌خواهم؟
با provider: openai همهٔ مدل‌ها از یک مسیر و یک قالب می‌آیند و تنظیم ساده می‌ماند. گیسو خودش درخواست را به سرویس‌دهندهٔ Claude می‌رساند.
کد پروژه‌ام کجا می‌رود؟
به gisoo.pro و از آنجا به سرویس‌دهندهٔ همان مدل. گیسو متن درخواست و پاسخ را ذخیره نمی‌کند و فقط فراداده مثل مدل، توکن و هزینه ثبت می‌شود.
راهنماهای مرتبط
پاسخ پرسشتان را پیدا نکردید؟
شناسهٔ درخواست (هدر X-Request-Id) را با پرسشتان در تیکت بفرستید تا دقیق بررسی کنیم.
