Codex با هوش مصنوعی FluxCDN
Codex (برنامهٔ ترمینال و افزونهٔ ویرایشگر) کد را میخواند، فرمان اجرا میکند و تغییر میدهد. با یک «ارائهدهندهٔ» تازه در فایل config.toml به FluxCDN وصل میشود و با هر مدلی از فهرست ما کار میکند.
- مجوز:
- Apache-2.0، متنباز
- سیستمعاملها:
- macOS، Linux، Windows
- آدرس (OpenAI Responses):
https://ai.fluxcdn.cloud/api/v1
پیش از شروع
- یک کلید API بسازید. در صفحهٔ کلیدهای API دکمهٔ «ساخت کلید» را بزنید و کلید را همان لحظه کپی کنید؛ با
flux_live_شروع میشود و دوباره کامل نشان داده نمیشود. - Codex نصب باشد. اگر قبلاً نصبش کردهاید، بهروز باشد.
- برای ایجنتها کلید جدا بسازید و با دکمهٔ «سقفها» برایش سقف هزینهٔ روزانه یا ماهانه بگذارید. ایجنتها خودشان پشت هم درخواست میفرستند؛ سقف جلوی هزینهٔ پیشبینینشده را میگیرد.
- کمی اعتبار در حساب داشته باشید (صورتحساب).
- در نمونهها بهجای
flux_live_YOUR_KEYکلید خودتان را بگذارید.
راهاندازی
گام 1: کلید را در یک متغیر محیطی بگذارید
Codex کلید را از متغیری میخواند که در
env_keyنام بردهاید. ما اسمش راFLUXCDN_API_KEYگذاشتهایم.~/.zshrc · ~/.bashrcexport FLUXCDN_API_KEY="flux_live_YOUR_KEY"پس از آن یک ترمینال تازه باز کنید (در ویندوز PowerShell را ببندید و دوباره باز کنید).
گام 2: یک ترکیب مدل انتخاب کنید و
config.tomlرا بنویسیداگر این فایل را از قبل دارید، این خطها را به آن اضافه کنید. چهار خط بالا باید پیش از هر بخش
[…]بیایند.model_context_windowفقط برای مدلهایی است که OpenAI نیستند. اگرCODEX_HOMEرا تنظیم کردهاید، فایل در همان پوشه است.قیمت هر میلیون توکن. قیمتهای طرح رایگان، به تومان با نرخ امروز. مسیریابها (
router/autoو مانند آن) برای ایجنتها پیشنهاد نمیشوند: ایجنت به مدلی نیاز دارد که حتماً ابزار را پشتیبانی کند.~/.codex/config.toml · Windows: %USERPROFILE%\.codex\config.tomlmodel = "openai/gpt-5.5" model_provider = "fluxcdn" web_search = "disabled" # model_reasoning_effort = "medium" [model_providers.fluxcdn] name = "FluxCDN" base_url = "https://ai.fluxcdn.cloud/api/v1" env_key = "FLUXCDN_API_KEY" wire_api = "responses"گام 3: Codex را اجرا کنید
در پوشهٔ پروژه
codexرا اجرا کنید. برای یک بار با مدل دیگر، شناسه را هنگام شروع بدهید؛ منوی/modelفقط مدلهایی را میشناسد که خود Codex میشناسد.Terminalcodex # another model, just this time codex -m deepseek/deepseek-v4-pro codex -c model="z-ai/glm-5.3" # one task without the interactive screen codex exec "Summarise the README"codex execیک کار را بدون صفحهٔ تعاملی انجام میدهد (مثلاً در اسکریپت). اجازههای اجرای فرمان را طبق مستندات خود Codex تنظیم کنید؛ گزینههایی را که همهٔ اجازهها را دور میزنند به کار نبرید.گام 4: چند ترکیب کنار هم: پروفایلها
برای هر ترکیب یک فایل جدا بسازید، مثلاً
~/.codex/deepseek.config.tomlبا همان محتوای بالا و مدل دیگر، و Codex را باcodex --profile deepseekاجرا کنید. جدولهای[profiles.x]داخل فایل اصلی دیگر خوانده نمیشوند.گام 5: در ویرایشگر
افزونهٔ Codex همان
~/.codex/config.tomlرا میخواند. متغیرFLUXCDN_API_KEYباید برای خود ویرایشگر هم تعریف باشد: در macOS و Linux ویرایشگر را از ترمینالی باز کنید که متغیر را دارد (مثلاًcode .)؛ در ویندوزsetxکافی است، فقط ویرایشگر را یک بار ببندید و باز کنید.
هر تنظیم چه میکند
model- مدلی که Codex با آن کار میکند؛ هر شناسهای از صفحهٔ مدلها.
model_provider= fluxcdn- Codex را به بخش
[model_providers.fluxcdn]میفرستد. base_url= https://ai.fluxcdn.cloud/api/v1- آدرس FluxCDN، با
/v1. Codex خودش/responsesرا اضافه میکند. env_key= FLUXCDN_API_KEY- نام متغیری که کلید در آن است؛ خود کلید اینجا نمیآید.
wire_api= responses- Codex فقط API Responses را با ارائهدهندهٔ دیگر به کار میبرد؛
chatدیگر پذیرفته نمیشود. name= FluxCDN- نامی که Codex در
/statusو پیامهایش نشان میدهد. model_context_window- اختیاری: پنجرهٔ متن مدل، برای مدلهایی که Codex نمیشناسد. ترکیبهای بالا عددش را از فهرست ما میگذارند.
model_reasoning_effort- اختیاری: چقدر فکر کند (
low،medium،high)، برای مدلهایی که پیش از پاسخ فکر میکنند. web_search= disabled- جستوجوی وب داخلی Codex روی سرور OpenAI اجرا میشود و از این راه در دسترس نیست. خاموشش کنید.
بررسی کنید که کار میکند
گام 1: وضعیت را ببینید
در Codex بنویسید
/status. باید مدل شما و ارائهدهندهٔ «FluxCDN» را نشان دهد.گام 2: یک کار کوچک بدهید
مثلاً «فایل README را خلاصه کن». درخواست را با مدل و هزینهاش در فعالیت کنسول میبینید.
رفع مشکل
- «unexpected status 401 Unauthorized: This API key is not valid.» یا Codex کلید را پیدا نمیکند
- کلید درست نیست یا متغیر در همان ترمینال تعریف نشده. بدون اینکه کل کلید را نشان دهید، ابتدایش را ببینید:
echo ${FLUXCDN_API_KEY:0:10}(در PowerShell:$env:FLUXCDN_API_KEY.Substring(0,10)). بایدflux_live_چاپ شود. - Codex دربارهٔ
wire_apiخطا میدهد - مقدارش باید
"responses"باشد."chat"در نسخههای تازهٔ Codex حذف شده است. - ارائهدهنده عوض نمیشود
- بخش
[model_providers.fluxcdn]باید در فایل خانگی~/.codex/config.tomlباشد. فایل.codex/config.tomlداخل پروژه ارائهدهندهها را نمیخواند. - «No model named ….»
- شناسهٔ مدل در FluxCDN نیست یا درست نوشته نشده. آن را دقیقاً از صفحهٔ مدلها کپی کنید، با پیشوند سازنده:
openai/gpt-5.5، نهgpt-5.5. - «Model metadata for … not found. Defaulting to fallback metadata»
- بیخطر است و کار ادامه پیدا میکند. Codex مدلهایی را که نمیشناسد با تنظیم عمومی اجرا میکند و فایلها را از راه شل ویرایش میکند.
openai/gpt-5.5ابزار وصلهٔ (patch) خود Codex را هم میگیرد.model_context_windowاندازهٔ واقعی را به Codex میگوید. /modelمدلهای FluxCDN را نشان نمیدهد- عادی است. مدل را در
config.tomlبگذارید یا هنگام شروع بدهید:codex -m qwen/qwen3-coder. - «Quota exceeded. Check your plan and billing details.»
- این پیام خود Codex است و یعنی اعتبار FluxCDN شما برای این درخواست کافی نیست. پیش از هر درخواست، بیشترین هزینهٔ ممکن آن کنار گذاشته میشود و بعد فقط هزینهٔ واقعی برداشته میشود. اعتبار اضافه کنید یا مدل ارزانتری انتخاب کنید. Codex با این خطا دوباره تلاش نمیکند و میایستد.
- خطای 429:
rate_limit_exceededیاbudget_exceeded - یا تعداد درخواست در دقیقه از سقف گذشته (کمی صبر کنید؛ بیشتر ابزارها خودشان دوباره میفرستند)، یا هزینهٔ امروز یا این ماهِ همین کلید به سقفش رسیده. سقف را در کلیدهای API با دکمهٔ «سقفها» ببینید.
- خطای 502، 503، 504 یا 529
- سرویس سازندهٔ مدل لحظهای در دسترس نبوده. دوباره بفرستید؛ بیشتر ابزارها خودشان این کار را میکنند. درخواستی که پیش از پاسخ شکست بخورد هزینهای ندارد. اگر طول کشید، موقتاً مدل دیگری انتخاب کنید.
محدودیتها
- جستوجوی وب داخلی Codex (
web_search) روی سرور OpenAI اجرا میشود و از این راه در دسترس نیست. - FluxCDN گفتوگو را نگه نمیدارد؛ Codex هر بار کل گفتوگو را میفرستد، همانطور که با هر ارائهدهندهٔ دیگری میکند.

