OpenCode इंस्टॉलेशन और OmniProxy कॉन्फ़िगरेशन

OpenCode एक ओपन-सोर्स कोडिंग असिस्टेंट है जो आपको टर्मिनल, IDE या डेस्कटॉप से कोड लिखने की सुविधा देता है। यह आपके कोड या संदर्भ (context) को स्टोर नहीं करता है, जिससे यह गोपनीयता-संवेदनशील प्रोजेक्ट्स के लिए उपयुक्त है। build का उपयोग किसी प्रोजेक्ट को संशोधित करने के लिए किया जाता है, जबकि plan डिफ़ॉल्ट रूप से केवल-पढ़ने (read-only) के लिए है और यह अपरिचित कोड को समझने और बदलाव करने से पहले योजना बनाने के लिए उपयोगी है। आप अपनी आवश्यकताओं के आधार पर एक मॉडल सेवा चुन सकते हैं।

शुरू करने से पहले

इंस्टॉलेशन स्क्रिप्ट सबसे आसान विकल्प है। आपको एक आधुनिक टर्मिनल की आवश्यकता है—एक टर्मिनल एप्लिकेशन जो कमांड चला सके और प्रोजेक्ट फ़ाइलों के साथ काम कर सके—जैसे कि WezTerm, Alacritty, Ghostty, या Kitty। Windows पर, WSL को प्राथमिकता दी जाती है। यह Windows के भीतर एक Linux वातावरण प्रदान करता है जिसमें बेहतर प्रदर्शन और कार्यक्षमता होती है।

सबसे आसान

इंस्टॉलेशन स्क्रिप्ट

• curl opencode.ai/install
• macOS Linux पर सीधे उपयोग करें
• Windows पर WSL की अनुशंसा की जाती है

macOS Linux

Homebrew टैप

• anomalyco/tap/opencode
• फॉर्मूला की तुलना में अधिक बार अपडेट किया जाता है
• Arch के लिए भी एक पैकेज उपलब्ध है

नेटिव Windows

पैकेज मैनेजर

• choco या scoop
• या npm के साथ वैश्विक स्तर पर इंस्टॉल करें
• आप इसे Releases से भी डाउनलोड कर सकते हैं

वर्तमान मॉडल सूची से मॉडल ID भी तैयार रखें। मॉडल ID वह नाम है जिसका उपयोग सेवा किसी विशिष्ट मॉडल की सटीक पहचान करने के लिए करती है।

पहली बार इंस्टॉल और लॉन्च करें

सबसे आसान इंस्टॉलेशन कमांड है:

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

आप इन इंस्टॉलेशन विधियों में से किसी एक का भी उपयोग कर सकते हैं:

• Node.js: npm install -g opencode-ai। Bun, pnpm, और Yarn के पास भी संबंधित वैश्विक इंस्टॉलेशन कमांड हैं; इस गाइड के अंत में परिचय पृष्ठ देखें।
• macOS और Linux पर Homebrew: brew install anomalyco/tap/opencode। इस टैप का उपयोग करें क्योंकि यह brew install opencodeकी तुलना में अधिक बार अपडेट होता है, जिसे Homebrew टीम द्वारा बनाए रखा जाता है।
• Arch Linux: स्थिर रिलीज़ के लिए sudo pacman -S opencode का उपयोग करें, या नए संस्करण के लिए AUR पैकेज opencode-bin का उपयोग करें।
• Windows: उपयोग करें choco install opencode या scoop install opencode। आप npm install -g opencode-aiका भी उपयोग कर सकते हैं। बाइनरी फ़ाइलें Releases से भी डाउनलोड की जा सकती हैं। Windows पर Bun के साथ इंस्टॉलेशन के लिए समर्थन अभी प्रगति पर है।

अपनी प्रोजेक्ट डायरेक्टरी में प्रवेश करें, फिर OpenCode लॉन्च करें:

cd /path/to/project
opencode

पहली बार उपयोग करते समय, आप चला सकते हैं /init। यह प्रोजेक्ट का विश्लेषण करता है और प्रोजेक्ट रूट में AGENTS.md बनाता है। इस फ़ाइल को Git में कमिट किया जा सकता है ताकि प्रोजेक्ट इन निर्देशों को बनाए रखे।

OmniProxy से कनेक्शन मान प्राप्त करें

baseURL: https://your-omniproxy-origin.example/v1
API Key: <YOUR_OMNIPROXY_API_KEY>
Model ID: Copy from the current OmniProxy model list

baseURL सेवा का पता है, API Key एक्सेस क्रेडेंशियल है, और Model ID मॉडल का पूरा नाम है।

उपयोग करते समय /v1/chat/completions, npm पैकेज को @ai-sdk/openai-compatibleपर सेट करें। Chat Completions एक प्रकार का चैट अनुरोध इंटरफ़ेस है। केवल तभी स्विच करें जब मॉडल @ai-sdk/openai का उपयोग करता है /v1/responses। जब OmniProxy का उपयोग चैट कंप्लीशन एंडपॉइंट के माध्यम से किया जाता है, तो संगतता पैकेज को बनाए रखें।

OmniProxy की वर्तमान सूची से पूरा मॉडल ID कॉपी करें, जिसमें कोई भी स्लैश शामिल हो। 2026-10-09 तक, दो संदर्भ ID थे claude-sonnet-5-5 और gpt-6-luna. gpt-6-luna Chat Completions का समर्थन करता है; Chat Completions के माध्यम से फ़ंक्शन कॉलिंग केवल तभी समर्थित है जब reasoning_effort है none। ऐसा ID कॉपी न करें जो सूची में नहीं है।

टूल कॉन्फ़िगरेशन दर्ज करें

एक Provider को कॉन्फ़िगरेशन मानों के एक सेट के रूप में समझा जा सकता है जिसका उपयोग OpenCode किसी मॉडल सेवा से कनेक्ट करने के लिए करता है। Provider दस्तावेज़ीकरण एक OpenAI-संगत सेवा को जो /connect के अंतर्गत सूचीबद्ध नहीं है, एक कस्टम Provider के रूप में मानता है। एक OpenAI-संगत सेवा समान अनुरोध प्रारूप का उपयोग करती है और उसी प्रकार के क्लाइंट द्वारा कॉल की जा सकती है।

1. OpenCode में /connect चलाएं और Other पर स्क्रॉल करें।
2. एक Provider ID दर्ज करें। नीचे दिया गया उदाहरण omniproxyका उपयोग करता है। ऐसा ID चुनें जिसे याद रखना आसान हो क्योंकि आपको कॉन्फ़िगरेशन फ़ाइल में उसी का उपयोग करना होगा।
3. OmniProxy API Key दर्ज करें। यह चरण केवल क्रेडेंशियल को सहेजता है; पता और मॉडल अभी भी opencode.jsonमें जोड़े जाने चाहिए। क्रेडेंशियल ~/.local/share/opencode/auth.jsonमें संग्रहीत है।
4. प्रोजेक्ट डायरेक्टरी में opencode.json बनाएं या संशोधित करें:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniproxy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniProxy",
      "options": {
        "baseURL": "https://your-omniproxy-origin.example/v1"
      },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" },
        "gpt-6-luna": { "name": "GPT-6 Luna" }
      }
    }
  }
}

5. चलाएं /models। कस्टम Provider और उसके मॉडल सूची में दिखाई देंगे।

/connect के अंतर्गत दर्ज ID opencode.json में कुंजी से मेल खाना चाहिए। इस फ़ाइल में कोई वास्तविक गुप्त कुंजी न रखें। यदि आप /connect का उपयोग नहीं करते हैं, तो आप options.apiKey में पर्यावरण-चर (environment-variable) सिंटैक्स का उपयोग कर सकते हैं, जैसे {env:VARIABLE_NAME}। 2026-10-09 को OpenCode 1.18.34 के साथ परीक्षण में, /connect का उपयोग किए बिना कुंजी को सीधे प्रोजेक्ट के options.apiKey में डालने पर भी सफलतापूर्वक कनेक्ट हो गया। यदि गेटवे कुंजी को मान्य नहीं करता है, तो यह मान केवल स्थानीय मशीन पर उपयोग किया जाने वाला एक प्लेसहोल्डर स्ट्रिंग हो सकता है। models के अंतर्गत कुंजियों को सूची से पूर्ण ID का उपयोग करना चाहिए।

कुंजी

/connect

• नीचे Other चुनें
• अपना स्वयं का Provider ID चुनें
• auth.json में संग्रहीत

प्रोजेक्ट

opencode.json

• प्रदाता कुंजी का नाम समान होना चाहिए
• एक संगत npm पैकेज का उपयोग करें
• baseURL /v1 पर समाप्त होता है

चुनें

/models

• मॉडल सूची में दिखाई देता है
• प्रश्न पूछने से पहले एक चुनें
• गेटवे सूची से ID का उपयोग करें

वास्तविक कार्य के साथ सत्यापित करें

पहले प्रोजेक्ट डायरेक्टरी से एक वास्तविक कार्य चलाएं। मॉडल संदर्भ प्रारूप Provider ID/model IDहै; मॉडल ID के भीतर किसी भी स्लैश को सुरक्षित रखें:

opencode run --model omniproxy/claude-sonnet-5-5 --auto "Explain what a file you specify does. Do not modify the file."

--auto इस रन को फ़ाइल-रीडिंग टूल जैसे टूल का उपयोग करने की अनुमति देता है। 2026-10-09 को OpenCode 1.18.34 के साथ परीक्षण में, इसने निर्दिष्ट फ़ाइल की सामग्री को सफलतापूर्वक पढ़ लिया। पहला रन लगभग दो मिनट का था।

इंटरैक्टिव उपयोग के लिए, opencodeचलाएं, फिर /modelsके साथ एक मॉडल चुनें। आप @ का उपयोग फ़ाइलों को खोजने के लिए कर सकते हैं। opencode auth list का उपयोग /connectके माध्यम से सहेजे गए क्रेडेंशियल की पुष्टि करने के लिए करें, फिर स्रोत और मॉडल ID को सत्यापित करने के लिए OmniProxy के अनुरोध रिकॉर्ड की जांच करें।

लॉन्च

opencode लॉन्च करता है

• पहले प्रोजेक्ट पर cd करें
• auth list ID दिखाता है
• कॉन्फ़िगरेशन फ़ाइल प्रोजेक्ट में है

कार्य

इसने कोड पढ़ा

• किसी विशिष्ट फ़ाइल के बारे में पूछें
• इसकी व्याख्या की समीक्षा करें
• यदि यह गलत है तो /undo का उपयोग करें

लॉग

गेटवे में दृश्यमान

• स्रोत OpenCode है
• मॉडल ID मेल खाता है
• कुंजी को कमिट न करें

सामान्य त्रुटियां

• OmniProxy /modelsके अंतर्गत दिखाई नहीं देता है: जांचें कि /connect के अंतर्गत दर्ज ID opencode.jsonमें कुंजी से मेल खाता है npm , कि @ai-sdk/openai-compatibleको baseURL पर सेट किया गया है, और यह कि /v1के साथ समाप्त होता है।
• क्रेडेंशियल गायब है: चलाएं opencode auth list। Bedrock जैसे प्रदाता जो पर्यावरण चर पर निर्भर करते हैं, यहां दिखाई नहीं देते हैं; एक कस्टम Provider जिसे /connect के माध्यम से कॉन्फ़िगर किया गया है, उसे दिखाई देना चाहिए।
• Windows कार्यक्षमता अधूरी है: इसके बजाय WSL के अंदर इंस्टॉलेशन स्क्रिप्ट का उपयोग करें।
• मॉडल ID अमान्य है: इसे OmniProxy की वर्तमान सूची से फिर से कॉपी करें और modelsके अंतर्गत संबंधित कुंजी को अपडेट करें।
• अनुरोध गलत एंडपॉइंट पर जा रहे हैं: चैट कंप्लीशन के लिए @ai-sdk/openai-compatible बनाए रखें। Responses इंटरफ़ेस के लिए पैकेज न बदलें जब तक कि OmniProxy पर वह मॉडल वास्तव में /v1/responses का उपयोग न करता हो।

आधिकारिक संदर्भ

इंस्टॉलेशन के लिए, OpenCode परिचय देखें। कस्टम Providers के लिए, Providers देखें। उदाहरणों में उपयोग किए गए मॉडल ID के लिए, Claude मॉडल अवलोकन और GPT-6 Luna देखें।

अपनी स्वयं की OmniProxy कॉन्फ़िगरेशन से प्रत्येक प्लेसहोल्डर को मान से बदलें। कभी भी एक वास्तविक कुंजी प्रकाशित न करें।

एक सहेजा गया परिणाम या HTTP 200 अकेले पूरी एजेंट संगतता को साबित नहीं करता है। OmniProxy के कॉल रिकॉर्ड में स्रोत और मॉडल जांचें।

आधिकारिक स्रोत · OpenCode ↗