মূল কনটেন্টে যান
এআই টিউটোরিয়াল

স্ট্রিমিং, ফেইলওভার ও স্থানীয় ফলব্যাকসহ Infinite Claude Code-এর মাধ্যমে Claude Code চালান

Infinite Claude Code ইনস্টল করা, এর স্থানীয় Anthropic-সামঞ্জস্যপূর্ণ রাউটার যাচাই করা, Claude Code চালু করা, ঐচ্ছিক প্রোভাইডার কনফিগার করা, HUD-এর মাধ্যমে অনুরোধ পর্যবেক্ষণ করা এবং এর মডেল পুলজুড়ে স্বয়ংক্রিয় সাবএজেন্ট বিতরণ করা শিখুন।

পড়তে প্রায় 25 মিনিট লাগবে
স্ট্রিমিং, ফেইলওভার ও স্থানীয় ফলব্যাকসহ Infinite Claude Code-এর মাধ্যমে Claude Code চালান

Infinite Claude Code কী?

Infinite Claude Code হলো কোনো dependency ছাড়াই তৈরি একটি Node.js proxy, যা অফিসিয়াল Anthropic client—যেমন Claude Code CLI, Claude Desktop এবং সমর্থিত IDE extension—কে OpenAI-সামঞ্জস্যপূর্ণ model provider-এর একটি pool-এর সঙ্গে সংযুক্ত করে। এটি /v1/messages-এ Anthropic Messages API request গ্রহণ করে, সেগুলো provider-এর format-এ রূপান্তর করে এবং response-কে Anthropic-সামঞ্জস্যপূর্ণ real-time Server-Sent Events-এ ফিরিয়ে দেয়।

প্রকল্পটি বিনামূল্যের cloud model-কে অগ্রাধিকার দেয়, ঐচ্ছিক provider credential সমর্থন করে এবং স্থানীয় Ollama instance-এ fallback করতে পারে। প্রকল্পের README অনুযায়ী, router দ্রুত চালু হয়, 30 MB-এর কম RAM ব্যবহার করে এবং idle অবস্থায় কোনো CPU ব্যবহার করে না।

Repository-তে preconfigured cloud pool-কে বিনামূল্যে ব্যবহারের উপযোগী হিসেবে বর্ণনা করা হয়েছে। তবে সংশ্লিষ্ট external service-গুলো provider availability, rate limit, model access এবং pricing পরিবর্তন করতে পারে। তাই চলমান workload-এর জন্য নির্ভর করার আগে প্রতিটি provider-এর বর্তমান শর্ত দেখে নিন।

Router কীভাবে কাজ করে

স্থানীয় router ডিফল্টভাবে 127.0.0.1:20129-এ listen করে। Claude Code এই endpoint-এ Anthropic-ধাঁচের request পাঠায়। এরপর Infinite Claude Code task শ্রেণিবদ্ধ করে, উপযুক্ত model নির্বাচন করে, tool call অনুবাদ করে এবং result-টি client-এ stream করে ফেরত পাঠায়।

  1. Claude Code, Claude Desktop অথবা কোনো IDE extension /v1/messages-এ request পাঠায়।

  2. Semantic classifier prompt এবং উপলভ্য tool পর্যালোচনা করে।

  3. Dispatcher তার priority pool থেকে provider এবং model নির্বাচন করে।

  4. Providerটি unavailable বা rate-limited হলে router অন্য configured provider-এ চলে যায়।

  5. OpenAI-ধাঁচের function call Anthropic tool-use message-এ রূপান্তর করা হয়।

  6. Response token real-time SSE streaming-এর মাধ্যমে ফেরত দেওয়া হয়।

  7. Cloud route unavailable হলে এবং Ollama configured থাকলে router স্থানীয় model ব্যবহার করতে পারে।

মূল বৈশিষ্ট্য

সমান্তরাল subagent dispatch

Claude Code একাধিক subagent বা background session চালু করলে swarm dispatcher concurrent request-গুলো বিভিন্ন provider-এর মধ্যে ভাগ করে দিতে পারে, যাতে সব কাজ একটি model-এ না যায়। এর উদ্দেশ্য হলো single-provider bottleneck এবং rate-limit failure কমানো।

Semantic task routing

Router সম্ভাব্য workload অনুযায়ী model বেছে নেয়। নথিভুক্ত routing strategy architecture task-এর জন্য Nemotron 120B বা Kimi K3-এর মতো reasoning model, generation ও file edit-এর জন্য North Mini Code বা Qwen Coder-এর মতো code-focused model এবং দ্রুত command-এর জন্য Nemotron Lightning-কে অগ্রাধিকার দেয়।

Tool-call repair

কিছু open-weight model tool argument-এ ভুল JSON তৈরি করে। Claude Code tool call চালানোর আগে Infinite Claude Code একটি AST-ভিত্তিক sanitizer ব্যবহার করে unescaped quote বা অসম্পূর্ণ bracket-এর মতো সমস্যা মেরামতের চেষ্টা করে।

স্বয়ংক্রিয় provider failover

প্রকল্পটি OpenRouter, NVIDIA NIM, OmniRouter, 9Router, Groq, Cerebras, Together AI, Google Gemini, Mistral AI, OpenAI, Anthropic এবং অন্যান্য ঐচ্ছিক service-সহ একটি অগ্রাধিকারভিত্তিক pool সমর্থন করে। ব্যর্থ বা rate-limited request অন্য কোনো উপলভ্য provider-এর মাধ্যমে পুনরায় চেষ্টা করা যেতে পারে।

Monitoring dashboard

Browser-ভিত্তিক HUD সক্রিয় subagent, provider activity, generated token, latency এবং অফিসিয়াল Claude 3.7 Sonnet API pricing-এর ভিত্তিতে আনুমানিক সাশ্রয়ী অর্থের counter দেখায়।

Offline fallback

qwen3:4b বা deepseek-r1-এর মতো model ব্যবহার করে Ollama স্থানীয় resilience দিতে পারে। স্থানীয় performance এবং tool reliability নির্বাচিত model ও আপনার hardware-এর ওপর নির্ভর করে।

পূর্বশর্ত

  • Node.js 18 বা পরবর্তী সংস্করণ।

  • Manual installation method-এর জন্য Git।

  • Claude Code CLI, Claude Desktop অথবা সমর্থিত IDE integration।

  • Windows-এ PowerShell অথবা macOS ও Linux-এ একটি shell।

  • শুধু স্থানীয় offline fallback চাইলে Ollama।

প্রকল্পটির জন্য Python environment বা অতিরিক্ত Node.js package প্রয়োজন হয় না।

Infinite Claude Code ইনস্টল করুন

বিকল্প 1: Windows one-line installer

PowerShell খুলে repository থেকে installer command চালান:

& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/juanitogit/infinite-claude-code/main/install.ps1")))

এই command একটি remote script download করে সঙ্গে সঙ্গে চালায়। তাই আপনার security policy-তে প্রয়োজন হলে আগে install.ps1 পর্যালোচনা করুন।

বিকল্প 2: Manual Windows installation

git clone https://github.com/juanitogit/infinite-claude-code.git
cd infinite-claude-code
powershell -ExecutionPolicy Bypass -File .\install.ps1

বিকল্প 3: macOS বা Linux installation

git clone https://github.com/juanitogit/infinite-claude-code.git
cd infinite-claude-code
chmod +x install.sh && ./install.sh

Installation mode বেছে নিন

Interactive installer দুটি mode দেয়:

  • Express Install: ঐচ্ছিক provider credential না চেয়ে নথিভুক্ত preconfigured free tier কনফিগার করে।

  • Custom Install: অতিরিক্ত provider-এর API key চায়। যে provider configure করতে চান না, সেটি এড়িয়ে যেতে Enter চাপুন।

স্থানীয় Router যাচাই করুন

Repository directory থেকে service status পরীক্ষা করুন:

node bin/infinite-claude.js status

সুস্থ installation-এ Infinite Claude Code সক্রিয় আছে বলে দেখানো উচিত, local URL হিসেবে http://127.0.0.1:20129 শনাক্ত করা উচিত, SSE streaming নিশ্চিত করা উচিত এবং pool-এর সক্রিয় provider-গুলোর তালিকা দেখানো উচিত।

Infinite Claude Code সক্রিয় এবং সুস্থ অবস্থায় আছে!
URL: http://127.0.0.1:20129
স্ট্রিমিং: সক্রিয় (SSE রিয়েল-টাইম)
পুলে সক্রিয় প্রোভাইডার: ...

সার্ভিসটি সুস্থ অবস্থায় না থাকলে নিশ্চিত করুন যে Node.js 18 বা পরবর্তী সংস্করণ উপলভ্য আছে এবং অন্য কোনো অ্যাপ্লিকেশন ইতিমধ্যে 20129 পোর্ট ব্যবহার করছে না।

Claude Code চালু করুন

রাউটার চালু হয়ে গেলে এবং ইনস্টলার ক্লায়েন্ট কনফিগার করলে, স্বাভাবিকভাবে Claude Code চালু করুন:

claude

এরপর ইন্টার‌্যাক্টিভ সেশনে একটি কোডিং অনুরোধ লিখতে পারেন:

Inspect this project, explain its architecture, and identify the safest first refactoring task.

অনুরোধটি স্থানীয় প্রক্সির মাধ্যমে রাউট হওয়া উচিত এবং উত্তর তৈরি হওয়ার সঙ্গে সঙ্গে স্ট্রিম হয়ে ফিরে আসবে।

একটি সরাসরি কাজ চেষ্টা করুন

Claude Code সরাসরি টার্মিনাল থেকেও একটি প্রম্পট গ্রহণ করতে পারে:

claude "Review the authentication module and propose a refactoring plan"

খালি ইন্টার‌্যাক্টিভ সেশন দিয়ে শুরু করার প্রয়োজন নেই এমন কেন্দ্রীভূত কাজের জন্য এটি কার্যকর। মডেল নির্বাচন কমান্ডটি নিজে নয়, Infinite Claude Code-এর রাউটিং লজিক পরিচালনা করে।

Cyber HUD-এ অনুরোধ পর্যবেক্ষণ করুন

রাউটার সক্রিয় থাকা অবস্থায় নিচের স্থানীয় ঠিকানাটি খুলুন:

http://localhost:20129/hud

HUD বর্তমান সেশনের লাইভ টেলিমেট্রি দেখায়, যার মধ্যে রয়েছে:

  • প্রতিটি অনুরোধ পরিবেশনকারী প্রোভাইডার।

  • উৎপাদিত টোকেনের সংখ্যা।

  • মিলিসেকেন্ডে অনুরোধের লেটেন্সি।

  • একসঙ্গে সক্রিয় সাবএজেন্টের সংখ্যা।

  • Claude 3.7 Sonnet API-এর মূল্যের ভিত্তিতে আনুমানিক সাশ্রয়ের কাউন্টার।

কনফিগার করা পুলজুড়ে অনুরোধগুলো বিতরণ হচ্ছে কি না নিশ্চিত করতে এবং অস্বাভাবিকভাবে বেশি লেটেন্সি থাকা প্রোভাইডার শনাক্ত করতে এই ড্যাশবোর্ড ব্যবহার করুন।

প্রোভাইডার ও পরিবেশ ভেরিয়েবল কনফিগার করুন

src/providers.js-এ প্রোভাইডারের সংজ্ঞা কাস্টমাইজ করতে পারেন অথবা পরিবেশ ভেরিয়েবলের মাধ্যমে শংসাপত্র ও এন্ডপয়েন্ট সরবরাহ করতে পারেন। README-তে নিচের ভেরিয়েবলগুলো নথিভুক্ত আছে:

  • OPENROUTER_API_KEY: কাস্টম OpenRouter শংসাপত্র। নথিভুক্ত ডিফল্টে পূর্ব-কনফিগার করা ফ্রি টিয়ার ব্যবহার করা হয়।

  • NVIDIA_API_KEY: কাস্টম NVIDIA NIM শংসাপত্র। রিপোজিটরিতে পূর্ব-কনফিগার করা NIM কী-কে ডিফল্ট হিসেবে নথিভুক্ত করা হয়েছে।

  • OMNIROUTER_API_KEY: কাস্টম OmniRouter শংসাপত্র।

  • ROUTER9_API_KEY: কাস্টম 9Router শংসাপত্র।

  • GROQ_API_KEY: ঐচ্ছিক Groq শংসাপত্র।

  • TOGETHER_API_KEY: ঐচ্ছিক Together AI শংসাপত্র।

  • OLLAMA_HOST: Ollama এন্ডপয়েন্ট, ডিফল্ট হিসেবে http://localhost:11434।

  • PORT: স্থানীয় প্রক্সি পোর্ট, ডিফল্ট হিসেবে 20129।

উদাহরণস্বরূপ, macOS বা Linux শেল চালু করার আগে রাউটারকে ভিন্ন Ollama হোস্ট ও পোর্টে নির্দেশ করতে পারে:

export OLLAMA_HOST="http://localhost:11434"
export PORT="20129"

PowerShell-এ সমতুল্য সেশন ভেরিয়েবল হলো:

$env:OLLAMA_HOST = "http://localhost:11434"
$env:PORT = "20129"

ব্যক্তিগত API কী সোর্স কন্ট্রোলের বাইরে রাখুন। শেল প্রোফাইল, পরিবেশ ফাইল বা গোপন তথ্যসম্বলিত পরিবর্তিত প্রোভাইডার কনফিগারেশন কমিট করবেন না।

স্থানীয় ফলব্যাক হিসেবে Ollama সেট আপ করুন

Infinite Claude Code Ollama-কে অফলাইন বা জরুরি রুট হিসেবে সমর্থন করে। README-তে qwen3:4b এবং deepseek-r1-কে উদাহরণ স্থানীয় মডেল হিসেবে তালিকাভুক্ত করা হয়েছে।

  1. আলাদাভাবে Ollama ইনস্টল ও চালু করুন।

  2. আপনার Ollama ইনস্টলেশনে পছন্দের মডেলটি উপলভ্য করুন।

  3. OLLAMA_HOST-এর মান http://localhost:11434 রাখুন অথবা আপনার কাস্টম এন্ডপয়েন্টে পরিবর্তন করুন।

  4. স্ট্যাটাস কমান্ড দিয়ে আবার Infinite Claude Code রাউটার যাচাই করুন।

ইন্টারনেট বিচ্ছিন্নতার সময় স্থানীয় ফলব্যাক বিশেষভাবে কার্যকর, যদিও মডেলের গতি, কনটেক্সট ধারণক্ষমতা এবং কোডিংয়ের মান স্থানীয় মডেল এবং উপলভ্য CPU, মেমরি বা GPU রিসোর্সের ওপর নির্ভর করবে।

স্বয়ংক্রিয় সাবএজেন্ট চালান

যে কাজ ভেঙে সম্পাদন করলে সুবিধা হয়, তার জন্য Claude Code-কে একসঙ্গে চলা সাবএজেন্ট তৈরি করতে স্পষ্টভাবে বলুন:

claude "Divide this task and use concurrent subagents in parallel to build the complete platform"

নথিভুক্ত --bg অপশন ব্যবহার করে ব্যাকগ্রাউন্ড কাজও পাঠাতে পারেন:

claude --bg "Refactor the authentication module and write unit tests"

রাউটারটি একাধিক সাবএজেন্টের কল আলাদা প্রোভাইডারজুড়ে বিতরণ করার জন্য তৈরি। কাজ চলার সময় HUD দেখুন, যাতে swarm-এর লোড ও প্রোভাইডার নির্বাচন পর্যবেক্ষণ করতে পারেন।

উন্নত টিপস

প্রোভাইডারের উপলভ্যতার সঙ্গে কনকারেন্সি মিলিয়ে নিন

প্রকল্পটি ব্যাপক কনকারেন্সি সমর্থন করে, তবে বাহ্যিক প্রোভাইডারগুলোর নিজস্ব রেট লিমিট বা উপলভ্যতার সীমাবদ্ধতা থাকতে পারে। প্রচুর ব্যাকগ্রাউন্ড কাজ চালু করার আগে HUD ও সক্রিয় প্রোভাইডারের তালিকা পরীক্ষা করুন।

পুল সম্প্রসারণে ঐচ্ছিক কী ব্যবহার করুন

পূর্ব-কনফিগার করা রুটগুলো ব্যস্ত থাকলে Custom Install Groq বা Together AI-এর মতো প্রোভাইডার যোগ করতে পারে। বৃহত্তর কনফিগার করা পুল ফেইলওভার সিস্টেমকে আরও বেশি রুট দেয়, তবে প্রতিটি ঐচ্ছিক সার্ভিসের আলাদা কোটা ও শর্ত থাকতে পারে।

সমস্যা সমাধানের সময় স্ট্যাটাস কমান্ড ব্যবহার করুন

Claude ক্লায়েন্ট নিজে ডিবাগ করার আগে node bin/infinite-claude.js status চালান। এটি স্থানীয় রাউটার সমস্যা এবং মডেল-প্রোভাইডার বা ক্লায়েন্ট সমস্যার মধ্যে দ্রুত পার্থক্য নির্ণয় করে।

প্রয়োজনে পোর্ট পরিবর্তন করুন

20129 পোর্ট অন্য কোনো সার্ভিসের সঙ্গে সংঘর্ষে জড়ালে PORT-এর মান অন্য কিছুতে সেট করুন। পরিবর্তনের পর Anthropic ক্লায়েন্ট কনফিগারেশন একই স্থানীয় এন্ডপয়েন্টে নির্দেশ করছে কিনা নিশ্চিত করুন।

প্রোভাইডার কনফিগারেশন সতর্কতার সঙ্গে পরিদর্শন করুন

অভিজ্ঞ ব্যবহারকারীরা মডেল কাস্টমাইজ করতে src/providers.js পরিবর্তন করতে পারেন। প্রত্যাশিত প্রোভাইডার ফরম্যাট বজায় রাখুন এবং একসঙ্গে চলা এজেন্ট শুরু করার আগে একটি সাধারণ রিকোয়েস্ট দিয়ে পরিবর্তনগুলো পরীক্ষা করুন।

মালিকানাধীন কোড সুরক্ষিত রাখুন

ক্লাউডের মাধ্যমে পাঠানো প্রম্পটে সোর্স কোড, টুলের আউটপুট বা প্রজেক্টের প্রসঙ্গ থাকতে পারে। গোপনীয় রিপোজিটরির সঙ্গে রাউটার ব্যবহারের আগে সক্রিয় প্রতিটি প্রোভাইডারের গোপনীয়তা ও ডেটা-ব্যবস্থাপনা নীতি পর্যালোচনা করুন। কাজ স্থানীয় পরিবেশে রাখতে হলে Ollama রুট ব্যবহার করুন।

উপসংহার

Infinite Claude Code Anthropic ক্লায়েন্ট এবং ক্লাউড বা স্থানীয় মডেলের একটি বড় পুলের মধ্যে হালকা অনুবাদ ও রাউটিং স্তর সরবরাহ করে। ইনস্টলার চালানোর পর সার্ভিসটি যাচাই করুন, claude চালু করুন এবং স্ট্রিমিং, ফেইলওভার ও একসঙ্গে চলা সাবএজেন্ট পর্যবেক্ষণ করতে HUD ব্যবহার করুন। আপনার কর্মপ্রবাহ অনুযায়ী ঐচ্ছিক প্রোভাইডার কী এবং Ollama ব্যবহার করে পুলটি সম্প্রসারণ বা স্থানীয় স্থিতিস্থাপকতা যোগ করতে পারেন।

প্রকল্পটি JuaneX রক্ষণাবেক্ষণ করেন এবং এটি MIT লাইসেন্সের অধীনে বিতরণ করা হয়। সোর্স কোড ও ইনস্টলেশন স্ক্রিপ্ট Infinite Claude Code রিপোজিটরিতে পাওয়া যায়।