راهنمای پیکربندی model_catalog_json در Codex
از 2026-10-08، model_catalog_json کلیدی اختیاری در config.toml مربوط به Codex است که مقدارش مسیر یک کاتالوگ مدل JSON است و Codex آن را فقط هنگام راهاندازی بارگذاری میکند؛ کد متنباز Codex در توضیحات کد منبع میگوید پس از تنظیم، این کلید کاتالوگ مدل همراه را برای فرایند جاری جایگزین میکند و انتخابگر /model گزینه‌هایش را از کاتالوگ فعال می‌سازد. یک فایل پروفایل می‌تواند آن را بازنویسی کند و وقتی هر دو فایل آن را تنظیم کنند، پروفایل اولویت دارد. این صفحه بر پایه مرجع رسمی پیکربندی، تاریخچه تغییرات و کد متنباز Codex، قالب، قواعد بازنویسی، تغییر 0.160.0 و دلایل معمول نبودن یک مدل در /model را بررسی میکند.
بهروزرسانی شده 2026-11-14
این ابزار را به نقطه پایانی QCode متصل کنید — یک کلید برای Claude، GPT و مدلهای چینی.
- صورتحساب به‌ازای توکن — نرخ‌های زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- بهصورت خودخدمت: شارژ حساب و فعال‌سازی فوری
چهار نکته کلیدی
زمان اعمال
مرجع رسمی پیکربندی: مسیری به یک کاتالوگ مدل JSON که هنگام راهاندازی بارگذاری میشود. طرح‌واره پیکربندی در کد متنباز Codex می‌افزاید که بازنویسی‌های پیکربندی به‌ازای هر thread پذیرفته میشوند اما آن را دوباره اعمال نمیکنند؛ بنابراین پس از ویرایش فایل، Codex را دوباره راهاندازی کنید.
رابطه با کاتالوگ همراه
یک توضیح در کد منبع Codex متنباز میگوید که آن کاتالوگ همراه را برای فرایند جاری جایگزین میکند؛ گزینههای /model از کاتالوگ فعال ساخته میشوند، بر اساس اولویت مرتب میشوند و بر اساس حالت احراز هویت و قابلیت مشاهده فیلتر میشوند.
وقتی هر دو فایل آن را تنظیم میکنند
پیکربندی پیشرفته رسمی: فایلهای پروفایل هم میتوانند model_catalog_json را بازنویسی کنند و وقتی هر دو فایل آن را تنظیم کنند، Codex از مقدار پروفایل استفاده میکند.
کاتالوگهای صریح ارائهدهنده
Codex CLI 0.160.0 که در 2026-10-01 منتشر شد: کاتالوگهای مدل صریح ارائهدهنده دیگر مدلهای همراه پشتیبانینشده را شامل نمیشوند و پس از شکست تازه‌سازی، از ورودیهای کهنه دوباره استفاده نمیکنند.
model_catalog_json چه کاری انجام میدهد
از 2026-10-08، model_catalog_json به شما اجازه میدهد کاتالوگ مدل خودتان را به Codex بدهید: مرجع رسمی پیکربندی آن را «مسیر اختیاری به یک کاتالوگ مدل JSON که هنگام راهاندازی بارگذاری میشود» توصیف میکند، نوع آن را رشته (path) می‌داند، و پیکربندی نمونه رسمی آن را بهصورت model_catalog_json = "/absolute/path/to/models.json" می‌نویسد و توضیح میدهد که بازنویسی کاتالوگ مدل فقط هنگام راهاندازی است. توضیحات کد منبع در کد متنباز Codex فراتر می‌روند: پس از تنظیم، این کاتالوگ کاتالوگ همراه را برای فرایند جاری جایگزین میکند و انتخابگر /model گزینه‌هایش را از کاتالوگ فعال می‌سازد. بنابراین اگر می‌خواهید /model فقط مدل‌هایی را که انتخاب میکنید فهرست کند، یا نام‌های نمایشی یا ترتیب را تغییر دهید، این همان فایلی است که باید ویرایش کنید. دو محدودیت اعمال میشود: جدول سازگاری مرجع پیکربندی برای دسترسی کامپیوتر محلی با Work Cloud آن را به‌عنوان بازنویسی ابری مدیریت‌شده پشتیبانینشده فهرست میکند و اشاره میکند که کاتالوگ مدل محلی منتقل نمیشود؛ و مدیران میتوانند کاتالوگ مدل JSON را که Codex هنگام راهاندازی استفاده میکند از طریق requirements.toml الزام کنند.
تغییرات نسخه (0.156.0 تا 0.161.0)
فهرست کامل تغییرات Codex CLI 0.156.0 (2026-09-22) شامل #46561 با عنوان «پشتیبانی از URL صریح فهرست مدل ارائهدهنده» است؛ این PR میگوید که model_catalog_url را به پیکربندی ارائهدهنده اضافه میکند و کشف فهرست با کلید API همراه با base_url سفارشی نیازمند یک URL صریح فهرست است. یادداشتهای انتشار 0.160.0 (2026-10-01) چنین است: «فهرست‌های مدل صریح ارائهدهنده دیگر مدلهای همراه پشتیبانینشده را شامل نمیشوند و پس از خطاهای تازه‌سازی از ورودیهای کهنه استفاده نمیکنند.» PR #49135 توضیح میدهد که پیش‌تر ارائه‌دهندگان دارای model_catalog_url می‌توانستند مدلهای همراهی را معرفی کنند که در فهرستشان وجود نداشت؛ اکنون اسلاگ‌های فهرست باید یکتا و غیرخالی باشند، فراداده بر اساس شناسه دقیق مدل تطبیق داده میشود و راهاندازی بدون هیچ مدل در دسترس، خطای پیکربندی گزارش میکند، در حالی که مدل پیکربندیشده بهصورت صریح همچنان مجاز است. در 0.161.0 (2026-10-07)، GPT-6.1 Sol مدل پیش‌فرض در فهرست‌های همراه و Amazon Bedrock شد.
گاه‌شمار فهرست مدل
Codex CLI 0.156.0 منتشر شد؛ فهرست کامل تغییرات آن شامل #46561 است که model_catalog_url را به پیکربندی ارائهدهنده اضافه میکند.
Codex CLI 0.160.0 منتشر شد: فهرست‌های مدل صریح ارائهدهنده دیگر مدلهای همراه پشتیبانینشده را شامل نمیشوند و پس از خطاهای تازه‌سازی از ورودیهای کهنه استفاده نمیکنند.
Codex CLI 0.161.0 منتشر شد: GPT-6.1 Sol مدل پیش‌فرض در فهرست‌های همراه و Amazon Bedrock میشود؛ این صفحه در 2026-10-08 با صفحات رسمی بررسی شده است.
موارد تأییدشده در مقابل موارد ذکرنشده در منابع رسمی
تأییدشده (عیناً در مستندات رسمی یا کد متنباز)
همه موارد زیر را می‌توان کلمه‌به‌کلمه در مستندات رسمی Codex، گزارش تغییرات یا کد متنباز Codex (طرح‌واره پیکربندی، کد منبع و یادداشتهای PR) بررسی کرد: model_catalog_json مسیر یک فهرست مدل JSON است که در زمان راهاندازی بارگذاری میشود؛ بازنویسی‌های پیکربندی در سطح هر رشته آن را دوباره اعمال نمیکنند؛ پس از تنظیم، فهرست همراه را برای فرایند جاری جایگزین میکند؛ گزینههای /model بر اساس اولویت مرتب و بر اساس حالت احراز هویت و قابلیت مشاهده فیلتر میشوند؛ یک فایل پروفایل می‌تواند آن را بازنویسی کند و اگر هر دو فایل مقدار را تعیین کنند، مقدار پروفایل استفاده میشود؛ از 0.134.0، --profile دیگر جدول [profiles.profile-name] را در config.toml نمیخواند؛ در Work Cloud به‌عنوان بازنویسی مدیریت‌شده ابری پشتیبانی نمیشود؛ شکست در تجزیه JSON و فهرست خالی هر یک خطای راهاندازی مخصوص خود را تولید میکنند؛ از 0.160.0، فهرست‌های صریح ارائهدهنده دیگر مدلهای همراه پشتیبانینشده را شامل نمیشوند؛ از 0.161.0، GPT-6.1 Sol مدل پیش‌فرض فهرست همراه است.
به‌طور رسمی ذکر نشده است؛ بنابراین در اینجا نتیجه‌گیری نمیشود
سه چیز مستند نشده است و این صفحه آنها را پر نمی‌کند: نخست، کدام فیلدهای ورودی الزامی‌اند و چه مقادیری را می‌پذیرند، چون مستندات جدول فیلد ندارند و مرجعی که باید دنبال شود models.json همراه در کد متنباز Codex است؛ دوم، مسیرهای نسبی چگونه حل میشوند، چون مرجع پیکربندی تنها string (path) را ذکر میکند، بدنه نمونه پیکربندی از مسیر مطلق استفاده میکند و یک نمونه پروفایل مسیر ./models.json را نشان میدهد، بنابراین مسیر مطلق انتخاب ایمن است؛ سوم، تغییر 0.160.0 برای فهرست‌های صریح ارائهدهنده در PR خود model_catalog_url را نام می‌برد و اینکه آیا model_catalog_json محلی از همان قواعد پیروی میکند یا نه، گفته نشده است. همچنین تا تاریخ 2026-10-08، model_catalog_url را می‌توان در طرح‌واره پیکربندی و یادداشتهای PR کد متنباز Codex یافت؛ مرجع پیکربندی در developers.openai.com آن را فهرست نمی‌کند.
model_catalog_json در مقابل model_catalog_url
model_catalog_json (فایل محلی)
در سطح بالای config.toml یا یک فایل profile تنظیم میشود؛ مقدار آن مسیر یک فایل JSON محلی است که فقط در زمان راهاندازی خوانده میشود و پس از تنظیم، فهرست همراه را جایگزین میکند. مناسب افراد و تیم‌هایی است که فهرست ثابت /model یا فهرست‌های متفاوت برای هر profile می‌خواهند. در Work Cloud نمی‌توان آن را به‌عنوان بازنویسی مدیریت‌شده ابری استفاده کرد.
model_catalog_url (به‌ازای هر ارائهدهنده)
درون پیکربندی یک ارائهدهنده تنظیم میشود؛ طرح‌واره پیکربندی در کد متنباز Codex آن را «URL کامل اختیاری برای فهرست مدل بومی Codex» توصیف میکند و یادداشتهای PR میگویند Codex آن را با احراز هویت همان ارائهدهنده دریافت میکند. زمانی مناسب است که یک دروازه فهرست خودش را نگه می‌دارد؛ از 0.160.0 چنین فهرست‌های صریحی مرجع تلقی میشوند و دیگر مدلهای همراه بیرون از فهرست را با آن مخلوط نمیکنند.
مراحل راهاندازی
مرحله 1، ارائهدهنده را متصل کنید. با استفاده از مستندات QCode به‌عنوان مثال (نام ارائهدهنده به انتخاب شماست؛ مستندات از qcode استفاده میکند): در ~/.codex/config.toml بنویسید model_provider = "qcode"، model = "gpt-6.1-sol"، model_reasoning_effort = "high"، سپس جدول [model_providers.qcode] را با name = "qcode"، base_url = "https://api.qcode.cc/openai"، wire_api = "responses"، requires_openai_auth = true اضافه کنید و کلید را در OPENAI_API_KEY در ~/.codex/auth.json قرار دهید. برای اینکه کلید را به‌جای آن از طریق متغیر محیطی منتقل کنید، requires_openai_auth = true را در جدول با env_key = "QCODE_API_KEY" جایگزین کنید (نام متغیر هم به انتخاب شماست) و آن متغیر را export کنید. از یکی از این دو استفاده کنید: مستندات رسمی بیان میکند که Codex وقتی requires_openai_auth = true است، env_key را نادیده می‌گیرد. مرحله 2، فایل کاتالوگ را آماده کنید: از codex-rs/models-manager/models.json در کد متنباز Codex به‌عنوان قالب استفاده کنید؛ سطح بالا یک آرایه "models" است و هر ورودی فیلدهایی مانند slug، display_name، priority، visibility و context_window دارد. فقط ورودیهایی را که می‌خواهید نگه دارید، slug را روی شناسه دقیق مدل تنظیم کنید، برای مثال gpt-6.1-sol، gpt-6-sol یا gpt-5.6-sol، و فیلدهایی را که قالب ندارد از خود نسازید. مرحله 3، model_catalog_json = "/absolute/path/to/models.json" را در سطح بالای config.toml اضافه کنید. مرحله 4، برای تغییر کاتالوگ‌ها به‌ازای هر وظیفه، model_catalog_json را در سطح بالای ~/.codex/profile-name.config.toml قرار دهید و با codex --profile profile-name اجرا کنید؛ آن را در جدول [profiles.profile-name] قرار ندهید. مرحله 5، Codex را دوباره راهاندازی کنید و در یک نشست /model را تایپ کنید تا فهرست را بررسی کنید.
در QCode
اتصال Codex به QCode از صفحه Codex در docs.qcode.cc پیروی میکند: base_url را روی https://api.qcode.cc/openai، wire_api را روی responses تنظیم کنید و از کلید API QCode خود که با cr_ شروع میشود استفاده کنید؛ این تنظیمات فقط به مدلهای GPT سرویس میدهد و Claude و مدلهای چینی از آن عبور نمیکنند. پیکربندی Codex در مستندات QCode هیچ ورودی model_catalog_json ندارد و پیکربندی مستندشده همان‌طور که هست کار میکند. gpt-6.1-sol، gpt-6-sol و gpt-5.6-sol روی QCode قابل فراخوانی هستند و هر سه شناسه در کاتالوگ همراه (models.json) در کد متنباز Codex نیز وجود دارند؛ برای تغییر مدل‌ها برای یک اجرای واحد، از codex -m gpt-6-sol استفاده کنید. صورتحساب به‌ازای هر توکن است؛ برای قیمت هر مدل، /models را ببینید.
پرسش‌های متداول
model_catalog_json چه کاری انجام میدهد؟
Codex را به یک کاتالوگ مدل JSON ارجاع میدهد. مرجع رسمی پیکربندی میگوید این، مسیرِ یک فایل کاتالوگ است که هنگام راهاندازی بارگذاری میشود؛ یک توضیح درون کد متنباز Codex میگوید که بهمحض تنظیم، کاتالوگ همراه را برای فرایند جاری جایگزین میکند، بنابراین گزینههای /model از همان فایل میآیند. این یک کلید اختیاری است که مقدارش یک رشته مسیر است.
چرا مدل سفارشی من در /model نمایش داده نمیشود؟
بیشتر اوقات ورودی در کاتالوگ وجود ندارد یا بهصورت قابلمشاهده نوشته نشده است: یک کامنت در کد متنباز Codex میگوید گزینههای /model بر اساس priority مرتب و بر اساس حالت احراز هویت و visibility فیلتر میشوند، و کاتالوگ همراه در خود کد متنباز Codex ورودیهایی دارد که visibility آنها روی "hide" تنظیم شده است. دلیل شایع بعدی، راهاندازی مجدد نکردن پس از ویرایش فایل است، زیرا فقط هنگام راهاندازی اعمال میشود. اگر از ارائهدهندهای با model_catalog_url استفاده میکنید، از 0.160.0 به بعد مدلهای همراه خارج از کاتالوگ آن نیز دیگر ترکیب نمیشوند.
فایل کاتالوگ از چه قالبی استفاده میکند؟
سطح بالا یک آرایه "models" است: وقتی کد متنباز Codex فایل را میخواند، آن فهرست models را بررسی میکند، و models.json همراه از همان ساختار استفاده میکند. آرایه حداقل به یک ورودی نیاز دارد، در غیر این صورت راهاندازی با پیام model_catalog_json path ... must contain at least one model شکست میخورد؛ JSON نامعتبر با failed to parse model_catalog_json path ... as JSON شکست میخورد. مستندات جدول فیلد ندارند، بنابراین رویکرد ایمن این است که یک ورودی را از فایل همراه کپی کنید و سپس slug، display_name و priority را تغییر دهید.
اگر هم profile و هم config.toml آن را تنظیم کنند، کدام یک اعمال میشود؟
profile. پیکربندی پیشرفته رسمی میگوید فایلهای profile نیز میتوانند model_catalog_json را بازنویسی کنند و Codex وقتی هر دو فایل آن را تنظیم میکنند از مقدار profile استفاده میکند. آن را در سطح بالای ~/.codex/profile-name.config.toml قرار دهید؛ از 0.134.0، --profile دیگر جدول [profiles.profile-name] را در config.toml نمیخواند.
0.160.0 درباره کاتالوگهای مدل چه چیزی را تغییر داد؟
کاتالوگهای صریح مدل ارائهدهنده معتبر شدند: یادداشتهای انتشار 2026-10-01 میگویند دیگر مدلهای همراه پشتیبانینشده را شامل نمیشوند و پس از شکست در بهروزرسانی، از ورودیهای کهنه دوباره استفاده نمیکنند. PR #49135 اضافه میکند که slugهای کاتالوگ باید یکتا و غیرخالی باشند و فراداده بر اساس شناسه دقیق مدل تطبیق داده شود؛ راهاندازی بدون مدل در دسترس خطای پیکربندی گزارش میکند، در حالی که مدل صراحتاً پیکربندیشده همچنان مجاز است.
آیا برای استفاده از Codex با QCode به model_catalog_json نیاز دارید؟
خیر، الزامی نیست. پیکربندی Codex در مستندات QCode چنین ورودی‌ای ندارد؛ با base_url https://api.qcode.cc/openai و wire_api = "responses" مطابق مستندات، می‌توانید gpt-6.1-sol، gpt-6-sol و gpt-5.6-sol را فراخوانی کنید و هر سه شناسه نیز در کاتالوگ همراه در کد متنباز Codex وجود دارند. فقط اگر می‌خواهید /model تنها مدل‌هایی را که انتخاب میکنید فهرست کند یا نام‌های نمایشی و ترتیب را تغییر دهید، به کاتالوگ اختصاصی خود نیاز دارید.
منابع
تعریف کلید، قواعد بازنویسی پروفایل و محدودیت‌های مدیریت‌شده: مرجع پیکربندی Codex، پیکربندی پیشرفته، پیکربندی نمونه و صفحه مدل‌ها در OpenAI (developers.openai.com، خزش‌شده در 2026-10-08). تغییرات نسخه: تاریخچه تغییرات رسمی Codex و یادداشتهای GitHub Releases برای 0.156.0، 0.160.0 و 0.161.0، خزش‌شده در همان روز. قالب کاتالوگ، قاعده جایگزینی، پیام‌های خطا و فیلتر /model: شِمای پیکربندی، models.json همراه و کامنت‌های کد منبع در شاخه main کد متنباز openai/codex، به‌علاوه یادداشتهای PRهای #46561 و #49135، خزش‌شده در همان روز. راهاندازی QCode: صفحه Codex در مستندات QCode (به‌روزرسانی‌شده در 2026-09-30)، خزش‌شده در همان روز.
Codex را مطابق مستندات راهاندازی کنید و همین حالا از مدلهای GPT استفاده کنید
یک کلید cr_ و base_url https://api.qcode.cc/openai به شما امکان میدهد در Codex بین gpt-6.1-sol، gpt-6-sol و gpt-5.6-sol جابه‌جا شوید؛ صورتحساب بر اساس توکن است و قیمت هر مدل در /models آمده است.
مطالب مرتبط
مدل پیش‌فرض Codex CLI به GPT-6.1 Sol تبدیل میشود
rust-v0.161.0 مدل GPT-6.1 Sol را مدل پیش‌فرض در کاتالوگهای همراه و Bedrock میکند، 0.162.0 برچسب پیش‌فرض TUI را حذف میکند، به‌علاوه پیکربندی config.toml و راهاندازی کلید QCode.
فعال‌سازی GPT-5.5 در Codex: در 14 اکتبر بازنشسته میشود، API باقی می‌ماند
زمان بازنشستگی GPT-5.5 در Codex و اینکه چگونه در سمت API در دسترس می‌ماند.
محدودیت‌های Codex در ChatGPT Pro در برابر Plus (2026-11)
تفاوت Plus و سه سطح Pro در بازه 5 ساعته، برآوردها، دو برابر شدن 10-29، سهمیه مشترک دسامبر و راه‌های خروج رسمی.
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
ساختار پیکربندی و نقل‌قول‌های این صفحه در 2026-10-08 با مستندات رسمی OpenAI Codex، تاریخچه تغییرات و کد متنباز Codex بررسی شد؛ تغییرات ممکن است بدون اطلاع قبلی رخ دهند. توضیحات منبع و کاتالوگ همراه بین نسخه‌ها تغییر میکنند، بنابراین نسخه Codex روی دستگاه خود را ملاک قرار دهید؛ در دسترس بودن مدل همان چیزی است که /models نشان میدهد.