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


**پاسخ کوتاه**: در «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_` شروع می‌شود را از قبل کپی کرده‌اید. هنوز حساب ندارید؟ ابتدا [ثبت‌نام کنید](https://qcode.cc/fa/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-codex-desktop-before)، در [صفحه قیمت‌ها](https://qcode.cc/fa/pricing?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-codex-desktop-before) یک پلن انتخاب کنید و سپس در [داشبورد](https://qcode.cc/fa/dashboard) کلید بسازید.
- رایانه می‌تواند `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)؛ روی آن کلیک کنید تا نصب شروع شود](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/01-download-page.webp)


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




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

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

![پس از زدن «获取» (دریافت)، Microsoft Store آماده‌سازی دانلود و بررسی وابستگی‌ها را نشان می‌دهد و در جای دکمه پیشرفت نصب دیده می‌شود (1)](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/02-install-store.webp)


اگر درست پیش بروید این را می‌بینید: دکمه به «正在下载 / 正在安装» (در حال دانلود / در حال نصب) تبدیل می‌شود و پس از پایان به «打开» (باز کردن)؛ در منوی شروع هم `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) و دکمه رد کردن ندارد](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/03-first-launch.webp)


اگر درست پیش بروید این را می‌بینید: کارتی که فقط دکمه‌های ورود دارد، عنوانش `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 و دکمه بازگشت](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/04-login-api-key.webp)


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




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

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

```powershell
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)](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/05-run-script.webp)


اگر درست پیش بروید این را می‌بینید: بنر `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)](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/06-choose-domain.webp)


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




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

از [داشبورد](https://qcode.cc/fa/dashboard) رشته‌ای را که با `cr_` شروع می‌شود کپی کنید، به پنجره برگردید و در ① بعد از `API 密钥:` (کلید API:) بچسبانید و Enter بزنید.

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

![اسکریپت می‌خواهد کلید API را بچسبانید (1)؛ پس از چسباندن چیزی نمایش داده نمی‌شود و Enter فقط `已读取密钥: cr_****` و چهار رقم آخر را نشان می‌دهد (2)](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/07-enter-key.webp)


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


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

اگر هنوز حساب QCode ندارید، ابتدا [ثبت‌نام کنید](https://qcode.cc/fa/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-codex-desktop-key). اگر می‌خواهید به‌ازای مصرف پرداخت کنید، ابتدا یک [بسته پرداخت به‌ازای مصرف](https://qcode.cc/fa/pay-as-you-go?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-codex-desktop-key) بخرید و سپس در [داشبورد](https://qcode.cc/fa/dashboard) کلید بسازید. کلید ساخته‌شده را که با `cr_` شروع می‌شود کامل کپی کنید و بالا بچسبانید. می‌توانید با کارت اعتباری / نقدی (Visa / Mastercard)، یا Apple Pay / Google Pay، یا رمزارز پرداخت کنید — به [روش‌های پرداخت](/docs/reference/payment-methods) مراجعه کنید.




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

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

![اسکریپت می‌پرسد در کدام کلاینت Codex استفاده می‌کنید (1)؛ نخستین مورد `1) Codex 桌面版 App` (اپ دسکتاپ Codex) است که فقط فایل پیکربندی را می‌نویسد (2)](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/08-choose-client.webp)


اگر درست پیش بروید این را می‌بینید: دو خط گزینه — `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 بزنید تا انتخاب شود](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/09-choose-model.webp)


اگر درست پیش بروید این را می‌بینید: چند خط مدل که با `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)](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/10-write-config.webp)


اگر درست پیش بروید این را می‌بینید: `已写入 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)](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/11-config-ok.webp)


اگر درست پیش بروید این را می‌بینید: هر سه خط `[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)](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/13-onboarding.webp)


اگر درست پیش بروید این را می‌بینید: کارت پرسشنامه، بدون `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)](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/14-main-model.webp)


اگر درست پیش بروید این را می‌بینید: حالت بالا-چپ `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)](https://docs.qcode.cc/static/images/tut/codex-desktop/202611/zh/15-first-reply.webp)


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




## بررسی موفقیت

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

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


### تمام شد

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

- [آموزش کامل Codex CLI](/docs/ide/codex)
- [آموزش کامل Claude Code](/docs/getting-started/claude-code-tutorial)
- [مقایسه Codex و Claude Code](/docs/getting-started/codex-vs-claude-code)
- [نقاط پایانی و قالب API](/docs/getting-started/endpoints-and-api-paths)
- و بعد: در [صفحه قیمت‌ها](https://qcode.cc/fa/pricing?utm_source=docs.qcode.cc&utm_medium=tut_done&utm_campaign=knowledge_base&src=docs-ide-codex-desktop-done) پلن‌ها را مقایسه کنید و مناسب استفاده بلندمدت را انتخاب کنید
- به [داشبورد](https://qcode.cc/fa/dashboard) برگردید و مصرف و موجودی را ببینید


## خطاهای رایج

| متن خطا | علت | چه کار کنید |
|---|---|---|
| `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](/docs/ide/codex) است.

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

برنامه پیکربندی را فقط یک‌بار هنگام راه‌اندازی می‌خواند. پس از تغییر `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 را چند دور خودگردان می‌گذارید، مصرف یک کار ممکن است بیشتر شود؛ می‌توانید در [داشبورد](https://qcode.cc/fa/dashboard) مصرف و موجودی را ببینید.

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

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

### ساخت config.toml

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

```powershell
mkdir $HOME\.codex
```

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

```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` باشد و گیومه و دونقطه هر دو نیم‌عرض انگلیسی:

```json
{
  "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` را نادیده می‌گیرد.

```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"
env_key = "QCODE_API_KEY"
```

```powershell
# تنظیم موقت (همین نشست)
$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](https://github.com/openai/codex) |