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

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

VS Code با هوش مصنوعی FluxCDN

در VS Code چند راه دارید و همه با همان آدرس و کلید کار می‌کنند: چت خود Copilot با ارائه‌دهندهٔ «Custom Endpoint»، یا یکی از افزونه‌های متن‌باز. این افزونه‌ها در Cursor، Windsurf و دیگر ویرایشگرهای ساخته‌شده بر VS Code هم نصب می‌شوند. Claude Code و Codex هم افزونهٔ VS Code دارند؛ صفحهٔ خودشان را ببینید.

مجوز:
VS Code و افزونهٔ Copilot Chat: MIT؛ سرویس Copilot اختصاصی است
سیستم‌عامل‌ها:
macOS، Linux، Windows
آدرس (سازگار با OpenAI):
https://ai.fluxcdn.cloud/api/v1
آدرس (آدرس کامل درخواست):
https://ai.fluxcdn.cloud/api/v1/chat/completions

پیش از شروع

  • یک کلید API بسازید. در صفحهٔ کلیدهای API دکمهٔ «ساخت کلید» را بزنید و کلید را همان لحظه کپی کنید؛ با flux_live_ شروع می‌شود و دوباره کامل نشان داده نمی‌شود.
  • برای ایجنت‌ها کلید جدا بسازید و با دکمهٔ «سقف‌ها» برایش سقف هزینهٔ روزانه یا ماهانه بگذارید. ایجنت‌ها خودشان پشت هم درخواست می‌فرستند؛ سقف جلوی هزینهٔ پیش‌بینی‌نشده را می‌گیرد.
  • کمی اعتبار در حساب داشته باشید (صورت‌حساب).
  • در نمونه‌ها به‌جای flux_live_YOUR_KEY کلید خودتان را بگذارید.

GitHub Copilot Chat

از VS Code نسخهٔ 1.122 به بعد. حساب GitHub یا اشتراک Copilot لازم نیست و این مصرف از سهمیهٔ Copilot کم نمی‌شود.

مستندات خود ابزار ↗
  1. گام 1: ارائه‌دهندهٔ Custom Endpoint را اضافه کنید

    از Command Palette فرمان Chat: Manage Language Models را باز کنید، Add Models و بعد Custom Endpoint را بزنید. یک نام (مثلاً FluxCDN AI) و کلید را بدهید و نوع API را Chat Completions بگذارید. کلید در حافظهٔ امن VS Code می‌ماند.

  2. گام 2: یک مدل انتخاب کنید و chatLanguageModels.json را کامل کنید

    VS Code فایل chatLanguageModels.json را باز می‌کند. بخش models را مثل زیر کنید و خط apiKey را همان‌طور که VS Code نوشته نگه دارید. برای هر مدل دیگر یک بلوک دیگر در models بگذارید. toolCalling: true لازم است تا مدل در حالت Agent دیده شود.

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

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

    chatLanguageModels.json
    [
      {
        "name": "FluxCDN AI",
        "vendor": "customendpoint",
        "apiKey": "${input:chat.lm.secret.…}",
        "apiType": "chat-completions",
        "models": [
          {
            "id": "anthropic/claude-sonnet-5.5",
            "name": "Claude Sonnet 5.5 (FluxCDN)",
            "url": "https://ai.fluxcdn.cloud/api/v1/chat/completions",
            "toolCalling": true,
            "vision": true,
            "maxInputTokens": 1000000,
            "maxOutputTokens": 32000
          }
        ]
      }
    ]

    نوع‌های دیگر هم کار می‌کنند: "apiType": "messages" با آدرس https://ai.fluxcdn.cloud/api/v1/messages، یا "responses" با https://ai.fluxcdn.cloud/api/v1/responses. Chat Completions ساده‌ترین است.

  3. گام 3: مدل را انتخاب کنید

    مدل را در فهرست مدل‌های چت بردارید. اگر دیده نشد، VS Code را یک بار ببندید و باز کنید.

Cline

ایجنت متن‌باز با حساب کاربری اختیاری؛ با کلید خودتان حساب Cline لازم نیست.

مجوز:
Apache-2.0
سیستم‌عامل‌ها:
VS Code، JetBrains، CLI
مستندات خود ابزار ↗
  1. گام 1: ارائه‌دهنده را تنظیم کنید

    در پنل Cline روی چرخ‌دنده (تنظیمات) بزنید و این مقدارها را بدهید. در Model Configuration پنجرهٔ متن (Context Window) را برابر مدل بگذارید؛ Cline با آن تصمیم می‌گیرد کی گفت‌وگو را خلاصه کند.

    Settings
    API Provider:  OpenAI Compatible
    Base URL:      https://ai.fluxcdn.cloud/api/v1
    API Key:       flux_live_YOUR_KEY
    Model ID:      anthropic/claude-sonnet-5.5

Kilo Code

مجوز:
MIT
سیستم‌عامل‌ها:
VS Code، JetBrains، CLI
مستندات خود ابزار ↗
  1. گام 1: یک ارائه‌دهندهٔ سفارشی بسازید

    Settings → Providers، پایین صفحه Custom provider: شناسه fluxcdn، نام نمایشی FluxCDN AI، Provider API را OpenAI Compatible بگذارید، آدرس https://ai.fluxcdn.cloud/api/v1 و کلید را بدهید. Kilo فهرست مدل‌ها را خودش از FluxCDN می‌گیرد (Fetch models). برای CLI یا تنظیم دقیق‌تر، فایل زیر را بنویسید و کلید را در FLUXCDN_API_KEY بگذارید.

    ~/.config/kilo/kilo.jsonc
    {
      "$schema": "https://app.kilo.ai/config.json",
      "model": "fluxcdn/anthropic/claude-sonnet-5.5",
      "provider": {
        "fluxcdn": {
          "npm": "@ai-sdk/openai-compatible",
          "name": "FluxCDN AI",
          "options": {
            "baseURL": "https://ai.fluxcdn.cloud/api/v1",
            "apiKey": "{env:FLUXCDN_API_KEY}"
          },
          "models": {
            "anthropic/claude-sonnet-5.5": { "name": "Claude Sonnet 5.5", "tool_call": true, "limit": { "context": 1000000, "output": 32000 } },
            "qwen/qwen3-coder": { "name": "Qwen3 Coder", "tool_call": true, "limit": { "context": 262144, "output": 32000 } }
          }
        }
      }
    }

    {env:…} در فایل تنظیمات پروژه خوانده نمی‌شود؛ کلید را در فایل سراسری نگه دارید.

Zoo Code

ادامهٔ Roo Code، که 15 مه 2026 بایگانی شد. تنظیمش با Roo Code یکی است.

مجوز:
Apache-2.0
سیستم‌عامل‌ها:
VS Code و ویرایشگرهای ساخته‌شده بر آن
مستندات خود ابزار ↗
  1. گام 1: ارائه‌دهنده را تنظیم کنید

    از آیکون تنظیمات همین مقدارها را بدهید. Zoo Code فقط با فراخوانی ابزار بومی کار می‌کند؛ مدلی با برچسب Tools انتخاب کنید.

    Settings
    API Provider:  OpenAI Compatible
    Base URL:      https://ai.fluxcdn.cloud/api/v1
    API Key:       flux_live_YOUR_KEY
    Model ID:      anthropic/claude-sonnet-5.5

Continue

مجوز:
Apache-2.0
سیستم‌عامل‌ها:
VS Code، JetBrains، CLI
مستندات خود ابزار ↗
  1. گام 1: مدل‌ها را در config.yaml بنویسید

    Continue فایل را پس از ذخیره دوباره می‌خواند. capabilities: [tool_use] برای حالت Agent لازم است. Continue مدل‌های gpt-5 را خودکار به API Responses می‌فرستد؛ با useResponsesApi: false همه از یک مسیر می‌روند.

    ~/.continue/config.yaml · Windows: %USERPROFILE%\.continue\config.yaml
    name: FluxCDN
    version: 1.0.0
    schema: v1
    models:
      - name: Claude Sonnet 5.5 (FluxCDN)
        provider: openai
        model: anthropic/claude-sonnet-5.5
        apiBase: https://ai.fluxcdn.cloud/api/v1
        apiKey: flux_live_YOUR_KEY
        roles: [chat, edit, apply]
        capabilities: [tool_use, image_input]
      - name: GPT-5.5 (FluxCDN)
        provider: openai
        model: openai/gpt-5.5
        apiBase: https://ai.fluxcdn.cloud/api/v1
        apiKey: flux_live_YOUR_KEY
        useResponsesApi: false
        roles: [chat, edit, apply]
        capabilities: [tool_use, image_input]
      - name: Qwen3 Coder (FluxCDN)
        provider: openai
        model: qwen/qwen3-coder
        apiBase: https://ai.fluxcdn.cloud/api/v1
        apiKey: flux_live_YOUR_KEY
        roles: [chat, edit, apply]
        capabilities: [tool_use]

    نقش‌های embed و rerank را به مدل‌های FluxCDN ندهید؛ ایندکس کد با embedder محلی خود Continue کار می‌کند.

بررسی کنید که کار می‌کند

  1. گام 1: از ایجنت کاری بخواهید

    یک مدل FluxCDN را در پنل چت بردارید و بنویسید «فایل‌های این پوشه را فهرست کن». اگر ابزاری صدا زده شد، همه‌چیز درست است. خطاهای Copilot در Output → GitHub Copilot Chat دیده می‌شوند.

رفع مشکل

مدل در حالت Agent دیده نمی‌شود
در chatLanguageModels.json باید "toolCalling": true باشد و مدل ابزار را پشتیبانی کند.
Cline زود گفت‌وگو را خلاصه می‌کند یا پیام «context» می‌دهد
در Model Configuration پنجرهٔ متن را برابر مدل بگذارید (در صفحهٔ هر مدل آمده).
خطای 401 یا invalid_api_key
کلید کامل کپی نشده، باطل شده یا جای دیگری گذاشته شده. کلید با flux_live_ شروع می‌شود و فاصلهٔ اضافه ندارد. اگر ابزار کلید را از متغیر محیطی می‌خواند، پس از تنظیم آن یک ترمینال یا پنجرهٔ تازه باز کنید.
خطای 402، insufficient_credit (در Codex: insufficient_quota) با اینکه اعتبار دارید
پیش از هر درخواست، بیشترین هزینه‌ای که آن درخواست ممکن است داشته باشد از اعتبارتان کنار گذاشته می‌شود. وقتی پاسخ تمام شد فقط هزینهٔ واقعی برداشته می‌شود و بقیه برمی‌گردد. ابزاری که برای هر درخواست خروجی خیلی بلندی می‌خواهد، مبلغ بزرگی کنار می‌گذارد. سقف خروجی ابزار را کمتر کنید (مثلاً 32000 توکن) یا اعتبار اضافه کنید.
خطای 404 یا model_not_found
شناسهٔ مدل باید دقیقاً همان باشد که در صفحهٔ مدل‌ها آمده، با پیشوند سازنده: anthropic/claude-sonnet-5.5، نه claude-sonnet-5.5. حروف کوچک و نقطه‌ها مهم‌اند. شناسه را کپی کنید، تایپ نکنید.
خطای 404 که از مدل حرفی نمی‌زند
آدرس پایه درست نیست. بیشتر ابزارها https://ai.fluxcdn.cloud/api/v1 را می‌خواهند و خودشان بقیه را اضافه می‌کنند؛ /chat/completions را دو بار ننویسید و /v1 را جا نیندازید. جدول کدام آدرس را ببینید.
خطا دربارهٔ previous_response_id یا ابزارهای داخلی OpenAI (جست‌وجوی وب، جست‌وجوی فایل، اجرای کد)
بعضی ابزارها بی‌صدا به API Responses می‌روند. FluxCDN آن را دارد، اما بدون حافظه (هر بار کل گفت‌وگو فرستاده می‌شود) و بدون ابزارهایی که روی سرور OpenAI اجرا می‌شوند. ابزار را روی Chat Completions بگذارید: در n8n Use Responses API را خاموش کنید، در Continue useResponsesApi: false، در Vercel AI SDK openai.chat(...) و در LangChain use_responses_api=False.
ایجنت ابزاری صدا نمی‌زند یا مدل در فهرست ایجنت نیست
مدلی انتخاب کنید که ابزار (tools) را پشتیبانی کند؛ در صفحهٔ مدل‌ها برچسب Tools دارد. در بعضی ابزارها باید این قابلیت را برای مدل روشن کنید (گام‌های بالا). مسیریاب‌ها برای ایجنت‌ها پیشنهاد نمی‌شوند.
خطای 429: rate_limit_exceeded یا budget_exceeded
یا تعداد درخواست در دقیقه از سقف گذشته (کمی صبر کنید؛ بیشتر ابزارها خودشان دوباره می‌فرستند)، یا هزینهٔ امروز یا این ماهِ همین کلید به سقفش رسیده. سقف را در کلیدهای API با دکمهٔ «سقف‌ها» ببینید.
خطای 502، 503، 504 یا 529
سرویس سازندهٔ مدل لحظه‌ای در دسترس نبوده. دوباره بفرستید؛ بیشتر ابزارها خودشان این کار را می‌کنند. درخواستی که پیش از پاسخ شکست بخورد هزینه‌ای ندارد. اگر طول کشید، موقتاً مدل دیگری انتخاب کنید.

محدودیت‌ها

  • پیشنهادهای کم‌رنگ حین تایپ (تکمیل کد)، جست‌وجوی معنایی و قابلیت‌های وابسته به embedding در Copilot همچنان از GitHub می‌آیند و حساب GitHub می‌خواهند.

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