Codex

یک نسخه پشتیبانی‌شده Node.js LTS نصب کنید، Codex را نصب کنید، Key اختصاصی بسازید و سپس config.toml و auth.json سازگار با نسخه را از API Keys -> Use key به پوشه پیش‌فرض .codex کپی کنید. پس از هر تغییر Codex را کاملا ببندید و دوباره باز کنید.

پیش از شروع

فقط نسخه فعلی کلاینت را از ناشر رسمی آن نصب کنید. پیش از تغییر پیکربندی محلی در کنسول یک API Key اختصاصی بسازید؛ Key شخصی، مشترک یا استقرار تولید را دوباره استفاده نکنید.

Windows، macOS و Linux

• Windows: از نصب‌کننده فعلی Windows یا روند PowerShell استفاده کنید و پس از تغییر فایل پیکربندی همه فرایندهای کلاینت را ببندید.
• macOS: از برنامه امضاشده یا نصب‌کننده رسمی ترمینال مناسب CPU استفاده کنید؛ تنظیمات دایرکتوری خانگی متعلق به همان کاربر macOS است.
• Linux / WSL: دستورالعمل فعلی توزیع یا CLI رسمی را دنبال کنید؛ WSL دایرکتوری خانگی Linux را می‌خواند نه پروفایل Windows را.

انتخاب مدل

با Key اختصاصی GET /v1/models را فراخوانی و یک data[].id برگشتی را انتخاب کنید. فهرست محدودشده به Key مرجع است؛ پیکربندی قبلی، مقاله یا انتخاب‌گر کلاینت دسترسی را تضمین نمی‌کند.

پیکربندی

npm install -g @openai/codex
codex --version

model_provider = "OpenAI"
model = "your-console-model"

[model_providers.OpenAI]
base_url = "https://ai.tavonilo.com"
wire_api = "responses"

تأیید

Key را با /v1/models بررسی کنید، یک درخواست کوچک بدون داده حساس بفرستید و برای پشتیبانی فقط زمان، مسیر، مدل، وضعیت HTTP و request ID را نگه دارید. timeout ثابت نمی‌کند تولید قابل‌هزینه پردازش نشده است، پس درخواست طولانی یا تصویری را کورکورانه تکرار نکنید.

بازیابی ایمن

• 401: Key ناقص، لغوشده یا نادرست را جایگزین کنید و آن را در درخواست پشتیبانی نچسبانید.
• 403: گروه Key، نمایش مدل، موجودی و مجوز route را بررسی کنید.
• 404: Base URL نشان‌داده‌شده را استفاده کنید، نه endpoint کامل؛ /v1 را دوبار اضافه نکنید.
• 429: کار را صف‌بندی و در صورت وجود Retry-After را رعایت کنید؛ یک batch را هم‌زمان دوباره نفرستید.
• 5xx یا timeout: فقط در صورت امن بودن عملیات با حد مشخص دوباره تلاش کنید. زمان، route، model، وضعیت HTTP و request ID را در لاگ حذف‌شده از راز نگه دارید.

مرز اعتبارنامه

برای هر دستگاه یا بار کاری Key جدا استفاده کنید. هرگز API Key، auth.json، متن کامل خصوصی، گذرواژه، کد تأیید یا اطلاعات پرداخت را برای پشتیبانی نفرستید؛ با احتمال افشا Key را فورا لغو و جایگزین کنید.

مستندات مرتبط

• مدل‌ها و قیمت‌ها
• فهرست مدل‌ها
• undefined