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

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

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

Claude Code کد شما را می‌خواند، فرمان اجرا می‌کند و فایل‌ها را ویرایش می‌کند. با دو تنظیم به FluxCDN وصل می‌شود: آدرس و کلید. بعد هر مدلی از فهرست ما می‌تواند پشتش کار کند و هزینه به تومان از کیف پولتان کم می‌شود.

مجوز:
نرم‌افزار Anthropic، متن‌باز نیست
سیستم‌عامل‌ها:
macOS، Linux، Windows
آدرس (سازگار با Anthropic):
https://ai.fluxcdn.cloud/api

پیش از شروع

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

راه‌اندازی

  1. گام 1: یک ترکیب مدل انتخاب کنید و تنظیم‌ها را ذخیره کنید

    بهترین جا فایل تنظیمات خود Claude Code است: روی هر سه سیستم‌عامل یکسان است و با بستن ترمینال پاک نمی‌شود. اگر این فایل را از قبل دارید، فقط بلوک env را به آن اضافه کنید. متغیرهای محیطی (زبانه‌های بعدی) هم همین کار را می‌کنند؛ یکی از این دو راه کافی است.

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

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

    ~/.claude/settings.json · Windows: %USERPROFILE%\.claude\settings.json
    {
      "env": {
        "ANTHROPIC_BASE_URL": "https://ai.fluxcdn.cloud/api",
        "ANTHROPIC_AUTH_TOKEN": "flux_live_YOUR_KEY",
        "ANTHROPIC_MODEL": "anthropic/claude-sonnet-5.5",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-sonnet-5.5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-5.5",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-5.5",
        "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
        "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
      }
    }

    پس از تغییر پروفایل شل یک ترمینال تازه باز کنید. setx در ویندوز برای پنجره‌های بعدی ذخیره می‌شود؛ PowerShell را ببندید و دوباره باز کنید. فقط برای همین پنجره: $env:ANTHROPIC_BASE_URL = "https://ai.fluxcdn.cloud/api" و همین‌طور بقیه.

  2. گام 2: Claude Code را اجرا کنید

    در پوشهٔ پروژه claude را اجرا کنید. حساب Anthropic لازم نیست؛ درخواست‌ها با کلید FluxCDN فرستاده می‌شوند.

    Terminal
    cd your-project
    claude
  3. گام 3: در VS Code، JetBrains و اپ دسکتاپ

    افزونهٔ VS Code: تنظیم‌های زبانهٔ «VS Code» در گام اول را در settings.json خود VS Code بگذارید؛ claudeCode.disableLoginPrompt جلوی پنجرهٔ ورود Anthropic را می‌گیرد. افزونهٔ JetBrains همان تنظیم‌های Claude Code را به کار می‌برد (فایل ~/.claude/settings.json). اپ دسکتاپ Claude هیچ‌کدام را نمی‌خواند؛ آنجا آدرس و کلید را از منوی Developer → Configure Third-Party Inference وارد کنید.

هر تنظیم چه می‌کند

ANTHROPIC_BASE_URL= https://ai.fluxcdn.cloud/api
آدرس FluxCDN. بدون /v1 بنویسید؛ Claude Code خودش /v1/messages را اضافه می‌کند.
ANTHROPIC_AUTH_TOKEN= flux_live_…
کلید شما، که به شکل Authorization: Bearer فرستاده می‌شود. پیشنهاد ما همین است.
ANTHROPIC_API_KEY= flux_live_…
راه دیگر برای کلید (با هدر x-api-key). در حالت تعاملی Claude Code یک بار می‌پرسد از این کلید استفاده کند یا نه. یکی از این دو کافی است.
ANTHROPIC_MODEL
مدل اصلی؛ هر شناسه‌ای از صفحهٔ مدل‌ها. اگر خالی بماند Claude Code نام claude-opus-5-5 را می‌فرستد که FluxCDN آن را anthropic/claude-opus-5.5 می‌خواند.
ANTHROPIC_DEFAULT_OPUS_MODEL · ANTHROPIC_DEFAULT_SONNET_MODEL · ANTHROPIC_DEFAULT_HAIKU_MODEL
مدل‌هایی که پشت نام‌های opus، sonnet و haiku در منوی /model و در زیرعامل‌ها می‌نشینند. Haiku کارهای کوچک پس‌زمینه را انجام می‌دهد؛ یک مدل ارزان و سریع بگذارید. ANTHROPIC_SMALL_FAST_MODEL قدیمی است و به‌جایش همین Haiku را بگذارید.
CLAUDE_CODE_SUBAGENT_MODEL
اختیاری: یک مدل برای همهٔ زیرعامل‌ها (subagents).
CLAUDE_CODE_MAX_CONTEXT_TOKENS
اندازهٔ پنجرهٔ متن مدل. برای مدل‌هایی که Claude نیستند لازم است؛ بدون آن Claude Code هشدار می‌دهد که 200 هزار توکن فرض کرده. ترکیب‌های بالا عددش را از فهرست ما می‌گذارند.
CLAUDE_CODE_MAX_OUTPUT_TOKENS= 32000
سقف خروجی هر درخواست. با 32000 اعتبار کمتری برای هر درخواست کنار گذاشته می‌شود (پایین‌تر: «رفع مشکل»).
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC= 1
به‌روزرسانی خودکار، گزارش خطا و آمار استفاده را که به Anthropic می‌رود خاموش می‌کند. برای به‌روزرسانی، گاهی claude update را اجرا کنید.
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS= 1
قابلیت‌های آزمایشی‌ای را که فقط سرور Anthropic می‌فهمد نمی‌فرستد. با هر آدرسی غیر از Anthropic پیشنهاد می‌شود.

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

  1. گام 1: وضعیت را ببینید

    در Claude Code بنویسید /status. باید «Anthropic base URL» را https://ai.fluxcdn.cloud/api نشان دهد و «Auth token» را تنظیم‌شده.

  2. گام 2: یک پیام بفرستید

    مثلاً بنویسید «این پروژه چه کار می‌کند؟». پاسخ که آمد، درخواست را با مدل و هزینه‌اش در فعالیت کنسول می‌بینید.

  3. گام 3: مدل را عوض کنید

    /model deepseek/deepseek-v4-pro (یا هر شناسهٔ دیگر). Claude Code اول یک درخواست آزمایشی خیلی کوچک می‌فرستد و اگر جواب آمد، مدل عوض می‌شود.

رفع مشکل

«API Error: 402 Not enough credit for this request. Top up the wallet and try again.» با اینکه اعتبار دارید
پیش از هر درخواست، بیشترین هزینه‌ای که آن درخواست ممکن است داشته باشد از اعتبارتان کنار گذاشته می‌شود؛ وقتی پاسخ تمام شد فقط هزینهٔ واقعی برداشته می‌شود و بقیه برمی‌گردد. Claude Code روی Opus تا 128000 توکن خروجی می‌خواهد؛ یعنی دست‌کم 922,593 تومان برای هر درخواست کنار گذاشته می‌شود، حتی اگر پاسخ خیلی کمتر بشود. CLAUDE_CODE_MAX_OUTPUT_TOKENS را 32000 بگذارید تا این مبلغ به حدود 230,648 تومان برسد. اگر باز خطا دیدید، اعتبار اضافه کنید.
«Claude Code doesn't recognize the model …, assumes a context window of 200k tokens»
بی‌خطر است و کار ادامه پیدا می‌کند. Claude Code مدل‌هایی را که Claude نیستند نمی‌شناسد؛ CLAUDE_CODE_MAX_CONTEXT_TOKENS پنجرهٔ متن واقعی را به آن می‌گوید. ترکیب‌های بالا این خط را دارند و عددش در صفحهٔ هر مدل هم آمده.
Claude Code هنوز می‌خواهد وارد حساب Anthropic شوید
تنظیم‌ها خوانده نشده‌اند. فایل ~/.claude/settings.json را نگاه کنید: JSON باید درست باشد (کاماها، آکولادها). اگر متغیر محیطی گذاشته‌اید، ترمینال تازه باز کنید. در افزونهٔ VS Code claudeCode.disableLoginPrompt را true کنید.
Claude Code می‌پرسد از کلید API استفاده کند یا نه
این برای ANTHROPIC_API_KEY است و فقط یک بار پرسیده می‌شود؛ تأیید کنید. یا به‌جایش ANTHROPIC_AUTH_TOKEN بگذارید که چیزی نمی‌پرسد.
«There's an issue with the selected model (…)»
شناسهٔ مدل در FluxCDN نیست یا درست نوشته نشده. آن را دقیقاً از صفحهٔ مدل‌ها کپی کنید، با پیشوند سازنده: deepseek/deepseek-v4-pro، نه deepseek-v4-pro. مدل باید ابزار (tools) را پشتیبانی کند.
«Failed to authenticate. API Error: 401 This API key is not valid.»
کلید کامل کپی نشده، باطل شده یا هنوز کلید قبلی خوانده می‌شود. کلید با flux_live_ شروع می‌شود. در /status ببینید Claude Code کدام تنظیم را خوانده؛ اگر متغیر محیطی را عوض کرده‌اید، ترمینال تازه باز کنید. Claude Code با کلید نادرست دوباره تلاش نمی‌کند و همان بار اول این خطا را نشان می‌دهد.
هزینه‌ای که Claude Code نشان می‌دهد با کنسول فرق دارد
هزینه‌ای که Claude Code چاپ می‌کند (/cost، total_cost_usd) برآورد خودش با قیمت‌های فهرست Anthropic است، نه مبلغی که FluxCDN برداشته. هزینهٔ واقعی هر درخواست، به تومان، در فعالیت کنسول است.
خطای 429: rate_limit_exceeded یا budget_exceeded
یا تعداد درخواست در دقیقه از سقف گذشته (کمی صبر کنید؛ بیشتر ابزارها خودشان دوباره می‌فرستند)، یا هزینهٔ امروز یا این ماهِ همین کلید به سقفش رسیده. سقف را در کلیدهای API با دکمهٔ «سقف‌ها» ببینید.
خطای 502، 503، 504 یا 529
سرویس سازندهٔ مدل لحظه‌ای در دسترس نبوده. دوباره بفرستید؛ بیشتر ابزارها خودشان این کار را می‌کنند. درخواستی که پیش از پاسخ شکست بخورد هزینه‌ای ندارد. اگر طول کشید، موقتاً مدل دیگری انتخاب کنید.

محدودیت‌ها

  • ابزار WebSearch در Claude Code با هیچ آدرسی جز خود Anthropic کار نمی‌کند، چون جست‌وجو روی سرور Anthropic انجام می‌شود. WebFetch (خواندن یک صفحهٔ مشخص) کار می‌کند.
  • Anthropic فقط مدل‌های خودش را در Claude Code به‌طور رسمی پشتیبانی می‌کند. مدل‌های دیگر از نظر فنی کار می‌کنند؛ کیفیت کار ایجنت به مدل بستگی دارد.
  • اپ دسکتاپ Claude فایل تنظیمات و متغیرهای بالا را نمی‌خواند (گام 3).

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