OpenCode उपयोग: ओपन-सोर्स एजेंट, घरेलू मॉडल्स जैसे चाहें जोड़ें
पिछले दो पाठों के Claude Code और Codex क्रमशः Anthropic और OpenAI दोनों कंपनियों के मॉडल्स और सदस्यताओं से बंधे हैं; इस पाठ में 12 मिनट में ओपन-सोर्स शिविर के OpenCode को देखें — टूल का मूल ओपन-सोर्स और मुफ़्त है, मॉडल जैसे चाहें जोड़ें: DeepSeek, Kimi, ज़िपू (Zhipu), टोंग्यी (Tongyi) ये सभी घरेलू वेंडर आधिकारिक मॉडल कैटलॉग में हैं, जिसकी key हाथ में है उसी का उपयोग करें। यह OpenCode ट्यूटोरियल CLI इस मुख्य रूप पर केंद्रित है — आधिकारिक पोज़िशनिंग «ओपन-सोर्स AI कोडिंग एजेंट», साथ ही डेस्कटॉप और वेब संस्करण भी हैं, बस एक लाइन में कह दिया। (तथ्य-सत्यापन समय 2026-11-05; मॉडल कैटलॉग और कमांड्स वर्शन अपडेट के साथ बदल सकते हैं, आधिकारिक दस्तावेज़ ही मानक हैं।)
सीखने के बाद आप क्या कर सकेंगे
- macOS / Linux पर OpenCode CLI इंस्टॉल करें (Windows पर आधिकारिक स्वतंत्र बाइनरी का उपयोग करें), प्रोजेक्ट डायरेक्टरी में एक कमांड से शुरू करें
/connectसे मॉडल जोड़ें: DeepSeek, Kimi, ज़िपू (Zhipu), टोंग्यी (Tongyi) जैसे घरेलू वेंडर सभी आधिकारिक कैटलॉग में हैं, API key पेस्ट करते ही उपयोग शुरू/modelsसे मॉडल चुनें, पहला काम सौंपें, और देखें कि यह खुद फ़ाइलें पढ़ता है, कोड बदलता है, कमांड चलाता है- आसान ऑपरेशन:
@से फ़ाइल रेफर करें,!से सीधे shell चलाएँ,/undoसे पछतावे की गोली लें opencode statsसे उपयोग पर नज़र रखें,opencode upgradeसे अपग्रेड करें, क्रेडेंशियल प्रबंधन के लिएopencode auth
आपकी अभी की दुविधा
- Claude Code के लिए Claude सदस्यता चाहिए, Codex के लिए ChatGPT अकाउंट चाहिए; मेरे पास तो पहले से DeepSeek / Kimi / ज़िपू (Zhipu) की API key है
- वेब संस्करण में कोड पर चर्चा, फ़ाइलें बार-बार कॉपी-पेस्ट, बदलाव के बाद खुद वापस पेस्ट करना पड़ता है
- सुना है OpenCode ओपन-सोर्स और मुफ़्त AI कोडिंग टूल है, लेकिन इंस्टॉल के बाद हैरान: मॉडल कहाँ से आए? टर्मिनल इंटरफ़ेस कैसे उपयोग करें?
यह तरीका कब अपनाएँ
जब आपको चाहिए:
- एक ऐसा ओपन-सोर्स कोडिंग एजेंट जो मॉडल वेंडर से बंधा न हो — किसी भी कंपनी की API key जोड़ सकते हैं, घरेलू मॉडल्स सीधे उपयोग करें
- मौजूदा घरेलू मॉडल अकाउंट (API पे-ऐज़-यू-गो या Coding Plan पैकेज) से टर्मिनल के एजेंट को चलाना
- टूल का मूल ओपन-सोर्स: सोर्स कोड github.com/anomalyco/opencode पर सार्वजनिक है, चाहें तो बदलें
और नहीं चाहते:
- कोडिंग एजेंट के उपयोग के लिए खासतौर पर विदेशी सदस्यता लेना
- वेब चैट बॉक्स में कोड और एरर्स को बार-बार आगे-पीछे करना
- एक ही मॉडल इकोसिस्टम में लॉक हो जाना — आज DeepSeek कल Kimi, key बदलते ही मॉडल बदल जाता है
🎒 शुरू करने से पहले की तैयारी
- रोज़मर्रा के उपयोग की थीम-भूमिका पढ़ चुके हों, और जानते हों कि यह पेज चार टूल्स में से OpenCode (ओपन-सोर्स शिविर) के बारे में है
- कम से कम एक मॉडल अकाउंट: घरेलू वेंडर (DeepSeek / Kimi / ज़िपू (Zhipu) आदि) की API key, या ChatGPT Plus / Pro सदस्यता, या पहले OpenCode Console से जुड़कर मुफ़्त मॉडल से जाँच करें — हर रास्ते का खर्च देखें कीमत तुलना
- एक प्रैक्टिस प्रोजेक्ट डायरेक्टरी (ऐसी जिसमें
cdकरके घुसते ही काम शुरू हो जाए) - 12 मिनट बिना बाधा डाले निकाला गया समय
💡 पिछले दो पाठ अनिवार्य शर्त नहीं हैं
इस पाठ के लिए केवल रोज़मर्रा के उपयोग की थीम-भूमिका पढ़ना ज़रूरी है। Claude Code उपयोग और Codex उपयोग इस पाठ से स्वतंत्र हैं, लेकिन «काम सौंपने की तरह एक बात साफ़ कहने» की विधि सब जगह लागू होती है।
केंद्रीय विचार
OpenCode की आधिकारिक पोज़िशनिंग एक लाइन में: ओपन-सोर्स AI कोडिंग एजेंट (open source AI coding agent), जिसके टर्मिनल, डेस्कटॉप और वेब — तीन रूप हैं। पिछले दो पाठों से इसका सबसे बुनियादी अंतर: मॉडल बंधा नहीं है। Claude Code Claude मॉडल चलाता है, Codex GPT मॉडल चलाता है; OpenCode का मूल केवल एक «एजेंट शेल» है, मॉडल कैटलॉग models.dev से आता है, सौ से ज़्यादा देशी-विदेशी वेंडर जैसे चाहें जोड़ें — यही इसे चीनी उपयोगकर्ताओं के लिए सबसे अनुकूल बनाता है: कैटलॉग में बड़ी संख्या में चीनी वेंडर और घरेलू पैकेज खास तौर पर शामिल हैं।
पिछले दो पाठों के साथ साथ देखें:
| Claude Code | Codex | OpenCode | |
|---|---|---|---|
| मॉडल | Claude सीरीज़ | GPT सीरीज़ | बंधा नहीं: models.dev कैटलॉग में सौ से ज़्यादा वेंडर जैसे चाहें जोड़ें |
| भुगतान | Claude सदस्यता या API key | ChatGPT सदस्यता या API key | मूल ओपन-सोर्स और मुफ़्त, मॉडल का खर्च उस वेंडर को जिसे आपने जोड़ा (साथ ही वैकल्पिक सदस्यता OpenCode Go) |
| सोर्स कोड | बंद स्रोत | बंद स्रोत | ओपन सोर्स (github.com/anomalyco/opencode) |
| रूप | टर्मिनल / IDE / डेस्कटॉप / वेब | CLI / IDE / डेस्कटॉप / वेब | टर्मिनल / डेस्कटॉप / वेब |
उपयोग एक वाक्य में: पहले /connect से खाता जोड़ें, फिर /models से मॉडल चुनें। क्रेडेंशियल जोड़ने के चार तरीके हैं:
| क्रेडेंशियल तरीका | कैसे काम करता है |
|---|---|
| API key | कुंजी पेस्ट करें, उस विक्रेता के खाते के रूप में सहेजा जाता है |
| OAuth | ब्राउज़र या डिवाइस कोड से अधिकृत करें |
| कमांड | विक्रेता द्वारा दी गई कुंजी-प्राप्ति कमांड चलाएं, आउटपुट को key के रूप में सहेजा जाता है |
| पर्यावरण चर | सेवा प्रक्रिया से चर पढ़ता है, डिस्क पर सहेजा नहीं जाता |
तीन रूप एक वाक्य में: CLI के अलावा, OpenCode का डेस्कटॉप संस्करण (आधिकारिक साइट से इंस्टॉलर डाउनलोड) और वेब संस्करण (opencode pair एक बार उपयोग होने वाला लॉगिन लिंक बनाता है, 5 मिनट में मान्य, एक बार उपयोग के बाद अमान्य) भी है — इस पाठ में इन पर विस्तार नहीं होगा, CLI ही मुख्य धारा है।
** और Claude Code, Codex में से किसे चुनें और कैसे संयोजित करें? ** अगर आप किसी कंपनी का मॉडल इस्तेमाल करना चाहते हैं तो उसका आधिकारिक टूल चुनें; अगर आपके पास घरेलू मॉडल की key है, या आप किसी एक इकोसिस्टम से बंधना नहीं चाहते, तो OpenCode सही विकल्प है। इन्हें साथ इस्तेमाल करना पूरी तरह संभव है—तीनों में प्रोजेक्ट निर्देशिका (instruction file) मैकेनिज्म है, OpenCode AGENTS.md को मानक मानता है (Codex के साथ यही फ़ाइल साझा है; v2.3.1 से, जब डायरेक्टरी में AGENTS.md नहीं होता तो यह CLAUDE.md भी पढ़ता है, विवरण के लिए देखें AGENTS.md और CLAUDE.md); चारों टूल्स के बीच चुनाव की पूरी तुलना के लिए देखें टूल तुलना, और पूरी लागत तालिका के लिए देखें कीमत तुलना।
मेरे साथ करें
चरण 1: OpenCode CLI इंस्टॉल करें
क्यों: OpenCode एक स्वतंत्र रूप से इंस्टॉल होने वाला कमांड-लाइन टूल है, पहले इंस्टॉल करने पर ही आगे का सब कुछ संभव है।
तरीका A: आधिकारिक इंस्टॉल स्क्रिप्ट (अनुशंसित, macOS / Linux)
curl -fsSL https://opencode.ai/v2/install | bashतरीका B: पैकेज मैनेजर (macOS / Linux)
brew install anomalyco/tap/opencode-v2npm install -g @opencode/clinpm पैकेज postinstall स्क्रिप्ट से आपके प्लेटफ़ॉर्म का बाइनरी चुनता है: pnpm को स्पष्ट अनुमति देनी होगी (pnpm add -g --allow-build=@opencode/cli @opencode/cli), bun में भरोसा जोड़ना होगा (bun install -g --trust @opencode/cli); इसके अतिरिक्त yarn, AUR (paru -S opencode-beta), mise जैसे चैनल भी हैं (mise को 2026.10.9 या नया संस्करण चाहिए, पुराने संस्करण से OpenCode 1 इंस्टॉल होता है)।
Windows उपयोगकर्ता: स्वतंत्र बाइनरी या डेस्कटॉप संस्करण
आधिकारिक रूप से स्पष्ट है कि "Windows पैकेज मैनेजर समर्थित नहीं है"। दो रास्ते: आधिकारिक साइट से स्वतंत्र CLI बाइनरी (zip, ARM64 / x64 में विभाजित) डाउनलोड करें, निकालकर तुरंत उपयोग करें; या सीधे डेस्कटॉप ऐप इंस्टॉल करें।
इंस्टॉल के बाद सत्यापित करें:
opencode --versionआपको दिखना चाहिए: टर्मिनल पर संस्करण संख्या छपी होगी।
- छोटी जाँच:
opencode --versionसंस्करण संख्या छाप सकता है
चरण 2: OpenCode शुरू करें, टर्मिनल इंटरफ़ेस से परिचित हों
क्यों: OpenCode का मुख्य रूप फुल-स्क्रीन टर्मिनल इंटरफ़ेस (TUI) है, पहली बार शुरू करके इससे परिचित हो जाएं, बाद के सभी काम यहीं होंगे।
cd /path/to/your/project
opencodeआपको दिखना चाहिए: फुल-स्क्रीन टर्मिनल इंटरफ़ेस, नीचे इनपुट बॉक्स। सीधे टाइप करके कार्य बताएं, Enter दबाकर भेजें; नई पंक्ति के लिए Shift+Enter (या Ctrl+Enter / Alt+Enter / Ctrl+J) उपयोग करें।
फुल-स्क्रीन नहीं चाहते? दो और प्रवेश-द्वार हैं:
| प्रवेश-द्वार | कमांड | किसके लिए उपयुक्त |
|---|---|---|
| अति-सरल इंटरफ़ेस | opencode mini | सादा इनपुट बॉक्स पसंद करने वालों के लिए |
| स्क्रिप्ट / CI एकल कार्य | opencode run "Explain this repository" | इंटरफ़ेस नहीं खुलता, आउटपुट सीधे टर्मिनल में जाता है |
- छोटी जाँच: मैंने प्रोजेक्ट निर्देशिका में
opencodeशुरू किया, इनपुट बॉक्स देखा और टाइप कर सका
चरण 3: OpenCode ट्यूटोरियल का केंद्र — /connect से चीनी मॉडल जोड़ना
क्यों: OpenCode में अपने-आप कोई मॉडल नहीं होता, आपका खाता जोड़ने पर ही यह "जीवित" होता है। और चीनी मॉडल ही इसकी खूबी है: आधिकारिक मॉडल निर्देशिका (models.dev से) में बड़ी संख्या में चीनी विक्रेता और घरेलू प्लान शामिल हैं — पिछले दो पाठों के टूल की बजाय इसे चुनने का सबसे बड़ा कारण यही है।
सत्र में टाइप करें:
/connectआपको दिखना चाहिए: विक्रेता चयन सूची। एक विक्रेता चुनें (जैसे DeepSeek), संकेत के अनुसार API key पेस्ट करें।
चीनी विक्रेता निर्देशिका (अंश; एक ही विक्रेता के अक्सर अंतरराष्ट्रीय / घरेलू / प्लान संस्करण के कई प्रविष्टियाँ होते हैं, जिसे आपने सक्रिय किया है वही पहचानें):
| विक्रेता | निर्देशिका के प्रविष्टि (उदाहरण) | क्रेडेंशियल पर्यावरण चर |
|---|---|---|
| DeepSeek | DeepSeek | DEEPSEEK_API_KEY |
| Moonshot Kimi | Moonshot AI (China), Kimi For Coding | MOONSHOT_API_KEY / KIMI_API_KEY |
| Zhipu AI | Zhipu AI, Zhipu AI Coding Plan, Z.AI | ZHIPU_API_KEY |
| Alibaba Tongyi | Alibaba (China), Alibaba Coding Plan | DASHSCOPE_API_KEY / ALIBABA_CODING_PLAN_API_KEY |
| MiniMax | MiniMax (minimax.cn), MiniMax Token Plan | MINIMAX_API_KEY |
| ByteDance Volcano Ark | Volcengine Ark, Volcengine Ark Coding Plan | ARK_API_KEY / ARK_CODING_PLAN_API_KEY |
| SiliconFlow | SiliconFlow (China) | SILICONFLOW_CN_API_KEY |
| Tencent | Tencent Coding Plan (China) | TENCENT_CODING_PLAN_API_KEY |
| StepFun | StepFun (China) | STEPFUN_API_KEY |
| ModelScope (MoDa) | ModelScope | MODELSCOPE_API_KEY |
opencode के साथ deepseek जोड़ने का उदाहरण लें—इंटरफ़ेस खोले बिना भी जुड़ सकते हैं (प्रदाता ID यानी कैटलॉग में दिया गया नाम):
opencode auth login deepseek --method keyआपको यह दिखना चाहिए: API key डालने का प्रॉम्प्ट, पेस्ट करने के बाद यह खाते के रूप में सेव हो जाती है।
जोड़ने के बाद जाँचें:
opencode auth listआपको यह दिखना चाहिए: जुड़े हुए प्रदाता खातों की सूची।
💡 हाथ में एक भी key नहीं है? पहले आधिकारिक मुफ़्त मॉडल आज़माएँ
OpenCode Console (opencode.ai/console) में रजिस्टर करके जोड़ने पर, कैटलॉग में कुछ मुफ़्त मॉडल जुड़ जाएँगे (जैसे GLM-5.3-Flash Free, DeepSeek V4.1 Flash Free), बिना एक पैसा खर्च किए पहले पूरा फ़्लो चला लें।
- छोटी जाँच:
opencode auth listमें मेरा अभी-अभी जोड़ा हुआ प्रदाता दिख रहा है
चरण 4: /models से मॉडल चुनें, पहला काम सौंपें
क्यों: प्रदाता से जुड़ना सिर्फ़ यानी «सामान का स्रोत मिल गया», अब OpenCode को बताना भी ज़रूरी है कि इस बार कौन सा मॉडल इस्तेमाल करना है। चुनने के बाद पिछले दो पाठों की तरह काम सौंप सकते हैं।
सत्र में टाइप करें:
/modelsआपको यह दिखना चाहिए: आपके जुड़े प्रदाताओं के मॉडलों की सूची (जैसे DeepSeek कैटलॉग के नीचे DeepSeek V4.1 Flash 1017 आदि), चुनते ही स्विच हो जाता है, सिर्फ़ मौजूदा सेशन पर लागू।
पहला काम सौंपें—Codex पाठ की तरह, पहले इसे इस प्रोजेक्ट के बारे में समझाने को कहें:
Explain how authentication works in this projectआपको यह दिखना चाहिए: OpenCode खुद फ़ाइलें पढ़ता है, प्रोजेक्ट की संरचना सूचीबद्ध करता है; कोड बदलने को कहने पर वह सीधे फ़ाइलें संपादित करता है, जाँच के लिए स्थानीय स्तर पर कमांड चलाता है।
मॉडल बदलना हो तो कभी भी /models (या Ctrl+X दबाकर फिर M; F2 हाल में इस्तेमाल किए मॉडलों के बीच चक्कर लगाता है)।
- छोटी जाँच:
/modelsमें मेरे जुड़े प्रदाता के मॉडल दिख रहे हैं और एक चुना गया है
चरण 5: रोज़मर्रा के सुविधाजनक ऑपरेशन—@ से फ़ाइल संदर्भित करें, ! से कमांड चलाएँ, /undo पछतावे की गोली
क्यों: एजेंट को सुविधाजनक पाना इन्हीं छोटी-छोटी हरकतों पर निर्भर करता है। OpenCode के रोज़मर्रा के ऑपरेशन एक ही टेबल में:
| क्या करना चाहते हैं | ऑपरेशन |
|---|---|
| किसी फ़ाइल को संदर्भित करें | Review @src/auth.ts for error handling problems (लाइन नंबर के साथ भी @src/auth.ts#20-45) |
| सीधे shell चलाएँ | !git status (आउटपुट सेशन में रहता है, यह देख सकता है) |
| सभी कमांड सूचीबद्ध करें | / टाइप करें; Ctrl+P कमांड पैनल खोलता है |
| नया सेशन शुरू करें | /new या Ctrl+X दबाकर फिर N |
| पुराने सेशन पर लौटें | /sessions |
| पछतावे की गोली लें | /undo पिछला संदेश और उसका किया काम पूर्ववत करें; /redo फिर से लागू करें |
| एक «गिनती में न आने वाला» छोटा सवाल पूछें | /btw why did the test in step 2 fail? (जवाब संदर्भ में नहीं जाता) |
आपको यह दिखना चाहिए: @ फ़ाइल खोज सूची खोलता है, जितना टाइप करें उतना सिकुड़ती है; ! shell मोड में जाता है, Esc दबाने पर बिना चलाए बाहर निकलता है।
- छोटी जाँच: मैंने
@से फ़ाइल संदर्भित की,!से कमांड चलाई,/undoसे एक बार पूर्ववत किया
चरण 6: खाते, उपयोग और अपडेट का ध्यान रखें
क्यों: OpenCode का सिद्धांत है «टूल अलग, मॉडल का खर्च प्रदाता का»—कितने खाते जुड़े हैं, पैसा कहाँ खर्च हो रहा है, इसकी जानकारी होनी चाहिए।
opencode auth list
opencode stats
opencode stats --costआपको यह दिखना चाहिए: auth list सेव किए खाते सूचीबद्ध करता है; stats साझा करने योग्य उपयोग आँकड़े देता है, --cost जोड़ने पर खर्च का विवरण दिखता है।
वर्शन अपग्रेड करें:
opencode upgradeक्रेडेंशियल सुरक्षा के दो वाक्य: API key और OAuth टोकन स्थानीय SQLite डेटाबेस में सेव होते हैं (पाथ opencode debug paths db से देखें, आमतौर पर ~/.local/share/opencode/opencode.db); डेटाबेस को हाथ से न बदलें, खाते जोड़ने-हटाने के लिए हमेशा /connect या opencode auth कमांड ही इस्तेमाल करें।
- छोटी जाँच:
opencode statsमें मेरा उपयोग दिख रहा है
चेकपॉइंट ✅
opencode --versionवर्शन नंबर छापता है, प्रोजेक्ट डायरेक्टरी में टर्मिनल इंटरफ़ेस चालू होता है/connectसे कम से कम एक प्रदाता जुड़ा है,opencode auth listमें वह दिखता है/modelsसे मॉडल चुन लिया, पहला काम सौंपा, उसे खुद फ़ाइलें पढ़ते और बदलते देखा- सीख गए
@से फ़ाइल संदर्भित करना,!से कमांड चलाना,/undoसे पूर्ववत करना opencode statsमें उपयोग दिखता है, पता है क्रेडेंशियल कहाँ सेव हैं, कैसे प्रबंधित करें
आम ग़लतियों की चेतावनी
❌ Windows पर पैकेज मैनेजर से इंस्टॉल नहीं होता
आधिकारिक दस्तावेज़ साफ़ कहते हैं: «Windows पैकेज मैनेजर समर्थित नहीं है»। सही तरीका: आधिकारिक साइट से स्टैंडअलोन CLI बाइनरी डाउनलोड करें (zip अनज़िप करें), या डेस्कटॉप ऐप इंस्टॉल करें; winget / scoop पर समय बर्बाद न करें।
❌ pnpm / bun से npm पैकेज इंस्टॉल करते समय स्क्रिप्ट रोक दी जाती है, इंस्टॉल के बाद चलता नहीं
npm पैकेज postinstall स्क्रिप्ट से प्लेटफ़ॉर्म बाइनरी चुनता है, pnpm डिफ़ॉल्ट रूप से स्क्रिप्ट रोकता है और bun डिफ़ॉल्ट रूप से भरोसा नहीं करता। अनुमति देने का तरीका: pnpm add -g --allow-build=@opencode/cli @opencode/cli, bun install -g --trust @opencode/cli। npm उपयोगकर्ताओं पर कोई असर नहीं।
❌ ChatGPT प्लान से लॉगिन के बाद लगता है «मॉडल मूर्ख हो गया»
OpenCode ने ChatGPT लॉगिन वाले मॉडल्स के लिए डिफ़ॉल्ट रूप से संदर्भ सीमा जोड़ दी है (GPT-6.1 Sol और नए मॉडल्स 500,000, पुराने मॉडल्स 272,000), जो Codex के डिफ़ॉल्ट मानों के साथ संरेखित है, ताकि प्लान का उपयोग बहुत तेज़ी से खत्म न हो। v2.3.1 से, ChatGPT लॉगिन के बाद मॉडल सूची में GPT 6.2 Sol और GPT 6.2 Astra (fast वेरिएंट सहित) भी शामिल हैं। @@I18N_KEEP_000042@@ अगर आप सच में इसे हटाना चाहते हैं, तो कॉन्फ़िगरेशन में यह बिल्ट-इन प्लगइन बंद कर दें:
{ "plugins": ["-opencode.provider.openai-context-caps"] }(- प्रीफ़िक्स का मतलब है सिर्फ़ यही एक इनबिल्ट प्लगइन बंद होगा, बाकी प्लगइन प्रभावित नहीं होंगे।)
❌ API key को कॉन्फ़िग फ़ाइल में साफ़ टेक्स्ट के रूप में लिखा और रिपॉज़िटरी में कमिट कर दिया
क्रेडेंशियल /connect या opencode auth login से सेव करने चाहिए (स्थानीय डेटाबेस में), या सेवा प्रोसेस को एनवायरनमेंट वेरिएबल से देने चाहिए; opencode.jsonc में लिखकर git में कमिट करना चाबी दरवाज़े में लगी छोड़ने जैसा है। अस्थायी रूप से एनवायरनमेंट वेरिएबल से भी चलेगा: DEEPSEEK_API_KEY=<你的key> opencode --standalone।
उन्नत तरकीबें (वैकल्पिक)
अपने प्रोजेक्ट के लिए एक «निर्देश पुस्तिका» रखें। प्रोजेक्ट की रूट डायरेक्टरी में AGENTS.md रखें, जिसमें बिल्ड कमांड, कोड कन्वेंशन और सत्यापन आवश्यकताएँ लिखें; हर सेशन में OpenCode पहले इसे पढ़ता है; ग्लोबल संस्करण ~/.config/opencode/AGENTS.md में रखें। v2.3.1 (2026-11-18) से, OpenCode CLAUDE.md भी पढ़ता है: जब किसी डायरेक्टरी में AGENTS.md नहीं होता, तो उस डायरेक्टरी का CLAUDE.md पढ़ता है, और जब ग्लोबल AGENTS.md गायब हो, तो ~/.claude/CLAUDE.md पढ़ने पर वापस आता है; अगर आपको यह फ़ॉलबैक नहीं चाहिए, तो पर्यावरण चर OPENCODE_DISABLE_CLAUDE_CODE सेट करें। जब दोनों मौजूद हों, तो AGENTS.md प्राथमिक होता है। लिखने के तरीके की विस्तृत जानकारी के लिए देखें AGENTS.md और CLAUDE.md: AI के लिए एक प्रोजेक्ट निर्देश पुस्तिका।
हर कदम पर क्या हो रहा है यह नहीं दिख रहा? v2.3.0(2026-11-13)से, सब-एजेंट डिफ़ॉल्ट रूप से बैकग्राउंड में चलते हैं और काम पूरा करके लौटकर रिपोर्ट करते हैं; टर्मिनल इंटरफ़ेस का लॉग भी डिफ़ॉल्ट रूप से ज़्यादा शांत है(session.verbosity डिफ़ॉल्ट रूप से low, टूल कॉल्स की एक श्रृंखला एक ही एक्टिविटी लाइन में फोल्ड हो जाती है)。हर कदम देखने के लिए, सेटिंग्स में Verbosity को medium या high पर सेट करें।
लोकल मॉडल जोड़ें, पूरी तरह ऑफ़लाइन। Ollama इंस्टॉल होने पर, ollama serve से सेवा चालू करें, ollama pull qwen3:8b से मॉडल खींचें; OpenCode 127.0.0.1:11434 पर मौजूद मॉडलों को अपने आप खोज लेता है, खाते से जुड़ने की ज़रूरत नहीं; LM Studio और vLLM के लिए भी बिल्ट-इन डिस्कवरी है।
डायरेक्टरी में न होने वाले प्रोवाइडर खुद जोड़ें। OpenAI-संगत API सभी को कस्टम प्रोवाइडर के रूप में opencode.jsonc में जोड़ा जा सकता है:
{
"$schema": "https://opencode.ai/config.json",
"providers": {
"acme": {
"name": "Acme",
"env": ["ACME_API_KEY"],
"package": "@opencode/ai/providers/openai-compatible",
"settings": { "baseURL": "https://llm.acme.example/v1" },
"models": { "qwen3-coder": { "name": "Qwen 3 Coder" } }
}
}
}पहले से ChatGPT सब्सक्रिप्शन है? सीधे इस्तेमाल करें। /connect में OpenAI चुनें, लॉगिन तरीके में Sign in with ChatGPT चुनें—उपयोग आपके Plus / Pro प्लान में गिना जाता है, मॉडल बिना शुल्क दिखता है।
"मासिक फ्लैट अनलिमिटेड" चाहिए? OpenCode Go देखें। आधिकारिक रूप से बंडल किए गए कोडिंग मॉडलों की सब्सक्रिप्शन: Go $10/माह, Go Plus $40/माह, Go Teams $20/सदस्य/माह; कंट्रोल कंसोल में सब्सक्राइब करने के बाद सामान्य प्रोवाइडर की तरह /connect से जोड़ें। पूरी तरह वैकल्पिक है, न सब्सक्राइब करने से किसी सुविधा पर असर नहीं पड़ता।
स्क्रिप्ट और CI में चलाएँ। opencode run से इंटरफ़ेस खोले बिना एक बार का काम: opencode run --model anthropic/claude-sonnet-5-5 "Refactor parseToken"; --continue जोड़कर पिछला सेशन जारी रखें।
इस पाठ का सारांश
✅ OpenCode ट्यूटोरियल की रोज़मर्रा की मुख्य धारा = CLI इंस्टॉल करें → /connect से मॉडल जोड़ें (घरेलू प्रोवाइडर में से कोई भी चुनें) → /models से मॉडल चुनें → काम सौंपें → @/!//undo से आसान कार्य → stats से उपयोग पर नज़र रखें।
✅ यह ओपन-सोर्स एजेंट है जो किसी मॉडल से बंधा नहीं है: मुख्य उत्पाद मुफ़्त और ओपन-सोर्स है, मॉडल का शुल्क उस प्रोवाइडर को देते हैं जिससे आप जोड़ते हैं; घरेलू मॉडलों की डायरेक्टरी सबसे पूरी है—DeepSeek, Kimi, ज़िपू, टोंगयी, MiniMax, Volcano Ark, SiliconFlow, Tencent, Step, ModelScope सभी शामिल हैं।
✅ तीन रूप: CLI (इस पाठ की मुख्य धारा), डेस्कटॉप संस्करण, वेब संस्करण (opencode pair वन-टाइम लिंक, 5 मिनट में मान्य)।
✅ क्रेडेंशियल जोड़ने के चार तरीके (API key / OAuth / कमांड / एनवायरनमेंट वेरिएबल), खाते के क्रेडेंशियल लोकल SQLite डेटाबेस में रहते हैं (एनवायरनमेंट वेरिएबल डिस्क पर नहीं लिखे जाते), प्रबंधन केवल /connect और opencode auth कमांड से होता है।
✅ प्रोजेक्ट की गाइडलाइन AGENTS.md को मानक मानी जाती है, जो Codex के साथ एक ही फ़ाइल साझा करती है, इसलिए टूल बदलने पर दोबारा लिखने की ज़रूरत नहीं; v2.3.1 से, जब AGENTS.md नहीं होता तो फ़ॉलबैक के रूप में CLAUDE.md पढ़ा जाता है।
मुख्य कार्यों की समीक्षा:
| कार्य | कैसे करें | विवरण |
|---|---|---|
| इंस्टॉल | curl -fsSL https://opencode.ai/v2/install | bash | विकल्प: brew, npm; Windows के लिए स्टैंडअलोन बाइनरी |
| शुरू करें | प्रोजेक्ट डायरेक्टरी में opencode | अति-सरल संस्करण opencode mini; स्क्रिप्ट opencode run |
| मॉडल जोड़ें | /connect प्रोवाइडर चुनकर key पेस्ट करें | कमांड-लाइन तरीका opencode auth login <厂商> --method key |
| मॉडल चुनें | /models | केवल मौजूदा सेशन पर लागू; F2 हाल के मॉडलों को घुमाता है |
| फ़ाइल जोड़ें / कमांड चलाएँ | @src/auth.ts / !git status | @ के साथ #20-45 लाइन नंबर दिया जा सकता है |
| पूर्ववत | /undo, /redo | पिछला संदेश और उसका किया काम हटा देता है |
| उपयोग देखें | opencode stats, opencode stats --cost | अपग्रेड के लिए opencode upgrade |
अगले पाठ की झलक
अब तक कमांड लाइन इस्तेमाल की; आख़िरी पाठ उनके लिए है जो टर्मिनल को बिल्कुल नहीं छूना चाहते: WorkBuddy उपयोग: Tencent का डेस्कटॉप AI वर्कस्पेस।
आप सीखेंगे:
- WorkBuddy क्या है: Tencent का डेस्कटॉप AI वर्कस्पेस, WeChat QR स्कैन करके ही लॉगिन हो जाता है
- बिना कमांड लाइन लिखे AI से वेबसाइट, मिनी-प्रोग्राम कैसे बनवाएँ
- पॉइंट कैसे गिने जाते हैं, प्लान कैसे चुनें
- चारों टूल के शुल्क की पूरी तालिका कीमत तुलना में देखें