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

OpenCode हा एक ओपन-सोर्स कोडिंग असिस्टंट आहे जो तुम्हाला टर्मिनल, आयडीई किंवा डेस्कटॉपवरून कोड लिहिण्याची परवानगी देतो. तो तुमचा कोड किंवा संदर्भ साठवत नाही, ज्यामुळे तो गोपनीयता-संवेदनशील प्रकल्पांसाठी योग्य ठरतो. build प्रोजेक्ट सुधारण्यासाठी वापरले जाते, तर plan डीफॉल्टनुसार रीड-ओन्ली असते आणि अपरिचित कोड समजून घेण्यासाठी आणि बदल करण्यापूर्वी योजना आखण्यासाठी उपयुक्त असते. तुम्ही तुमच्या गरजेनुसार मॉडेल सेवा निवडू शकता.

सुरू करण्यापूर्वी

इंस्टॉलेशन स्क्रिप्ट हा सर्वात सोपा पर्याय आहे. तुम्हाला आधुनिक टर्मिनलची आवश्यकता आहे—एक टर्मिनल ॲप्लिकेशन जे कमांड्स चालवू शकते आणि प्रोजेक्ट फाईल्ससह काम करू शकते—जसे की 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 सह जागतिक स्तरावर स्थापित करा
• तुम्ही ते रिलीजमधून देखील डाउनलोड करू शकता

सध्याच्या मॉडेल यादीतून मॉडेल आयडी देखील तयार ठेवा. मॉडेल आयडी हे असे नाव आहे जे सेवा विशिष्ट मॉडेल अचूकपणे ओळखण्यासाठी वापरते.

प्रथमच स्थापित आणि लाँच करा

सर्वात सोपी इंस्टॉलेशन कमांड आहे:

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देखील वापरू शकता. बायनरी फाईल्स रिलीजमधून देखील डाउनलोड केल्या जाऊ शकतात. 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वर सेट करा. चॅट कंप्लीशन्स हा चॅट विनंती इंटरफेसचा एक प्रकार आहे. फक्त तेव्हाच @ai-sdk/openai वर स्विच करा जेव्हा मॉडेल /v1/responsesवापरते. जेव्हा OmniProxy चॅट कंप्लीशन्स एंडपॉईंटद्वारे वापरले जाते, तेव्हा सुसंगतता पॅकेज ठेवा.

OmniProxy च्या सध्याच्या यादीतून संपूर्ण मॉडेल आयडी कॉपी करा, कोणत्याही स्लॅशसह. 2026-10-09 पर्यंत, दोन संदर्भ आयडी होते claude-sonnet-5-5 आणि gpt-6-luna. gpt-6-luna . चॅट कंप्लीशन्सना सपोर्ट करते; चॅट कंप्लीशन्सद्वारे फंक्शन कॉलिंग तेव्हाच सपोर्ट केले जाते जेव्हा reasoning_effort हे noneअसते. यादीत नसलेला आयडी कॉपी करू नका.

टूल कॉन्फिगरेशन प्रविष्ट करा

प्रदाता (Provider) म्हणजे कॉन्फिगरेशन मूल्यांचा संच जो OpenCode मॉडेल सेवेशी कनेक्ट करण्यासाठी वापरतो. प्रदाता दस्तऐवजीकरण अशा OpenAI-सुसंगत सेवेला, जी /connect अंतर्गत सूचीबद्ध नाही, सानुकूल प्रदाता म्हणून मानते. OpenAI-सुसंगत सेवा समान विनंती फॉरमॅट वापरते आणि त्याच प्रकारच्या क्लायंटद्वारे कॉल केली जाऊ शकते.

1. OpenCode मध्ये /connect चालवा आणि Other वर स्क्रोल करा.
2. प्रदाता आयडी प्रविष्ट करा. खालील उदाहरण omniproxyवापरते. लक्षात ठेवण्यास सोपा आयडी निवडा कारण तुम्हाला कॉन्फिगरेशन फाईलमध्ये तोच वापरावा लागेल.
3. OmniProxy API की प्रविष्ट करा. ही पायरी फक्त क्रेडेंशियल सेव्ह करते; पत्ता आणि मॉडेल्स अजूनही 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. सानुकूल प्रदाता आणि त्याची मॉडेल्स यादीमध्ये दिसतील.

अंतर्गत प्रविष्ट केलेला आयडी /connect हा opencode.jsonमधील की शी जुळला पाहिजे. या फाईलमध्ये वास्तविक गुप्त की ठेवू नका. जर तुम्ही /connectवापरत नसाल, तर तुम्ही options.apiKeyमध्ये पर्यावरण-व्हेरिएबल सिंटॅक्स वापरू शकता, जसे की {env:VARIABLE_NAME}. OpenCode 1.18.34 सह 2026-10-09 रोजी केलेल्या चाचणीमध्ये, की थेट प्रोजेक्टच्या options.apiKey मध्ये /connect वापरल्याशिवाय टाकल्याने देखील यशस्वीरित्या कनेक्ट झाले. जर गेटवे की सत्यापित करत नसेल, तर हे मूल्य स्थानिक मशीनवर वापरले जाणारे प्लेसहोल्डर स्ट्रिंग असू शकते. अंतर्गत की models यादीतील पूर्ण आयडी वापरणे आवश्यक आहे.

की

/connect

• तळाशी Other निवडा
• तुमचा स्वतःचा प्रदाता आयडी निवडा
• auth.json मध्ये साठवले जाते

प्रोजेक्ट

opencode.json

• प्रदाता की ने समान नाव वापरणे आवश्यक आहे
• सुसंगत npm पॅकेज वापरा
• baseURL /v1 सह संपते

निवडा

/models

• मॉडेल यादीमध्ये दिसते
• प्रश्न विचारण्यापूर्वी एक निवडा
• गेटवे यादीतील आयडी वापरा

वास्तविक कार्याची पडताळणी करा

प्रथम प्रोजेक्ट डिरेक्टरीमधून एक वास्तविक कार्य चालवा. मॉडेल संदर्भ फॉरमॅट आहे Provider ID/model ID; मॉडेल आयडीमधील कोणतेही स्लॅश जतन करा:

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

--auto या रनला फाईल-रीडिंग टूल्स सारखी साधने वापरण्याची परवानगी देते. OpenCode 1.18.34 सह 2026-10-09 रोजी केलेल्या चाचणीमध्ये, त्याने निर्दिष्ट फाईलची सामग्री यशस्वीरित्या वाचली. पहिल्या रनला सुमारे दोन मिनिटे लागली.

परस्परसंवादी वापरासाठी, चालवा opencode, त्यानंतर /modelsसह मॉडेल निवडा. तुम्ही @ फाईल्स शोधण्यासाठी वापरू शकता. वापरून opencode auth list द्वारे सेव्ह केलेले क्रेडेंशियल कन्फर्म करा /connect, त्यानंतर स्रोत आणि मॉडेल आयडी सत्यापित करण्यासाठी OmniProxy च्या विनंती नोंदी तपासा.

लाँच

opencode लाँच होते

• प्रथम प्रोजेक्टवर cd करा
• auth list आयडी दर्शवते
• कॉन्फिगरेशन फाईल प्रोजेक्टमध्ये आहे

कार्य

त्याने कोड वाचला

• विशिष्ट फाईलबद्दल विचारा
• त्याचे स्पष्टीकरण पुनरावलोकन करा
• जर ते चुकीचे असेल तर /undo वापरा

लॉग्स

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

• स्रोत OpenCode आहे
• मॉडेल आयडी जुळतो
• की कमिट करू नका

सामान्य त्रुटी

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

वापरत नाही तोपर्यंत रिस्पॉन्स इंटरफेससाठी पॅकेज बदलू नका.

अधिकृत संदर्भ

इंस्टॉलेशनसाठी, OpenCode introduction पहा. सानुकूल प्रदात्यांसाठी, Providers पहा. उदाहरणांमध्ये वापरलेल्या मॉडेल आयडीसाठी, Claude model overview आणि GPT-6 Luna पहा.

तुमच्या स्वतःच्या OmniProxy कॉन्फिगरेशनमधील प्रत्येक जागादार मूल्य बदला. वास्तविक की कधीही प्रकाशित करू नका.

संवर्धित परिणाम किंवा HTTP 200 फक्त पूर्ण एजंट सुसंगतता सिद्ध करत नाही. OmniProxy च्या कॉल रेकॉर्डमध्ये स्रोत आणि मॉडेल तपासा.

अधिकृत स्रोत · OpenCode ↗