इंस्टॉलेशन और लॉगिन (Mac / Windows / Linux)

📚 सीरीज नेविगेशन: पिछला लेख 02 · मुख्य अवधारणाओं का त्वरित अवलोकन Codex के कुछ मुख्य शब्दों (एजेंट, सैंडबॉक्स, अनुमोदन, स्थानीय / क्लाउड) को स्पष्ट करता है। यह लेख आपको इसे अपने कंप्यूटर पर वास्तव में इंस्टॉल करना सिखाएगा—डेस्कटॉप ऐप और CLI दोनों प्रक्रियाओं को कवर करते हुए, लॉगिन प्रमाणीकरण, तीनों प्लेटफॉर्म्स के अंतर और सामान्य इंस्टॉलेशन समस्याओं की चरण-दर-चरण व्याख्या। अगला लेख 04 · सदस्यता और शुल्क पैसों से संबंधित विषय पर है।

OpenAI ने 2026 की शुरुआत में Codex को चार प्रवेश द्वारों में विभाजित किया: वेब संस्करण, डेस्कटॉप ऐप, CLI, और IDE एक्सटेंशन। मैंने खुद इसे CLI से लेकर डेस्कटॉप ऐप तक उपयोग किया है, और मेरा अनुभव यह है कि—किसे इंस्टॉल करना है और कैसे इंस्टॉल करना है, इस बारे में आधिकारिक दस्तावेज़ और पुराने ट्यूटोरियल्स अक्सर आपस में मेल नहीं खाते।

वास्तव में, Codex इंस्टॉल करना मुश्किल नहीं है, मुश्किल यह है कि कोई आपको यह नहीं बताता कि कौन सा तरीका आधिकारिक रूप से सही है और कौन सा पुराना हो चुका है। यह लेख प्रत्येक प्लेटफॉर्म और प्रत्येक इंस्टॉलेशन के सही तरीके को स्पष्ट करेगा, ताकि आप वैसी गलतियाँ न करें जैसी मेरे दोस्तों ने कीं।

इस लेख को पढ़ने के बाद, आपको मिलेगा:

• डेस्कटॉप ऐप और CLI दोनों इंस्टॉलेशन प्रक्रियाओं की जानकारी, और यह जानना कि Mac / Windows / Linux पर इन्हें कैसे चलाया जाए (अपेक्षित आउटपुट के साथ, ताकि आप इंस्टॉलेशन की पुष्टि कर सकें)
• CLI को इंस्टॉल करने के तीन तरीकों (आधिकारिक स्क्रिप्ट / Homebrew / npm) की तुलना, ताकि आप अपने लिए सही तरीका चुन सकें
• दो लॉगिन तरीकों (ChatGPT अकाउंट / API key) का अंतर, और रिमोट या सर्वर वातावरण में लॉगिन की समस्या का मानक समाधान
• एरर्स और सुधारों की एक त्वरित तालिका, जो नए उपयोगकर्ताओं के सामने आने वाली अधिकांश समस्याओं को हल करेगी

---

01 इंस्टॉल करने से पहले तीन बातें समझ लें

जल्दबाजी में कमांड्स न चलाएं। कई लोग इंस्टॉल करने के बाद महसूस करते हैं कि "इस प्लेटफॉर्म पर कोई डेस्कटॉप संस्करण नहीं है" या "इस अकाउंट में MFA सक्षम होना चाहिए"। तीन चीजें पहले चेक कर लें।

पहली बात: आप इसे कहाँ से उपयोग करना चाहते हैं

Codex के चार प्रवेश द्वार हैं, लेकिन इंस्टॉलेशन के लिए आपको दो मुख्य रास्तों में से एक को चुनना होगा:

• डेस्कटॉप ऐप: ग्राफिकल इंटरफ़ेस, उपयोग करने में आसान, उन लोगों के लिए उपयुक्त जो टर्मिनल का उपयोग नहीं करना चाहते। लेकिन यह केवल macOS और Windows पर उपलब्ध है, Linux पर अभी नहीं है (आधिकारिक तौर पर इसके लिए एक वेटिंग लिस्ट दी गई है)।
• CLI (कमांड लाइन): टर्मिनल में चलने वाला कोडिंग एजेंट, तीनों प्लेटफॉर्म्स पर समर्थित है, और डेवलपर्स द्वारा सबसे अधिक उपयोग किया जाता है।

मेरा सुझाव: डेवलपर्स सीधे CLI को समझें, यह सबसे अधिक उपयोगी और क्रॉस-प्लेटफॉर्म है। यह लेख मुख्य रूप से CLI पर केंद्रित है, और डेस्कटॉप ऐप के लिए एक अलग भाग दिया गया है। आप किसी को भी इंस्टॉल कर सकते हैं—लॉगिन की स्थिति CLI और IDE एक्सटेंशन के बीच साझा होती है (डेस्कटॉप ऐप में अलग से लॉगिन होता है, जैसा कि भाग 06 में बताया गया है)।

दूसरी बात: आपके पास एक चालू अकाउंट होना चाहिए

नए उपयोगकर्ता अक्सर इसे अनदेखा करते हैं: Codex, ChatGPT प्लान के साथ काम करता है।

आधिकारिक नियमों के अनुसार, ChatGPT के Plus, Pro, Business, Edu, Enterprise प्लान्स में Codex का उपयोग शामिल है। आप बिना प्लान के OpenAI API key का उपयोग करके भी भुगतान कर सकते हैं—लेकिन API key से लॉगिन करने पर ChatGPT वर्कस्पेस की कुछ सुविधाएं सीमित या अनुपलब्ध हो सकती हैं (जैसे क्लाउड Codex के लिए ChatGPT लॉगिन अनिवार्य है)।

स्थानीय CLI को API key के साथ चलाना संभव है, OpenAI आपके Platform अकाउंट से स्टैंडर्ड एपीआई रेट के अनुसार शुल्क लेगा, जो प्लान की सीमा से अलग है।

प्लान और शुल्कों का विवरण अगले लेख 04 · सदस्यता और शुल्क में दिया गया है। इस लेख में हम मानकर चल रहे हैं कि आपके पास एक चालू ChatGPT प्लान या API key है।

तीसरी बात: इंटरनेट OpenAI से जुड़ने योग्य होना चाहिए

Codex के सभी प्रवेश द्वारों को इंटरनेट की आवश्यकता होती है, और यह सीधे OpenAI के सर्वर से जुड़ता है। कई बार नेटवर्क समस्याओं के कारण chatgpt.com और platform.openai.com से जुड़ने के लिए प्रॉक्सी का उपयोग करना पड़ता है, इंस्टॉलेशन, लॉगिन और दैनिक उपयोग के दौरान इसका ध्यान रखें, अन्यथा "डाउनलोड टाइमआउट" या "लॉगिन विफलता" जैसी एरर आ सकती हैं।

💡 संक्षेप में: इंस्टॉलेशन से पहले तीन चीजें चेक करें—CLI चुनें (क्रॉस-प्लेटफॉर्म), ChatGPT प्लान या API key चालू हो, और नेटवर्क OpenAI से सही जुड़ रहा हो। इसके बाद ही कमांड चलाएं।

---

02 रास्ता 1: डेस्कटॉप ऐप (Mac / Windows)

जो लोग टर्मिनल का उपयोग नहीं करना चाहते, उनके लिए डेस्कटॉप ऐप से शुरुआत करना सबसे आसान है।

सादृश्य: डेस्कटॉप ऐप एक ऐसा ChatGPT है जो आपके प्रोजेक्ट फोल्डर से जुड़ा है। आप सामान्य चैट की तरह ही बात करते हैं; अंतर यह है कि यह आपके कंप्यूटर पर मौजूद एक फोल्डर से जुड़ सकता है, फ़ाइलें पढ़ सकता है, कोड बदल सकता है और कमांड चला सकता है—यानी यह चैट, प्रोजेक्ट डायरेक्टरी और मेमोरी को एक साथ जोड़ता है।

वास्तविक उपयोग:

• आप प्रोडक्ट डिज़ाइनर हैं, कोड नहीं लिखते लेकिन AI से बदलाव करवाना चाहते हैं या यह देखना चाहते हैं कि कोई सुविधा कैसे लागू की गई है।
• आप एक साथ कई प्रोजेक्ट्स पर काम करना चाहते हैं—प्रोजेक्ट A में टेस्ट चलाते समय प्रोजेक्ट B में निर्देश देना।
• आप ग्राफिकल इंटरफ़ेस में देखना चाहते हैं कि उसने क्या बदला है, और फिर उसे स्वीकार करना चाहते हैं।

डाउनलोड और इंस्टॉलेशन

https://chatgpt.com/codex पर जाएं और अपने प्लेटफॉर्म के अनुसार पैकेज डाउनलोड करें:

प्लेटफॉर्म	पैकेज कैसे चुनें
macOS (Apple Silicon)	सीधे डिफ़ॉल्ट पैकेज डाउनलोड करें
macOS (Intel चिप)	Intel build चुनें, गलत न करें
Windows	आधिकारिक इंस्टॉलेशन पैकेज डाउनलोड करें
Linux	अभी डेस्कटॉप ऐप नहीं है, प्रतीक्षा सूची में नाम लिखवाएं; पहले CLI का उपयोग करें

Mac उपयोगकर्ताओं को यदि संदेह हो कि उनके पास Intel है या Apple Silicon: स्क्रीन के बाईं ओर सेब के आइकन पर क्लिक करें → "About This Mac", यदि चिप में Apple M श्रृंखला लिखी है तो वह Apple Silicon है, और यदि Intel लिखा है तो Intel build डाउनलोड करें। गलत चिप वाला पैकेज इंस्टॉल नहीं होगा या क्रैश हो जाएगा।

पहला लॉगिन और प्रोजेक्ट चुनना

ऐप इंस्टॉल करने के बाद इन तीन चरणों का पालन करें:

1. लॉगिन: ChatGPT अकाउंट या OpenAI API key से लॉगिन करें (API key लॉगिन में कुछ सीमाएं हैं, जैसा कि अगले भाग में बताया गया है)।
2. प्रोजेक्ट चुनें: वह फोल्डर चुनें जिसमें आप Codex से काम करवाना चाहते हैं। यदि आपने पहले ऐप, CLI या IDE एक्सटेंशन का उपयोग किया है, तो पुरानी सूची दिखाई देगी।
3. पहला संदेश भेजें: प्रोजेक्ट चुनने के बाद, पुष्टि करें कि नीचे बाईं ओर Local चुना गया है (ताकि वह क्लाउड के बजाय आपके कंप्यूटर पर काम करे), और इनपुट बॉक्स में अपना निर्देश लिखें।

शुरुआत में जटिल सुविधाओं पर ध्यान देने के बजाय, "बातचीत" और "प्रोजेक्ट" पर ध्यान केंद्रित करें: बातचीत सामान्य चैट की तरह होती है; और प्रोजेक्ट आपके कंप्यूटर के एक फोल्डर से बंधा होता है जिसके बाहर Codex काम नहीं कर सकता।

इंस्टॉलेशन के बाद नीचे बाईं ओर "Settings → General → Language" में जाकर भाषा बदली जा सकती है (ऐप भाषा को खुद पहचान लेता है)। राइट बार और बॉटम बार को ऊपर दाईं ओर दिए गए आइकन से खोला जा सकता है। इंटरफ़ेस कुछ ऐसा दिखता है:

💡 संक्षेप में: डेस्कटॉप ऐप केवल Mac और Windows पर उपलब्ध है, Mac उपयोगकर्ता Intel / Apple Silicon पैकेजेस का ध्यान रखें; इसे चलाने के लिए बस तीन कदम हैं—लॉगिन करना, प्रोजेक्ट फोल्डर चुनना, और Local की पुष्टि करके संदेश भेजना।

---

03 रास्ता 2: CLI (तीनों प्लेटफॉर्म्स के लिए एक कमांड)

पहले निष्कर्ष देखते हैं: सभी प्लेटफॉर्म्स पर आधिकारिक इंस्टॉलेशन स्क्रिप्ट का उपयोग करना सबसे अच्छा है (standalone installer)। यह Node.js पर निर्भर नहीं करता, एक स्वतंत्र बाइनरी के रूप में चलता है और पूरी तरह सुरक्षित है।

सादृश्य: आधिकारिक स्क्रिप्ट एक ऐप स्टोर से वन-क्लिक इंस्टॉलेशन की तरह है। एक बार क्लिक करने पर यह खुद डाउनलोड होता है, सही स्थान पर सेट होता है और आपके सिस्टम की अन्य चीजों को प्रभावित नहीं करता; जबकि पुराना npm तरीका पहले एक पैकेज मैनेजर को इंस्टॉल करने और फिर ऐप इंस्टॉल करने जैसा था—जिसमें निर्भरताएँ अधिक थीं और समस्याओं की संभावना भी।

macOS / Linux

टर्मिनल खोलें और यह कमांड चलाएं:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

नेटवर्क नोट: प्रॉक्सी के उपयोग से डाउनलोड सुचारू रूप से पूरा होगा।

यदि आप ऑटोमेशन स्क्रिप्ट या CI/CD के लिए बिना किसी प्रॉम्प्ट के इसे इंस्टॉल करना चाहते हैं, तो पर्यावरण चर (environment variable) का उपयोग करें:

curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_NON_INTERACTIVE=1 sh

Windows (नेटिव, बिना WSL के)

PowerShell में यह कमांड चलाएं (कमांड प्रॉम्प्ट PS C:\> होना चाहिए):

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

ऑटोमेशन स्क्रिप्ट (CI) के लिए:

$env:CODEX_NON_INTERACTIVE=1; irm https://chatgpt.com/codex/install.ps1 | iex

यहाँ -ExecutionPolicy ByPass स्क्रिप्ट चलाने के लिए एक अस्थायी अनुमति प्रदान करता है और आपके सिस्टम की नीति को हमेशा के लिए नहीं बदलता; irm स्क्रिप्ट को डाउनलोड करता है और iex उसे रन करता है। यदि irm is not recognized दिखाई देता है, तो आप सामान्य CMD का उपयोग कर रहे हैं, PowerShell का उपयोग करें।

अन्य विकल्प: Homebrew / npm

आधिकारिक स्क्रिप्ट के अलावा दो अन्य तरीके भी हैं, जिनकी तुलना नीचे दी गई है:

इंस्टॉलेशन विधि	कमांड	आवश्यकता	सुझाव
आधिकारिक स्क्रिप्ट	curl ... | sh (विंडोज़ के लिए irm)	कोई नहीं	सर्वश्रेष्ठ विकल्प, बाइनरी फाइल, सिस्टम से स्वतंत्र
Homebrew (Mac)	brew install --cask codex	Homebrew इंस्टॉल होना चाहिए	जो लोग अपने मैक पर सॉफ्टवेयर प्रबंधित करने के लिए Brew का उपयोग करते हैं; अपडेट थोड़े बाद में आते हैं
npm	npm install -g @openai/codex	Node.js इंस्टॉल होना चाहिए	जो लोग npm के साथ वैश्विक टूल इंस्टॉल करने के अभ्यस्त हैं

Homebrew में अपडेट आधिकारिक रूप से जारी होने के एक या दो दिन बाद आते हैं क्योंकि इसके लिए Cask टीम की समीक्षा आवश्यक होती है; लेकिन यह उन लोगों के लिए अधिक स्थिर हो सकता है जो हर दिन नए अपडेट्स नहीं चाहते।

Homebrew (macOS):

brew install --cask codex

npm (किसी भी प्लेटफॉर्म पर, Node.js होना चाहिए):

npm install -g @openai/codex

कुछ बातों का ध्यान रखें:

• npm कमांड के लिए sudo का उपयोग करना है या नहीं, यह आपके Node वातावरण पर निर्भर करता है। कई पुराने ट्यूटोरियल्स में sudo npm install -g लिखा होता है, लेकिन sudo का उपयोग अनुमतियों से संबंधित जटिलताएँ पैदा कर सकता है। मेरा सुझाव: nvm या Volta का उपयोग करके Node को यूजर डायरेक्टरी में इंस्टॉल करें, जिससे sudo की आवश्यकता नहीं होगी; यदि अनुमतियों की एरर आती है, तो npm के बजाय सीधे आधिकारिक स्क्रिप्ट का उपयोग करें।
• Homebrew के लिए --cask लिखना न भूलें और पैकेज का नाम सही लिखें जो कि codex है।

💡 संक्षेप में: CLI के लिए आधिकारिक स्क्रिप्ट सबसे अच्छी है, Mac/Linux के लिए curl ... | sh और Windows के लिए irm का उपयोग करें, यह Node पर निर्भर नहीं करती; Homebrew और npm विकल्प के रूप में हैं।

नीचे दिया गया आरेख दोनों इंस्टॉलेशन प्रक्रियाओं की तुलना दिखाता है:

यह आरेख दिखाता है: डेस्कटॉप ऐप के लिए पैकेज डाउनलोड करके इंस्टॉल किया जाता है और ऐप में लॉगिन किया जाता है; CLI के लिए इंस्टॉलेशन के बाद codex login चलाया जाता है। दोनों ही तरीकों में लॉगिन के लिए ChatGPT अकाउंट या API key का उपयोग किया जा सकता है।

---

04 Windows उपयोगकर्ता: नेटिव या WSL?

Windows पर Codex का उपयोग करते समय कुछ विशेष बातों का ध्यान रखना होता है, जिनके बारे में यहाँ बताया गया है।

आधिकारिक तौर पर इसके तीन उपयोग तरीके हैं:

• नेटिव Windows + elevated सैंडबॉक्स: अनुशंसित। यह एक विशेष कम-अनुमति वाले सैंडबॉक्स उपयोगकर्ता, फ़ाइल सिस्टम सीमा और फ़ायरवॉल नियमों का उपयोग करके Codex को प्रोजेक्ट डायरेक्टरी में सुरक्षित रखता है, जिससे सुरक्षा सबसे अधिक रहती है।
• नेटिव Windows + unelevated सैंडबॉक्स: विकल्प। जब कॉर्पोरेट नीतियों के कारण आप एडमिनिस्ट्रेटर स्तर पर elevated कॉन्फ़िगरेशन नहीं कर पाते, तब इसका उपयोग करें। यह थोड़ा कम सुरक्षित है लेकिन बुनियादी सुरक्षा प्रदान करता है।
• WSL2 (Windows Subsystem for Linux): लिनक्स वातावरण में चलता है और लिनक्स सैंडबॉक्स का उपयोग करता है। जब आपको लिनक्स टूलचेन की आवश्यकता हो या आपके प्रोजेक्ट्स पहले से WSL2 में हों, तब इसे चुनें।

तुलना तालिका:

तरीका	आवश्यकता	कब उपयोग करें
नेटिव + elevated	एडमिनिस्ट्रेटर द्वारा अनुमत सैंडबॉक्स कॉन्फ़िगरेशन	डिफ़ॉल्ट रूप से सर्वश्रेष्ठ, प्रदर्शन और सुरक्षा में सबसे आगे
नेटिव + unelevated	एडमिनिस्ट्रेटर अनुमति की आवश्यकता नहीं	जब elevated मोड कॉर्पोरेट नीतियों के कारण ब्लॉक हो
WSL2	WSL2 सक्रिय होना चाहिए	लिनक्स वातावरण की आवश्यकता होने पर, या प्रोजेक्ट WSL2 में होने पर

महत्वपूर्ण बातें:

• Windows संस्करण: Windows 11 अनुशंसित है; Windows 10 (संस्करण 1809 या नया) भी समर्थित है (जिसमें ConPTY जैसे आधुनिक कंसोल घटक होने चाहिए), पुराना विंडोज 10 अनुशंसित नहीं है।
• winget चालू होना चाहिए: यदि नहीं है, तो विंडोज अपडेट करें या विंडोज पैकेज मैनेजर इंस्टॉल करें।
• WSL1 अब समर्थित नहीं है: Codex 0.115 के बाद लिनक्स सैंडबॉक्स के लिए bubblewrap का उपयोग किया जा रहा है, WSL1 का समर्थन 0.114 के बाद समाप्त कर दिया गया था, इसलिए WSL2 का उपयोग करें।

WSL2 के लिए, पहले एडमिनिस्ट्रेटर PowerShell में सबसिस्टम इंस्टॉल करें, और फिर WSL शेल में जाकर CLI इंस्टॉलेशन स्क्रिप्ट चलाएं:

wsl --install
wsl

WSL शेल (लिनक्स टर्मिनल) में प्रवेश करने के बाद:

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

एक परफॉर्मेंस टिप: प्रोजेक्ट फाइलों को /mnt/c/... जैसे विंडोज माउंटेड पाथ में न रखें, इससे फाइल प्रोसेसिंग धीमी हो सकती है और अनुमतियों की समस्या आ सकती है। फाइलों को लिनक्स होम डायरेक्टरी (जैसे ~/code/my-app) में रखना सबसे तेज़ रहता है। विंडोज से इन फाइलों को देखने के लिए फ़ाइल एक्सप्लोरर में \\wsl$ टाइप करके जाएं।

नीचे दिया गया आरेख विंडोज़ पर निर्णय लेने में मदद करेगा:

यह आरेख स्पष्ट करता है: प्राथमिकता नेटिव elevated को दें, यदि अनुमति न हो तो unelevated पर जाएं, और लिनक्स वातावरण की आवश्यकता होने पर WSL2 का उपयोग करें।

💡 संक्षेप में: Windows पर सर्वश्रेष्ठ तरीका नेटिव + elevated सैंडबॉक्स है, नीतियां अवरुद्ध होने पर unelevated पर जाएं, और लिनक्स वातावरण के लिए WSL2 का उपयोग करें; WSL1 का समर्थन समाप्त हो चुका है।

---

05 इंस्टॉलेशन की पुष्टि करना

CLI इंस्टॉल करने के बाद, एक नया टर्मिनल खोलें और यह कमांड चलाएं:

codex --version

आपको संस्करण संख्या दिखाई देगी (संख्या बदल सकती है, जो सामान्य है):

codex-cli 0.139.0

संस्करण संख्या दिखाई देना = इंस्टॉलेशन सफल। यदि command not found: codex (या विंडोज़ में 'codex' is not recognized) दिखाई देता है, तो इसका मतलब है कि PATH कॉन्फ़िगर नहीं है (सिस्टम डायरेक्टरी को पहचान नहीं पा रहा है), जिसे हम भाग 08 में ठीक करना सीखेंगे।

अपग्रेड करने या सहायता के लिए codex --help कमांड का उपयोग करें—चूँकि यह टूल लगातार अपडेट हो रहा है, आधिकारिक तौर पर दी गई जानकारी पर ही भरोसा करें। codex --help से आप देख सकते हैं कि वर्तमान संस्करण में कौन सी कमांड्स उपलब्ध हैं।

डेस्कटॉप ऐप का संस्करण नंबर ऐप के मेनू में जाकर देखा जा सकता है। ऐप और CLI के संस्करण अलग होने से सुविधाओं में अंतर हो सकता है, इसलिए समस्याओं के समय दोनों की जांच कर लें।

💡 संक्षेप में: CLI के लिए codex --version से जांच करें; अपग्रेड और कमांड विवरण के लिए हमेशा codex --help का उपयोग करें, पुराने ट्यूटोरियल्स के भरोसे न रहें।

---

06 लॉगिन: सिस्टम को पहचान देना

इंस्टॉल होने के बाद Codex अभी एक खाली टूल है, इसे काम करने के लिए अकाउंट से जोड़ना होगा। अपने प्रोजेक्ट फोल्डर में टर्मिनल खोलें और टाइप करें:

codex

यदि लॉगिन क्रेडेंशियल नहीं हैं, तो यह आपको ChatGPT से लॉगिन करने के लिए कहेगा और ब्राउज़र में एक पेज खुलेगा। प्रमाणीकरण पूरा होने के बाद ब्राउज़र एक्सेस टोकन को CLI में भेज देगा और लॉगिन पूरा हो जाएगा।

दोनों लॉगिन तरीकों में से किसे चुनें

तरीका	लॉगिन प्रक्रिया	किसके लिए उपयुक्त	ध्यान दें
ChatGPT अकाउंट (अनुशंसित)	Sign in with ChatGPT चुनें, ब्राउज़र में अनुमति दें	अधिकांश लोगों के लिए, क्लाउड सुविधाओं के उपयोग के लिए	उपयोग सीमा आपके ChatGPT प्लान के अनुसार होगी
API key	API key लॉगिन चुनें, OpenAI Platform से की प्राप्त करें	CI/CD और ऑटोमेशन स्क्रिप्ट्स के लिए	स्टैंडर्ड एपीआई शुल्क लागू होंगे; ChatGPT वर्कस्पेस की कुछ सुविधाएं उपलब्ध नहीं होंगी

मैं दैनिक उपयोग के लिए ChatGPT अकाउंट का उपयोग करता हूँ—प्लान की सीमा पर्याप्त होती है और क्लाउड कार्य भी उपलब्ध रहते हैं। API key का उपयोग मैं केवल ऑटोमेशन स्क्रिप्ट्स और CI/CD के लिए करता हूँ क्योंकि इसके लिए ब्राउज़र इंटरैक्शन की आवश्यकता नहीं होती; लेकिन ध्यान रखें कि API key को सुरक्षित स्थानों पर ही रन करें।

क्रेडेंशियल कहाँ सुरक्षित रहते हैं

लॉगिन पूरा होने पर, क्रेडेंशियल स्थानीय कंप्यूटर पर सुरक्षित हो जाते हैं और हर बार लॉगिन की आवश्यकता नहीं होती। दो मुख्य बातें:

• CLI और IDE एक्सटेंशन एक ही लॉगिन क्रेडेंशियल साझा करते हैं—एक तरफ लॉगआउट करने पर दूसरी तरफ भी लॉगआउट हो जाएगा।
• क्रेडेंशियल स्थानीय स्तर पर ~/.codex/auth.json फ़ाइल में या ऑपरेटिंग सिस्टम के क्रेडेंशियल मैनेजर (जैसे मैक का Keychain) में सुरक्षित रहते हैं; जिसे cli_auth_credentials_store से कॉन्फ़िगर किया जा सकता है (विवरण के लिए लेख 18 देखें)।

⚠️ ~/.codex/auth.json फ़ाइल में आपका एक्सेस टोकन होता है, इसे पासवर्ड की तरह सुरक्षित रखें: इसे git में न डालें, किसी टिकट में साझा न करें या चैट में न भेजें।

ChatGPT लॉगिन के लिए, Codex टोकन को समाप्त होने से पहले स्वचालित रूप से अपडेट करता है, इसलिए आपको बार-बार लॉगिन करने की आवश्यकता नहीं होगी।

रिमोट / सर्वर / WSL पर लॉगिन अटकने पर क्या करें

यह एक आम समस्या है: जब आप रिमोट सर्वर, बिना ग्राफिकल इंटरफ़ेस (headless) वाले वातावरण में होते हैं, तो ब्राउज़र आधारित लॉगिन काम नहीं करता—क्योंकि या तो ब्राउज़र उपलब्ध नहीं होता या लोकलहोस्ट पोर्ट ब्लॉक होता है। इसके समाधान के लिए डिवाइस कोड लॉगिन (Device Code Login) का उपयोग किया जाता है।

प्रॉम्प्ट में Sign in with Device Code चुनें, या सीधे यह कमांड चलाएं:

codex login --device-auth

यह अभी एक प्रायोगिक (beta) सुविधा है। यह आपको एक लिंक और एक बार उपयोग होने वाला कोड देगा। आप किसी भी डिवाइस के ब्राउज़र में वह लिंक खोलकर कोड दर्ज कर सकते हैं, और लॉगिन हो जाएगा, इसके लिए सर्वर पर ब्राउज़र होना आवश्यक नहीं है।

डिवाइस कोड लॉगिन के लिए आपके ChatGPT अकाउंट या वर्कस्पेस में आवश्यक अनुमतियाँ सक्षम होनी चाहिए। यदि यह काम नहीं करता है, तो दो अन्य तरीके हैं:

1. क्रेडेंशियल कॉपी करना: एक ऐसे कंप्यूटर पर लॉगिन करें जहाँ ब्राउज़र है, और वहां से जनरेट हुई ~/.codex/auth.json फ़ाइल को रिमोट सर्वर के उसी पाथ पर कॉपी कर दें। जैसे SSH के माध्यम से:

   ssh user@remote 'mkdir -p ~/.codex'
   scp ~/.codex/auth.json user@remote:~/.codex/auth.json

2. SSH पोर्ट फ़ॉरवर्डिंग: रिमोट सर्वर के लोकलहोस्ट पोर्ट (डिफ़ॉल्ट localhost:1455) को अपने स्थानीय कंप्यूटर पर फ़ॉरवर्ड करें, जिससे सामान्य ब्राउज़र लॉगिन काम करने लगेगा:

   ssh -L 1455:localhost:1455 user@remote

   इसके बाद रिमोट शेल में codex login चलाएं और अपने स्थानीय कंप्यूटर के ब्राउज़र में प्रक्रिया पूरी करें।

डिवाइस कोड लॉगिन सबसे आसान है—बस codex login --device-auth चलाना है, कोड कॉपी करके ब्राउज़र में डालना है और काम पूरा।

💡 संक्षेप में: सामान्य रूप से ChatGPT अकाउंट का उपयोग करें, टोकन फ़ाइल ~/.codex/auth.json को सुरक्षित रखें; रिमोट सर्वर के लिए codex login --device-auth का उपयोग करें।

---

07 व्यावहारिक अभ्यास: पहली बार टूल को रन करना

प्रक्रिया को समझने के लिए एक बार इसे चलाकर देखें। इसके लिए किसी पहले से बने प्रोजेक्ट की आवश्यकता नहीं है, एक खाली फोल्डर में काम हो जाएगा।

पहला चरण, एक खाली डायरेक्टरी बनाएं, वहां जाएं और Codex शुरू करें:

mkdir codex-test && cd codex-test
codex

पहली बार चलने पर यह लॉगिन के लिए कहेगा (भाग 06 के अनुसार प्रक्रिया पूरी करें)। लॉगिन के बाद आपको स्वागत संदेश और इनपुट बॉक्स दिखाई देगा।

दूसरा चरण, एक निर्देश देकर काम करवाएं:

在 test.py 里写一个打印 hello world 的函数

(कोड ब्लॉक में निर्देश होने के कारण इसे मूल रूप में रहने दें)

अपेक्षित व्यवहार: Codex डिफ़ॉल्ट रूप से अनुमोदन नियम के साथ काम करता है—फाइलें बदलने या कमांड चलाने से पहले वह आपको योजना दिखाता है और पुष्टि (Yes चुनने) पर ही काम करता है। वह बिना पूछे आपके प्रोजेक्ट में कोई बदलाव नहीं करेगा।

जैसे ही आप पुष्टि करेंगे, डायरेक्टरी में test.py फ़ाइल बन जाएगी। शेल से बाहर आने के लिए Ctrl + C दबाएं या /exit टाइप करें।

तीसरा चरण (एक अच्छी आदत), चूँकि Codex आपके प्रोजेक्ट में बदलाव करता है, इसलिए काम शुरू करने से पहले और बाद में Git कमिट करना सुरक्षित रहता है, ताकि किसी गड़बड़ी के समय आप आसानी से पुराने कोड पर वापस जा सकें:

git init
git add -A && git commit -m "codex 动手前的检查点"

इस अभ्यास से आपने इंस्टॉलेशन, लॉगिन, निर्देश देना, अनुमोदन देखना और फ़ाइल में बदलाव करने की पूरी प्रक्रिया को समझ लिया है। यह पुष्टि कि वह आपसे पूछकर ही काम करता है, उपयोग में सुरक्षा का अहसास कराती है।

नीचे दिया गया आरेख इस प्रक्रिया को दिखाता है:

इस प्रक्रिया में सबसे महत्वपूर्ण बीच का पुष्टि चरण है: जब आप Yes चुनेंगे तभी वह बदलाव करेगा, अन्यथा रुक जाएगा।

💡 संक्षेप में: खाली डायरेक्टरी बनाकर काम शुरू करें—codex रन करके लॉगिन करें, निर्देश दें और पुष्टि पर Yes चुनें; बदलावों से पहले Git कमिट करना हमेशा सुरक्षित रहता है।

---

08 एरर सोल्यूशन: समस्याओं का समाधान

इंस्टॉलेशन या लॉगिन के दौरान कुछ एरर्स आ सकती हैं, जिनका समाधान नीचे दी गई तालिका में दिया गया है:

एरर / समस्या	कारण	समाधान
command not found: codex	डायरेक्टरी PATH में नहीं है	इंस्टॉलेशन डायरेक्टरी को PATH में जोड़ें (नीचे देखें)
'codex' is not recognized (Windows)	PATH सेट नहीं है या टर्मिनल रीस्टार्ट नहीं किया	PATH सेट करने के बाद टर्मिनल रीस्टार्ट करें
irm is not recognized	CMD में PowerShell कमांड रन की	PowerShell खोलकर कमांड चलाएं
लॉगिन ब्राउज़र लोड होता रहता है / विफल होता है	पोर्ट ब्लॉक या रिमोट एनवायरनमेंट	codex login --device-auth का उपयोग करें (भाग 06)
इंस्टॉलेशन स्क्रिप्ट डाउनलोड अटक जाती है	नेटवर्क कनेक्टिविटी समस्या	प्रॉक्सी का उपयोग करें, या Homebrew से आज़माएं
API key लॉगिन के बाद कुछ फ़ंक्शन काम नहीं कर रहे	API key लॉगिन में वर्कस्पेस सुविधाओं की सीमाएं हैं	ChatGPT अकाउंट से लॉगिन करें
Windows एरर 1385 (कमांड विफल)	विंडोज पॉलिसी द्वारा सैंडबॉक्स अनुमति ब्लॉक होना	IT विभाग से संपर्क करें; या अस्थायी रूप से unelevated सैंडबॉक्स पर स्विच करें
codex अनइंस्टॉल करने के बाद भी चल रहा है	सिस्टम में कई इंस्टॉलेशन मौजूद हैं	which -a codex चलाकर फालतू इंस्टॉलेशन डिलीट करें

दो महत्वपूर्ण एरर्स के समाधान नीचे दिए गए हैं।

समस्या 1: command not found: codex (सबसे आम)

जब सिस्टम codex कमांड को नहीं पहचान पाता—इसका मतलब यह नहीं है कि वह इंस्टॉल नहीं हुआ है, बल्कि उसका पाथ (PATH) सिस्टम सेटिंग्स में दर्ज नहीं है।

सादृश्य: PATH सिस्टम के लिए एक एड्रेस बुक की तरह है। सॉफ्टवेयर इंस्टॉल होने का मतलब घर बनना है, लेकिन जब तक उसका पता एड्रेस बुक में दर्ज नहीं होगा, सिस्टम उसे ढूंढ नहीं पाएगा।

समाधान (macOS में Zsh के लिए, पहले जांचें कि स्क्रिप्ट ने फाइल कहाँ रखी है और उसे PATH में जोड़ें):

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

यहाँ माना गया है कि पाथ ~/.local/bin है; वास्तविक पाथ के लिए स्क्रिप्ट इंस्टॉलेशन के समय प्रिंट हुई जानकारी को देखें। Linux (Bash) के लिए ~/.zshrc के स्थान पर ~/.bashrc का उपयोग करें। Windows उपयोगकर्ता सिस्टम एनवायरनमेंट वेरिएबल्स में जाकर पाथ जोड़ें और टर्मिनल रीस्टार्ट करें।

जांच के लिए:

codex --version

संस्करण संख्या दिखाई देने पर समस्या हल हो गई है।

समस्या 2: कई इंस्टॉलेशन का आपस में टकराना

यदि आपने पहले npm से इंस्टॉल किया था और फिर आधिकारिक स्क्रिप्ट से किया, तो सिस्टम में कई codex हो सकते हैं जिससे अजीब व्यवहार हो सकता है। यह जांचने के लिए कि कितने पाथ सेट हैं:

which -a codex

यदि एक से अधिक दिखते हैं, तो केवल एक (अनुशंसित आधिकारिक स्क्रिप्ट वाला) रखें और बाकी को हटा दें। जैसे npm वाला वर्जन हटाने के लिए:

npm uninstall -g @openai/codex

अक्सर which -a codex चलाने पर यह समस्या सामने आ जाती है। फालतू इंस्टॉलेशन हटाने और पाथ को ठीक करने से सब सही हो जाता है।

💡 संक्षेप में: एरर आने पर पहले कारण समझें, सीधे दोबारा इंस्टॉल न करें; कमांड न मिलने पर PATH चेक करें, और अजीब व्यवहार होने पर कई इंस्टॉलेशन की जांच which -a codex से करें।

---

09 सारांश

इस लेख में हमने इंस्टॉलेशन और लॉगिन की पूरी प्रक्रिया को समझा:

• इंस्टॉलेशन से पहले: CLI प्रवेश द्वार चुनें, ChatGPT प्लान या API key क्रेडेंशियल तैयार रखें, और नेटवर्क कनेक्टिविटी सुनिश्चित करें।
• इंस्टॉलेशन के तरीके: डेस्कटॉप ऐप केवल Mac और Windows के लिए है (मैक पर चिप का ध्यान रखें); CLI तीनों प्लेटफॉर्म्स के लिए है जहाँ आधिकारिक स्क्रिप्ट सबसे अच्छी है; Homebrew और npm अन्य विकल्प हैं।
• Windows पर विशेष नियम: नेटिव elevated सैंडबॉक्स सबसे अच्छा है, आवश्यकता होने पर unelevated या WSL2 पर जाएं; WSL1 अब समर्थित नहीं है।
• लॉगिन: डिफ़ॉल्ट रूप से ChatGPT अकाउंट का उपयोग करें और टोकन फ़ाइल ~/.codex/auth.json को सुरक्षित रखें; रिमोट सर्वर के लिए codex login --device-auth का उपयोग करें।
• समस्या निवारण: कमांड एरर के लिए PATH सेटिंग्स की जांच करें और डुप्लीकेट इंस्टॉलेशन हटाएं।

अब आप अपने कंप्यूटर पर Codex इंस्टॉल करने और पहला बुनियादी कार्य चलाने के लिए तैयार हैं।

अगले लेख 04 · सदस्यता और शुल्क में हम पैसों से संबंधित नियमों को समझेंगे: ChatGPT प्लान्स में कितनी सीमा मिलती है? API key के शुल्क की गणना कैसे होती है? और यह अन्य कोडिंग टूल्स की तुलना में कितना किफायती है? काम शुरू करने से पहले शुल्कों को समझना सुरक्षित रहता है।

---

सॉफ्टवेयर सेटअप हो गया है, अब शुल्कों और सीमाओं को समझकर काम शुरू करते हैं—अगले लेख में मिलते हैं।