Codex دسکتاپ با QCode: آموزش تصویری ویندوز ۱۱، یک قدم یک تصویر، بدون حساب ChatGPT

با ۱۵ قدم و ۱۴ تصویر، Codex دسکتاپ 26.1117.4957.0 را در ویندوز ۱۱ از Microsoft Store نصب کنید، با اسکریپت یک‌مرحله‌ای کلید cr_ QCode را در config.toml و auth.json بنویسید و بدون حساب ChatGPT نخستین پیام را بفرستید.

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

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

در این صفحه

پاسخ کوتاه: در «Windows PowerShell» ویندوز دستور irm https://qcode.cc/install/codex.ps1 | iex را بچسبانید، کلید cr_ را وارد کنید و 1) Codex 桌面版 App (اپ دسکتاپ Codex) را انتخاب کنید؛ اسکریپت base_url = "https://api.qcode.cc/openai" و کلید را در %USERPROFILE%\.codex\ می‌نویسد. سپس از سینی سیستم کاملاً خارج شوید و دوباره باز کنید و در بالا-چپ به Codex سوییچ کنید.

مورد مقدار
نشانی اتصال (base_url) https://api.qcode.cc/openai
پروتکل API (wire_api) responses
مدل پیش‌فرض gpt-6.2-sol
فایل پیکربندی %USERPROFILE%\.codex\config.toml
فایل کلید %USERPROFILE%\.codex\auth.json

بررسی‌شده در 2026-11-22 · ChatGPT (Codex دسکتاپ) 26.1117.4957.0 · ویندوز ۱۱

تصویرهای زیر را قدم‌به‌قدم دنبال کنید: حدود ده دقیقه بعد، Codex دسکتاپ روی رایانه ویندوزی شما نصب شده و به QCode وصل است — برنامه را باز کنید، در بالا-چپ به حالت Codex سوییچ کنید و مستقیم گفت‌وگو کنید.

استفاده از Codex دسکتاپ از طریق QCode فقط یک کلید API از QCode می‌خواهد و به حساب ChatGPT نیازی ندارد: صفحه ورود برنامه را لازم نیست پر کنید، چون auth.json که اسکریپت یک‌مرحله‌ای نوشته است آن را خودبه‌خود کنار می‌زند. نسخه دسکتاپ و Codex CLI همان %USERPROFILE%\.codex\config.toml را مشترک دارند، پس پس از تغییر پیکربندی حتماً از سینی کاملاً خارج شوید و دوباره باز کنید.

  • مناسب برای: ویندوز ۱۱ (۶۴ بیتی) · ویندوز ۱۰ (۶۴ بیتی) هم مناسب است، باید بتواند Microsoft Store را باز کند
  • نسخه نرم‌افزار: ChatGPT (Codex دسکتاپ) 26.1117.4957.0 · اسکریپت یک‌مرحله‌ای v2026.11.21.1
  • تصویرها به‌روزرسانی شده در: 2026-11
  • زمان لازم: 10 دقیقه (بسته نصب حدود 759 مگابایت است؛ اگر شبکه کند است کمی بیشتر صبر کنید)
  • چیزهایی که لازم دارید: یک کلید API از QCode که با cr_ شروع می‌شود؛ یک رایانه ویندوزی با اینترنت
  • رایانه ویندوز ۱۱ یا ویندوز ۱۰ است (هر دو ۶۴ بیتی) و می‌تواند Microsoft Store و «Windows PowerShell» را باز کند
  • کلید API QCode که با cr_ شروع می‌شود را از قبل کپی کرده‌اید. هنوز حساب ندارید؟ ابتدا ثبت‌نام کنید، در صفحه قیمت‌ها یک پلن انتخاب کنید و سپس در داشبورد کلید بسازید.
  • رایانه می‌تواند qcode.cc، api.qcode.cc و Microsoft Store را باز کند؛ اگر دانلود نشد، توضیح مناطق را در «دانلود و نصب» ببینید
  • 10 دقیقه زمان بدون وقفه کنار بگذارید؛ فقط مرحله نصب از Store یک‌بار «کنترل حساب کاربری» (UAC) نشان می‌دهد، «是» (بله) را بزنید.

دانلود و نصب

Codex دسکتاپ بسته نصب جداگانه‌ای به نام «Codex» ندارد: در Microsoft Store نامش ChatGPT است (ناشر OpenAI) و پس از نصب در برنامه به حالت Codex سوییچ می‌کنید. به Node.js و WSL وابسته نیست.

تفاوت مناطق فقط در این است که کدام ورودی دانلود باز می‌شود؛ پس از نصب، مراحل اتصال کاملاً یکسان است. نخست منطقه خود را انتخاب کنید:

  • Microsoft Store و بسته نصب رسمی هر دو کار می‌کنند: در Store عبارت ChatGPT را جست‌وجو کنید، یا در مرورگر https://apps.microsoft.com/detail/9plm9xgg6vks را باز کنید و «获取» (دریافت) را بزنید.
  • اگر می‌خواهید Store را دور بزنید، بسته نصب رسمی ChatGPT-x64.msix را دانلود کنید (برای دستگاه ARM از ChatGPT-arm64.msix) و دوبار کلیک کنید.
  • اسکریپت یک‌مرحله‌ای از qcode.cc می‌گذرد و معمولاً مستقیم در دسترس است.
  • ترجیحاً Microsoft Store: در مرورگر https://apps.microsoft.com/detail/9plm9xgg6vks را باز کنید، یا در «运行» (Run) عبارت ms-windows-store://pdp/?productid=9PLM9XGG6VKS را وارد کنید و «获取» (دریافت) را بزنید؛ نیازی به ورود با حساب مایکروسافت نیست.
  • اگر صفحه Store باز نشد یا مدام می‌چرخد، از بسته نصب رسمی https://persistent.oaistatic.com/codex-app-prod/ChatGPT-x64.msix استفاده کنید (روی دستگاه ARM ChatGPT-arm64.msix). پس از دوبار کلیک، «应用安装程序» (App Installer) کار را می‌گیرد و ممکن است یک‌بار UAC نشان دهد.
  • اسکریپت یک‌مرحله‌ای از qcode.cc می‌گذرد و معمولاً مستقیم در دسترس است.
  • کانال دانلود مثل «اروپا / ژاپن» است: صفحه محصول ChatGPT در Microsoft Store، یا بسته نصب رسمی ChatGPT-x64.msix.
  • اگر Microsoft Store باز نشد، از بسته نصب رسمی استفاده کنید؛ پس از دوبار کلیک، «应用安装程序» (App Installer) کار را می‌گیرد.
  • اسکریپت یک‌مرحله‌ای از qcode.cc می‌گذرد و معمولاً مستقیم در دسترس است.
  • Microsoft Store معمولاً کار می‌کند؛ اگر Store باز نشد، بسته نصب رسمی ChatGPT-x64.msix را دانلود کنید (برای دستگاه ARM از ChatGPT-arm64.msix) و دوبار کلیک کنید.
  • اگر نه Store و نه بسته نصب باز نشد، شبکه دیگری را امتحان کنید؛ پس از نصب، روش اتصال تغییری نمی‌کند.
  • اسکریپت یک‌مرحله‌ای از qcode.cc می‌گذرد و معمولاً مستقیم در دسترس است.

همراه تصویرها: ویندوز، یک قدم یک تصویر

۱۵ قدم زیر، هر قدم فقط یک کار. شماره‌های نارنجی روی تصویرها (①، ②، ③) با شماره‌های متن یکی‌اند؛ شماره را دیدید، همان جای تصویر را ببینید.

باز کردن صفحه ChatGPT در Microsoft Store

در مرورگر https://apps.microsoft.com/detail/9plm9xgg6vks را باز کنید. طبق ① بررسی کنید: نام برنامه ChatGPT، ناشر OpenAI و دکمه «获取» (دریافت) است.

صفحه محصول ChatGPT در Microsoft Store؛ زیر آیکون، نام، امتیاز و توضیح، دکمه «获取» (دریافت) قرار دارد (1)؛ روی آن کلیک کنید تا نصب شروع شود

اگر درست پیش بروید این را می‌بینید: بالای صفحه آیکون و نام ChatGPT است و دکمه سمت راست «获取» (دریافت). اگر «打开» (باز کردن) نوشته باشد، یعنی این رایانه قبلاً نصب شده و می‌توانید به قدم ۳ بروید.

زدن «获取» (دریافت) و شروع نصب

روی ① «获取» (دریافت) کلیک کنید. ویندوز «کنترل حساب کاربری» (UAC) را نشان می‌دهد؛ پس از تأیید اینکه ناشر Microsoft Windows است، «是» (بله) را بزنید و منتظر دانلود بمانید؛ بسته حدود 759 مگابایت است.

پس از زدن «获取» (دریافت)، Microsoft Store آماده‌سازی دانلود و بررسی وابستگی‌ها را نشان می‌دهد و در جای دکمه پیشرفت نصب دیده می‌شود (1)

اگر درست پیش بروید این را می‌بینید: دکمه به «正在下载 / 正在安装» (در حال دانلود / در حال نصب) تبدیل می‌شود و پس از پایان به «打开» (باز کردن)؛ در منوی شروع هم ChatGPT پیدا می‌شود.

گیر کرده‌اید؟ زدن «获取» (دریافت) کاری نمی‌کند یا Store خطا می‌دهد

ابتدا پنجره Store را ببندید و صفحه محصول را دوباره باز کنید و یک‌بار دیگر امتحان کنید؛ اگر باز هم نشد، بسته نصب رسمی ChatGPT-x64.msix را از بخش «دانلود و نصب» بگیرید و پس از دوبار کلیک «安装» (نصب) را بزنید. پس از نصب، ChatGPT را در منوی شروع جست‌وجو کنید تا باز شود.

نخستین اجرا: هنوز وارد نشوید

از منوی شروع ChatGPT را باز کنید (بار اول ممکن است دوباره در UAC «是» (بله) لازم باشد). صفحه اول صفحه ورود انگلیسی Sign in to ChatGPT است: ① همان Continue to sign in و ② همان Sign in another way.

این صفحه Skip ندارد و فعلاً هیچ دکمه ورودی را نزنید — قدم بعدی با اسکریپت یک‌مرحله‌ای پیکربندی را می‌نویسد و پس از باز کردن دوباره، این صفحه دیگر نمی‌آید.

صفحه ورود انگلیسی Sign in to ChatGPT در نخستین اجرا؛ بالا Continue to sign in (1) و پایین Sign in another way (2) و دکمه رد کردن ندارد

اگر درست پیش بروید این را می‌بینید: کارتی که فقط دکمه‌های ورود دارد، عنوانش Sign in to ChatGPT است و در کل صفحه «跳过» (رد کردن) یا Skip پیدا نمی‌شود.

آشنایی با ورودی جایگزین؛ این‌بار لازم نیست

اگر بعداً auth.json اثر نکرد و برنامه دوباره ورود خواست، در صفحه ورود Sign in another way را بزنید؛ داخل آن ① همان ورودی OpenAI API Key است و می‌توانید کلید cr_ را مستقیم وارد کنید (پایین‌تر Amazon Bedrock هم هست).

این آموزش از اسکریپت یک‌مرحله‌ای استفاده می‌کند، پس اینجا فقط یک نگاه کنید و وارد نشوید.

زیرصفحه Sign in another way: نخستین مورد ورودی OpenAI API Key است (1) و پایین‌تر Amazon Bedrock و دکمه بازگشت

اگر درست پیش بروید این را می‌بینید: نخستین مورد صفحه OpenAI API Key است و پایین Back برای بازگشت به صفحه ورود هست.

باز کردن PowerShell و چسباندن دستور یک‌مرحله‌ای

منوی شروع را باز کنید، Windows PowerShell (یا «终端» / Terminal) را تایپ و باز کنید، دستور زیر را بچسبانید و Enter بزنید:

irm https://qcode.cc/install/codex.ps1 | iex

① همان دستوری است که Enter زدید؛ ② نسخه اسکریپت در خط دوم بنر، v2026.11.21.1، که با به‌روزرسانی‌ها تغییر می‌کند؛ ③ سه تست سرعت دامنه‌های اتصال که بعد از آن اجرا می‌شود.

اگر سیستم شما چینی نیست، یا ابتدا $env:QCODE_LANG="en" را تنظیم کنید، اعلان‌های اسکریپت به انگلیسی نمایش داده می‌شوند؛ ترتیب کلیدها کاملاً یکسان است.

چسباندن دستور یک‌مرحله‌ای در Windows PowerShell و Enter (1)؛ زیر آن بنر اسکریپت QCode با شماره نسخه v2026.11.21.1 (2) و سپس نتیجه تست سرعت سه دامنه اتصال (3)

اگر درست پیش بروید این را می‌بینید: بنر QCode.cc · Codex 一键配置 (پیکربندی یک‌مرحله‌ای Codex)، یک خط شماره نسخه v2026.11.21.1 و سپس [1/6] و سه خط نتیجه تست سرعت.

گیر کرده‌اید؟ پیام می‌دهد irm دستور داخلی یا خارجی نیست

شما «命令提示符» (CMD) را باز کرده‌اید که irm را نمی‌شناسد. این پنجره را ببندید، دوباره «Windows PowerShell» یا «终端» (Terminal) را باز کنید و یک‌بار دیگر بچسبانید.

انتخاب دامنه اتصال: مستقیم Enter

در خط اعلان ① Enter بزنید تا سریع‌ترین گزینه داخل کروشه پذیرفته شود (این‌بار api.qcode.cc). پس از Enter، ② مقدار base_url=https://api.qcode.cc/openai را بازتاب می‌دهد — تا /openai و در پایان بدون /v1 و بدون اسلش.

asia.qcode.cc و us.qcode.cc دو نقطه اتصال دیگرند؛ هر سه به همان حساب QCode اشاره می‌کنند، Enter به‌طور پیش‌فرض سریع‌ترین را برمی‌دارد و لازم نیست خودتان انتخاب کنید.

اسکریپت می‌پرسد کدام دامنه اتصال؛ Enter یعنی ۱ (1)؛ پس از Enter دامنه api.qcode.cc و base_url=https://api.qcode.cc/openai بازتاب می‌شود (2)

اگر درست پیش بروید این را می‌بینید: یک خط 接入域: api.qcode.cc -> base_url=https://api.qcode.cc/openai (دامنه اتصال) و بلافاصله [2/6] که کلید می‌خواهد.

چسباندن کلید QCode

از داشبورد رشته‌ای را که با cr_ شروع می‌شود کپی کنید، به پنجره برگردید و در ① بعد از API 密钥: (کلید API:) بچسبانید و Enter بزنید.

هنگام تایپ چیزی نمایش داده نمی‌شود و کاراکتری روی صفحه نمی‌بینید؛ پس از Enter، ② فقط 已读取密钥: cr_**** (کلید خوانده شد) و چهار رقم آخر را نشان می‌دهد، یعنی کلید دریافت شده و قالبش هم درست است.

اسکریپت می‌خواهد کلید API را بچسبانید (1)؛ پس از چسباندن چیزی نمایش داده نمی‌شود و Enter فقط <code>已读取密钥: cr_****</code> و چهار رقم آخر را نشان می‌دهد (2)

اگر درست پیش بروید این را می‌بینید: یک خط 已读取密钥: cr_**** (کلید خوانده شد) که با cr_ شروع می‌شود و سپس [3/6].

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

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

انتخاب 1) Codex 桌面版 App

① خط پرسش «你要在哪个 Codex 客户端里使用?» (در کدام کلاینت Codex استفاده می‌کنید؟) است. روی ② 1) Codex 桌面版 App (اپ دسکتاپ Codex) مستقیم Enter بزنید (پیش‌فرض همان ۱ است). این گزینه فقط فایل پیکربندی را می‌نویسد، نه Node.js نصب می‌کند و نه Codex CLI.

اسکریپت می‌پرسد در کدام کلاینت Codex استفاده می‌کنید (1)؛ نخستین مورد <code>1) Codex 桌面版 App</code> (اپ دسکتاپ Codex) است که فقط فایل پیکربندی را می‌نویسد (2)

اگر درست پیش بروید این را می‌بینید: دو خط گزینه — 1) Codex 桌面版 App (اپ دسکتاپ Codex) و 2) Codex CLI؛ پس از Enter وارد [4/6] و دریافت فهرست مدل‌ها می‌شوید.

انتخاب مدل پیش‌فرض gpt-6.2-sol

① همان [4/6] است که در حال دریافت فهرست مدل‌های موجود است. در نخستین خط فهرست ② بعد از gpt-6.2-sol نوشته <- 推荐 (پیشنهادی)؛ مستقیم Enter بزنید تا همان انتخاب شود.

اسکریپت فهرست مدل‌های موجود را می‌گیرد (1)؛ در نخستین خط بعد از gpt-6.2-sol نوشته پیشنهادی (2)؛ Enter بزنید تا انتخاب شود

اگر درست پیش بروید این را می‌بینید: چند خط مدل که با 1) و 2) شروع می‌شوند؛ خط اول gpt-6.2-sol است و بعدش <- 推荐 (پیشنهادی).

گیر کرده‌اید؟ gpt-6.2-sol در فهرست نیست

فهرست مدل‌ها بر اساس مدل‌هایی گرفته می‌شود که این کلید می‌تواند استفاده کند. ابتدا مطمئن شوید کلید cr_ QCode را چسبانده‌اید و فاصله اضافی کپی نکرده‌اید؛ اسکریپت را دوباره اجرا کنید تا فهرست باز گرفته شود. تا وقتی خط اول <- 推荐 (پیشنهادی) دارد، مستقیم Enter بزنید.

تأیید نوشته‌شدن پیکربندی

① همان [OK] 已写入 config.toml + auth.json (نوشته شد) است؛ ② یادآوری می‌کند که اپ دسکتاپ و CLI همین پیکربندی را مشترک دارند و باید کاملاً خارج و دوباره اجرا شود تا اثر کند؛ ③ یک درخواست حداقلی است که اسکریپت خودکار می‌فرستد و 接入验证通过 (تأیید اتصال) یعنی نشانی، کلید و شبکه — کل زنجیره — درست کار می‌کند.

اسکریپت نشان می‌دهد config.toml و auth.json نوشته شدند (1)، یادآوری می‌کند اپ دسکتاپ و CLI پیکربندی مشترک دارند و باید کاملاً خارج و دوباره اجرا شود (2)، و تأیید اتصال (3)

اگر درست پیش بروید این را می‌بینید: 已写入 config.toml + auth.json (نوشته شد)، یک خط یادآوری «پس از خروج کامل و اجرای دوباره اثر می‌کند»، و 接入验证通过! 模型 gpt-6.2-sol 响应正常 (تأیید اتصال! مدل gpt-6.2-sol پاسخ درست می‌دهد).

دیدن خلاصه پایانی

خلاصه سه خط دارد: ① دامنه اتصال (این‌بار api.qcode.cc)، ② مدل پیش‌فرض gpt-6.2-sol، ③ اتصال [OK] 已验证 (تأیید شد). مسیر فایل پیکربندی در میانه است و به C:\Users\你的用户名\.codex اشاره می‌کند.

خلاصه پایانی اسکریپت: دامنه اتصال api.qcode.cc (1)، مدل پیش‌فرض gpt-6.2-sol (2)، فایل‌های config.toml و auth.json و اتصال OK تأیید شد (3)

اگر درست پیش بروید این را می‌بینید: هر سه خط [OK] دارند، دامنه اتصال api.qcode.cc و مدل gpt-6.2-sol است.

خروج کامل از برنامه

فقط بستن پنجره کافی نیست، فرایند هنوز زنده است و پیکربندی دوباره خوانده نمی‌شود. باید این‌طور خارج شوید:

  1. روی ^ در گوشه پایین-راست نوار وظیفه کلیک کنید تا آیکون‌های سینی مخفی باز شوند؛
  2. روی آیکون ChatGPT داخل آن راست‌کلیک کنید؛
  3. روی Exit کلیک کنید.

صفحه ورود منوی File ندارد، پس Ctrl+Q هم کار نمی‌کند؛ فقط Exit در سینی واقعاً فرایند را پایان می‌دهد.

اگر درست پیش بروید این را می‌بینید: آیکون ChatGPT از سینی ناپدید می‌شود؛ در Task Manager هم فرایند ChatGPT پیدا نمی‌شود.

گیر کرده‌اید؟ آیکون ChatGPT در سینی نیست

ممکن است آیکون جمع شده باشد: ابتدا ^ در پایین-راست نوار وظیفه را بزنید تا باز شود، بعد راست‌کلیک کنید. اگر منوی راست‌کلیک فقط New Chat / Send Feedback دارد، روی دکمه برنامه در نوار وظیفه راست‌کلیک کرده‌اید نه آیکون سینی؛ آیکون کوچک داخل ^ را امتحان کنید.

باز کردن دوباره و رد کردن پرسشنامه

از منوی شروع دوباره ChatGPT را باز کنید. این‌بار صفحه ورود نمی‌آید و مستقیم پرسشنامه What type of work do you do? می‌آید: ① گزینه Engineering و ② همان Skip. یک گزینه انتخاب کنید یا مستقیم ② Skip را بزنید؛ فقط پیشنهادهای رابط را تغییر می‌دهد و به اتصال کاری ندارد.

پس از باز کردن دوباره، پرسشنامه شخصی‌سازی مستقیم می‌آید؛ گزینه Engineering برجسته است (1) و پایین-راست دکمه Skip (2)

اگر درست پیش بروید این را می‌بینید: کارت پرسشنامه، بدون Sign in to ChatGPT؛ پس از زدن Skip وارد رابط اصلی می‌شوید.

گیر کرده‌اید؟ پس از باز کردن دوباره هنوز Sign in to ChatGPT می‌آید

یعنی برنامه فایل کلید را نخوانده. ابتدا مطمئن شوید %USERPROFILE%\.codex\auth.json وجود دارد و نام کلید داخلش OPENAI_API_KEY است؛ سپس یک‌بار از سینی Exit و دوباره باز کنید. اگر باز صفحه ورود آمد، در صفحه ورود Sign in another way → OpenAI API Key را بزنید و کلید cr_ را مستقیم وارد کنید.

سوییچ حالت به Codex

رابط اصلی به‌طور پیش‌فرض ChatGPT Work است. دکمه حالت ① در بالا-چپ را بزنید و در منو Codex را انتخاب کنید. پس از سوییچ، کپسول مدل ② در پایین-راست 6.2 Sol High را نشان می‌دهد — همان gpt-6.2-sol در config.toml به‌همراه شدت استدلال high.

رابط اصلی ChatGPT؛ دکمه حالت در بالا-چپ می‌تواند به Codex سوییچ کند (1) و کپسول مدل در پایین-راست 6.2 Sol High را نشان می‌دهد (2)

اگر درست پیش بروید این را می‌بینید: حالت بالا-چپ Codex، عنوان میانه What should we build?، متن جای‌نگهدار کادر Do anything و کپسول پایین-راست 6.2 Sol High.

گیر کرده‌اید؟ پایین-راست 6.2 Sol High نیست

یعنی config.toml اثر نکرده. %USERPROFILE%\.codex\config.toml را با Notepad باز کنید و مطمئن شوید در سطح بالا model = "gpt-6.2-sol" و model_provider = "qcode" هست و بخش [model_providers.qcode] هم وجود دارد؛ پس از ذخیره از سینی Exit و دوباره باز کنید.

فرستادن نخستین جمله و گرفتن پاسخ

در کادر ③ (با متن جای‌نگهدار Do anything) عبارت Say hello in one short sentence را تایپ و Enter بزنید. چند ثانیه بعد ① جمله‌ای است که فرستادید و زیرش ② پاسخ مدل است.

فرستادن یک سلام انگلیسی در کادر (1 پیام فرستاده‌شده)؛ چند ثانیه بعد پاسخ مدل می‌آید (2) و پایین کادر Do anything است (3)

اگر درست پیش بروید این را می‌بینید: پیام شما در سمت راست ناحیه گفت‌وگو می‌آید و چند ثانیه بعد در سمت چپ یک پاسخ کامل ظاهر می‌شود؛ نه مدام می‌چرخد و نه 401 می‌دهد.

بررسی موفقیت

اگر این سه مورد درست باشد، نصب و اتصال انجام شده است:

  • باز کردن دوباره دیگر Sign in to ChatGPT نمی‌آورد و حالت بالا-چپ به Codex سوییچ می‌شود؛
  • کپسول مدل پایین-راست 6.2 Sol High را نشان می‌دهد و با فرستادن یک جمله پاسخ عادی می‌آید؛
  • برای بررسی دوباره اینکه درخواست واقعاً از QCode می‌گذرد: probe.qcode.cc را باز کنید، کلید را وارد کنید و همان درخواست را با نام مدل gpt-6.2-sol ببینید.

تمام شد

این رایانه ویندوزی حالا Codex دسکتاپ نصب دارد و به QCode وصل است: از این به بعد ChatGPT را باز کنید و به حالت Codex سوییچ کنید تا مستقیم برایتان کد بنویسد و فایل‌ها را تغییر دهد. از اینجا می‌توانید:

خطاهای رایج

متن خطا علت چه کار کنید
Sign in to ChatGPT برنامه هنگام راه‌اندازی auth.json را نخوانده: یا اسکریپت یک‌مرحله‌ای اجرا نشده، یا پس از تغییر پیکربندی فقط پنجره بسته شده و از سینی کاملاً خارج نشده روی آیکون ChatGPT در سینی راست‌کلیک و Exit بزنید و دوباره باز کنید؛ اگر باز هم آمد بررسی کنید در %USERPROFILE%\.codex\auth.json مقدار OPENAI_API_KEY کلیدی باشد که با cr_ شروع می‌شود
ERROR: unexpected status 401 Unauthorized: {"error":"Missing API key"}, url: https://xxx/v1/responses در config.toml مقدار requires_openai_auth = true نوشته نشده، یا auth.json مقدار OPENAI_API_KEY را ندارد و درخواست بدون کلید می‌رود در [model_providers.qcode] داخل config.toml مقدار requires_openai_auth = true را اضافه کنید، auth.json را به شکل {"OPENAI_API_KEY": "cr_xxxxxxxx"} بنویسید، ذخیره کنید و از سینی Exit و دوباره باز کنید
404 route not supported: POST /chatgpt/v1/responses base_url به دامنه ورود ChatGPT نوشته شده، یا بعد از /openai مقدار /v1 یا اسلش اضافه شده base_url را به https://api.qcode.cc/openai برگردانید، ذخیره کنید و از سینی Exit و دوباره باز کنید
Error loading config.toml: wire_api = "chat" is no longer supported. wire_api هنوز chat است، در حالی که Codex فقط پروتکل Responses را پشتیبانی می‌کند wire_api را به "responses" تغییر دهید، ذخیره کنید و برنامه را دوباره باز کنید
Missing environment variable: OPENAI_API_KEY از شکل env_key استفاده شده، اما در فرایندی که برنامه را اجرا می‌کند این متغیر نیست؛ یا requires_openai_auth و env_key هم‌زمان مانده‌اند برای نسخه دسکتاپ requires_openai_auth = true + auth.json را پیشنهاد می‌کنیم و خط env_key را پاک کنید؛ از این دو شکل فقط یکی می‌تواند بماند
模型提供商不匹配 ارائه‌دهنده‌ای که تاریخچه گفت‌وگو به آن بسته شده با config.toml نمی‌خواند؛ معمولاً وقتی اول در برنامه با حساب رسمی وارد شده‌اید و بعد به کلید API تغییر داده‌اید یک گفت‌وگوی تازه بسازید؛ مطمئن شوید model_provider = "qcode" با نام جدول [model_providers.qcode] یکی است، پس از تغییر از سینی Exit و دوباره باز کنید

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

آیا به حساب ChatGPT نیاز دارم؟

خیر. برنامه در نخستین اجرا روی Sign in to ChatGPT می‌ماند، اما تا وقتی طبق قدم‌های بالا اسکریپت یک‌مرحله‌ای را اجرا کرده باشید، در %USERPROFILE%\.codex\auth.json یک کلید cr_ هست و باز کردن دوباره صفحه ورود را رد می‌کند و مستقیم به پرسشنامه و رابط اصلی می‌رود. در تمام این فرایند به حساب هیچ ارائه‌دهنده‌ای وارد نمی‌شوید.

نسبت نسخه دسکتاپ و Codex CLI چیست؟

هر دو همان %USERPROFILE%\.codex\config.toml و auth.json را مشترک دارند: مدل، نشانی اتصال و کلیدی که نسخه دسکتاپ می‌خواند دقیقاً همان چیزی است که Codex CLI می‌خواند. اسکریپت یک‌مرحله‌ای در قدم ۳ اگر 1) Codex 桌面版 App (اپ دسکتاپ Codex) را انتخاب کنید فقط پیکربندی می‌نویسد و Node.js و CLI نصب نمی‌کند؛ اگر بعداً خط فرمان خواستید، یک‌بار دیگر اسکریپت را اجرا کنید و 2) Codex CLI را انتخاب کنید؛ کلید را لازم نیست دوباره وارد کنید. طرز استفاده خط فرمان در آموزش کامل Codex CLI است.

اگر پس از تغییر پیکربندی اثر نکند چه کنم؟

برنامه پیکربندی را فقط یک‌بار هنگام راه‌اندازی می‌خواند. پس از تغییر config.toml یا auth.json باید از آیکون سینی پایین-راست نوار وظیفه روی ChatGPT راست‌کلیک و Exit بزنید، مطمئن شوید فرایند تمام شده و بعد دوباره باز کنید؛ فقط بستن پنجره یا Ctrl+Q کافی نیست.

آیا نسخه دسکتاپ به Node.js یا WSL نیاز دارد؟

هیچ‌کدام. نسخه دسکتاپ یک برنامه بومی ویندوز است که از Microsoft Store توزیع می‌شود؛ اسکریپت یک‌مرحله‌ای با انتخاب 1) Codex 桌面版 App (اپ دسکتاپ Codex) به Node.js دست نمی‌زند و WSL هم لازم نیست. Node.js فقط برای نصب Codex CLI لازم است.

مدل را چطور انتخاب کنم؟

نیاز شما مدل پیشنهادی دلیل
کار روزمره و کدنویسی پیچیده gpt-6.2-sol زمینه 1.05M / خروجی 128K، توان کلی متعادل
سخت‌ترین کارهای Agent چندمرحله‌ای gpt-6.2-astra یک رده بالاتر، مناسب معماری چندماژولی و کارهای طولانی
کارهای سبک روزمره / دسته‌ای gpt-6.1-terra / gpt-5.6-terra هزینه کمتر، بهینه برای سناریوهای کد
مدل‌های رده‌بالای نسل پیشین gpt-6-astra هنوز کار می‌کند، برای کارهای تازه gpt-6.2-astra را انتخاب کنید

تغییر مدل پیش‌فرض یعنی تغییر خط model در config.toml، ذخیره، و بعد Exit از سینی و باز کردن دوباره. توجه: gpt-6.2-* از model_reasoning_effort = "none" پشتیبانی نمی‌کند.

پس از انقضای کلید چه کنم؟

دو حالت دارد:

  • کلید پلن شخصی پس از انقضا تمدید نمی‌شود؛ فقط می‌توانید دوباره پلن بگیرید و کلید تازه بسازید.
  • کلید بسته پرداخت به‌ازای مصرف پس از انقضا با خرید یک بسته دیگر باز می‌گردد و همان کلید است.

پس از عوض کردن کلید یادتان باشد OPENAI_API_KEY در auth.json را هم به‌روز کنید و از سینی Exit و دوباره باز کنید.

هزینه چطور حساب می‌شود؟

نسخه دسکتاپ، Codex CLI و Claude Code می‌توانند همان کلید API QCode را مشترک استفاده کنند؛ هزینه بر اساس مصرف واقعی توکن حساب می‌شود و به ابزار ربطی ندارد. وقتی Codex را چند دور خودگردان می‌گذارید، مصرف یک کار ممکن است بیشتر شود؛ می‌توانید در داشبورد مصرف و موجودی را ببینید.

نوشتن دستی پیکربندی (بدون اسکریپت یک‌مرحله‌ای)

اسکریپت یک‌مرحله‌ای هر دو فایل را برایتان نوشته است. اگر می‌خواهید خودتان بنویسید، یا می‌خواهید در macOS پیکربندی را مقایسه کنید، طبق زیر عمل کنید. نسخه دسکتاپ و Codex CLI همان پیکربندی را می‌خوانند.

ساخت config.toml

در ویندوز (PowerShell) نخست پوشه را بسازید:

mkdir $HOME\.codex

سپس در %USERPROFILE%\.codex\config.toml بنویسید:

model_provider = "qcode"
model = "gpt-6.2-sol"
model_reasoning_effort = "high"

[model_providers.qcode]
name = "qcode"
base_url = "https://api.qcode.cc/openai"
wire_api = "responses"
requires_openai_auth = true

ساخت auth.json

در auth.json همان پوشه سه خط بنویسید؛ نام کلید باید OPENAI_API_KEY باشد و گیومه و دونقطه هر دو نیم‌عرض انگلیسی:

{
  "OPENAI_API_KEY": "cr_xxxxxxxx"
}

cr_xxxxxxxx را با کلید خودتان عوض کنید. هنگام ذخیره با Notepad، «保存类型» (نوع ذخیره) را روی «所有文件» (همه فایل‌ها) بگذارید و نام فایل را auth.json بنویسید، وگرنه به auth.json.txt تبدیل می‌شود و برنامه نمی‌تواند بخواند.

شکل جایگزین با متغیر محیطی (یکی را انتخاب کنید)

اگر می‌خواهید کلید را با متغیر محیطی بدهید، requires_openai_auth = true را با env_key = "QCODE_API_KEY" عوض کنید و این متغیر را تنظیم کنید. از این دو شکل فقط یکی را انتخاب کنید: وقتی requires_openai_auth = true نوشته شده باشد، Codex مقدار env_key را نادیده می‌گیرد.

model_provider = "qcode"
model = "gpt-6.2-sol"
model_reasoning_effort = "high"

[model_providers.qcode]
name = "qcode"
base_url = "https://api.qcode.cc/openai"
wire_api = "responses"
env_key = "QCODE_API_KEY"
# تنظیم موقت (همین نشست)
$env:QCODE_API_KEY = "cr_xxxxxxxx"

# تنظیم دائمی (در متغیرهای محیطی کاربر نوشته می‌شود؛ پس از تنظیم برنامه را دوباره باز کنید)
[System.Environment]::SetEnvironmentVariable("QCODE_API_KEY", "cr_xxxxxxxx", [System.EnvironmentVariableTarget]::User)

توضیح فیلدهای config.toml

فیلد توضیح
model_provider نام ارائه‌دهنده مدلی که استفاده می‌شود؛ اینجا qcode سفارشی. نام آزاد است، فقط باید با [model_providers.<نام>] یکی باشد
model مدل پیش‌فرض؛ gpt-6.2-sol پیشنهاد می‌شود و برای سخت‌ترین کارها gpt-6.2-astra
model_reasoning_effort شدت استدلال؛ low، medium، high و xhigh را پشتیبانی می‌کند. gpt-6.2-* مقدار none را نمی‌پذیرد، پس high یا xhigh را نگه دارید
base_url نشانی نقطه اتصال QCode. برای نسخه دسکتاپ https://api.qcode.cc/openai، در پایان بدون /v1 و بدون اسلش
wire_api نوع پروتکل API؛ Codex فعلاً فقط responses را پشتیبانی می‌کند
requires_openai_auth از احراز هویت با قالب OpenAI استفاده می‌کند و کلید از OPENAI_API_KEY در auth.json خوانده می‌شود. با true، Codex مقدار env_key را نادیده می‌گیرد

اسکریپت یک‌مرحله‌ای تنظیمات زمان اجرا مثل review_model = "gpt-6.2-sol" و windows_wsl_setup_acknowledged = true را هم می‌نویسد؛ نسخه دسکتاپ لازم نیست به آن‌ها دست بزند و دستی هم تغییرشان ندهید.

مدل‌های قابل استفاده

از طریق QCode می‌توانید این مدل‌های Codex / GPT را انتخاب کنید:

مدل توضیح سناریوی پیشنهادی
gpt-6.2-sol پرچم‌دار اصلی، زمینه 1.05M / حداکثر خروجی 128K؛ model_reasoning_effort = "none" را رد می‌کند انتخاب نخست برای کار روزمره و کدنویسی پیچیده (پیشنهادی)
gpt-6.2-astra پرچم‌دار رده بالا، زمینه 1.05M / حداکثر خروجی 128K؛ none را هم رد می‌کند سخت‌ترین کارهای Agent چندمرحله‌ای و معماری چندماژولی
gpt-6.1-terra رده میانی GPT-6.1، زمینه 1.05M کدنویسی روزمره / کارهای دسته‌ای
gpt-5.6-terra پرچم‌دار GPT-5.6، بهینه برای کد برنامه‌نویسی / سناریوهای Codex
gpt-6-astra قوی‌ترین رده نسل پیشین توان بالا؛ برای کارهای تازه gpt-6.2-astra را انتخاب کنید

مرور سریع اتصال

مورد توضیح
مدل‌های قابل استفاده GPT ✅ (پروتکل Responses) · Claude ❌ · مدل‌های چینی ❌ (پروتکل Responses مدل‌های چینی را سرویس نمی‌دهد) · Gemini ❌ (QCode فعلاً ارائه نمی‌کند)
پروتکل و Base URL Codex از OpenAI Responses استفاده می‌کند: در config.toml بنویسید base_url = "https://api.qcode.cc/openai" + wire_api = "responses"
محل پیکربندی در ویندوز %USERPROFILE%\.codex\ (config.toml + auth.json)، مشترک بین نسخه دسکتاپ و CLI
نقاط اتصال دیگر https://asia.qcode.cc/openai، https://us.qcode.cc/openai، با api.qcode.cc همان حساب و همان کلید
مستندات رسمی openai/codex

با QCode شروع کنید

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

سازمانی ←