Qwen Code CLI इंस्टॉल गाइड: विंडोज, macOS और लिनक्स पर त्वरित सेटअप (2026)

आवश्यकताएँ

Qwen Code CLI (Qwen मॉडलों द्वारा संचालित आधिकारिक टर्मिनल--आधारित AI कोडिंग एजेंट) इंस्टॉल करने से पहले, निम्नलिखित की उपस्थिति सुनिश्चित करें:

Node.js संस्करण 20 या उच्चतर (अनुशंसित: नवीनतम LTS)। nodejs.org से डाउनलोड करें।
विंडोज़ पर व्यवस्थापकीय विशेषाधिकारों वाला एक टर्मिनल या कमांड प्रॉम्प्ट।
पैकेज और मॉडल डाउनलोड करने के लिए इंटरनेट कनेक्शन।
वैकल्पिक पर अनुशंसित: Git (मैनुअल स्रोत इंस्टॉलेशन के लिए) और macOS/Linux पर Homebrew।

Node.js इंस्टॉलेशन सत्यापित करें:

node --version
npm --version

अपेक्षित आउटपुट संस्करणों को दिखाता है जैसे v20.x.x या उच्चतर।

चरण 1: अपनी इंस्टॉलेशन विधि चुनें

Qwen Code CLI कई इंस्टॉलेशन पथ प्रदान करता है। अधिकांश उपयोगकर्ताओं के लिए त्वरित इंस्टॉल स्क्रिप्ट अनुशंसित है क्योंकि यह स्वचालित रूप से निर्भरताएँ संभालती है।

त्वरित इंस्टॉल (अनुशंसित)

Linux / macOS:

bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)"

Windows (व्यवस्थापक के रूप में कमांड प्रॉम्प्ट चलाएँ):

curl -fsSL -o %TEMP%\install-qwen.bat https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat && %TEMP%\install-qwen.bat

चलाने के बाद, PATH को ताज़ा करने के लिए अपना टर्मिनल पुनः आरंभ करें।

चरण 2: npm के माध्यम से मैनुअल इंस्टॉलेशन

यदि आप मैनुअल नियंत्रण पसंद करते हैं:

npm install -g @qwen-code/qwen-code@latest

यह qwen कमांड को वैश्विक रूप से इंस्टॉल करता है।

sudo के साथ macOS/Linux पर (यदि अनुमति संबंधी समस्याएँ आती हैं):

sudo npm install -g @qwen-code/qwen-code@latest

चरण 3: Homebrew के माध्यम से इंस्टॉल करें (macOS और Linux)

brew install qwen-code

चरण 4: इंस्टॉलेशन सत्यापित करें

सफल इंस्टॉलेशन की पुष्टि करने के लिए निम्नलिखित कमांड चलाएँ:

qwen --version

आपको इसके समान आउटपुट दिखना चाहिए:

Qwen Code CLI v0.x.x

चरण 5: प्रथम लॉन्च और प्रमाणीकरण

इंटरैक्टिव CLI लॉन्च करें:

qwen

पहली बार चलाने पर, CLI आपको अपने Qwen खाते से प्रमाणित करने के लिए प्रेरित करेगा (वन-क्लिक लॉगिन के लिए ब्राउज़र खुलता है)। लॉग इन करने के बाद, यह डिफ़ॉल्ट सेटिंग्स लागू करता है और इंटरैक्टिव टर्मिनल UI में प्रवेश करता है।

सर्वोत्तम परिणामों के लिए पहले अपनी प्रोजेक्ट निर्देशिका पर नेविगेट करें:

cd /path/to/your/project
qwen

सत्र के अंदर, /help, /model जैसे कमांड का उपयोग करें या @filename के साथ फ़ाइलों का संदर्भ लें।

चरण 6: स्रोत से मैनुअल इंस्टॉलेशन (उन्नत)

डेवलपर्स के लिए जो नवीनतम अप्रकाशित परिवर्तन चाहते हैं:

git clone https://github.com/QwenLM/qwen-code.git
cd qwen-code
npm install
npm install -g .

फिर qwen --version से सत्यापित करें।

सामान्य समस्याएं और समस्या निवारण

कमांड 'qwen' नहीं मिली: अपना टर्मिनल पुनरारंभ करें या hash -r चलाएं (Linux/macOS)। Windows पर, कमांड प्रॉम्प्ट बंद करें और फिर से खोलें। सुनिश्चित करें कि Node.js का ग्लोबल बिन डायरेक्टरी आपके PATH में है।
npm install के दौरान अनुमति संबंधी त्रुटियाँ: Linux/macOS पर sudo का उपयोग करें या Windows पर कमांड प्रॉम्प्ट को एडमिनिस्ट्रेटर के रूप में चलाएं।
Node.js संस्करण बहुत पुराना है: nvm या आधिकारिक इंस्टॉलर का उपयोग करके Node 20+ में अपग्रेड करें।
Aliyun संपत्तियों के साथ नेटवर्क समस्याएं: बैकअप के रूप में npm विधि का प्रयास करें।
Termux या कुछ Linux वितरणों पर इंस्टॉलेशन विफल होता है: --ignore-scripts फ्लैग का उपयोग करें: npm install -g @qwen-code/qwen-code@latest --ignore-scripts।
प्रमाणीकरण कार्य नहीं कर रहा: सुनिश्चित करें कि आपका ब्राउज़र पॉप-अप्स की अनुमति देता है और आपके पास एक वैध Qwen खाता है।

लगातार समस्याओं के लिए, आधिकारिक GitHub रिपॉजिटरी देखें: https://github.com/QwenLM/qwen-code।

आगे के कदम

इंटरैक्टिव UI का अन्वेषण करें: उपलब्ध स्लैश कमांड्स के लिए /help टाइप करें।
एजेंटिक कोडिंग का प्रयास करें: CLI से कोड रिफैक्टर करने, फ़ाइलों को समझाने या प्राकृतिक भाषा का उपयोग करके कार्यों को स्वचालित करने के लिए कहें।
मॉडल कॉन्फ़िगर करें: Qwen3-Coder या अन्य समर्थित बैकएंड्स (स्थानीय Ollama सहित) चुनने के लिए /model का उपयोग करें।
VS Code के साथ एकीकृत करें: सहज संपादक एकीकरण के लिए Qwen Code कॉम्पेनियन एक्सटेंशन इंस्टॉल करें।
सेटिंग्स कस्टमाइज़ करें: थीम, डिफ़ॉल्ट मॉडल और उन्नत विकल्पों के लिए ~/.qwen/settings.json संपादित करें।

अब आप अपने टर्मिनल में सीधे एक शक्तिशाली AI पेयर प्रोग्रामर के रूप में Qwen Code CLI का उपयोग करने के लिए तैयार हैं। अपने प्रोजेक्ट फ़ोल्डर के अंदर "Explain this codebase" या "Refactor this function for better performance" जैसे सरल प्रॉम्प्ट्स से प्रारंभ करें।

हैप्पी कोडिंग!