OpenCode با هوش مصنوعی FluxCDN
OpenCode در ترمینال (و اپ دسکتاپ و افزونهٔ ویرایشگرش) کد را میخواند و تغییر میدهد. FluxCDN را به شکل یک ارائهدهندهٔ سازگار با OpenAI به آن معرفی میکنید.
- مجوز:
- MIT، متنباز
- سیستمعاملها:
- macOS، Linux، Windows (پیشنهاد خودش: WSL)
- آدرس (سازگار با OpenAI):
https://ai.fluxcdn.cloud/api/v1
پیش از شروع
- یک کلید API بسازید. در صفحهٔ کلیدهای API دکمهٔ «ساخت کلید» را بزنید و کلید را همان لحظه کپی کنید؛ با
flux_live_شروع میشود و دوباره کامل نشان داده نمیشود. - برای ایجنتها کلید جدا بسازید و با دکمهٔ «سقفها» برایش سقف هزینهٔ روزانه یا ماهانه بگذارید. ایجنتها خودشان پشت هم درخواست میفرستند؛ سقف جلوی هزینهٔ پیشبینینشده را میگیرد.
- کمی اعتبار در حساب داشته باشید (صورتحساب).
- در نمونهها بهجای
flux_live_YOUR_KEYکلید خودتان را بگذارید.
راهاندازی
گام 1: کلید را به OpenCode بدهید
در OpenCode بنویسید
/connect، پایین فهرست Other را بزنید، شناسهٔ ارائهدهنده راfluxcdnبنویسید و کلید را بچسبانید. کلید در~/.local/share/opencode/auth.jsonمیماند.گام 2: یک ترکیب مدل انتخاب کنید و
opencode.jsonرا بنویسیدبرای همهٔ پروژهها در
~/.config/opencode/opencode.json، یا فقط برای یک پروژه در ریشهٔ همان پروژه. هر مدلی که میخواهید باید زیرmodelsنام برده شود؛limitرا هم بگذارید، چون OpenCode اندازهٔ مدلهای ارائهدهندهٔ سفارشی را نمیداند.قیمت هر میلیون توکن. قیمتهای طرح رایگان، به تومان با نرخ امروز. مسیریابها (
router/autoو مانند آن) برای ایجنتها پیشنهاد نمیشوند: ایجنت به مدلی نیاز دارد که حتماً ابزار را پشتیبانی کند.~/.config/opencode/opencode.json{ "$schema": "https://opencode.ai/config.json", "provider": { "fluxcdn": { "npm": "@ai-sdk/openai-compatible", "name": "FluxCDN AI", "options": { "baseURL": "https://ai.fluxcdn.cloud/api/v1" }, "models": { "anthropic/claude-haiku-5.5": { "name": "Claude Haiku 5.5", "limit": { "context": 1000000, "output": 32000 } }, "anthropic/claude-sonnet-5.5": { "name": "Claude Sonnet 5.5", "limit": { "context": 1000000, "output": 32000 } } } } }, "model": "fluxcdn/anthropic/claude-sonnet-5.5", "small_model": "fluxcdn/anthropic/claude-haiku-5.5" }بهجای
/connectمیشود کلید را از متغیر محیطی خواند: درoptionsاین را اضافه کنید:"apiKey": "{env:FLUXCDN_API_KEY}".گام 3: مدل را انتخاب کنید
در OpenCode بنویسید
/modelsو یکی از مدلهای FluxCDN را بردارید.
بررسی کنید که کار میکند
گام 1: از ترمینال امتحان کنید
اولی مدلهای تنظیمشده را فهرست میکند و دومی یک پیام میفرستد. اگر خطا دیدید،
--print-logsرا هم اضافه کنید.Terminalopencode models fluxcdn opencode run "Say hello in one sentence"
رفع مشکل
- خطای 401 با کلید از متغیر محیطی
- اگر متغیر تعریف نشده باشد،
{env:FLUXCDN_API_KEY}خالی میشود و درخواست بدون کلید میرود. متغیر را در همان ترمینال تعریف کنید، یا کلید را با/connectبدهید. - مدل در
/modelsنیست - هر مدل باید زیر
modelsدرopencode.jsonنام برده شود. شناسهٔ کامل در OpenCode این شکل است:fluxcdn/deepseek/deepseek-v4-pro. - خطای 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را جا نیندازید. جدول کدام آدرس را ببینید. - ایجنت ابزاری صدا نمیزند یا مدل در فهرست ایجنت نیست
- مدلی انتخاب کنید که ابزار (tools) را پشتیبانی کند؛ در صفحهٔ مدلها برچسب Tools دارد. در بعضی ابزارها باید این قابلیت را برای مدل روشن کنید (گامهای بالا). مسیریابها برای ایجنتها پیشنهاد نمیشوند.
- خطای 429:
rate_limit_exceededیاbudget_exceeded - یا تعداد درخواست در دقیقه از سقف گذشته (کمی صبر کنید؛ بیشتر ابزارها خودشان دوباره میفرستند)، یا هزینهٔ امروز یا این ماهِ همین کلید به سقفش رسیده. سقف را در کلیدهای API با دکمهٔ «سقفها» ببینید.
- خطای 502، 503، 504 یا 529
- سرویس سازندهٔ مدل لحظهای در دسترس نبوده. دوباره بفرستید؛ بیشتر ابزارها خودشان این کار را میکنند. درخواستی که پیش از پاسخ شکست بخورد هزینهای ندارد. اگر طول کشید، موقتاً مدل دیگری انتخاب کنید.
محدودیتها
- OpenCode برای کار به فراخوانی ابزار نیاز دارد؛ مدلی با برچسب Tools انتخاب کنید.

