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: ارائهدهندهٔ Custom Endpoint را اضافه کنید
از Command Palette فرمان Chat: Manage Language Models را باز کنید، Add Models و بعد Custom Endpoint را بزنید. یک نام (مثلاً FluxCDN AI) و کلید را بدهید و نوع API را Chat Completions بگذارید. کلید در حافظهٔ امن VS Code میماند.
گام 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: مدل را انتخاب کنید
مدل را در فهرست مدلهای چت بردارید. اگر دیده نشد، VS Code را یک بار ببندید و باز کنید.
Cline
ایجنت متنباز با حساب کاربری اختیاری؛ با کلید خودتان حساب Cline لازم نیست.
- مجوز:
- Apache-2.0
- سیستمعاملها:
- VS Code، JetBrains، CLI
گام 1: ارائهدهنده را تنظیم کنید
در پنل Cline روی چرخدنده (تنظیمات) بزنید و این مقدارها را بدهید. در Model Configuration پنجرهٔ متن (Context Window) را برابر مدل بگذارید؛ Cline با آن تصمیم میگیرد کی گفتوگو را خلاصه کند.
SettingsAPI 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: یک ارائهدهندهٔ سفارشی بسازید
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: ارائهدهنده را تنظیم کنید
از آیکون تنظیمات همین مقدارها را بدهید. Zoo Code فقط با فراخوانی ابزار بومی کار میکند؛ مدلی با برچسب Tools انتخاب کنید.
SettingsAPI 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: مدلها را در
config.yamlبنویسیدContinue فایل را پس از ذخیره دوباره میخواند.
capabilities: [tool_use]برای حالت Agent لازم است. Continue مدلهایgpt-5را خودکار به API Responses میفرستد؛ باuseResponsesApi: falseهمه از یک مسیر میروند.~/.continue/config.yaml · Windows: %USERPROFILE%\.continue\config.yamlname: 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: از ایجنت کاری بخواهید
یک مدل 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 SDKopenai.chat(...)و در LangChainuse_responses_api=False. - ایجنت ابزاری صدا نمیزند یا مدل در فهرست ایجنت نیست
- مدلی انتخاب کنید که ابزار (tools) را پشتیبانی کند؛ در صفحهٔ مدلها برچسب Tools دارد. در بعضی ابزارها باید این قابلیت را برای مدل روشن کنید (گامهای بالا). مسیریابها برای ایجنتها پیشنهاد نمیشوند.
- خطای 429:
rate_limit_exceededیاbudget_exceeded - یا تعداد درخواست در دقیقه از سقف گذشته (کمی صبر کنید؛ بیشتر ابزارها خودشان دوباره میفرستند)، یا هزینهٔ امروز یا این ماهِ همین کلید به سقفش رسیده. سقف را در کلیدهای API با دکمهٔ «سقفها» ببینید.
- خطای 502، 503، 504 یا 529
- سرویس سازندهٔ مدل لحظهای در دسترس نبوده. دوباره بفرستید؛ بیشتر ابزارها خودشان این کار را میکنند. درخواستی که پیش از پاسخ شکست بخورد هزینهای ندارد. اگر طول کشید، موقتاً مدل دیگری انتخاب کنید.
محدودیتها
- پیشنهادهای کمرنگ حین تایپ (تکمیل کد)، جستوجوی معنایی و قابلیتهای وابسته به embedding در Copilot همچنان از GitHub میآیند و حساب GitHub میخواهند.

