Codex CLI: سبسکرپشن کے بجائے اپنی کی (key)

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 لگایا جاتا ہے — فائلوں پر کام۔ کوئی چھوٹی سی فائل جس میں واضح bug ہو رکھیں اور اسے ڈھونڈنے کو کہیں:

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

ایجنٹ کو خود ہی Read tool کال کرنا چاہیے، فائل کھولنی چاہیے اور لائن نمبر کے ساتھ ٹھیک جواب دینا چاہیے۔ اگر ایسا ہو گیا، تو پورا agentic loop (request → tool call → result → answer) گیٹ وے کے ذریعے درست کام کر رہا ہے۔

اگر کچھ غلط ہو، تو وجہ عموماً پیغام سے ہی سمجھ آ جاتی ہے:

سیشن کی پہلی request میں کچھ سیکنڈ لگ سکتے ہیں: Codex بڑا system prompt اور اپنے تمام tools کی تفصیل بھیجتا ہے، اور نیٹ ورک نوڈ کو کام وصول کرنا ہوتا ہے۔ بعد کے جواب تیزی سے آتے ہیں۔

نیٹ ورک کے تمام ماڈل ایک ہی قیمت پر دستیاب ہیں، لہذا انتخاب رویے کے بارے میں ہے، بجٹ کے بارے میں نہیں۔ نیچے ایک ہی کام (فائل پڑھنا اور غلطی تلاش کرنا) کو Codex کے ذریعے DeepSeek V4 Flash اور MiniMax M2.7 پر چلانے کے نتائج ہیں؛ GLM-5.3 Flash بعد میں نیٹ ورک میں شامل ہوا — اس لیے اس کی ماڈل خصوصیات نیچے دی گئی ہیں۔

ڈیفالٹ سفارش DeepSeek V4 Flash ہے: ایجنٹ کا کام تیزی سے کانٹیکسٹ کے حجم میں رک جاتا ہے، اور 380K ٹوکنز ایک ساتھ بہت سی فائلوں کو یاد رکھنے کا موقع دیتے ہیں۔ اگر کام پیچیدہ منطق پر سوچنے کا تقاضا کرتا ہے — تو GLM-5.3 Flash لیں، لیکن max_tokens میں اضافی بجٹ رکھیں: جواب کا ایک حصہ سوچنے میں خرچ ہوتا ہے۔ ماڈل کو کانفگ کی 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 کوئک سٹارٹ دکھاتا ہے کہ چند منٹوں میں کسی بھی ہم آہنگ ٹول کو کیسے جوڑنا ہے۔