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

Codex کوئی ایڈیٹر سوجسٹ ٹول نہیں، بلکہ ایک خود مختار ایگزیکیوٹر ہے۔ آپ اپنی ٹاسک الفاظ میں بیان کرتے ہیں، اور یہ خود فیصلہ کرتا ہے کہ کون سی فائلیں پڑھنی ہیں، کون سی کمانڈز چلانی ہیں اور کیا تبدیل کرنا ہے۔ اس کے پاس تقریباً دس ٹولز دستیاب ہیں: کمانڈز چلانا، فائلیں پڑھنا، ورک پلان برقرار رکھنا، صارف سے وضاحت مانگنا، سب ٹاسکس کے لیے چائلڈ ایجنٹس بنانا۔

کام کرنے کے دو موڈز ہیں۔ انٹرایکٹو — بغیر کسی آرگومنٹ کے codex، ٹرمینل میں ہر قدم دکھاتے ہوئے ڈائیلاگ۔ نان-انٹرایکٹو — codex exec «ٹاسک»، رزلٹ کے لیے ایک بار چلانا: یہ اسکرپٹس اور CI میں آسان ہے۔

سیکیورٹی بلٹ ان ہے: ڈیفالٹ طور پر ایجنٹ سینڈ باکس میں کام کرتا ہے اور تبدیلی سے پہلے تصدیق مانگتا ہے۔ کنٹرول لیول کنفیگریشن میں سیٹ کیا جاتا ہے — «سب کچھ پوچھیں» سے لے کر ورکنگ ڈائریکٹری میں لکھنے کی اجازت کے ساتھ مکمل خود مختار رن تک۔

ایک اور خصوصیت ڈائیلاگ کی حالت ہے۔ Codex سرور کو کچھ بھی یاد رکھنے کا نہیں کہتا: یہ پوری چیٹ ہسٹری اپنے پاس رکھتا ہے اور ہر موو کے ساتھ اسے بھیجتا ہے۔ اس کا مطلب ہے کہ آپ کی گفتگو ماڈل پرووائیڈر کے پاس جمع نہیں ہوتی اور اینڈپوائنٹ تبدیل کرنے سے سیشن ٹوٹتا نہیں ہے۔

Claude Code اور دیگر ٹرمینل ایجنٹس کے ساتھ فرق بنیادی طور پر پروٹوکول کا ہے۔ Codex ماڈل کے ساتھ Responses API کے ذریعے بات چیت کرتا ہے، جہاں گفتگو کو پیغامات کی عام لسٹ کے بجائے ایلیمنٹس کے ایک تسلسل کے طور پر بیان کیا جاتا ہے: ٹیکسٹ، ٹول کال، کال کا رزلٹ، ریزننگ بلاک۔ یہ ٹول کو زیادہ سخت ڈائیلاگ ماڈل دیتا ہے، اور آپ کو ایک ایسے اینڈپوائنٹ کی ضرورت ہوتی ہے جو یہ پروٹوکول سمجھتا ہو۔

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"

کی (key) فائل میں نہیں لکھی جاتی: env_key اس انوائرمنٹ ویری ایبل کا نام بتاتا ہے جہاں سے Codex اسے لے گا۔ ویری ایبل کا نام الگ ہے، OPENAI_API_KEY نہیں — تاکہ یہ سیٹنگ دوسرے OpenAI ٹولز کے ساتھ کوئی تصادم پیدا نہ کرے۔

export JOINGONKA_API_KEY=jg-آپکی-کی

model فیلڈ ڈیفالٹ ماڈل سیٹ کرتی ہے، اور model_provider یہ بتاتا ہے کہ کون سا بلاک استعمال کرنا ہے۔ رن کرتے وقت دونوں کو اوور رائیڈ کیا جا سکتا ہے، اس لیے ایک کنفگ آسانی سے کئی پرووائیڈرز چلا سکتا ہے: ورکنگ، ایکسپیریمینٹل اور بیک اپ۔

کی (key) رجسٹریشن کے بعد پرسنل اکاؤنٹ میں دی جاتی ہے، جہاں بیلنس اور خرچ دیکھا جا سکتا ہے۔ اگر آپ مین کنفگ کو تبدیل نہیں کرنا چاہتے، تو وہی بلاک ایک بار -c کے ذریعے پاس کر سکتے ہیں: codex -c model_provider=joingonka …۔ اور اگر آپ کئی آزاد کنفیگریشنز رکھنا چاہتے ہیں، تو CODEX_HOME ویری ایبل میں سیٹنگز ڈائریکٹری بتائیں۔

یہ یقینی بنانے کا تیز ترین طریقہ کہ کنکشن کام کر رہا ہے، ایک ون-ٹائم رن ہے:

codex exec "Ответь одной строкой: сколько будет 17*3?"

Codex جواب کے شروع میں پرنٹ کرتا ہے کہ وہ کس کے ساتھ کام کر رہا ہے: model، provider: joingonka، سینڈ باکس موڈ اور سیشن شناخت کنندہ۔ اگر وہاں آپ کا پرووائیڈر موجود ہے اور نیچے جواب آتا ہے، تو کنکشن زندہ ہے۔

اس کے بعد، اس اہم چیز کی جانچ کرنی چاہیے جس کے لیے Codex انسٹال کیا گیا ہے—فائلوں کے ساتھ کام کرنا۔ ڈائرکٹری میں ایک چھوٹی فائل رکھیں جس میں ایک واضح غلطی ہو اور اس سے اسے تلاش کرنے کو کہیں:

codex exec "Прочитай calc.py и скажи одной фразой, есть ли ошибка."

ایجنٹ کو خود ٹول کال کرنا چاہیے، فائل کھولنی چاہیے اور لائن نمبر بتاتے ہوئے جواب دینا چاہیے۔ اگر ایسا ہوتا ہے، تو گیٹ وے کے ذریعے مکمل ایجنٹ سائیکل (درخواست → ٹول کال → نتیجہ → جواب) درست طریقے سے کام کر رہا ہے۔

اگر کچھ غلط ہو جائے تو تشخیص عام طور پر پیغام سے ہی پڑھی جا سکتی ہے:

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

نیٹ ورک کے تمام ماڈلز ایک ہی قیمت پر دستیاب ہیں، اس لیے انتخاب کا تعلق بجٹ سے نہیں بلکہ کارکردگی سے ہے۔ نیچے ہر ماڈل پر Codex کے ذریعے ایک ہی کام (فائل پڑھنا اور غلطی تلاش کرنا) کرنے کے لائیو رن کے نتائج ہیں۔

ڈیفالٹ سفارش DeepSeek V4 Flash ہے: ایجنٹ کا کام تیزی سے کونٹیکسٹ حجم کی حدود میں آتا ہے، اور 380K ٹوکنز ایک ساتھ بہت سی فائلیں ذہن میں رکھنے کی سہولت دیتے ہیں۔ اگر انتہائی مختصر جوابات چاہیے تو Kimi K2.6 کا انتخاب کریں۔ فائل میں ترمیم کیے بغیر کنفیگ میں model لائن یا -c model=… فلیگ کے ذریعے ماڈل تبدیل کیا جا سکتا ہے۔

نیٹ ورک کے موجودہ ماڈلز کی فہرست ہمیشہ GET https://gate.joingonka.ai/v1/models پر دیکھی جا سکتی ہے۔

ایجنٹ ٹولز چیٹ کی نسبت مختلف طریقے سے ٹوکن خرچ کرتے ہیں: آپ کے ہر جملے کے ساتھ Codex ایک سسٹم پرامپٹ اور تمام ٹولز کی تفصیل شامل کرتا ہے، اور پھر ماڈل کے ساتھ ملٹی اسٹیپ گفتگو کرتا ہے۔ ایک لائیو رن میں، “فائل پڑھ کر غلطی تلاش کرنے” کے سادہ کام میں تقریباً 18-20 ہزار ٹوکنز خرچ ہوئے۔ خودمختاری کے لیے یہ ایک مناسب قیمت ہے، اور اسی لیے ٹوکن کی قیمت اہم ہے۔

JoinGonka Gateway کے ذریعے ٹوکنز کی قیمت انکمنگ پر $0.0047 فی ملین اور آؤٹ گوئنگ پر $0.014 فی ملین ہے — تمام ماڈلز کے لیے قیمت یکساں ہے اور اس صفحہ پر لائیو سورس سے لی جاتی ہے۔

موازنے کے لیے—Codex اور اس شعبے کے دیگر ادا شدہ آپشنز کیسے کام کرتے ہیں:

ادائیگی اصل خرچ کے مطابق ہوتی ہے، کوئی ماہانہ سبسکرپشن یا کوٹہ نہیں ہے: کوئی پانچ گھنٹے کی ونڈوز، “پرامپٹ” کی حد یا رش کے اوقات کا ضرب نہیں ہے۔ بیلنس کرپٹو کے ذریعے ٹاپ اپ کیا جا سکتا ہے، بیلنس اور روزانہ کا خرچ ذاتی اکاؤنٹ میں دیکھا جا سکتا ہے۔ معیشت کا تفصیلی تجزیہ سستے ترین API کے مضمون میں دیکھیں۔

مکالمے کی تاریخ Codex خود رکھتا ہے۔ یہ ہر درخواست کے ساتھ اسے مکمل بھیجتا ہے اور سرور سے کچھ بھی یاد رکھنے کا نہیں کہتا — اور ہم بھی خط و کتابت محفوظ نہیں کرتے۔ جواب کے بعد آپ کا کوڈ اور پرامپٹس گیٹ وے پر نہیں رہتے۔

ویب-سرچ کام کرتا ہے۔ Codex ہر درخواست میں ایک سرچ ٹول کا اعلان کرتا ہے، اور گیٹ وے اسے قبول کرتا ہے: سرچ ہماری طرف سے انجام دی جاتی ہے، اور نتائج ماڈل کے جواب میں شامل کر دیے جاتے ہیں۔

ٹولز اپنے ہیں، کلاؤڈ نہیں ہیں۔ Codex کمانڈز چلاتا ہے اور آپ کی مشین پر فائلیں مقامی طور پر پڑھتا ہے، لہذا پروجیکٹ تک رسائی ماڈل فراہم کنندہ پر منحصر نہیں ہے۔

سینڈ باکس۔ Linux پر Codex کمانڈز چلانے کے لیے bubblewrap کا استعمال کرتا ہے۔ اگر یہ سسٹم میں نہیں ہے، تو Codex خبردار کرے گا اور ایک بلٹ- اِن کاپی لے لے گا — یہ کام پر اثر انداز نہیں ہوتا، لیکن پیکج کو سٹینڈرڈ مینیجر کے ساتھ انسٹال کرنا زیادہ آسان ہے۔

اگر تصاویر کے ساتھ کام کرنے کی ضرورت ہو — انٹرفیس کا اسکرین شاٹ، تصویر پر خاکہ — تو ایسے کاموں کے لیے ویژن-سپورٹڈ ماڈل والا ٹول استعمال کریں: Gonka نیٹ ورک میں ماڈلز ٹیکسٹ-بیسڈ ہیں۔ کوڈ، کمانڈز اور فائلوں کے لیے یہ کوئی رکاوٹ نہیں ہے۔

دیگر ٹرمینل ایجنٹس، اگر Codex موزوں نہ ہو: API کوئک سٹارٹ دکھاتا ہے کہ چند منٹوں میں کسی بھی ہم آہنگ ٹول کو کیسے جوڑنا ہے۔