Codex CLI: सब्सक्रिप्शन के बजाय अपनी चाबी

Codex एडिटर में सुझाव देने वाला नहीं, बल्कि खुद काम करने वाला एजेंट है। आप काम शब्दों में बताते हैं, वह खुद तय करता है कि कौन-सी फ़ाइलें पढ़नी हैं, कौन-से कमांड चलाने हैं और क्या बदलना है। उसके पास करीब एक दर्जन टूल हैं: कमांड चलाना, फ़ाइलें पढ़ना, काम की योजना बनाना, उपयोगकर्ता से स्पष्टीकरण माँगना, उप-कार्यों के लिए चाइल्ड एजेंट बनाना।

दो मोड। इंटरैक्टिव — बिना आर्ग्युमेंट के codex, टर्मिनल में हर कदम दिखाते हुए बातचीत। नॉन-इंटरैक्टिव — codex exec "task", नतीजे तक एक बार का रन: स्क्रिप्ट और CI में सुविधाजनक।

सुरक्षा अंदर ही है: डिफ़ॉल्ट रूप से एजेंट सैंडबॉक्स में काम करता है और बदलावों से पहले पुष्टि माँगता है। नियंत्रण का स्तर कॉन्फ़िगरेशन में तय होता है — "सब कुछ पूछो" से लेकर वर्किंग डायरेक्टरी में लिखने के अधिकार वाले पूरी तरह स्वायत्त रन तक।

एक और ख़ासियत — बातचीत की स्थिति। Codex सर्वर से कुछ याद रखने को नहीं कहता: वह पूरी फ़ीड अपने पास रखता है और हर चरण के साथ उसे पूरा भेजता है। आपके लिए इसका मतलब है कि बातचीत मॉडल प्रोवाइडर की तरफ़ नहीं बैठती, और endpoint बदलने से शुरू किया हुआ सेशन नहीं टूटता।

Claude Code और दूसरे टर्मिनल एजेंटों से फ़र्क़ ठीक प्रोटोकॉल का है। Codex मॉडल से Responses API के ज़रिए बात करता है, जहाँ बातचीत सपाट संदेशों की सूची से नहीं, बल्कि तत्वों की फ़ीड से बताई जाती है: टेक्स्ट, टूल कॉल, कॉल का नतीजा, तर्क का ब्लॉक। टूल को इससे बातचीत का ज़्यादा सख़्त मॉडल मिलता है, और आपको — ऐसा endpoint रखने की ज़रूरत जो यह प्रोटोकॉल समझता हो।

तेज़ रास्ता — इंस्टॉलर। कमांड npx @joingonka/setup --tool codex खुद ~/.codex/config.toml में प्रोवाइडर का ब्लॉक लिख देता है — wire_api = "responses", मॉडल और उसकी असली कॉन्टेक्स्ट विंडो के साथ — आपकी टिप्पणियाँ और बाकी सेटिंग्स बरकरार रखते हुए, और फिर एक लाइव रिक्वेस्ट से चाबी और मॉडल जाँचता है। अगर कॉन्फ़िग में पहले से कोई और प्रोवाइडर चुना है, तो इंस्टॉलर उसे छुएगा नहीं और वन-ऑफ़ रन के लिए कमांड बता देगा। चाबी यह सीधे फ़ाइल में रखता है (परमिशन 600), experimental_bearer_token फ़ील्ड में — Codex में यही एक फ़ील्ड है जहाँ चाबी लिटरल के रूप में रखी जा सकती है; Codex खुद इसे एक्सपेरिमेंटल मानता है। नीचे दिया मैनुअल तरीका एनवायरनमेंट वेरिएबल से काम चला लेता है।

Codex अपनी सेटिंग्स ~/.codex/config.toml में रखता है। कस्टम प्रोवाइडर [model_providers.*] ब्लॉक से बताया जाता है, और यहाँ अहम फ़ील्ड है wire_api: इसके बिना Codex Chat Completions पर बात करने की कोशिश करेगा और एजेंटिक लूप नहीं बन पाएगा।

# ~/.codex/config.toml
model_provider = "joingonka"
model = "deepseek-ai/DeepSeek-V4-Flash-0731"

[model_providers.joingonka]
name = "JoinGonka Gateway"
base_url = "https://gate.joingonka.ai/v1"
env_key = "JOINGONKA_API_KEY"
wire_api = "responses"

चाबी फ़ाइल में नहीं लिखी जाती: env_key उस एनवायरनमेंट वेरिएबल का नाम बताता है जहाँ से Codex उसे उठाएगा। वेरिएबल का नाम अपना है, OPENAI_API_KEY नहीं — इससे यह सेटअप आपके OpenAI पर चलने वाले बाकी टूल्स को ओवरराइड नहीं करता।

export JOINGONKA_API_KEY=jg-your-key

model फ़ील्ड डिफ़ॉल्ट मॉडल तय करता है, और model_provider बताता है कि कौन-सा बताया गया ब्लॉक इस्तेमाल होगा। दोनों को रन के समय ओवरराइड किया जा सकता है, इसलिए एक ही कॉन्फ़िग कई प्रोवाइडर आराम से संभाल लेता है: प्रोडक्शन, एक्सपेरिमेंटल और बैकअप।

चाबी रजिस्ट्रेशन के बाद पर्सनल डैशबोर्ड में मिलती है, वहीं बैलेंस और खर्च भी दिखता है। अगर आप साझा कॉन्फ़िग छूना नहीं चाहते, तो वही ब्लॉक -c के ज़रिए एक बार के लिए पास कर सकते हैं: codex -c model_provider=joingonka …। और कई अलग-अलग कॉन्फ़िग रखने के लिए CODEX_HOME वेरिएबल से सेटिंग्स डायरेक्टरी बता दें।

यह पक्का करने का सबसे तेज़ तरीका कि सेटअप काम कर रहा है, एक बार चलाकर देखना है:

codex exec "Answer in one line: what is 17*3?"

जवाब के हेडर में Codex बताता है कि वह किसके साथ काम कर रहा है: model, provider: joingonka, सैंडबॉक्स मोड और सेशन आईडी। अगर वहाँ आपका प्रोवाइडर दिख रहा है और नीचे जवाब आ गया है — कनेक्शन ज़िंदा है।

इसके बाद वह चीज़ परखनी चाहिए जिसके लिए असल में Codex इस्तेमाल होता है — फ़ाइलों के साथ काम। कैटलॉग में एक छोटी सी फ़ाइल रखें जिसमें साफ़-साफ़ कोई बग हो, और उसे ढूँढने को कहें:

codex exec "Read calc.py and tell me in one sentence whether it has a bug."

एजेंट को खुद रीड टूल कॉल करना चाहिए, फ़ाइल खोलनी चाहिए और लाइन बताते हुए सारगर्भित जवाब देना चाहिए। अगर ऐसा हुआ, तो गेटवे से पूरा एजेंट साइकल (रिक्वेस्ट → टूल कॉल → नतीजा → जवाब) ठीक से जुड़ रहा है।

अगर कुछ गड़बड़ हुई हो, तो निदान आम तौर पर संदेश से ही साफ़ पढ़ा जा सकता है:

सेशन की पहली रिक्वेस्ट में कुछ सेकंड लग सकते हैं: Codex बड़ा सिस्टम प्रॉम्प्ट और अपने सारे टूल्स का ब्यौरा भेजता है, और नेटवर्क नोड को टास्क स्वीकार करना होता है। आगे के जवाब तेज़ आते हैं।

नेटवर्क के सभी मॉडल एक ही कीमत पर उपलब्ध हैं, इसलिए चुनाव बजट के बारे में नहीं, बल्कि व्यवहार के बारे में है। नीचे Codex पर DeepSeek V4 Flash और MiniMax M2.7 के माध्यम से एक ही कार्य (फ़ाइल पढ़ना और उसमें त्रुटि खोजना) के लाइव रन का परिणाम दिया गया है; GLM-5.3 Flash रन के बाद नेटवर्क में आया — इसके लिए मॉडल के गुण दिए गए हैं।

डिफ़ॉल्ट अनुशंसा DeepSeek V4 Flash है: एजेंट का काम जल्दी ही संदर्भ की मात्रा तक सीमित हो जाता है, और 380K टोकन एक साथ कई फ़ाइलों को ध्यान में रखने का अवसर देते हैं। यदि कार्य में जटिल तर्क के बारे में सोचना शामिल है — GLM-5.3 Flash लें, लेकिन max_tokens पर अतिरिक्त मार्जिन रखें: उत्तर बजट का एक हिस्सा तर्क पर खर्च होता है। मॉडल को config में model की एक लाइन या -c model=… फ्लैग द्वारा फ़ाइल को संपादित किए बिना बदला जा सकता है।

नेटवर्क मॉडल की वर्तमान सूची हमेशा GET https://gate.joingonka.ai/v1/models पर उपलब्ध रहती है।

एजेंट टूल चैट की तुलना में टोकन का उपयोग अलग तरह से करते हैं: आपके प्रत्येक वाक्यांश के लिए Codex एक सिस्टम प्रॉम्प्ट और सभी टूल्स का विवरण जोड़ता है, और फिर मॉडल के साथ बहु-चरणीय संवाद करता है। लाइव रन में, एक सरल कार्य "फ़ाइल पढ़ें और त्रुटि खोजें" लगभग 18-20 हजार टोकन खर्च करता है। यह स्वायत्तता के लिए एक सामान्य शुल्क है, और इसीलिए प्रति टोकन कीमत मायने रखती है।

JoinGonka Gateway के माध्यम से टोकन इनपुट पर $0.0069 प्रति मिलियन और आउटपुट पर $0.021 प्रति मिलियन खर्च होते हैं — कीमत नेटवर्क के सभी मॉडलों के लिए समान है और इस पेज पर लाइव स्रोत से ली जाती है।

तुलना के लिए — Codex और प्रतिस्पर्धियों के पास भुगतान के विकल्प कैसे काम करते हैं:

भुगतान वास्तविक खपत के लिए किया जाता है, बिना मासिक सदस्यता और बिना अनुरोधों की संख्या पर कोटे के: कोई पांच घंटे की विंडो, "प्रॉम्प्ट" की सीमा और पीक घंटों में मल्टीप्लायर नहीं हैं। बैलेंस को क्रिप्टो से टॉप-अप किया जाता है, बाकी राशि और दैनिक खपत व्यक्तिगत कैबिनेट में देखी जा सकती है। अर्थव्यवस्था का विस्तृत विश्लेषण सबसे सस्ते API वाले लेख में है।

संवाद का इतिहास Codex स्वयं रखता है। यह हर अनुरोध के साथ इसे पूरा भेजता है और सर्वर से कुछ भी याद रखने के लिए नहीं कहता - और हम पत्राचार संग्रहीत नहीं करते हैं। उत्तर के बाद आपका कोड और प्रॉम्प्ट गेटवे पर नहीं रहते हैं।

वेब-सर्च काम करता है। Codex हर अनुरोध में एक सर्च टूल घोषित करता है, और गेटवे इसे स्वीकार करता है: सर्च हमारी तरफ से निष्पादित की जाती है, और परिणाम मॉडल के उत्तर में शामिल किए जाते हैं।

टूल अपने हैं, क्लाउड आधारित नहीं। Codex कमांड निष्पादित करता है और फ़ाइलें स्थानीय रूप से, आपकी मशीन पर पढ़ता है, इसलिए प्रोजेक्ट तक पहुंच मॉडल प्रदाता पर निर्भर नहीं करती है।

सैंडबॉक्स। Linux पर Codex कमांड चलाने के लिए bubblewrap का उपयोग करता है। यदि यह सिस्टम में नहीं है, तो Codex चेतावनी देगा और एक बिल्ट-इन कॉपी ले लेगा - यह काम को प्रभावित नहीं करता है, लेकिन पैकेज को मानक प्रबंधक के साथ स्थापित करना अधिक सुविधाजनक है।

यदि आपको छवियों के साथ काम करने की आवश्यकता है - इंटरफ़ेस का स्क्रीनशॉट, फोटो पर योजना - तो ऐसी कार्यात्मकताओं के लिए विज़न-सक्षम मॉडल वाले टूल का उपयोग करें: Gonka नेटवर्क में मॉडल टेक्स्ट-आधारित हैं। कोड, कमांड और फ़ाइलों के लिए यह कोई सीमा नहीं है।

अन्य टर्मिनल एजेंट, यदि Codex उपयुक्त नहीं है: API क्विक स्टार्ट दिखाता है कि कुछ ही मिनटों में किसी भी संगत टूल को कैसे कनेक्ट किया जाए।