مفت ماڈلز کے ساتھ Codex CLI استعمال کریں
Codex CLI OpenAI کا اوپن سورس کوڈنگ ایجنٹ ہے جو ٹرمینل میں چلتا ہے۔ یہ حسب ضرورت ماڈل فراہم کنندہ استعمال کر سکتا ہے۔ یہ گائیڈ Codex CLI کو FreeLLMAPI کے ذریعے دوسرے فراہم کنندگان کے مفت ماڈلز سے جوڑتی ہے۔ Codex، Responses API بولتا ہے، اور FreeLLMAPI اسے /v1/responses پر فراہم کرتا ہے۔
کوڈ، ماڈل کے نام اور براہِ راست کیٹلاگ کے لیبل انگریزی میں دکھائے جاتے ہیں۔
یہ کیسے کام کرتا ہے
Codex CLI درخواستیں OpenAI Responses فارمیٹ میں بھیجتا ہے۔ Codex کی دستاویزات کہتی ہیں کہ responses واحد تعاون یافتہ wire_api قدر ہے۔ اس لیے Codex کے لیے فراہم کنندہ کو /v1/responses فراہم کرنا ہوگا۔ FreeLLMAPI یہ اینڈ پوائنٹ فراہم کرتا ہے۔ یہ ہر درخواست کا ترجمہ کرتا ہے اور اسے مفت ماڈل کو بھیجتا ہے، مثلاً Gemini، GPT-OSS، Qwen یا GLM۔
- آپ کو ملتا ہے: مفت ماڈلز پر Codex CLI ایجنٹ، اس کے ٹولز اور اس کا ترمیمی لوپ۔
- آپ کو نہیں ملتا: آپ کے ChatGPT پلان کے ذریعے OpenAI کے اپنے GPT ماڈلز۔ درخواستیں آپ کے FreeLLMAPI پول کے مفت فراہم کنندگان کو جاتی ہیں۔
- حد:
/v1/responsesپر ابھی تصویری ان پٹ سپورٹ نہیں ہے۔ متنی پرامپٹس استعمال کریں۔
مرحلہ 1: FreeLLMAPI اور Codex CLI انسٹال کریں
دونوں انسٹال کریں
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @openai/codexhttp://localhost:3001 کھولیں۔ Keys صفحے پر کم از کم دو مفت فراہم کنندہ کلیدیں شامل کریں۔ اسی صفحے سے اپنی متحد کلید کاپی کریں۔ macOS پر آپ brew install --cask codex سے بھی Codex انسٹال کر سکتے ہیں۔
مرحلہ 2: Codex CLI کو جوڑیں
سیٹ اپ کمانڈ ~/.codex/config.toml میں ایک فراہم کنندہ شامل کرتی ہے۔ یہ پہلے بیک اپ بناتی ہے اور نیا بلاک ضم کرتی ہے، اس لیے آپ کی باقی ترتیبات برقرار رہتی ہیں۔
ایک کمانڈ
export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-codex --url http://localhost:3001 --dry-run
npx freellmapi setup-codex --url http://localhost:3001
codexکمانڈ یہ ترتیبات لکھتی ہے، جن کی قدریں آپ کے براہ راست کیٹلاگ سے آتی ہیں۔ کلید فائل میں نہیں ہے۔ Codex اسے FREELLMAPI_API_KEY ماحولیاتی متغیر سے پڑھتا ہے، اس لیے جس شیل میں آپ Codex چلاتے ہیں وہاں متغیر export کریں۔
~/.codex/config.toml
model = "auto"
model_provider = "freellmapi"
model_context_window = 128000
model_auto_compact_token_limit = 115200
tool_output_token_limit = 20000
[model_providers.freellmapi]
name = "FreeLLMAPI"
base_url = "http://localhost:3001/v1"
wire_api = "responses"
env_key = "FREELLMAPI_API_KEY"
requires_openai_auth = false| کلید | یہ کیا کرتی ہے |
|---|---|
model_provider | model_providers سے فراہم کنندہ منتخب کرتی ہے۔ ڈیفالٹ openai ہے۔ |
env_key | وہ ماحولیاتی متغیر جس میں فراہم کنندہ کی API کلید ہوتی ہے |
requires_openai_auth | false کا مطلب ہے کہ Codex OpenAI لاگ اِن نہیں مانگتا |
model_context_window | فعال ماڈل کے سیاق و سباق کے ٹوکنز۔ کمانڈ یہ قدر آپ کے براہ راست کیٹلاگ سے لیتی ہے۔ |
model_auto_compact_token_limit | وہ ٹوکن شمار جو خودکار تاریخ کمپیکشن شروع کرتا ہے۔ کمانڈ سیاق و سباق ونڈو کا 90% مقرر کرتی ہے۔ |
tool_output_token_limit | ہر ٹول آؤٹ پٹ کے لیے ٹوکن بجٹ جو Codex تاریخ میں رکھتا ہے |
کلید کو فائلوں اور اپنے شیل پروفائل سے باہر رکھنے کے لیے لانچر استعمال کریں۔ یہ Codex کو صرف اپنے ماحول میں کلید کے ساتھ شروع کرتا ہے:
بغیر محفوظ کیے چلانے والا لانچر
npx freellmapi launch-codexیقین کرنے کے لیے کہ درخواستیں گیٹ وے کو جا رہی ہیں، npx freellmapi doctor چلائیں۔ یہ روٹ کیا گیا Authorization ہیڈر، کیٹلاگ اور ایک براہ راست پروب چیک کرتا ہے۔ اس کے بعد ڈیش بورڈ کا درخواست لاگ ہر Codex کال دکھاتا ہے۔ جواب کا ہیڈر X-Routed-Via اس فراہم کنندہ اور ماڈل کا نام دیتا ہے جس نے جواب دیا۔ اگر درخواست فال اوور ہوئی، تو X-Fallback-Trail ہر ناکام مرحلے اور اس کی وجہ کا نام دیتا ہے۔
[profiles.NAME] ٹیبلز نہیں پڑھتے، جو config.toml میں ہوتی ہیں۔ پروفائلز اب الگ فائلیں ہیں، مثلاً ~/.codex/NAME.config.toml۔ موجودہ Codex ورژن کے ساتھ اوپر کا ڈیفالٹ سیٹ اپ استعمال کریں۔ماڈل میٹا ڈیٹا کی انتباہ ہٹائیں
Codex ہر رن پر "Model metadata for auto not found" دکھاتا ہے۔ Codex گیٹ وے کی ماڈل آئی ڈیز نہیں جانتا۔ اسے اصل میٹا ڈیٹا دینے کے لیے، جیسے سیاق و سباق ونڈو اور تصویر کی سپورٹ، فراہم کنندہ میں ماڈل کیٹلاگ URL شامل کریں:
[model_providers.freellmapi] میں شامل کریں
model_catalog_url = "http://localhost:3001/v1/codex/models"کیٹلاگ Codex کا اپنا ڈیفالٹ سسٹم پرامپٹ اور ٹول کی ترتیبات برقرار رکھتا ہے۔ صرف انتباہ اور سیاق و سباق ونڈو بدلتے ہیں۔
Codex CLI کے لیے ماڈلز منتخب کریں
Codex ایک ایجنٹ ہے۔ یہ ٹول کالز کے ذریعے شیل کمانڈز چلاتا ہے اور فائلیں ترمیم کرتا ہے۔ ایسے ماڈلز استعمال کریں جن میں ٹول کالنگ ہو اور بڑی سیاق و سباق ونڈو ہو۔ جدول آج کے وہ مفت ماڈلز دکھاتا ہے جو دونوں اصولوں پر پورے اترتے ہیں۔
| ماڈل | مفت دستیاب | سیاق و سباق | مفت حدیں (بہترین پیشکش) | ٹولز | ویژن |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 درخواستیں فی منٹ 1 req/min per model | ہاں | نہیں |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 درخواستیں فی منٹ 40 RPM | ہاں | ہاں |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | ہاں | ہاں |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | ہاں | نہیں |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | ہاں | ہاں |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 درخواستیں فی منٹ 20 درخواستیں فی دن 250,000 ٹوکن فی منٹ ~3M | ہاں | ہاں |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | ہاں | ہاں |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 درخواستیں فی منٹ 50 درخواستیں فی دن 50 req/day account-wide (1,000 after a $10 purchase) | ہاں | ہاں |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 درخواستیں فی منٹ 50 درخواستیں فی دن Shared rate limit | ہاں | نہیں |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 درخواستیں فی منٹ 250 درخواستیں فی دن 70,000 ٹوکن فی منٹ ~6M | ہاں | ہاں |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 درخواستیں فی منٹ 20 درخواستیں فی دن 250,000 ٹوکن فی منٹ ~3M | ہاں | ہاں |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | ہاں | ہاں |
109 میں سے 12 مماثل مفت ماڈلز دکھائے جا رہے ہیں۔ تمام ماڈلز دیکھیں.
FreeLLMAPI کیٹلاگ کا براہِ راست ڈیٹا (ورژن 2026.11.19، 2026-11-19 کو جانچا گیا)۔ مفت حدیں اکثر بدلتی ہیں۔ کیٹلاگ ہر روز جانچا جاتا ہے۔
راؤٹر کو ہر درخواست کے لیے ماڈل منتخب کرنے دینے کے لیے model = "auto" رکھیں۔ کسی ایک ماڈل کو مقرر کرنے کے لیے npx freellmapi setup-codex --url http://localhost:3001 --model <id> چلائیں۔ آپ model = "auto:smart" یا model = "auto:fast" کو config.toml میں بھی مقرر کر سکتے ہیں۔
مفت ٹائرز کی فی منٹ اور فی دن حدیں ہوتی ہیں۔ جب کوئی فراہم کنندہ 429 غلطی بھیجتا ہے، تو FreeLLMAPI درخواست فال بیک چین کے اگلے ماڈل کو بھیجتا ہے۔ طویل Codex سیشنز کے لیے چار یا زیادہ فراہم کنندگان کی کلیدیں شامل کریں۔ جب Codex model_auto_compact_token_limit تک پہنچتا ہے تو اپنی تاریخ کمپیکٹ کرتا ہے۔ کم قدر چھوٹی درخواستیں بھیجتی ہے، جو کم فی منٹ ٹوکن حدوں والے مفت ٹائرز پر مدد دیتی ہے۔
خرابیوں کا ازالہ
| مسئلہ | وجہ | حل |
|---|---|---|
| Codex آپ سے ChatGPT کے ساتھ سائن اِن کرنے کو کہتا ہے | model_provider سیٹ نہیں ہے، اس لیے Codex openai استعمال کرتا ہے | model_provider = "freellmapi" سیٹ کریں |
401 "Invalid API key" | FREELLMAPI_API_KEY اس شیل میں سیٹ نہیں ہے | متغیر export کریں، یا npx freellmapi launch-codex استعمال کریں |
"Model metadata for auto not found" | Codex گیٹ وے کی ماڈل آئی ڈیز نہیں جانتا | model_catalog_url شامل کریں |
wire_api = "chat" کے ساتھ غلطیاں | Codex صرف Responses API سپورٹ کرتا ہے | wire_api = "responses" سیٹ کریں |
| پروفائل کی ترتیبات نظر انداز ہوتی ہیں | Codex 0.134.0 اور بعد کے ورژن [profiles.NAME] ٹیبلز نظر انداز کرتے ہیں | ڈیفالٹ فراہم کنندہ سیٹ اپ استعمال کریں، یا الگ پروفائل فائل |
| "N کوششوں کے بعد تمام ماڈلز ریٹ حد پر ہیں" | تمام کلیدیں اپنی حد پر ہیں | زیادہ فراہم کنندگان کی کلیدیں شامل کریں، یا کول ڈاؤن کا انتظار کریں |
اکثر پوچھے گئے سوالات
کیا میں Codex CLI مفت استعمال کر سکتا ہوں؟
ہاں۔ Codex CLI اوپن سورس ہے۔ config.toml میں FreeLLMAPI کو حسب ضرورت ماڈل فراہم کنندہ کے طور پر شامل کریں۔ گیٹ وے ہر درخواست مفت فراہم کنندہ ٹائرز کو بھیجتا ہے، اس لیے انفیرنس کی لاگت $0 ہے۔
کیا Codex CLI دوسرے فراہم کنندگان کے ماڈلز استعمال کر سکتا ہے؟
ہاں۔ base_url، env_key اور wire_api = "responses" کے ساتھ ایک [model_providers.
کیا Codex CLI Chat Completions API سپورٹ کرتا ہے؟
نہیں۔ Codex کا config حوالہ کہتا ہے کہ responses واحد تعاون یافتہ wire_api قدر ہے۔ FreeLLMAPI /v1/responses فراہم کرتا ہے، اس لیے یہ Codex فراہم کنندہ کے طور پر کام کرتا ہے۔
Codex CLI کے لیے کون سا مفت ماڈل سب سے اچھا ہے؟
ایسا ماڈل استعمال کریں جس میں ٹول کالنگ ہو اور کم از کم 128K سیاق و سباق ہو۔ اس صفحے کا جدول آج کے سب سے طاقتور مفت ماڈلز دکھاتا ہے جو دونوں اصولوں پر پورے اترتے ہیں۔
"Model metadata for auto not found" کو کیسے ٹھیک کروں؟
~/.codex/config.toml میں فراہم کنندہ کے بلاک میں model_catalog_url = "http://localhost:3001/v1/codex/models" شامل کریں۔ پھر Codex گیٹ وے کے ماڈلز کا اصل میٹا ڈیٹا پڑھتا ہے۔
متعلقہ گائیڈز
- Claude Code مفت میں کیسے استعمال کریں
- OpenCode کو مفت LLM API کے ساتھ استعمال کریں
- مفت LLM API کے ساتھ Aider استعمال کریں
- بہترین مفت coding model APIs
- کیا مفت GPT API ہے؟
ماخذ
- Codex docs: config reference (20 November 2026 کو جانچا گیا)
- Codex docs: advanced config and profiles (20 November 2026 کو جانچا گیا)
- Codex CLI repository (20 November 2026 کو جانچا گیا)
- FreeLLMAPI docs: coding agents and Codex (20 November 2026 کو جانچا گیا)
- FreeLLMAPI CLI generators (20 November 2026 کو جانچا گیا)