OpenCode के साथ शुरुआत करें

OpenCode एक ओपन सोर्स AI कोडिंग एजेंट है। v1 टर्मिनल, डेस्कटॉप ऐप और IDE एक्सटेंशन के रूप में उपलब्ध है। यह पृष्ठ v1 के opencode-ai पैकेज के लिए है; आधिकारिक v2 दस्तावेज़ (opens in a new tab) में अलग इंस्टॉलेशन निर्देश हैं।

आवश्यकताएँ

• WezTerm (opens in a new tab), Alacritty (opens in a new tab), Ghostty (opens in a new tab) या Kitty (opens in a new tab) जैसा आधुनिक टर्मिनल।
• चुने गए LLM प्रदाता की पहुँच और आवश्यक API कुंजी। क्लाइंट का ओपन सोर्स होना मॉडल की सेवाएँ निःशुल्क होने का अर्थ नहीं है।

इंस्टॉल करें

आधिकारिक v1 इंस्टॉलेशन स्क्रिप्ट:

curl -fsSL https://opencode.ai/install | bash

Node.js पैकेज मैनेजर में से कोई एक चुनें:

npm install -g opencode-ai

bun install -g opencode-ai

pnpm install -g opencode-ai

yarn global add opencode-ai

macOS और Linux पर Homebrew:

brew install anomalyco/tap/opencode

Arch Linux के स्थिर पैकेज या AUR पैकेज में से एक चुनें:

sudo pacman -S opencode

paru -S opencode-bin

Windows

Windows Subsystem for Linux (WSL) में Linux वाले निर्देश इस्तेमाल किए जा सकते हैं। सीधे Windows पर Chocolatey, Scoop या npm विकल्प उपलब्ध हैं:

choco install opencode

scoop install opencode

npm install -g opencode-ai

अन्य विकल्प:

mise use -g github:anomalyco/opencode

docker run -it --rm ghcr.io/anomalyco/opencode

v1 दस्तावेज़ के अनुसार Windows पर Bun इंस्टॉलेशन का समर्थन अभी विकसित किया जा रहा है। आप आधिकारिक रिलीज़ (opens in a new tab) से अपने सिस्टम का बाइनरी भी ले सकते हैं। अलग परियोजना के Go पैकेज को इस क्लाइंट का विकल्प न मानें।

प्रदाता कॉन्फ़िगर करें

टर्मिनल में opencode शुरू करें और /connect चलाएँ। प्रदाता चुनकर उसकी प्रमाणीकरण प्रक्रिया पूरी करें। Zen एक वैकल्पिक सेवा है; अन्य प्रदाता भी इस्तेमाल किए जा सकते हैं।

/connect

Zen के लिए आधिकारिक कंसोल (opens in a new tab) में साइन इन करें, बिलिंग सेट करें और अपनी API कुंजी कॉपी करें। कुंजी को /connect के संकेत में पेस्ट करें; उसे सार्वजनिक कॉन्फ़िगरेशन या Git में न लिखें। फिर उपलब्ध मॉडल चुनें:

/models

प्रोजेक्ट आरंभ करें

अपने प्रोजेक्ट की डायरेक्टरी खोलें:

cd /path/to/project

opencode

प्रोजेक्ट का विश्लेषण करके AGENTS.md बनाने के लिए:

/init

इस फ़ाइल में प्रोजेक्ट संरचना और विकास नियम रहते हैं। समीक्षा के बाद इसे Git में शामिल करें ताकि टीम एक ही निर्देश इस्तेमाल करे।

उपयोग

सवाल पूछें

फ़ाइल का संदर्भ जोड़ने के लिए @ लिखें। उदाहरण:

How is authentication handled in @packages/functions/src/api/index.ts?

नई सुविधा जोड़ें

बड़ी सुविधा के लिए पहले योजना बनाएँ। Tab से Plan एजेंट चुनें; वह विश्लेषण के लिए सीमित अनुमतियाँ इस्तेमाल करता है। वास्तविक अनुमति व्यवहार के लिए अनुमतियाँ देखें।

When a user deletes a note, flag it as deleted in the database.
Add a screen to restore or permanently delete those notes.

योजना पढ़ें, सीमाएँ और अपेक्षित परिणाम बताएँ। डिज़ाइन की तस्वीर टर्मिनल में खींचकर संदर्भ के रूप में जोड़ सकते हैं। तैयार होने पर Tab से Build एजेंट चुनें और बदलाव लागू करने को कहें।

मौजूदा कोड बदलें

छोटे बदलाव के लिए फ़ाइल और अपेक्षित व्यवहार स्पष्ट करें:

Add authentication to /settings using the pattern in
@packages/functions/src/notes.ts.

कोड में हुए बदलाव की समीक्षा करें और प्रोजेक्ट के परीक्षण चलाएँ। एजेंट की सफलता की घोषणा परीक्षण का विकल्प नहीं है।

बदलाव वापस लें

पिछला बदलाव वापस लेने के लिए:

/undo

ज़रूरत पड़ने पर इसे दोहराएँ, निर्देश सुधारें और फिर से प्रयास करें। वापस लिया गया बदलाव दोबारा लागू करने के लिए:

/redo

बातचीत साझा करें

/share

यह बातचीत का लिंक बनाकर क्लिपबोर्ड में कॉपी करता है। बातचीत डिफ़ॉल्ट रूप से साझा नहीं होती। साझा लिंक रखने वाला कोई भी व्यक्ति उसे देख सकता है; प्रकाशित करने से पहले निजी जानकारी जाँचें। साझाकरण सेटिंग में इसे बंद किया जा सकता है।

अपनी ज़रूरत के अनुसार बदलें

थीम, कीबोर्ड शॉर्टकट, फ़ॉर्मेटर, कस्टम कमांड और कॉन्फ़िगरेशन से अपने काम का तरीका सेट करें।

दस्तावेज़ का स्रोत (MIT)