Qwen Code की शुरुआत Google के Gemini CLI पर बने एक प्रोजेक्ट के रूप में हुई थी, और आज GitHub पर इसके अपने 30,000 से ज़्यादा स्टार हैं। README के मुताबिक यह प्रोजेक्ट शुरुआत में Gemini CLI v0.8.2 पर आधारित था, फिर v0.1 से इसने मूल प्रोजेक्ट के साथ सिंक करना बंद कर दिया और एक स्वतंत्र, कई प्रोटोकॉल वाला कोडिंग एजेंट बन गया।
मुख्य बातें
- Qwen Code टर्मिनल के लिए Apache-2.0 लाइसेंस वाला ओपन-सोर्स कोडिंग एजेंट है, जो Gemini CLI के फ़ोर्क के रूप में शुरू हुआ।
- इसे स्टैंडअलोन स्क्रिप्ट से, Node.js 22 या नए वर्ज़न के साथ npm से, या Homebrew से इंस्टॉल करें, फिर मॉडल जोड़ने के लिए /auth चलाएं।
- साइन-इन का कोई भी विकल्प मुफ़्त नहीं बताया गया है, इसलिए बिना खर्च के लिए लोकल Ollama, vLLM या LM Studio सर्वर इस्तेमाल करें।
- नए कोडबेस पर रीड-ओनली Plan Mode में शुरुआत करें, /diff से बदलाव देखें और /restore से वापस लौटें।
यह गाइड बताती है कि Qwen Code कैसे इंस्टॉल करें, साइन इन कैसे करें (या इसे किसी मुफ़्त लोकल मॉडल से कैसे जोड़ें), और किसी असली प्रोजेक्ट पर इसे सुरक्षित तरीके से कैसे इस्तेमाल करें। नीचे की हर बात GitHub पर प्रोजेक्ट के अपने README और डॉक्यूमेंटेशन से ली गई है, जिन्हें 15 नवंबर 2026 को जांचा गया। इस लेख के लिए कोई भी कमांड चलाई नहीं गई, इसलिए पहले किसी फ़ालतू फ़ोल्डर में आज़माएं।
आपको क्या चाहिए
- macOS, Linux या Windows पर एक टर्मिनल
- Node.js 22 या नया वर्ज़न, अगर आप npm वाला तरीका चुनते हैं
- एक कोड प्रोजेक्ट, जिस पर इसे चलाया जा सके (कोई फ़ालतू रिपो सबसे अच्छा है)
- मॉडल के लिए पैसे देने या उसे होस्ट करने का तरीका: Qwen सब्सक्रिप्शन, API key, या लोकल मॉडल सर्वर

Qwen Code क्या है
यह एक ओपन-सोर्स कोडिंग एजेंट है जो आपके टर्मिनल में चलता है, आपका रिपो पढ़ता है, फ़ाइलें बदलता है और कमांड चलाता है। GitHub पर इसका लाइसेंस Apache-2.0 बताया गया है, और README के मुताबिक यह OpenAI, Anthropic, Gemini और Qwen की API के साथ-साथ किसी भी थर्ड-पार्टी प्रोवाइडर या Ollama या vLLM जैसे लोकल मॉडल के साथ काम करता है। 15 नवंबर 2026 तक सबसे नया रिलीज़ टैग v0.27.4 है।
प्रोजेक्ट अपना बेंचमार्क भी बताता है: SWE-bench Verified पर Qwen Code के सात वर्ज़न ने एक ही Qwen 3.7 Max मॉडल के साथ औसतन 76.40% से 77.80% के बीच स्कोर किया। यह मेंटेनर्स का अपना मूल्यांकन है, कोई स्वतंत्र टेस्ट नहीं।
आंकड़ों में
30,000से ज़्यादा GitHub स्टार
77.80%खुद बताया गया सबसे ऊंचा SWE-bench औसत
v0.27.4सबसे नया रिलीज़ टैग
स्टेप बाय स्टेप
1. इसे इंस्टॉल करें
README तीन तरीके बताता है। पहला है Linux और macOS के लिए एक लाइन का इंस्टॉलर:
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash
किसी स्क्रिप्ट को सीधे अपने शेल में चलाना भरोसे का फ़ैसला है। इंस्टॉलर Alibaba Cloud के एक स्टोरेज पते पर होस्ट है, इसलिए चाहें तो इसकी जगह npm या Homebrew इस्तेमाल करें:
npm install -g @qwen-code/qwen-code@latest
या, macOS और Linux पर Homebrew से:
brew install qwen-code
Windows यूज़र्स के लिए README में PowerShell इंस्टॉलर दिया गया है। स्टैंडअलोन इंस्टॉल के बाद अपना टर्मिनल रीस्टार्ट करें, ताकि एनवायरनमेंट वेरिएबल लागू हो जाएं।
2. इसे किसी प्रोजेक्ट के अंदर शुरू करें
cd ~/projects/my-app
qwen
आपको एक इंटरैक्टिव टर्मिनल सेशन दिखना चाहिए। README में “1.0 Preview” ब्रांच का भी ज़िक्र है, लेकिन यहां दिए निर्देश मेन वर्ज़न के लिए हैं।
3. साइन इन करें या मॉडल जोड़ें
/auth टाइप करें। डॉक्यूमेंटेशन पांच मुख्य विकल्प बताता है:
- Qwen Account with Subscription: Plus या Pro सब्सक्रिप्शन के साथ ब्राउज़र से साइन-इन।
- QwenCloud: Token Plan या इस्तेमाल के हिसाब से भुगतान वाली Standard API Key।
- Alibaba ModelStudio: Coding Plan, Token Plan या Standard API Key।
- Third-party Providers: एक बिल्ट-इन लिस्ट, जिसमें DeepSeek, Kimi, OpenRouter और दूसरे प्रोवाइडर हैं, API key के साथ।
- Custom Provider: लोकल सर्वर, प्रॉक्सी या कोई ऐसा प्रोवाइडर जो सपोर्टेड नहीं है।
मौजूदा डॉक्यूमेंटेशन में इनमें से किसी भी विकल्प को मुफ़्त नहीं बताया गया है। खर्च शून्य रखने के लिए लोकल मॉडल इस्तेमाल करें। डॉक्यूमेंटेशन दिखाता है कि Ollama, vLLM और LM Studio एक OpenAI-कम्पैटिबल पते के ज़रिए काम करते हैं। सर्वर वाला हिस्सा हमारी गाइड Ollama से AI मॉडल चलाना में है। फिर डॉक्यूमेंटेशन के अपने उदाहरण के आधार पर ~/.qwen/settings.json में एक कॉन्फ़िग सेव करें:
{
"env": { "OLLAMA_API_KEY": "ollama" },
"modelProviders": {
"openai": [
{
"id": "your-model-name",
"name": "My local model",
"envKey": "OLLAMA_API_KEY",
"baseUrl": "http://localhost:11434/v1"
}
]
},
"security": { "auth": { "selectedType": "openai" } },
"model": { "name": "your-model-name" }
}
your-model-name की जगह वही सटीक मॉडल नाम डालें जो आपका सर्वर बताता है। डॉक्यूमेंटेशन के मुताबिक model.name को किसी एक id वैल्यू से मेल खाना चाहिए। सेव करने के बाद qwen चलाएं।
4. अपना पहला सवाल पूछें
README एक सुरक्षित, सिर्फ़ पढ़ने वाले प्रॉम्प्ट से शुरू करने की सलाह देता है:
Explain this repository and show me where to start.
फिर /init चलाएं, जो डॉक्यूमेंटेशन के मुताबिक मौजूदा डायरेक्टरी का विश्लेषण करके एक शुरुआती कॉन्टेक्स्ट फ़ाइल बनाता है। Qwen Code आपकी QWEN.md और AGENTS.md ब्रीफ़िंग अपने-आप लोड करता है। अगर आप पहले से स्किल फ़ाइलें इस्तेमाल करते हैं, तो हमारी गाइड Claude Code में एजेंट स्किल्स यह आइडिया समझाती है, और Qwen Code अपने डॉक्यूमेंटेशन में अपना /skills पैनल बताता है।
5. तय करें कि इसे कितनी आज़ादी मिले
Qwen Code में पांच परमिशन मोड हैं: Plan, Ask Permissions, Auto-Edit, Auto और YOLO। इनके बीच बदलने के लिए Shift+Tab (Windows पर Tab) दबाएं। डॉक्यूमेंटेशन Auto को डिफ़ॉल्ट बताता है, जिसमें एक क्लासिफ़ायर सुरक्षित काम मंज़ूर करता है और जोखिम वाले रोकता है, लेकिन उसी पेज पर Ask Permissions को शुरुआती मोड भी बताया गया है, इसलिए स्टेटस बार देख लें। नए कोडबेस के लिए Plan Mode में शुरुआत करें:
/plan refactor the settings page
Plan Mode रीड-ओनली है, यानी न कुछ बदला जाता है, न कुछ चलाया जाता है। अपने पिछले मोड पर लौटने के लिए /plan exit टाइप करें। जैसा डॉक्यूमेंटेशन सलाह देता है, YOLO को भरोसेमंद प्रोजेक्ट्स के लिए ही रखें।
6. जांचें और बदलाव वापस लें
बिना कमिट किए गए बदलावों का इंटरैक्टिव व्यू खोलने के लिए /diff इस्तेमाल करें। अगर कोई स्टेप गड़बड़ हो गया, तो /restore चेकपॉइंट्स की लिस्ट दिखाता है और प्रोजेक्ट की फ़ाइलों को किसी टूल के चलने से पहले की हालत में लौटा देता है।
7. इसे स्क्रिप्ट्स में इस्तेमाल करें
README के मुताबिक हेडलेस मोड स्क्रिप्ट्स और CI से चलता है:
qwen -p "Summarize the repository layout."

आम एरर और उनके हल
qwen: command not found. README के निर्देश के मुताबिक इंस्टॉल करने के बाद अपना टर्मिनल रीस्टार्ट करें। npm के लिए पक्का करें कि Node.js का वर्ज़न 22 या नया है।- ब्राउज़र से साइन-इन नहीं हो रहा। CI या बिना निगरानी वाले कंटेनर में ऑथ डॉक्यूमेंटेशन इसकी जगह एनवायरनमेंट वेरिएबल के साथ API key वाला तरीका इस्तेमाल करने को कहता है।
qwen authसे कुछ काम नहीं बनता। यह कमांड हटा दी गई है।qwenचलाएं, फिर/auth। अपना मौजूदा ऑथेंटिकेशन जांचने के लिए/doctorचलाएं।- लोकल मॉडल टाइम आउट हो जाता है। पक्का करें कि
baseUrlके आख़िर में/v1है और सर्वर चल रहा है। धीमे सर्वर के लिए डॉक्यूमेंटेशनstreamIdleTimeoutMsसेटिंग बताता है। - डेमन सुरक्षित है या नहीं, पक्का नहीं। अगर आप
qwen serveयाqwen daemon startइस्तेमाल करते हैं, तो ध्यान दें कि README के मुताबिक यह डिफ़ॉल्ट रूप से बिना bearer ऑथेंटिकेशन के loopback पर सुनता है, इसलिए कोई भी लोकल प्रोसेस जो इस तक पहुंच सके, पूरी API इस्तेमाल कर सकता है, कोड चलाने समेत। शेयर्ड होस्ट परQWEN_SERVER_TOKENसेट करें और--require-authइस्तेमाल करें।
क्या आप जानते हैं?
डिफ़ॉल्ट रूप से qwen serve डेमन बिना bearer ऑथेंटिकेशन के loopback पर सुनता है, इसलिए कोई भी लोकल प्रोसेस जो इस तक पहुंच सके, पूरी API इस्तेमाल कर सकता है, कोड चलाने समेत। शेयर्ड होस्ट पर QWEN_SERVER_TOKEN सेट करें और –require-auth इस्तेमाल करें।
क्या इसे आज़माना चाहिए?
अगर आपको Claude Code या Gemini CLI का तरीका पसंद है और आप कुछ ऐसा चाहते हैं जिसे अपने मॉडल से जोड़ सकें, तो Qwen Code बस एक छोटे से इंस्टॉल की दूरी पर है। Plan Mode में शुरुआत करें, एक Git कमिट तैयार रखें, और जब तक खुद न आज़मा लें, बेंचमार्क के आंकड़ों को मेंटेनर्स के अपने आंकड़े मानें।
अक्सर पूछे जाने वाले सवाल
क्या Qwen Code मुफ़्त है?
टूल खुद Apache-2.0 के तहत ओपन सोर्स है, लेकिन मौजूदा डॉक्यूमेंटेशन में /auth के किसी भी साइन-इन विकल्प को मुफ़्त नहीं बताया गया है। खर्च शून्य रखने के लिए इसे Ollama, vLLM या LM Studio के ज़रिए किसी लोकल मॉडल से जोड़ें।
Qwen Code कैसे इंस्टॉल करें?
README तीन तरीके बताता है: Linux और macOS के लिए एक लाइन का स्टैंडअलोन इंस्टॉलर, Node.js 22 या नए वर्ज़न के साथ npm install -g @qwen-code/qwen-code@latest, या brew install qwen-code। Windows यूज़र्स के लिए PowerShell इंस्टॉलर है। इसके बाद अपना टर्मिनल रीस्टार्ट करें।
क्या Qwen Code, Ollama के साथ लोकल मॉडल इस्तेमाल कर सकता है?
हां। एक ~/.qwen/settings.json सेव करें जो किसी OpenAI-कम्पैटिबल प्रोवाइडर को http://localhost:11434/v1 पर पॉइंट करे, और पक्का करें कि model.name प्रोवाइडर की किसी एक id वैल्यू से मेल खाता हो। फिर qwen चलाएं।
Qwen Code में Plan Mode क्या है?
Plan Mode पांच परमिशन मोड में से एक है और रीड-ओनली है, यानी न कुछ बदला जाता है, न कुछ चलाया जाता है। इसे /plan के बाद अपना काम लिखकर शुरू करें, और पिछले मोड पर लौटने के लिए /plan exit टाइप करें।
छोटा क्विज़
Qwen Code शुरुआत में किस प्रोजेक्ट पर आधारित था?
- Claude Code
- Gemini CLI
- Ollama
README के मुताबिक यह शुरुआत में Gemini CLI v0.8.2 पर आधारित था।
कौन-सा मोड रीड-ओनली है?
- Plan
- YOLO
- Auto-Edit
डॉक्यूमेंटेशन के मुताबिक Plan Mode न कुछ बदलता है, न कुछ चलाता है।
कौन-सी कमांड प्रोजेक्ट की फ़ाइलों को किसी चेकपॉइंट पर लौटाती है?
- /diff
- /init
- /restore
/restore चेकपॉइंट्स की लिस्ट दिखाता है और फ़ाइलों को किसी टूल के चलने से पहले की हालत में लौटा देता है।
स्रोत
लिंक आख़िरी बार 15 नवंबर 2026 को जांचे गए।





प्रतिक्रिया लिखें