Codex CLI روی سرور ابری: نصب، پیکربندی و اجرا در پس‌زمینه
Codex CLI را می‌توان روی سرور ابری QCode نصب کرد: با tmux یا systemd در پس‌زمینه، پس از قطع اتصال SSH به اجرا ادامه می‌دهد. اسکریپت تکدستوری بهطور پیشفرض فقط پیکربندی را مینویسد، بنابراین روی سرور Codex CLI را انتخاب کنید.
بهروزرسانی شده 2026-11-14
این ابزار را به نقطه پایانی QCode متصل کنید — یک کلید برای Claude، GPT و مدلهای چینی.
- صورتحساب به‌ازای توکن — نرخ‌های زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- بهصورت خودخدمت: شارژ حساب و فعال‌سازی فوری
چهار نکته: پیکربندی، کلید، پروتکل، غیرتعاملی
کلیدهای سطح بالا بههمراه جدول ارائهدهنده
سطح بالا سه کلید را در خود دارد: model_provider، model و model_reasoning_effort؛ base_url، wire_api و requires_openai_auth باید داخل جدول [model_providers.qcode] قرار بگیرند و این دو سطح را نمی‌توان با هم اشتباه گرفت.
یکی را انتخاب کنید
با requires_openai_auth = true، کلید از OPENAI_API_KEY در ~/.codex/auth.json خوانده میشود؛ برای استفاده از متغیر محیطی به‌جای آن، آن خط را با env_key = "QCODE_API_KEY" جایگزین کنید و آن را export کنید. مستندات رسمی OpenAI بیان میکند که Codex وقتی requires_openai_auth = true است، env_key را نادیده می‌گیرد.
فیلد پروتکل ثابت است
Codex از پروتکل Responses استفاده میکند، بنابراین wire_api روی responses تنظیم میشود، و مرجع رسمی پیکربندی Codex در OpenAI بیان میکند که این فیلد در حال حاضر فقط از responses پشتیبانی میکند و در صورت حذف، بهطور پیشفرض responses است.
اجراهای غیرتعاملی
codex exec --sandbox workspace-write کارهای دستهای را روی سرور اجرا میکند: بهصورت غیرتعاملی کار میکند، نتیجه را در خروجی استاندارد چاپ میکند و تغییرات را داخل فضای کاری نگه میدارد.
آیا Codex CLI میتواند روی سرور ابری اجرا شود؟
تا 2026-10-19، بله. سرور ابری QCode ماشینی است که خودتان آن را مدیریت می‌کنید، با 1 IPv4 عمومی اختصاصی، KVM و دسترسی کامل root، و معمولاً ظرف چند دقیقه آماده میشود؛ کنسول در حال حاضر به زبان‌های چینی و انگلیسی در دسترس است، و پس از نصب Codex CLI، فراخوانی‌های مدل با کلید QCode شما از طریق نقطه پایانی QCode انجام می‌شوند. سرورهای ابری و سرویس‌های هوش مصنوعی جداگانه فروخته می‌شوند، بنابراین لازم نیست ابتدا یک پلن شخصی بخرید؛ Codex مدل‌ها را با کلید داشبورد QCode شما فراخوانی میکند، و شما در حساب کاربری QCode خود یک پلن انتخاب می‌کنید تا آن کلید را دریافت کنید.
مستندات رسمی و وضعیت ابزار (بررسی‌شده در 2026-10-19)
تا 2026-10-19، شروع سریع Codex در docs.qcode.cc مسیر Responses را توصیف میکند، و کلید با cr_ شروع میشود و در OPENAI_API_KEY واقع در ~/.codex/auth.json قرار می‌گیرد.
سه تاریخ در خط زمانی
تاریخ انتشار GPT-6 Sol بهروزشده (gpt-6.1-sol)؛ شروع سریع Codex در QCode آن را به‌عنوان مدل پیشفرض پیشنهادی فهرست میکند.
انتشار Codex CLI v0.162.1، آخرین نسخه پایدار، همانطور که در راهنمای Codex در QCode ثبت شده است.
راهنمای Codex در QCode در این روز بهروزرسانی شد و تنظیمات پیکربندی، پارامترهای تأیید و sandbox و روش‌های نصب مجدداً بررسی شدند؛ این تاریخ بازنگری مستندات است، نه انتشار Codex.
تأییدشده در مقابل منتشرنشده
تأییدشده (قابل بررسی در منبع)
موارد مرتبط با Codex را می‌توان در منبع بررسی کرد: (1) نقطه پایانی، کلید و دو سطح پیکربندی در بخش اجرای Codex روی سرور در بالا توصیف شده‌اند؛ (2) مدل پیشنهادی gpt-6.1-sol است و می‌توان میزان تلاش استدلال را با model_reasoning_effort = "high" تنظیم کرد؛ (3) codex exec --sandbox workspace-write بهصورت غیرتعاملی اجرا میشود، نتیجه را در خروجی استاندارد چاپ میکند و تغییرات را داخل فضای کاری نگه میدارد. قواعد دوره آزمایشی، بازپرداخت و تمدید سرور ابری در qcode.cc/en/cloud آمده است.
منتشرنشده یا تأییدنشده
qcode.cc/en/cloud ارقام پهنای باند یا تأخیر را برای خطوط منتشر نمی‌کند، و قیمت‌های شروع با موجودی‌های جدید و اندازه‌ها تغییر می‌کنند، بنابراین مقایسه خطوط مرجع است. شما میتوانید اندازه را بهصورت آنلاین ارتقا دهید و فقط تا تاریخ انقضا تفاوت را بپردازید، اما کاهش اندازه و انتقال به منطقه یا خط دیگر در دسترس نیست.
اجرای محلی در مقابل اجرا در پس‌زمینه روی سرور
پیکربندی همراه شماست
config.toml و کلید روی ماشین خودتان قرار دارند، بنابراین وقتی آن ماشین از دسترس خارج شود، Codex هم با آن از دسترس خارج میشود. مناسب برای کارهای کوتاه و ویرایش تعاملی.
ماشین متعلق به شماست و شما فرایند را زنده نگه می‌دارید
با tmux یا systemd، Codex پس از بستن لپ‌تاپ شما در پس‌زمینه به اجرا ادامه می‌دهد (به پرسش‌های متداول مراجعه کنید)؛ در داشبورد میتوانید وضعیت را بررسی کنید و سرور را شروع، متوقف، راهاندازی مجدد و تمدید کنید. مناسب برای کارهای طولانی و کارهای پس‌زمینه.
راهاندازی Codex روی سرور
ابتدا منطقه، خط، مدت و اندازه را در qcode.cc/en/cloud انتخاب کنید؛ قیمت‌های شروع در مقایسه خطوط آمده است. دوم، با اطلاعات اتصال داشبورد وارد شوید: ssh root@ بههمراه IP سرور، با استفاده از گذرواژه root که هنگام سفارش تعیین کرده‌اید (یا کلید خصوصی‌ای که با کلید عمومی SSH افزوده‌شده شما مطابقت دارد). سوم، نصب‌کننده تکدستوری را روی سرور اجرا کنید: curl -fsSL https://qcode.cc/install/codex.sh | bash -s -- --lang en --target cli، و پیام‌های اسکریپت به انگلیسی است؛ مستندات می‌گوید نقاط پایانی api، asia و us را اندازه‌گیری میکند و سریع‌ترین را پیشنهاد می‌دهد، از شما می‌خواهد کلید دارای پیشوند cr_ را جای‌گذاری کنید، فایل پیکربندی ~/.codex را مینویسد و اتصال را بررسی میکند. ابتدا میپرسد که اپ دسکتاپ میخواهید یا CLI، و اپ دسکتاپ پیشفرض فقط پیکربندی را مینویسد و Node.js یا CLI را نصب نمی‌کند، بنابراین روی سرور Codex CLI را انتخاب کنید. چهارم، برای پیکربندی دستی، model_provider = "qcode"، model = "gpt-6.1-sol" و model_reasoning_effort = "high" را در بالای ~/.codex/config.toml قرار دهید، سپس جدول [model_providers.qcode] را با name = "qcode"، base_url = "https://api.qcode.cc/openai"، wire_api = "responses" و requires_openai_auth = true اضافه کنید (نام ارائهدهنده را خودتان انتخاب می‌کنید، تا زمانی که با نام جدول مطابقت داشته باشد؛ مثال مستندات از qcode استفاده میکند). پنجم، کلید دارای پیشوند cr_ را در OPENAI_API_KEY در ~/.codex/auth.json قرار دهید؛ کلید از داشبورد QCode شما می‌آید. برای استفاده از متغیر محیطی به‌جای آن، requires_openai_auth = true را در جدول با env_key = "QCODE_API_KEY" جایگزین کنید و آن متغیر را export کنید؛ این دو حالت متقابلاً انحصاری‌اند. ششم، با codex --version بررسی کنید و سپس یک prompt تک‌خطی hello-world اجرا کنید.
نحوه اتصال در QCode
روی سرور، Codex با نقطه پایانی QCode ارتباط برقرار میکند؛ پیکربندی کامل در بخش راهاندازی Codex روی سرور در بالا آمده است. مدلهای GPT در دسترس از طریق QCode عبارتاند از gpt-6.1-sol، gpt-6-sol، gpt-6-astra، gpt-5.6-sol و gpt-5.6-terra؛ درخواست‌ها به‌ازای هر توکن صورتحساب می‌شوند و نرخ‌های هر مدل در /models فهرست شده‌اند؛ سرورهای ابری و سرویس‌های هوش مصنوعی یک موجودی حساب کاربری مشترک دارند. برای پلن ماهانه آماده نیستید؟ بسته‌های پرداخت به‌ازای مصرف از $4 برای یک سهمیه یک‌باره شروع می‌شوند که آن را ظرف 7 روز مصرف می‌کنید (شارژ حساب از $5 شروع میشود).
پرسش‌های متداول
چگونه میتوانم Codex را بهصورت غیرتعاملی روی سرور اجرا کنم؟
از codex exec استفاده کنید: بهصورت غیرتعاملی اجرا میشود و نتیجه را در خروجی استاندارد چاپ میکند (برای JSONL، --json را اضافه کنید)، برای مثال codex exec --sandbox workspace-write. sandbox به workspace محدود است و به سیستم بیرون از آن دست نمیزند، که برای یکپارچهسازی CI/CD و کارهای دستهای مناسب است.
چگونه پرداخت کنم و چگونه سفارش دهم؟
میتوانید با Alipay، WeChat، کارت بانکی یا ارز دیجیتال پرداخت کنید. منطقه، خط، مدت و اندازه را انتخاب کنید و سپس سفارش دهید؛ سرور معمولاً ظرف چند دقیقه آماده میشود. اگر راهاندازی ناموفق باشد یا سرور ظرف 2 ساعت پس از سفارش تحویل داده نشود، کل مبلغ به موجودی حساب شما بازمیگردد. اسپم، DDoS، اسکن، استخراج رمزارز و محتوای غیرقانونی ممنوع است؛ ما سرور را فوراً خاموش میکنیم و مبلغ پرداختشده بازپرداخت نمیشود.
از کدام مدل باید روی سرور استفاده کنم؟
مدل پیشفرض توصیهشده در مستندات gpt-6.1-sol است (GPT-6 Sol بهروزشده)، و میتوانید بهطور موقت با codex --model gpt-6.1-sol تغییر دهید؛ سایر مدلهای GPT در دسترس از طریق QCode عبارتاند از gpt-6-sol، gpt-6-astra، gpt-5.6-sol و gpt-5.6-terra، و فهرست کامل در qcode.cc/models است.
دوره آزمایشی چگونه صورتحساب میشود و آیا پس از ثبتنام میتوانم بازپرداخت بگیرم؟
دوره آزمایشی پرداختی است: 1 روز (24 ساعت) طول میکشد و قیمت به اندازه بستگی دارد؛ پس از پایان آن، سرور حذف میشود و دادهها نگهداری نمیشوند. در طول دوره آزمایشی میتوانید با انتخاب 1، 3، 6 یا 12 ماه از پنل آن را نگه دارید، و هر حساب کاربری در هر زمان فقط میتواند یک سرور آزمایشی داشته باشد. پس از راهاندازی سرور، بازپرداختی وجود ندارد.
اسکریپت تکدستوری و config.toml دستنویس چه ارتباطی با هم دارند؟
بهطور پیشفرض، اسکریپت فقط پیکربندی را مینویسد: هنگام اجرا ابتدا میپرسد که اپ دسکتاپ میخواهید یا CLI، و Node.js و CLI را فقط زمانی نصب میکند که Codex CLI را انتخاب کنید. اگر ~/.codex/config.toml از قبل وجود داشته باشد، اسکریپت فقط model_provider، model، review_model و model_reasoning_effort بههمراه جدول ارائهدهنده را بهروزرسانی میکند، سرور MCP، profile و approval_policy موجود شما را همانطور که هستند نگه میدارد، و پیش از نوشتن، یک نسخه .bak دارای برچسب زمان از فایل در همان پوشه ذخیره میکند؛ فقط زمانی کل فایل را بازنویسی میکند که فایل اصلی نتواند بهصورت ایمن ادغام شود، و این را اعلام میکند.
چگونه Codex را پس از قطع شدن اتصال SSH روی سرور در حال اجرا نگه دارم؟
برای اینکه فرآیند پس از قطع شدن SSH همچنان اجرا شود، روش معمول قرار دادن Codex در یک نشست tmux یا نوشتن آن به‌عنوان یک سرویس systemd است؛ این یک رویه عمومی Linux است، نه ویژگی QCode یا OpenAI. میتوانید وضعیت ماشین را در داشبورد بررسی کنید و آن را از همان‌جا روشن، متوقف، راهاندازی مجدد و تمدید کنید.
منابع دست‌اول
صفحه سرور ابری QCode (qcode.cc/en/cloud، دریافت و بررسی‌شده در 2026-10-19): مناطق و خطوط، IPv4 و دسترسی مدیریتی کامل، آزمایش و شرایط، قواعد بازپرداخت، عملکردهای داشبورد، کاربردهای ممنوع، روش‌های پرداخت و نصب با یک فرمان. شروع سریع Codex در docs.qcode.cc (دریافت و بررسی‌شده در 2026-10-19): ارائهدهنده، env_key و auth.json در config.toml، مدلهای موجود و پارامترهای sandbox. راهنمای Codex در QCode (دریافت و بررسی‌شده در 2026-10-19): نسخه و تاریخ انتشار Codex CLI، تنظیمات config، پارامترهای تأیید و sandbox. راهنمای نصب یک‌کلیکی در docs.qcode.cc (دریافت و بررسی‌شده در 2026-10-19): تست سرعت نقطه پایانی، دو هدف (اپلیکیشن دسکتاپ و CLI)، رفتار نوشتن و پشتیبان‌گیری. صفحه‌های رسمی OpenAI Codex درباره احراز هویت و مرجع پیکربندی (دریافت و بررسی‌شده در 2026-10-19): نحوه خواندن کلید و مقادیر مجاز فیلد protocol.
همین حالا یکی را باز کنید
یک ماشین که خودتان مدیریت می‌کنید، با Codex CLI که مدلهای GPT مانند gpt-6.1-sol را از طریق نقطه پایانی QCode فراخوانی میکند؛ درخواست‌ها به‌ازای هر توکن محاسبه می‌شوند.
صفحه‌های مرتبط
بسته‌های پرداخت به‌ازای مصرف
بدون اشتراک: یک بار خرید سهمیه که ظرف 7 روز مصرف میشود.
راهنمای کامل Codex CLI
از نصب تا تنظیمات چندمدلی و پروکسی، پیکربندی کامل Codex CLI در یک مطالعه.
راهنمای پیکربندی API شخص ثالث برای Codex CLI
ساختار config.toml و خطاهای رایج هنگام اتصال Codex به API شخص ثالث.
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
محتوا در 2026-10-19 با صفحه‌های زنده qcode.cc/en/cloud و docs.qcode.cc بررسی شد؛ با بهروزرسانی آن صفحه‌ها، ممکن است محتوا بدون اطلاع بیشتر تغییر کند. در دسترس بودن مدل‌ها همان چیزی است که /models نشان می‌دهد.