پرش به محتوا
FluxCDNFluxCDN
esc
ورود
در این صفحه

مستنداتراهنمای ابزارها

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. گام 1: کلید را در یک متغیر محیطی بگذارید

    Codex کلید را از متغیری می‌خواند که در env_key نام برده‌اید. ما اسمش را FLUXCDN_API_KEY گذاشته‌ایم.

    ~/.zshrc · ~/.bashrc
    export FLUXCDN_API_KEY="flux_live_YOUR_KEY"

    پس از آن یک ترمینال تازه باز کنید (در ویندوز PowerShell را ببندید و دوباره باز کنید).

  2. گام 2: یک ترکیب مدل انتخاب کنید و config.toml را بنویسید

    اگر این فایل را از قبل دارید، این خط‌ها را به آن اضافه کنید. چهار خط بالا باید پیش از هر بخش […] بیایند. model_context_window فقط برای مدل‌هایی است که OpenAI نیستند. اگر CODEX_HOME را تنظیم کرده‌اید، فایل در همان پوشه است.

    یک ترکیب انتخاب کنید؛ تنظیم‌های زیر با آن عوض می‌شوند. هر شناسه‌ای از صفحهٔ مدل‌ها را هم می‌شود جایشان گذاشت.

    قیمت هر میلیون توکن. قیمت‌های طرح رایگان، به تومان با نرخ امروز. مسیریاب‌ها (router/auto و مانند آن) برای ایجنت‌ها پیشنهاد نمی‌شوند: ایجنت به مدلی نیاز دارد که حتماً ابزار را پشتیبانی کند.

    ~/.codex/config.toml · Windows: %USERPROFILE%\.codex\config.toml
    model = "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. گام 3: Codex را اجرا کنید

    در پوشهٔ پروژه codex را اجرا کنید. برای یک بار با مدل دیگر، شناسه را هنگام شروع بدهید؛ منوی /model فقط مدل‌هایی را می‌شناسد که خود Codex می‌شناسد.

    Terminal
    codex
    
    # 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. گام 4: چند ترکیب کنار هم: پروفایل‌ها

    برای هر ترکیب یک فایل جدا بسازید، مثلاً ~/.codex/deepseek.config.toml با همان محتوای بالا و مدل دیگر، و Codex را با codex --profile deepseek اجرا کنید. جدول‌های [profiles.x] داخل فایل اصلی دیگر خوانده نمی‌شوند.

  5. گام 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. گام 1: وضعیت را ببینید

    در Codex بنویسید /status. باید مدل شما و ارائه‌دهندهٔ «FluxCDN» را نشان دهد.

  2. گام 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 هر بار کل گفت‌وگو را می‌فرستد، همان‌طور که با هر ارائه‌دهندهٔ دیگری می‌کند.

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