محدودیت‌های استفاده OpenAI Codex توضیح داده شد (۲۰۲۶)

محدودیت‌های استفاده OpenAI Codex توضیح داده شد (۲۰۲۶)

OpenAI Codex یک ابزار کدنویسی عامل‌گرای قدرتمند است، اما با محدودیت‌های استفاده‌ای همراه است که می‌توانند گیج‌کننده باشند. چه از طریق ChatGPT به Codex دسترسی داشته باشید، چه از API، درک این محدودیت‌ها به شما کمک می‌کند جریان کاری خود را برنامه‌ریزی کنید و از برخورد به دیوار در میان پروژه جلوگیری کنید.

این راهنما هر محدودیت را، نحوه کارکرد آن‌ها و استراتژی‌های عملی برای کار در محدوده آن‌ها یا درخواست افزایش را توضیح می‌دهد.

محدودیت‌های Codex بر اساس پلان

محدودیت‌های پلان ChatGPT

اگر از طریق ChatGPT به Codex دسترسی دارید، محدودیت‌های شما به سطح اشتراکتان بستگی دارد.

نوع محدودیت	Plus ($20/mo)	Pro ($200/mo)	Team ($25/کاربر/mo)	Enterprise
وظیفه در روز	~۲۵	~۲۵۰	~۱۰۰	سفارشی
حداکثر فایل در وظیفه	۵۰	۲۰۰	۱۰۰	سفارشی
timeout وظیفه	۱۰ دقیقه	۳۰ دقیقه	۱۵ دقیقه	سفارشی
وظایف همزمان	۱	۳	۲	سفارشی
اندازه repository	تا ۵۰۰ مگابایت	تا ۲ گیگابایت	تا ۱ گیگابایت	سفارشی
دسترسی به مدل	codex-mini	codex-mini + codex	codex-mini + codex	همه

چند نکته مهم:

• محدودیت‌های وظیفه روزانه در نیمه‌شب UTC تنظیم مجدد می‌شوند.
• محدودیت ~۲۵ وظیفه در Plus تقریبی است. OpenAI از محدودیت «مبتنی بر محاسبه» استفاده می‌کند، بنابراین وظایف ساده کمتر از سهمیه شما مصرف می‌کنند.
• وظایف همزمان به تعداد وظایف Codex که می‌توانید به‌طور موازی اجرا کنید اشاره دارد. کاربران Plus فقط می‌توانند یکی را در یک زمان اجرا کنند.

محدودیت‌های API

اگر از طریق OpenAI API به Codex دسترسی دارید، با محدودیت‌های متفاوتی مواجه هستید.

نوع محدودیت	Tier 1 (جدید)	Tier 2	Tier 3	Tier 4	Tier 5
RPM (درخواست/دقیقه)	۶۰	۱۰۰	۳۰۰	۸۰۰	۲,۰۰۰
TPM (توکن/دقیقه)	۶۰,۰۰۰	۲۰۰,۰۰۰	۱,۰۰۰,۰۰۰	۵,۰۰۰,۰۰۰	۱۰,۰۰۰,۰۰۰
RPD (درخواست/روز)	۱,۰۰۰	۵,۰۰۰	۱۵,۰۰۰	۵۰,۰۰۰	۱۵۰,۰۰۰
هزینه ماهانه برای واجد شرایط بودن	$5	$50	$100	$250	$1,000

نحوه کارکرد سطوح API

OpenAI بر اساس هزینه تجمعی و سن حساب، به‌طور خودکار سطحی به شما اختصاص می‌دهد:

• Tier 1: حساب‌های جدید با حداقل ۵ دلار پرداخت
• Tier 2: ۵۰ دلار+ خرج‌شده، حساب حداقل ۷ روزه
• Tier 3: ۱۰۰ دلار+ خرج‌شده، حساب حداقل ۳۰ روزه
• Tier 4: ۲۵۰ دلار+ خرج‌شده، حساب حداقل ۳۰ روزه
• Tier 5: ۱,۰۰۰ دلار+ خرج‌شده، حساب حداقل ۳۰ روزه

به‌طور خودکار ارتقا پیدا می‌کنید. هیچ فرآیند درخواستی برای ارتقای tier استاندارد وجود ندارد.

درک محدودیت‌های توکن

هر تعامل Codex محدودیت‌های توکنی دارد که بر میزان زمینه‌ای که مدل می‌تواند پردازش کند تأثیر می‌گذارد.

مدل	پنجره زمینه	حداکثر توکن خروجی
codex-mini	۲۰۰,۰۰۰ توکن	۱۶,۳۸۴ توکن
codex	۲۰۰,۰۰۰ توکن	۱۶,۳۸۴ توکن

چه چیزی بر مصرف توکن تأثیر می‌گذارد

• فایل‌های کد شما. هر فایلی که Codex می‌خواند به‌عنوان توکن ورودی محاسبه می‌شود. یک فایل Python معمولی ۲۰۰ خطی تقریباً ۲,۰۰۰-۳,۰۰۰ توکن است.
• دستورالعمل شما. توضیح وظیفه‌تان به‌عنوان توکن ورودی محاسبه می‌شود.
• کد تولیدشده. کدی که Codex می‌نویسد به‌عنوان توکن خروجی محاسبه می‌شود.
• استدلال داخلی. استدلال chain-of-thought Codex (قابل مشاهده در لاگ وظیفه) به‌عنوان توکن خروجی محاسبه می‌شود.

برآورد توکن برای یک وظیفه

راهنمای تقریبی برای وظایف معمولی Codex:

پیچیدگی وظیفه	توکن ورودی	توکن خروجی	مجموع توکن
ساده (رفع باگ در یک فایل)	۳,۰۰۰-۵,۰۰۰	۵۰۰-۱,۵۰۰	۳,۵۰۰-۶,۵۰۰
متوسط (اضافه کردن ویژگی در ۲-۳ فایل)	۱۰,۰۰۰-۳۰,۰۰۰	۲,۰۰۰-۵,۰۰۰	۱۲,۰۰۰-۳۵,۰۰۰
پیچیده (بازنویسی ماژول، نوشتن تست)	۳۰,۰۰۰-۸۰,۰۰۰	۵,۰۰۰-۱۵,۰۰۰	۳۵,۰۰۰-۹۵,۰۰۰

نحوه بررسی استفاده فعلی

ChatGPT

1. ChatGPT را باز کنید و به Settings > Subscription بروید.
2. استفاده فعلی و وظایف باقی‌مانده در بخش Codex نشان داده می‌شوند.
3. در رابط Codex خود نیز یک نشانگر «Usage» می‌بینید.

API

استفاده را به‌صورت برنامه‌نویسی یا از داشبورد بررسی کنید.

import openai

# بررسی هدرهای rate limit از هر پاسخ API
response = openai.chat.completions.create(
    model="codex-mini",
    messages=[{"role": "user", "content": "Hello"}],
    max_tokens=10
)

# اطلاعات rate limit در هدرهای پاسخ است
# x-ratelimit-limit-requests: محدودیت RPM شما
# x-ratelimit-remaining-requests: درخواست‌های باقی‌مانده
# x-ratelimit-reset-requests: زمان تا تنظیم مجدد

همچنین می‌توانید داشبورد استفاده را در platform.openai.com/usage بررسی کنید.

نحوه افزایش محدودیت‌ها

گزینه ۱: ارتقای پلان ChatGPT

ساده‌ترین راه برای افزایش محدودیت‌های Codex، ارتقا از Plus به Pro است.

معیار	Plus	Pro (ارتقای ۱۰ برابر)
وظایف روزانه	~۲۵	~۲۵۰
وظایف همزمان	۱	۳
timeout وظیفه	۱۰ دقیقه	۳۰ دقیقه
قیمت	$20/mo	$200/mo

گزینه ۲: ارتقا در سطوح API

هزینه تجمعی خود را افزایش دهید تا به‌طور خودکار سطوح بالاتر را باز کنید. جهش از Tier 1 به Tier 2 (فقط ۵۰ دلار کل هزینه) افزایش قابل توجهی می‌دهد:

• RPM: ۶۰ -> ۱۰۰ (افزایش ۶۷٪)
• TPM: ۶۰,۰۰۰ -> ۲۰۰,۰۰۰ (افزایش ۲۳۳٪)
• RPD: ۱,۰۰۰ -> ۵,۰۰۰ (افزایش ۴۰۰٪)

گزینه ۳: درخواست افزایش سفارشی rate limit

برای کاربران API که نیاز به محدودیت‌هایی فراتر از Tier 5 دارند، OpenAI یک فرم درخواست افزایش rate limit ارائه می‌دهد.

1. به platform.openai.com/settings/organization/limits بروید.
2. روی «Request rate limit increase» کلیک کنید.
3. فرم را با موارد استفاده، حجم مورد انتظار و جزئیات کسب‌وکار پر کنید.
4. OpenAI معمولاً ظرف ۲-۷ روز کاری پاسخ می‌دهد.

نکاتی برای تأیید:

• موارد استفاده کسب‌وکارتان را به‌وضوح توضیح دهید.
• مصرف توکن روزانه/ماهانه پیش‌بینی‌شده را ارائه دهید.
• اگر محصولی می‌سازید که Codex را ادغام می‌کند ذکر کنید.
• حساب‌های با هزینه بیشتر اولویت دارند.

گزینه ۴: استفاده از چندین کلید API

برای سازمان‌ها، می‌توانید چندین کلید API در پروژه‌های جداگانه بسازید. هر پروژه rate limit‌های خود را دارد. این برای تیم‌هایی که پروژه‌های مختلف الگوهای استفاده متفاوت دارند مفید است.

import openai

# پروژه الف - محصول اصلی
client_a = openai.OpenAI(
    api_key="sk-proj-A-...",
)

# پروژه ب - ابزارهای داخلی
client_b = openai.OpenAI(
    api_key="sk-proj-B-...",
)

استراتژی‌هایی برای کار در محدوده محدودیت‌ها

۱. اولویت‌بندی وظایف

هر وظیفه کدنویسی به Codex نیاز ندارد. از آن برای وظایف پیچیده چند مرحله‌ای استفاده کنید و ویرایش‌های ساده را دستی انجام دهید.

استفاده مناسب از وظایف Codex:

• «ماژول پرداخت را از callback‌ها به async/await بازنویسی کن و همه تست‌ها را به‌روز کن»
• «error handling جامع به هر endpoint API در پوشه routes/ اضافه کن»

بهتر است دستی انجام شود:

• رفع یک تایپو
• تغییر نام یک متغیر
• به‌روز کردن یک شماره نسخه

۲. ساختار repository را بهینه کنید

یک فایل .codexignore بسازید تا فایل‌های غیرضروری را از زمینه حذف کنید:

# .codexignore - کاهش مصرف توکن
node_modules/
dist/
build/
.git/
*.lock
*.map
coverage/
__pycache__/
.next/
vendor/

۳. دستورالعمل‌های دقیق بنویسید

دستورالعمل‌های واضح به Codex کمک می‌کند وظایف را در اولین تلاش کامل کند و از نیاز به تکرار (که وظایف اضافی از سهمیه شما می‌سوزاند) جلوگیری کند.

بد: "باگ auth را رفع کن"

خوب: "در src/auth/middleware.ts، تأیید JWT در خط ۳۴ وقتی توکن منقضی شده
یک استثنای unhandled پرتاب می‌کند. آن را در یک try-catch بپیچ
که یک پاسخ ۴۰۱ با پیام 'Token expired' برمی‌گرداند. یک unit test
در tests/auth.test.ts اضافه کن که این رفتار را تأیید کند."

۴. از codex-mini برای وظایف ساده‌تر استفاده کنید

مدل کامل codex را برای وظایف پیچیده‌ای که نیاز به استدلال عمیق‌تر دارند نگه دارید. مدل codex-mini اکثر تغییرات تک‌فایل را خوب انجام می‌دهد و کمتر در برابر سهمیه مبتنی بر محاسبه محاسبه می‌شود.

۵. وظایف را کارآمد صف‌بندی کنید

در پلان Pro، می‌توانید ۳ وظیفه همزمان اجرا کنید. وظایف را به‌طور استراتژیک صف‌بندی کنید:

• اول یک وظیفه بازنویسی پیچیده شروع کنید (بیشتر طول می‌کشد).
• در حین اجرا، دو وظیفه ساده‌تر که سریع تمام می‌شوند ارسال کنید.
• نتایج را به‌محض پایان مرور کنید به جای انتظار به‌ترتیب.

پیام‌های خطا و رفع‌آن‌ها

خطا	معنی	رفع
Rate limit exceeded	به محدودیت RPM یا TPM رسیده‌اید	صبر کنید و دوباره امتحان کنید، یا سطح را ارتقا دهید
Task limit reached	سهمیه وظیفه روزانه تمام شده	تا نیمه‌شب UTC صبر کنید، یا پلان را ارتقا دهید
Context length exceeded	توکن‌های زیادی در زمینه	از .codexignore استفاده کنید، دامنه فایل را کاهش دهید
Task timed out	وظیفه از محدودیت زمانی تجاوز کرده	به وظایف کوچک‌تر تقسیم کنید
Concurrent task limit	وظایف موازی زیادی	منتظر بمانید تا وظیفه فعلی تمام شود
Repository too large	repository از محدودیت اندازه تجاوز کرده	فایل‌ها/پوشه‌های بزرگ را حذف کنید

سوالات متداول

آیا وظایف استفاده‌نشده به روز بعد منتقل می‌شوند؟ خیر. محدودیت‌های وظیفه روزانه در نیمه‌شب UTC تنظیم مجدد می‌شوند و جمع نمی‌شوند.

آیا فرآیند «تفکر» در محدودیت‌های توکن محاسبه می‌شود؟ بله. توکن‌های استدلال داخلی Codex به‌عنوان توکن‌های خروجی برای صورت‌حساب API محاسبه می‌شوند. در ChatGPT، در برابر سهمیه وظیفه مبتنی بر محاسبه شما محاسبه می‌شوند.

آیا می‌توانم ببینم چند وظیفه باقی دارم؟ در ChatGPT، بله -- رابط Codex سهمیه باقی‌مانده شما را نشان می‌دهد. در API، هدرهای پاسخ x-ratelimit-remaining-* را بررسی کنید.

اگر rate limit در API را از دست بدهم چه اتفاقی می‌افتد؟ یک خطای ۴۲۹ (Too Many Requests) دریافت می‌کنید. برای مدیریت این مشکل با graceful در کدتان، exponential backoff پیاده‌سازی کنید.

آیا محدودیت‌های Codex از محدودیت‌های پیام ChatGPT جدا هستند؟ بله. Codex سهمیه وظیفه خود را دارد که از محدودیت‌های پیام مکالمه ChatGPT جداست.

جمع‌بندی

محدودیت‌های استفاده OpenAI Codex به‌طور قابل توجهی بر اساس پلان متفاوت است -- از ~۲۵ وظیفه روزانه در Plus تا تقریباً نامحدود در Enterprise. برای اکثر توسعه‌دهندگان انفرادی، پلان Plus کافی است. اگر مداوم به محدودیت‌ها می‌رسید، ارتقا به Pro یا انتقال به API با قیمت‌گذاری پرداخت به ازای توکن انعطاف‌پذیری بیشتری می‌دهد.

اگر اپلیکیشن‌های مجهز به هوش مصنوعی می‌سازید و به تولید رسانه مقرون‌به‌صرفه کنار جریان کاری کدنویسی نیاز دارید، Hypereal AI را رایگان امتحان کنید -- ۳۵ کردیت، بدون نیاز به کارت اعتباری. API ساده است و به‌خوبی با پروژه‌های ساخته‌شده با Codex یا هر ابزار کدنویسی هوش مصنوعی دیگری کار می‌کند. توسعه‌دهندگان ایرانی می‌توانند مستقیم ثبت‌نام کنند و بدون محدودیت از API استفاده کنند.