Codex (CLI شرکت OpenAI)

کارهای محلی جدید Codex را از طریق Responses API استریمی OneProvider اجرا کنید.

CLI و برنامهٔ دسکتاپ عامل کدنویسی Codex

چه چیزی کار می‌کند

از پاسخ‌های استریمی، فراخوانی تابع، ابزارهای محلی مانند apply_patch و حسابداری مصرف پشتیبانی می‌کند. این تنظیم کارهای محلی جدید در CLI، دسکتاپ و IDE را تغییر می‌دهد؛ گفتگوهای ابری Codex را تغییر نمی‌دهد.

محدودیت کلاینت

بعد از تغییر ارائه‌دهنده، Codex را دوباره راه‌اندازی کنید و یک کار محلی جدید بسازید. کارهای موجود همان مدل و ارائه‌دهنده‌ای را نگه می‌دارند که با آن شروع شده‌اند.

راه‌اندازی

1. نصب یا بررسی Codex

   اگر codex --version از قبل یک نسخه چاپ می‌کند، ادامه دهید. در غیر این صورت CLI فعلی را نصب کنید.

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

2. در دسترس گذاشتن یک کلید اختصاصی

   یک کلید اختصاصی OneProvider بسازید و آن را در همان نشست ترمینالی که Codex را اجرا می‌کند export کنید.

   export ONEPROVIDER_API_KEY="sk-your-key-here"

3. افزودن ارائه‌دهندهٔ سفارشی

   ~/.codex/config.toml را باز کنید (دسکتاپ: Settings → Configuration → Open config.toml) و ارائه‌دهندهٔ OneProvider را اضافه کنید.

   model_provider = "oneprovider"
   model = "gpt-6.1-sol"
   [model_providers.oneprovider]
   name = "OneProvider"
   base_url = "https://api.oneprovider.dev/v1"
   env_key = "ONEPROVIDER_API_KEY"
   wire_api = "responses"

4. راه‌اندازی مجدد و آزمون یک کار محلی جدید

   کاربران CLI یک بررسی فقط‌خواندنی اجرا کنند. کاربران دسکتاپ باید برنامه را کامل ببندند، دوباره باز کنند و یک کار محلی جدید شروع کنند.

   codex

بررسی اتصال

تأیید درخواست در داشبورد

درخواست تکمیل‌شده باید مدل انتخابی، /v1/responses، مصرف توکن و مبلغ کسرشده را نشان دهد.

مشخصات اتصال

پروتکل

responses

Endpoint

https://api.oneprovider.dev/v1

امنیت کلید

از یک کلید اختصاصی با دامنهٔ دسترسی محدود استفاده کنید. در macOS برنامهٔ دسکتاپی که از Dock باز شده ممکن است متغیرهای محیطی ترمینال را به ارث نبرد؛ به‌جای گذاشتن راز در config.toml از احراز هویت Keychain مبتنی بر دستور در Codex استفاده کنید.

کدام مدل را انتخاب کنیم

model را در همان config.toml و زیر model_provider تنظیم کنید. gpt-6.1-sol ردهٔ پیشرو برای کارهای دشوار عامل‌محور، gpt-6.1-terra پیش‌فرض متعادل برای کار روزمره و gpt-5.6-luna ردهٔ کم‌هزینه برای کارهای پرحجم و سریع است. Codex با Responses API کار می‌کند، پس شناسه‌های GPT را از صفحهٔ مدل‌ها انتخاب کنید؛ نرخ‌ها در صفحهٔ قیمت‌ها است.

خطاهای رایج و راه‌حل‌ها

401 یا «missing credentials»

ONEPROVIDER_API_KEY برای Codex دیده نمی‌شود. آن را در ترمینالی که Codex را اجرا می‌کند export کنید. برنامهٔ دسکتاپی که از Dock باز شده در macOS آن را به ارث نمی‌برد: از احراز هویت Keychain مبتنی بر دستور استفاده کنید.

404

base_url باید https://api.oneprovider.dev/v1 همراه با /v1 باشد و wire_api باید "responses" باشد.

Codex هنوز مدل یا ارائه‌دهندهٔ قدیمی را به کار می‌برد

کارهای موجود همان ارائه‌دهنده‌ای را نگه می‌دارند که با آن شروع شده‌اند. Codex را دوباره راه‌اندازی کنید و یک کار محلی جدید بسازید.

«You've hit your usage limit» یا Codex از من ورود به ChatGPT می‌خواهد

این سقف اشتراک ChatGPT است: درخواست به ChatGPT رفته، پس ارائه‌دهندهٔ OneProvider فعال نیست. model_provider = "oneprovider" را در بالاترین خط config.toml و بالای هر [table] بگذارید (بدون نقل‌قول هوشمند)، Codex را کامل ببندید و یک کار محلی جدید شروع کنید. سپس با codex logout از ChatGPT خارج شوید (در برنامهٔ دسکتاپ: از تنظیمات آن) و codex را در ترمینالی اجرا کنید که ONEPROVIDER_API_KEY در آن export شده است: با فعال بودن ارائه‌دهنده، فقط با کلید کار می‌کند. آزمون سریع: codex -c model_provider=oneprovider. wire_api فقط "responses" را می‌پذیرد.

429 «Insufficient balance»

موجودی یا سقف کلید تمام شده است. شارژ کنید؛ تلاش دوباره کمکی نمی‌کند.

پرسش‌های متداول

آیا این گفتگوهای ابری Codex را تغییر می‌دهد؟

نه، فقط کارهای محلی جدید در CLI، دسکتاپ و IDE را.

به حساب OpenAI نیاز دارم؟

نه، کلید OneProvider برای کارهای محلی جای آن را می‌گیرد.

می‌توانم در Codex از مدل‌های Claude استفاده کنم؟

Codex با Responses API و شناسه‌های GPT کار می‌کند. برای Claude از Claude Code استفاده کنید.

هزینه را کجا بررسی کنم؟

در صفحهٔ «مصرف» داشبورد: هر درخواست مدل، /v1/responses و مبلغ کسرشده را نشان می‌دهد.

پاسخ‌های سریع

از کدام base URL استفاده کنم؟

Claude Code و SDKهای Anthropic از https://api.oneprovider.dev استفاده می‌کنند. SDKهای OpenAI و کلاینت‌های سازگار با OpenAI از https://api.oneprovider.dev/v1 استفاده می‌کنند. یک کلید پشت هر دو آدرس کار می‌کند؛ فهرست مدل‌ها در صفحهٔ مدل‌ها و نرخ‌ها در صفحهٔ قیمت‌ها است.

چگونه احراز هویت کنم؟

کلید خام sk-… را در x-api-key یا Authorization: Bearer بفرستید: یکی از این دو، نه هر دو. کلید را در یک متغیر محیطی نگه دارید، نه در فایلی که commit می‌شود. اطلاعات بیشتر دربارهٔ احراز هویت .

کلید را از کجا بگیرم؟

حساب کاربری خود را در ربات Telegram به نام @oneprovider_robot یا در app.oneprovider.dev باز کنید، موجودی را شارژ کنید و «صدور کلید» را بزنید. هر کلید می‌تواند سقف مصرف مخصوص خودش را داشته باشد. حساب کاربری و کلیدهای API .

کدهای 401، 404 و 429 یعنی چه؟

401: کلید ارسال نشده، اشتباه تایپ شده یا در هدر نادرست فرستاده شده است؛ کلید را کامل و بدون گیومه و فاصله جای‌گذاری کنید. 404: معمولاً base URL نادرست است، مثلاً /v1 جا افتاده یا دوبار آمده است. 429 با پیام «Insufficient balance»: موجودی حساب کاربری یا سقف مصرف کلید تمام شده است؛ به‌جای تلاش دوباره، شارژ کنید. هر 429 دیگری محدودیت نرخ است؛ تا پایان زمان Retry-After صبر کنید. جزئیات: کدهای خطا و رفع اشکال .

چرا استریم‌ها قطع یا ریست می‌شوند؟

VPN و پروکسی‌های VLESS اغلب SSE را بافر می‌کنند یا مذاکرهٔ HTTP/2 را مختل می‌کنند. OneProvider هیچ محدودیت منطقه‌ای ندارد و استریم‌ها را بافر نمی‌کند؛ پروکسی را خاموش کنید و دوباره امتحان کنید.

اگر این‌ها کافی نبود از کجا بپرسم؟

در Telegram به @Oneproviderhelpbot پیام بدهید یا در حساب کاربری وب «پشتیبانی» را باز کنید و کد وضعیت HTTP و متن دقیق خطا را بفرستید. پشتیبانی چگونه کار می‌کند .