BroadRouter
شروع کریں

اوپن ماڈلز کے ساتھ Claude Code: پراکسی، نیٹو اینڈپوائنٹس اور حدیں

BroadNet Inference ٹیم · 6 منٹ کی پڑھائی · شائع شدہ

Claude Code، Anthropic Messages API کی درخواستیں ANTHROPIC_BASE_URL پر بھیجتا ہے۔ OpenAI-compatible فراہم کنندہ کے لیے LiteLLM جیسا ترجمہ کرنے والا پراکسی چلا کر Claude Code کو اس پر پوائنٹ کریں، یا DeepSeek یا Z.ai جیسا فراہم کنندہ منتخب کریں جس کا اپنا Anthropic فارمیٹ اینڈپوائنٹ ہے۔ Anthropic، Claude Code میں غیر Claude ماڈلز کو سپورٹ نہیں کرتا، اس لیے ٹولز، کیشنگ اور کانٹیکسٹ کی حدیں خود ٹیسٹ کریں۔

Claude Code ہر درخواست Anthropic Messages API فارمیٹ میں بھیجتا ہے، /v1/messages پر، جہاں بھی ANTHROPIC_BASE_URL پوائنٹ کرتا ہو۔ زیادہ تر اوپن ماڈل فراہم کنندگان، BroadNet Inference سمیت، اس کے بجائے OpenAI فارمیٹ بولتے ہیں۔ اس لیے آپ کو یا تو دونوں کے درمیان ترجمہ کرنے والا پراکسی چاہیے، یا ایسا فراہم کنندہ جو اپنا Anthropic فارمیٹ اینڈپوائنٹ شائع کرتا ہو۔ یہ پوسٹ دونوں کا احاطہ کرتی ہے، ساتھ میں وہ حدیں جو طے کرتی ہیں کہ یہ کرنا فائدہ مند ہے یا نہیں۔

Claude Code براہِ راست OpenAI-compatible API کو کال کیوں نہیں کر سکتا؟

Claude Code کی گیٹ وے مطابقت گائیڈ ان فارمیٹس کی فہرست دیتی ہے جو گیٹ وے کو فراہم کرنے ہوں گے۔ سادہ base URL کے لیے وہ ہے Anthropic Messages: /v1/messages، اختیاری /v1/messages/count_tokens کے ساتھ، اور anthropic-beta اور anthropic-version ہیڈرز آگے بھیجے جائیں۔ OpenAI-compatible API مختلف درخواست اور جواب کی ساخت کے ساتھ /v1/chat/completions فراہم کرتا ہے۔ Claude Code کو براہِ راست اس پر پوائنٹ کریں تو درخواستیں ناکام ہوتی ہیں۔

شروع کرنے سے پہلے ایک اور بات جان لیں۔ Claude Code کے اپنے ڈاکس کہتے ہیں کہ Anthropic “doesn’t support routing Claude Code to non-Claude models through any gateway.” (ترجمہ: کسی بھی گیٹ وے کے ذریعے Claude Code کو غیر Claude ماڈلز پر روٹ کرنا سپورٹ نہیں کرتا۔) پھر بھی کئی لوگ ایسا کرتے ہیں، لیکن Anthropic میں کوئی اسے آپ کے لیے ڈیبگ نہیں کرے گا۔

آپ کے تین اختیارات کیا ہیں؟

راستہ کیسے کام کرتا ہے کس کے لیے بہترین نقصان
ترجمہ کرنے والا پراکسی (LiteLLM) Claude Code لوکل پراکسی سے Anthropic فارمیٹ میں بات کرتا ہے؛ پراکسی OpenAI-compatible فراہم کنندہ کو کال کرتا ہے کسی خاص OpenAI-compatible فراہم کنندہ، جیسے BroadNet، کا استعمال چلانے اور اپ ڈیٹ کرنے کے لیے ایک اور پراسیس؛ ترجمے میں خلا
نیٹو Anthropic فارمیٹ اینڈپوائنٹ فراہم کنندہ خود /v1/messages قبول کرتا ہے ان کے بنانے والوں سے DeepSeek یا GLM ماڈلز ہر ایک کچھ فیلڈز میپ کرتا یا نظرانداز کرتا ہے
کوئی دوسرا ایجنٹ ایسا ایجنٹ استعمال کریں جو OpenAI-compatible base URL لیتا ہے جسے خاص طور پر Claude Code کی ضرورت نہیں آپ Claude Code کا انٹرفیس اور فیچرز چھوڑ دیتے ہیں

LiteLLM کے ذریعے Claude Code کیسے چلائیں؟

غیر Anthropic ماڈلز کے لیے LiteLLM کا ٹیوٹوریل یوں کام کرتا ہے: پراکسی انسٹال کریں، config.yaml میں ماڈلز متعین کریں، اسے شروع کریں، پھر Claude Code میں دو ویری ایبلز سیٹ کریں۔ LiteLLM فارمیٹس کے درمیان ترجمہ کرتا ہے، اس لیے Claude Code، Anthropic درخواستیں ہی بھیجتا رہتا ہے۔

BroadNet ماڈلز کو اسی طرح متعین کریں جیسے LiteLLM گائیڈ میں ہے، openai/ سابقے اور api_base کے ساتھ:

model_list:
  - model_name: glm
    litellm_params:
      model: openai/broadnet/glm-5.3
      api_base: https://inference.broadnet.ai/v1
      api_key: os.environ/BROADNET_API_KEY
      rpm: 30
  - model_name: qwen
    litellm_params:
      model: openai/broadnet/qwen3.8-27b
      api_base: https://inference.broadnet.ai/v1
      api_key: os.environ/BROADNET_API_KEY
      rpm: 30

general_settings:
  master_key: os.environ/LITELLM_MASTER_KEY

پراکسی شروع کریں:

uv tool install 'litellm[proxy]'
export BROADNET_API_KEY='your-broadnet-key'
export LITELLM_MASTER_KEY='sk-any-local-secret'
litellm --config config.yaml   # listens on http://0.0.0.0:4000

پھر Claude Code کو اس پر پوائنٹ کریں۔ ANTHROPIC_AUTH_TOKEN ایک Authorization: Bearer ہیڈر کے طور پر جاتا ہے، جسے LiteLLM پڑھتا ہے:

export ANTHROPIC_BASE_URL=http://0.0.0.0:4000
export ANTHROPIC_AUTH_TOKEN="$LITELLM_MASTER_KEY"
export ANTHROPIC_MODEL=glm                  # main model
export ANTHROPIC_DEFAULT_HAIKU_MODEL=qwen   # background tasks
export ANTHROPIC_DEFAULT_SONNET_MODEL=glm   # the sonnet alias
export ANTHROPIC_DEFAULT_OPUS_MODEL=glm     # the opus alias
export CLAUDE_CODE_SUBAGENT_MODEL=glm       # subagents
claude

Claude Code میں /status چلائیں۔ Anthropic base URL والی لائن میں پراکسی کا پتہ نظر آنا چاہیے۔

ماڈل ویری ایبلز اہم ہیں۔ LiteLLM کا Claude Code صفحہ خبردار کرتا ہے کہ ایسا بلٹ اِن Claude نام منتخب کرنا جو آپ کی کنفیگ میں متعین نہیں، “Invalid model name passed in” کے ساتھ ناکام ہوتا ہے۔ Claude Code کا env-vars ریفرنس کہتا ہے کہ ANTHROPIC_DEFAULT_HAIKU_MODEL بیک گراؤنڈ کام کے لیے بھی استعمال ہوتا ہے، اس لیے اسے بھی میپ کریں، ورنہ بیک گراؤنڈ درخواستیں ایسا Haiku نام مانگیں گی جسے پراکسی نہیں جانتا۔ CLAUDE_CODE_SUBAGENT_MODEL سب ایجنٹس کا ڈیفالٹ ماڈل سیٹ کرتا ہے، لیکن سب ایجنٹ بناتے وقت Claude جو ماڈل دیتا ہے، اکثر sonnet یا haiku جیسا کوئی عرفی نام، وہ ترجیح لیتا ہے۔ sonnet اور opus عرفی نام بھی میپ کرنے کا مطلب ہے کہ وہ درخواستیں بھی ایسے ماڈل تک پہنچیں گی جسے پراکسی جانتا ہے۔ اپنی BroadNet کلید پراکسی کے انوائرمنٹ میں رکھیں، کسی پروجیکٹ کی کمٹ شدہ .claude/settings.json میں کبھی نہیں۔

کون سے DeepSeek اور GLM اینڈپوائنٹس بغیر پراکسی کے چلتے ہیں؟

دو ماڈل بنانے والے Anthropic فارمیٹ base URLs شائع کرتے ہیں:

فراہم کنندہ Base URL ماڈل ہینڈلنگ (ان کے ڈاکس سے، 2026-11-15 کو دیکھا گیا)
DeepSeek https://api.deepseek.com/anthropic claude-sonnet* اور claude-haiku* نام deepseek-flash پر میپ ہوتے ہیں؛ claude-opus*، deepseek-v4-pro پر؛ جو نام claude سے شروع نہیں ہوتے، وہ 400 لوٹاتے ہیں
Z.ai (GLM Coding Plan) https://api.z.ai/api/anthropic کلید ANTHROPIC_AUTH_TOKEN میں؛ دستی مثال Opus اور Sonnet کو glm-5.3[1m] پر اور Haiku کو glm-5.3-flash[1m] پر میپ کرتی ہے

DeepSeek کا 10 ستمبر 2026 کا ریلیز نوٹ کہتا ہے کہ deepseek-flash، DeepSeek-V4.1-Flash چلاتا ہے۔ اس کا Anthropic API صفحہ یہ بھی بتاتا ہے کہ وہ کیا نظرانداز کرتا ہے: دوسری چیزوں کے ساتھ cache_control، budget_tokens، disable_parallel_tool_use اور anthropic-version ہیڈر۔ deepseek-flash پر اسسٹنٹ پیغامات میں تصاویر 400 لوٹاتی ہیں، اور deepseek-v4-pro تصاویر کی جگہ “[Unsupported Image]” رکھ دیتا ہے۔

اگر آپ کو Claude Code میں صرف DeepSeek یا GLM چاہیے، تو یہ نیٹو اینڈپوائنٹس سب سے مختصر راستہ ہیں۔ دونوں کی قیمتوں اور پلان کی حدوں کا موازنہ Claude API کے متبادل والے صفحے میں ہے۔

غیر Claude ماڈل پر کیا ٹوٹتا یا بدلتا ہے؟

ترجمے سے درخواستیں چلتی رہتی ہیں، لیکن Claude Code کے کئی فیچرز ایسی چیزوں پر انحصار کرتے ہیں جنہیں پراکسی یا دوسرا ماڈل شاید آگے نہ بھیجے۔ Claude Code کے ڈاکس ان کے نام بتاتے ہیں:

  • پرامپٹ کیشنگ۔ Claude Code system اور پیغام کے بلاکس پر cache_control لگاتا ہے۔ اگر گیٹ وے یا اپ اسٹریم اسے ہٹا دے، تو کوئی ایرر نہیں آتا، لیکن ہر ٹرن کا بل بغیر کیش والے ان پٹ کے طور پر بنتا ہے۔ OpenAI-compatible اپ اسٹریم پر کیشنگ اس کے بجائے اس فراہم کنندہ کے اپنے اصولوں پر چلتی ہے۔ جب BroadNet کا usage بلاک کیش ہٹ بتاتا ہے، تو وہ کیش شدہ ان پٹ کا بل کم قیمت پر بناتا ہے؛ اپنے لاگز میں cached_tokens جانچیں۔
  • ٹوکن گنتی۔ /v1/messages/count_tokens کے بغیر Claude Code حروف پر مبنی اندازے پر لوٹ آتا ہے، اس لیے /context تخمینی ہے۔
  • کانٹیکسٹ ونڈو۔ Claude Code نامعلوم ماڈل ناموں پر اپنی ڈیفالٹ ونڈو لگاتا ہے۔ ماڈل کے مطابق CLAUDE_CODE_AUTO_COMPACT_WINDOW (100,000 سے 1,000,000 ٹوکن) سیٹ کریں۔ 262,144 ٹوکن کانٹیکسٹ والے Qwen3.8 27B کے لیے اسے اس سے کافی نیچے رکھیں۔
  • نامعلوم فیلڈز۔ Extra inputs are not permitted یا کسی anthropic-beta قدر کا نام لینے والا 400 کا مطلب ہے کہ اپ اسٹریم میں کسی نے پری ریلیز فیلڈ مسترد کی۔ ڈاکس CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 تجویز کرتے ہیں۔
  • تھنکنگ۔ MAX_THINKING_TOKENS اور ایڈاپٹو تھنکنگ Claude کے فیچرز ہیں۔ BroadNet پر DeepSeek V4.1 Flash، GLM 5.3 اور Qwen3.8 27B جواب دینے سے پہلے ریزننگ کرتے ہیں، اور وہ ریزننگ ٹوکن max_tokens میں گنے جاتے ہیں۔ اگر جواب خالی آئیں، تو آؤٹ پٹ کی حد بڑھائیں یا reasoning_effort low بھیجیں۔ دیکھیں ریزننگ ماڈلز خالی جواب کیوں دیتے ہیں۔
  • تصاویر۔ BroadNet پر GLM 5.3 صرف متن والا ہے۔ اگر آپ اسکرین شاٹس پیسٹ کرتے ہیں تو Qwen3.8 27B استعمال کریں۔

بھروسہ کرنے سے پہلے ایک اصل ٹاسک شروع سے آخر تک ٹیسٹ کریں، فائل ایڈٹس، شیل کمانڈز اور ایک طویل سیشن کے ساتھ۔

Claude Code کے پیچھے BroadNet کا کون سا ماڈل رکھیں؟

Claude Code ٹول کالز کے ذریعے فائلیں پڑھتا، ایڈٹ کرتا اور کمانڈز چلاتا ہے۔ BroadNet کا API ریفرنس دو ماڈلز کے لیے ٹولز، اسٹرکچرڈ آؤٹ پٹ اور ریزننگ دستاویز کرتا ہے:

ماڈل ان پٹ / آؤٹ پٹ فی 1M ٹوکن کانٹیکسٹ تصاویر ٹولز دستاویزی
GLM 5.3 $0.78 / $3.46 1,048,576 نہیں ہاں
Qwen3.8 27B $0.175 / $2.17 262,144 ہاں ہاں
DeepSeek V4.1 Flash $0.175 / $0.52 1,048,576 ہاں دستاویزی نہیں

بڑی ریپوزٹریز کے لیے GLM 5.3 فطری مرکزی ماڈل ہے۔ Qwen3.8 27B فی ان پٹ ٹوکن سستا ہے اور تصاویر اور ہلکی بیک گراؤنڈ کالز کے لیے چلتا ہے۔ دونوں کے لیے ٹاپ اپ چاہیے؛ وہ $5 کے ابتدائی کریڈٹ میں شامل نہیں۔ GLM 5.3 بمقابلہ Qwen3.8 27B موازنہ میں دونوں ساتھ ساتھ ہیں۔

کیا آپ Claude Code کے ساتھ BroadNet کا مقررہ قیمت والا پلان استعمال کر سکتے ہیں؟

دستاویزی طور پر نہیں، اور خریدنے سے پہلے یہ جاننا بہتر ہے۔ Full Moon، Orbit اور Meteor پلانز صرف DeepSeek V4.1 Flash کا احاطہ کرتے ہیں، اور BroadNet اس کے لیے ٹول کالنگ دستاویز نہیں کرتا۔ ہر پلان سیشن ایک وقت میں ایک درخواست بھی چلاتا ہے۔ Claude Code مرکزی لوپ کے ساتھ سب ایجنٹس اور بیک گراؤنڈ ٹاسکس چلا سکتا ہے، اور وہ درخواستیں ایک سیشن پر قطار میں لگیں گی۔

اگر آپ کو مقررہ قیمت ہی چاہیے، تو ایسا ایجنٹ استعمال کریں جسے BroadNet پلان کے ساتھ دستاویز کرتا ہے، جیسے Aider۔ Claude Code کے لیے استعمال کے مطابق ادائیگی والے GLM 5.3 یا Qwen3.8 27B استعمال کریں، جو ہر کلید پر فی منٹ 30 درخواستوں اور 4 جاری درخواستوں کی اجازت دیتے ہیں۔ 429 پر ایررز اور دوبارہ کوششیں کے مطابق رک کر دوبارہ کوشش کریں۔

دوسرا ایجنٹ کب بہتر انتخاب ہے؟

اگر آپ کو خود Claude Code کی ضرورت نہیں، تو پراکسی چھوڑ دیں۔ opencode، Cline، Roo Code، Continue اور Aider سب براہِ راست OpenAI-compatible base URL، ایک کلید اور ایک ماڈل ID لیتے ہیں۔ ہر ایک کے فیلڈز کے نام کوڈنگ ایجنٹس میں اوپن ماڈلز میں ہیں، ساتھ میں opencode اور Cline کی سیٹ اپ گائیڈز۔ کم پرزوں کا مطلب ہے ترجمے کے کم بگز۔ اس کام کے لیے ماڈلز کے موازنے کے لیے دیکھیں کوڈنگ ایجنٹس کے لیے بہترین اوپن ماڈل۔

اگر آپ کا کام ایکسٹینڈڈ تھنکنگ، Anthropic پرامپٹ کیشنگ یا Claude Code کے نئے بیٹا جیسے Claude سے مخصوص فیچرز پر انحصار کرتا ہے، تو Claude ماڈلز پر ہی رہیں۔ اس صورت میں ماڈل بدلنے کے بجائے Claude Code کے اندر ہی لاگت گھٹائیں۔

BroadNet Inference کہاں فٹ ہوتا ہے

BroadNet Inference ایک OpenAI-compatible API ہے، اس لیے یہ Claude Code تک صرف LiteLLM جیسے پراکسی کے ذریعے پہنچتا ہے۔ پراکسی کے پیچھے GLM 5.3 اور Qwen3.8 27B دستاویزی ٹول کالنگ والے دو ماڈلز ہیں، جن کا بل فی ٹوکن بنتا ہے اور درخواست کے بعد کوئی مواد محفوظ نہیں رکھا جاتا۔ اگر آپ کو نیٹو Anthropic فارمیٹ اینڈپوائنٹ چاہیے، تو DeepSeek اور Z.ai زیادہ آسان ہیں۔ اگر آپ کو BroadNet کا مقررہ قیمت والا پلان چاہیے، تو اسے ایسے ایجنٹ کے ساتھ جوڑیں جو OpenAI فارمیٹ بولتا ہو۔

عام سوالات

کیا Claude Code میں DeepSeek استعمال ہو سکتا ہے؟

ہاں، دو طریقوں سے۔ DeepSeek ایک Anthropic فارمیٹ base URL، https://api.deepseek.com/anthropic، شائع کرتا ہے، جو claude-sonnet اور claude-haiku ناموں کو deepseek-flash پر اور claude-opus ناموں کو deepseek-v4-pro پر میپ کرتا ہے۔ یا آپ DeepSeek ماڈلز کے کسی بھی OpenAI-compatible ہوسٹ کے آگے LiteLLM جیسا ترجمہ کرنے والا پراکسی لگاتے ہیں۔

کیا Claude Code، OpenAI-compatible API کے ساتھ چلتا ہے؟

براہِ راست نہیں۔ Claude Code، Anthropic Messages API کی درخواستیں /v1/messages پر بھیجتا ہے۔ LiteLLM جیسا پراکسی ان درخواستوں کو لے کر OpenAI طرز کے /chat/completions اینڈپوائنٹ پر بھیجتا ہے، پھر جواب کا الٹا ترجمہ کرتا ہے۔

کیا Anthropic دوسرے ماڈلز کے ساتھ Claude Code کے استعمال کو سپورٹ کرتا ہے؟

نہیں۔ Claude Code کے گیٹ وے ڈاکس کہتے ہیں کہ Anthropic کسی بھی گیٹ وے کے ذریعے Claude Code کو غیر Claude ماڈلز پر روٹ کرنا سپورٹ نہیں کرتا۔ عملی طور پر یہ کئی لوگوں کے لیے چلتا ہے، لیکن اس راستے کے بگز آپ کو خود ڈیبگ کرنے ہوں گے۔

Claude Code کے پیچھے BroadNet کا کون سا ماڈل لگاؤں؟

GLM 5.3 یا Qwen3.8 27B۔ BroadNet صرف ان دونوں کے لیے ٹول کالنگ دستاویز کرتا ہے، اور Claude Code فائلیں ٹولز کے ذریعے ہی ایڈٹ کرتا اور کمانڈز چلاتا ہے۔ GLM 5.3 کا کانٹیکسٹ 1,048,576 ٹوکن ہے؛ Qwen3.8 27B کا 262,144 ہے اور وہ تصاویر قبول کرتا ہے۔

کیا میں Claude Code کو BroadNet کے لامحدود پلان پر چلا سکتا ہوں؟

دستاویزی طور پر نہیں۔ مقررہ قیمت والے پلانز صرف DeepSeek V4.1 Flash کا احاطہ کرتے ہیں، اور BroadNet اس ماڈل کے لیے ٹول کالنگ دستاویز نہیں کرتا۔ پلان سیشن ایک وقت میں ایک درخواست بھی چلاتا ہے، جبکہ Claude Code سب ایجنٹس متوازی چلا سکتا ہے۔

LiteLLM کے ذریعے Claude Code "Invalid model name" کیوں کہتا ہے؟

Claude Code نے ایسا ماڈل نام مانگا جو آپ کی config.yaml میں متعین نہیں، اکثر کوئی بلٹ اِن Claude عرفی نام یا بیک گراؤنڈ والا Haiku ماڈل۔ ANTHROPIC_MODEL اور ANTHROPIC_DEFAULT_HAIKU_MODEL کو اپنی model_list کے ناموں پر سیٹ کریں۔

Markdown میں پڑھیںChatGPT سے پوچھیںClaude سے پوچھیںPerplexity سے پوچھیں