Jan دسکتاپ + QCode در ویندوز ۱۱: راهنمای نصب (۱۱ تصویر)

Jan دسکتاپ 0.8.8 را با QCode در ویندوز ۱۱ و در ۱۱ تصویر راه بیندازید: نصب Jan، افزودن ارائه‌دهنده سفارشی، گرفتن gpt-6.2-sol و فرستادن نخستین پیام.

به‌روزرسانی 2026-11-23

به کلید API نیاز دارید؟ ثبت‌نام ←نقاط پایانی و Base URL ←

در این صفحه

پاسخ کوتاه: در Jan به Settings → MODEL PROVIDERS بروید، روی دکمه + بزنید تا Add Custom Provider باز شود، OpenAI-compatible را انتخاب کنید، Provider name را QCode بگذارید، Base URL را https://api.qcode.cc/openai/v1 بگذارید، کلید cr_ را بچسبانید، Create را بزنید، سپس Models را تازه‌سازی کنید و gpt-6.2-sol را انتخاب کنید.

مورد مقدار
قالب API OpenAI-compatible
نام ارائه‌دهنده QCode
نشانی پایه https://api.qcode.cc/openai/v1
کلید API cr_xxxxxxxx
مدل پیشنهادی gpt-6.2-sol

بررسی‌شده در 2026-11-22 · Jan 0.8.8 · ویندوز ۱۱

تصویرهای ۱۱گانه زیر را در ویندوز ۱۱ قدم‌به‌قدم دنبال کنید تا Jan دسکتاپ را نصب کنید، از دانلود چند گیگابایتی مدل محلی بگذرید، کلید API QCode را به‌عنوان ارائه‌دهنده سفارشی وصل کنید و نخستین پاسخ را از gpt-6.2-sol بگیرید. می‌توانید با همان کلید QCode یک ارائه‌دهنده دوم هم برای claude-opus-5-5 اضافه کنید.

  • مناسب برای: ویندوز ۱۰ / ۱۱ (۶۴ بیتی) (رابط ویندوز ۱۱)
  • نسخه نرم‌افزار: Jan 0.8.8
  • تصویرها به‌روزرسانی شده در: 2026-11
  • زمان لازم: حدود ۱۰ دقیقه
  • چیزهایی که لازم دارید: یک کلید API از QCode که با cr_ شروع می‌شود

پیش از نخستین تصویر، مطمئن شوید این موارد آماده است:

  • یک رایانه ویندوز ۱۰ یا ویندوز ۱۱ (۶۴ بیتی) با دسترسی به اینترنت
  • دست‌کم ۱ گیگابایت فضای خالی دیسک برای بسته نصب ۵۴۵ مگابایتی و برنامه Jan (برای استفاده از QCode لازم نیست مدلی محلی دانلود کنید)
  • دسترسی به GitHub Releases (github.com) یا jan.ai برای دانلود بسته نصب، و همچنین api.qcode.cc برای درخواست‌های گفت‌وگو
  • کلید API QCode که از داشبورد کپی کرده‌اید (cr_xxxxxxxx). هنوز حساب ندارید؟ ابتدا ثبت‌نام کنید، در صفحه قیمت‌ها یک پلن انتخاب کنید و سپس در داشبورد کلید بسازید.

دانلود و نصب Jan

دکمه دانلود ویندوز Jan مستقیم به GitHub Releases وصل می‌شود. زبانه‌ای را انتخاب کنید که با موقعیت شما می‌خواند:

jan.ai/download را باز کنید و روی Windows → x64 بزنید؛ این گزینه برای رایانه‌های معمول Intel و AMD است (فقط روی رایانه‌های Snapdragon / ARM گزینه ARM64 را انتخاب کنید). اگر سایت موقتاً در دسترس نبود، Jan_0.8.8_x64-setup.exe را مستقیم از GitHub Releases v0.8.8 دانلود کنید.

گزینه‌های نصب جایگزین: نصب Jan از Microsoft Store، یا اجرای winget install Jan.Jan در PowerShell.

آینه رسمی چینی برای Jan وجود ندارد. GitHub Releases v0.8.8 را مستقیم در مرورگر باز کنید و Jan_0.8.8_x64-setup.exe (حدود ۵۴۵ مگابایت) را برای رایانه‌های معمول Intel و AMD دانلود کنید. اگر صفحه رسمی jan.ai/download پاسخ نداد یا دانلود متوقف شد، چند دقیقه صبر کنید و دوباره امتحان کنید، یا شبکه را عوض کنید.

می‌توانید در Microsoft Store عبارت Jan را جست‌وجو کنید یا آن را از PowerShell با winget install Jan.Jan نصب کنید (نسخه‌های Store و winget ممکن است کمی عقب‌تر از GitHub Releases باشند).

کپی کردن کلید API QCode

کنسول QCode را در مرورگر باز کنید و روی ① Sign in بزنید تا وارد حساب خود شوید. پس از ورود، API Key Management را باز کنید، روی آیکون چشم بزنید تا کلید cr_ نمایان شود و Copy را بزنید. این کلید را برای فرم ارائه‌دهنده در ادامه آماده نگه دارید.

ابتدا وارد کنسول QCode شوید، سپس از بخش API Key Management کلید cr_ را نمایان و کپی کنید

اگر درست پیش بروید این را می‌بینید: پس از زدن ① Sign in و باز کردن داشبورد، یک کلید که با cr_ شروع می‌شود و هیچ فاصله اضافی ندارد در حافظه موقت شما کپی شده است.

دانلود بسته نصب ویندوز

GitHub Releases v0.8.8 (یا jan.ai/download) را باز کنید و پایین بروید تا به فهرست Assets برسید. روی ① Jan_0.8.8_x64-setup.exe (545 مگابایت) برای رایانه‌های معمول ویندوزی Intel و AMD کلیک کنید. فقط اگر پردازنده رایانه‌تان ARM64 است روی ② Jan_0.8.8_arm64-setup.exe (320 مگابایت) کلیک کنید.

فهرست Assets در GitHub Releases؛ فایل Jan_0.8.8_x64-setup.exe (545 مگابایت) برای رایانه‌های معمول ویندوزی و Jan_0.8.8_arm64-setup.exe برای رایانه‌های ARM64

گیر کرده‌اید؟ فهرست Assets خالی است یا بسته نصب اجرا نمی‌شود

GitHub فهرست Assets را بعد از بقیه صفحه بارگذاری می‌کند. تا پایین صفحه بروید و چند ثانیه صبر کنید و بعد صفحه را دوباره باز کنید. اگر روی بسته نصب دوبار کلیک کردید و هیچ نشد، یا ویندوز گفت برنامه روی این رایانه اجرا نمی‌شود، احتمالاً اشتباهی arm64-setup.exe را دانلود کرده‌اید — برگردید و به‌جای آن Jan_0.8.8_x64-setup.exe را دانلود کنید.

اگر درست پیش بروید این را می‌بینید: ① Jan_0.8.8_x64-setup.exe با حجم تقریباً 545 مگابایت در پوشه Downloads دانلود می‌شود (یا روی رایانه ARM، ② Jan_0.8.8_arm64-setup.exe).

اجرای بسته نصب Jan

در پوشه Downloads روی Jan_0.8.8_x64-setup.exe دوبار کلیک کنید. Jan برای کاربر فعلی و در مسیر %LOCALAPPDATA%\Programs\Jan نصب می‌شود، بدون پنجره انتخاب پوشه و بدون صفحه‌های Next / Finish — یک پنجره Jan Setup وضعیت Installing را نشان می‌دهد، بعد بسته می‌شود و Jan خودکار اجرا می‌شود.

پنجره Jan Setup با نوار پیشرفت Installing و بدون هیچ پرسش ویزارد

گیر کرده‌اید؟ ویندوز اجازه مدیر می‌خواهد

خود Jan به دسترسی مدیر نیاز ندارد. اما روی رایانه ویندوزی تازه‌ای که Microsoft Visual C++ 2015–2022 Redistributable (x64) را ندارد، بسته نصب اول همان runtime را دانلود می‌کند و یک‌بار پنجره «کنترل حساب کاربری» (UAC) نشان می‌دهد. برای پایان نصب runtime روی Yes بزنید؛ Jan Setup خودکار ادامه می‌دهد.

اگر درست پیش بروید این را می‌بینید: نوار Installing کامل می‌شود، پنجره Jan Setup خودش بسته می‌شود و برنامه دسکتاپ Jan باز می‌شود.

رد کردن دانلود مدل محلی و باز کردن Settings

Jan در نخستین اجرا یک روند خوش‌آمدگویی ۴ مرحله‌ای اجرا می‌کند: Let's start را بزنید، منتظر بررسی موتور محلی بمانید و Continue را بزنید، سپس در صفحه تلمتری Deny (یا انتخاب خودتان) را بزنید. در STEP 4 OF 4 — Your first model، اگر فقط می‌خواهید از مدل‌های ابری QCode استفاده کنید روی ① Download نزنید — به‌جای آن در نوار کنار سمت چپ روی ② Settings بزنید تا مستقیم به تنظیمات بروید.

مرحله ۴ از ۴ در نخستین اجرای Jan (Your first model)؛ دکمه Download که باید رد شود و Settings در نوار کنار سمت چپ برجسته شده‌اند

گیر کرده‌اید؟ اشتباهی Download را زدم

لازم نیست منتظر پایان دانلود مدل محلی بمانید. همان‌جا در نوار کنار سمت چپ روی Settings بزنید و QCode را تنظیم کنید؛ بعداً می‌توانید مدل محلی را در Hub یا Llama.cpp لغو یا حذف کنید تا فضا آزاد شود.

اگر درست پیش بروید این را می‌بینید: با رد کردن ① Download و زدن ② Settings، نمای تنظیمات باز می‌شود و هیچ مدل محلی چند گیگابایتی دانلود نمی‌شود.

باز کردن فرم ارائه‌دهنده سفارشی

در نوار کنار تنظیمات، ① MODEL PROVIDERS را پیدا کنید (که ارائه‌دهنده‌های داخلی LOCAL و REMOTE را گروه‌بندی می‌کند). روی دکمه آیکونی ② + که دقیقاً سمت راست عنوان MODEL PROVIDERS است بزنید تا ارائه‌دهنده سفارشی اضافه کنید.

نوار کنار تنظیمات Jan؛ بخش MODEL PROVIDERS و دکمه آیکون + در سمت راست آن برجسته شده‌اند

اگر درست پیش بروید این را می‌بینید: زدن ② + در کنار ① MODEL PROVIDERS پنجره Add Custom Provider را باز می‌کند.

انتخاب قالب API و نام‌گذاری ارائه‌دهنده

در پنجره Add Custom Provider، زیر API format گزینه ① OpenAI-compatible را انتخاب کنید و در ② Provider name (همان Provider name (e.g. my-llm-server)) عبارت QCode را بنویسید. برای قدم بعد پنجره را باز نگه دارید.

پنجره Add Custom Provider با قالب API روی OpenAI-compatible و نام ارائه‌دهنده QCode

اگر درست پیش بروید این را می‌بینید: ① OpenAI-compatible انتخاب شده و در ② Provider name عبارت QCode نوشته شده است.

وارد کردن Base URL، چسباندن کلید API و زدن Create

در ① Base URL (همان https://your-endpoint/v1) مقدار https://api.qcode.cc/openai/v1 را وارد کنید — پسوند /v1 را نگه دارید و اسلش پایانی نگذارید. در کادر API key (همان Paste your API key) که بلافاصله زیر آن است، کلید cr_ خود را از داشبورد QCode بچسبانید و بعد پایین-راست روی ② Create بزنید.

پنجره Add Custom Provider با Base URL برابر https://api.qcode.cc/openai/v1، کلید API پوشیده و دکمه Create برجسته

به کلید API نیاز دارید؟

اگر هنوز حساب QCode ندارید، ابتدا ثبت‌نام کنید. برای شروع بدون پلن ماهانه، در صفحه بسته‌های پرداخت به‌ازای مصرف یک بسته بخرید، سپس در داشبورد کلید بسازید و رشته‌ای را که با cr_ شروع می‌شود کپی کنید. می‌توانید با کارت اعتباری / نقدی (Visa / Mastercard) پرداخت کنید — به روش‌های پرداخت مراجعه کنید.

گیر کرده‌اید؟ پس از ذخیره، درخواست‌ها با 404 یا 401 شکست می‌خورند

① Base URL را بررسی کنید: برای OpenAI-compatible باید دقیقاً https://api.qcode.cc/openai/v1 باشد (اگر /v1 را جا بیندازید 404 می‌گیرید). اگر 401 می‌گیرید، کادر API key را خالی کنید و کلید cr_ را دوباره از داشبورد کپی کنید، بدون فاصله ابتدایی و بدون گیومه.

اگر درست پیش بروید این را می‌بینید: ① Base URL مقدار https://api.qcode.cc/openai/v1 را نشان می‌دهد، کادر API key کلید چسبانده‌شده را دارد و با زدن ② Create ارائه‌دهنده ذخیره می‌شود و صفحه ارائه‌دهنده QCode باز می‌شود.

دریافت فهرست مدل‌های QCode

پس از زدن Create، در نوار کنار سمت چپ زیر REMOTE گزینه QCode ظاهر می‌شود و خودکار باز می‌شود. در ابتدا ① Models مقدار No model found را نشان می‌دهد (و یک نوار خاکستری در بالا می‌نویسد This provider may not be fully supported... — این نوار را می‌توانید نادیده بگیرید). روی آیکون refresh در سمت راست عنوان Models (آیکون میانی بین جست‌وجو و +) بزنید تا مدل‌ها از QCode بارگذاری شوند، از جمله ② gpt-6.2-sol.

صفحه ارائه‌دهنده QCode زیر REMOTE؛ بخش Models و مدل gpt-6.2-sol پس از تازه‌سازی فهرست مدل‌ها برجسته شده‌اند

گیر کرده‌اید؟ پس از تازه‌سازی، بخش Models هنوز No model found نشان می‌دهد

مطمئن شوید Base URL به /v1 ختم می‌شود (https://api.qcode.cc/openai/v1) و کلید cr_ هیچ فاصله اضافی ندارد، بعد دوباره روی آیکون refresh بزنید. می‌توانید روی دکمه + کنار آیکون refresh بزنید و gpt-6.2-sol را دستی وارد کنید.

اگر درست پیش بروید این را می‌بینید: زیر ① Models فهرست با مدل‌های QCode پر می‌شود و ② gpt-6.2-sol دیده می‌شود.

شروع گفت‌وگوی تازه و انتخاب gpt-6.2-sol

در نوار کنار سمت چپ روی New Chat (Ctrl N) بزنید. در بالا-چپ پنجره گفت‌وگو روی Select a model بزنید تا فهرست مدل‌ها باز شود، گروه ① QCode را پیدا کنید و روی ② gpt-6.2-sol بزنید.

فهرست انتخاب مدل در بالا-چپ یک گفت‌وگوی تازه؛ گروه ارائه‌دهنده QCode و مدل gpt-6.2-sol برجسته شده‌اند

اگر درست پیش بروید این را می‌بینید: پس از انتخاب ② gpt-6.2-sol زیر ① QCode فهرست بسته می‌شود و انتخابگر مدل در بالا-چپ gpt-6.2-sol را نشان می‌دهد.

نوشتن پیام آزمایشی و فرستادن آن

بررسی کنید که انتخابگر بالا-چپ gpt-6.2-sol را نشان می‌دهد. داخل ① Ask me anything... کلیک کنید، یک پیام کوتاه مثل Hello, please introduce yourself in one short sentence بنویسید و روی ② دکمه فلش نارنجی پایین-راست بزنید (یا Enter را بزنید).

کادر ورودی گفت‌وگو با متن Ask me anything، یک سلام آزمایشی تایپ‌شده و دکمه فلش نارنجی ارسال در پایین-راست برجسته

اگر درست پیش بروید این را می‌بینید: پرامپت شما در ① Ask me anything... نوشته شده و با زدن ② بلافاصله فرستاده می‌شود.

تأیید نخستین پاسخ

چند ثانیه صبر کنید تا مدل پاسخ دهد. پرامپت شما در ① حباب پیام کاربر ظاهر می‌شود، gpt-6.2-sol پاسخش را زیر آن به‌صورت جریانی می‌نویسد و ② خط وضعیت tokens/sec زیر پاسخ می‌آید.

گفت‌وگوی کامل‌شده؛ حباب پیام کاربر، پاسخ جریانی gpt-6.2-sol و مقدار tokens/sec زیر آن

اگر درست پیش بروید این را می‌بینید: ① حباب پیام شما، یک پاسخ عادی از gpt-6.2-sol و ② مقدار tokens/sec در زیر آن، بدون هیچ نوار خطای سرخ.

بررسی موفقیت

وقتی هر سه مورد درست باشد، تنظیم Jan شما آماده است:

  • Settings → MODEL PROVIDERS → REMOTE گزینه QCode را نشان می‌دهد و بخش Models آن شامل gpt-6.2-sol است.
  • یک گفت‌وگوی تازه با gpt-6.2-sol در چند ثانیه پاسخ عادی می‌دهد و زیر آن مقدار tokens/sec دیده می‌شود.
  • داشبورد شما (یا probe.qcode.cc) درخواست را زیر کلید cr_ شما ثبت می‌کند.

تمام شد

حالا Jan دسکتاپ روی ویندوز ۱۱ به QCode وصل است و با gpt-6.2-sol گفت‌وگو می‌کند. از اینجا می‌توانید:

خطاهای رایج

متن خطا علت چه کار کنید
No model found بلافاصله پس از زدن Create، Jan صفحه ارائه‌دهنده سفارشی تازه را باز می‌کند بدون اینکه فهرست مدل‌هایش پر شود روی آیکون refresh در سمت راست عنوان Models بزنید تا مدل‌ها از QCode گرفته شوند، یا روی + بزنید و gpt-6.2-sol را دستی اضافه کنید
This provider may not be fully supported... Jan این اخطار خاکستری را روی هر ارائه‌دهنده سفارشی که پیش‌فرض داخلی نیست نشان می‌دهد اخطار را نادیده بگیرید؛ تا وقتی Base URL و کلید cr_ درست باشند، QCode پس از تازه‌سازی Models عادی کار می‌کند
model_not_available_on_endpoint یک مدل Claude (مثل claude-opus-5-5) روی ارائه‌دهنده OpenAI-compatible درخواست شده، یا یک مدل GPT به ارائه‌دهنده Anthropic-compatible فرستاده شده برای gpt-6.2-sol از OpenAI-compatible (https://api.qcode.cc/openai/v1) استفاده کنید و برای claude-sonnet-5-5 یک ارائه‌دهنده جداگانه Anthropic-compatible (https://api.qcode.cc/api) اضافه کنید
404 در Base URL سازگار با OpenAI-compatible پسوند /v1 جا افتاده (https://api.qcode.cc/openai)، یا در Base URL سازگار با Anthropic-compatible یک /v1 اضافه آمده (https://api.qcode.cc/api/v1) برای OpenAI-compatible مقدار Base URL را https://api.qcode.cc/openai/v1 بگذارید، و برای Anthropic-compatible مقدار https://api.qcode.cc/api (بدون /v1)
401 کلید API نیست، منقضی شده، یا با فاصله یا گیومه اضافی چسبانده شده به داشبورد QCode برگردید، روی کلید cr_ خود Copy را بزنید، کادر API key را در Jan خالی کنید و کلید را تمیز بچسبانید

سوالات متداول

مدل‌های Claude را در Jan چطور استفاده کنم؟

مدل‌های Claude از نقطه پایانی سازگار با Anthropic در QCode استفاده می‌کنند، نه از نقطه پایانی سازگار با OpenAI. در Settings → MODEL PROVIDERS دوباره روی + بزنید و یک ارائه‌دهنده سفارشی دوم اضافه کنید با API format برابر Anthropic-compatible و Base URL برابر https://api.qcode.cc/api (بدون /v1)، همان کلید cr_ را بچسبانید، Models را تازه‌سازی کنید و claude-opus-5-5 را انتخاب کنید.

آیا می‌توانم در Jan بدون دانلود مدل محلی از QCode استفاده کنم؟

بله. در نخستین اجرا دکمه Download در STEP 4 OF 4 — Your first model را رد کنید و در نوار کنار سمت چپ روی Settings بزنید. Jan کاملاً با مدل‌های ابری QCode کار می‌کند و هیچ مدل محلی چند گیگابایتی روی دیسک شما ذخیره نمی‌شود.

وقتی کلید API QCode من منقضی شود چه می‌شود؟

رفتار تمدید به نوع پلن بستگی دارد:

  • پلن‌های شخصی: کلید پلن شخصی منقضی‌شده تمدید نمی‌شود. یک پلن تازه بخرید، در داشبورد کلید cr_ تازه بسازید و مقدار API key را در تنظیمات ارائه‌دهنده QCode در Jan عوض کنید.
  • بسته‌های پرداخت به‌ازای مصرف: وقتی یک بسته پرداخت به‌ازای مصرف منقضی می‌شود، با خرید یک بسته دیگر همان کلید cr_ خودکار برمی‌گردد و لازم نیست چیزی در Jan را تغییر دهید.

زبان رابط Jan را چطور عوض کنم؟

Settings → General → Language را باز کنید و زبان دلخواه را از فهرست انتخاب کنید.

آیا می‌توانم به نقطه دسترسی نزدیک‌تر QCode سوییچ کنم؟

بله. در Base URL مقدار api.qcode.cc را با asia.qcode.cc یا us.qcode.cc عوض کنید و همان پسوند مسیر را دقیقاً نگه دارید (/openai/v1 برای OpenAI-compatible و /api برای Anthropic-compatible).

اختیاری: افزودن مدل‌های Claude (Anthropic-compatible)

اگر می‌خواهید هم مدل‌های GPT و هم Claude را داخل Jan داشته باشید، ارائه‌دهنده سازگار با OpenAI خود با نام QCode را برای gpt-6.2-sol نگه دارید و یک ارائه‌دهنده سفارشی دوم برای Claude اضافه کنید:

مورد مقدار
قالب API Anthropic-compatible
نام ارائه‌دهنده QCode Claude
نشانی پایه https://api.qcode.cc/api
کلید API cr_xxxxxxxx (همان کلید QCode)
مدل پیشنهادی claude-opus-5-5

Jan برای ارائه‌دهنده‌های Anthropic-compatible خودکار /v1/messages را اضافه می‌کند، پس Base URL باید روی /api بماند (افزودن /v1 باعث 404 می‌شود). پس از زدن Create، روی آیکون refresh کنار Models بزنید تا claude-opus-5-5 در فهرست بیاید.

نقاط اتصال جایگزین

هر سه دامنه QCode توان مدل یکسانی دارند و فقط مسیر شبکه‌شان فرق می‌کند:

منطقه نشانی پایه سازگار با OpenAI نشانی پایه سازگار با Anthropic
پیش‌فرض (جهانی) https://api.qcode.cc/openai/v1 https://api.qcode.cc/api
آسیا https://asia.qcode.cc/openai/v1 https://asia.qcode.cc/api
آمریکای شمالی https://us.qcode.cc/openai/v1 https://us.qcode.cc/api

مستندات مرتبط

با QCode شروع کنید

یک کلید API برای Claude Code، Codex و بیشتر — بر اساس توکن، قیمت هر مدل در qcode.cc/models

سازمانی ←